OneApi 安全控制主要通过 Token 来实现，Token 分为两种，第一种是静态 Token，第二种是动态 Token。相对于来说，动态 Token 更安全一些。另外一种通过登录用户来控制权限，详见 OneApi 登录用户。
基于文件的接口管理方式中，Token 在配置文件中设置，且 Token 的应用范围仅限当前项目; 基于数据库的接口管理方式中，Token 在数据表中设置，应用范围是由数据库管理的所有项目。
当设置项oneapi.security.mode的值为token时，启用 Token 验证模式。静态 Token 类似于普通用户登录的的用户名和密码，需要在请求接口时提供额外的参数token。例如
基于文件管理的接口方式 Token 在设置项oneapi.token.list中设置，参见 OneApi 设置。oneapi.token.list设置项的格式为requester1=token1&requester2=token2&requester3=token3，字符与字符之间不能有空格，且 Token 必须唯一，即不同请求者的 Token 不能一样。例如teacher=npeiwxl&monitor=xequtnb。
Token 可以附加在地址参数中，也可以保存在 Header 中。名称为Authorization，值以Bearer开头，例如Bearer Xay876cadNw。
当设置项oneapi.security.mode的值为secret时，启用动态 Token 验证模式。动态 Token 需要先请求一个接口获取动态 Token，再用这个动态 Token 请求需要的接口，需要两步操作。但是动态 Token 有过期时间，在过期时间之内，可以不用再次获取动态 Token。
动态 Token 的获取接口示例如下，返回值是一个字符串：
这个接口需要自己在微服务中实现，调用方法OneApi.getSecretKey(String token)即可，示例如下：
另一个方法可以获取动态 Token 的剩余存活时间（time to live） OneApi.ttlSecretKey(String key)。
请求目标接口的示例如下，参数secret即动态 Token：
动态 Token 也可以保存在 Header 中进行传递，名称和值和 Token 验证相同。
建议使用 Redis 保存动态 Token，特别是在负载均衡模式下，只需在配置文件中配置名称为qross的 Redis 数据源连接即可，可参见 PQL 数据源配置。例如
需要在项目中引入依赖jedis 3.0或以上版本
与动态 Token 相关的设置项有两个：
oneapi.secret.key.ttl 可以设置动态Token的过期时间，默认时间为3600秒。oneapi.secret.key.digit 动态 Token 的位数，默认值是16位。请求接口时 OneApi 会验证请求者名称和 Token 是否匹配，判断请求者能不能访问这个服务，但是请求者是否有访问此接口的权限，还需要进行安全控制。就像用户系统一样，用户登录了系统，但是用户能够使用哪些功能还需要设置相应的权限。详见 OneApi 接口安全控制。
在接口服务中，有的接口可能是完全开放的，不需要安全验证也能够访问，OneApi 可以设置不需要安全验证也够访问的接口，详见 OneApi 设置安全验证例外。
参考链接
