mirror of https://github.com/ehang-io/nps
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
|
|
|||
|
|
# webAPI验证说明
|
|||
|
|
- 采用auth_key的验证方式
|
|||
|
|
- 在提交的每个请求后面附带两个参数，`auth_key` 和`timestamp`
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
auth_key的生成方式为：md5(配置文件中的auth_key+当前时间戳)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
timestamp为当前时间戳
|
|||
|
|
```
|
|||
|
|
```
|
|||
|
|
curl --request POST \
|
|||
|
|
--url http://127.0.0.1:8080/client/list \
|
|||
|
|
--data 'auth_key=2a0000d9229e7dbcf79dd0f5e04bb084×tamp=1553045344&start=0&limit=10'
|
|||
|
|
```
|
|||
|
|
**注意：** 为保证安全，时间戳的有效范围为20秒内，所以每次提交请求必须重新生成。
|
|||
|
|
|
|||
|
|
# 获取服务端时间
|
|||
|
|
由于服务端与api请求的客户端时间差异不能太大，所以提供了一个可以获取服务端时间的接口
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
POST /auth/gettime
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
# 获取服务端authKey
|
|||
|
|
|
|||
|
|
如果想获取authKey，服务端提供获取authKey的接口
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
POST /auth/getauthkey
|
|||
|
|
```
|
|||
|
|
将返回加密后的authKey，采用aes cbc加密，请使用与服务端配置文件中cryptKey相同的密钥进行解密
|
|||
|
|
|
|||
|
|
**注意：** nps配置文件中`auth_crypt_key`需为16位
|
|||
|
|
- 解密密钥长度128
|
|||
|
|
- 偏移量与密钥相同
|
|||
|
|
- 补码方式pkcs5padding
|
|||
|
|
- 解密串编码方式 十六进制
|
|||
|
|
|
|||
|
|
# 详细文档
|
|||
|
|
- **此文档近期可能更新较慢，建议自行抓包**
|
|||
|
|
|
|||
|
|
为方便第三方扩展，在web模式下可利用webAPI进行相关操作，详情见
|
|||
|
|
[webAPI文档](https://github.com/cnlh/nps/wiki/webAPI%E6%96%87%E6%A1%A3)
|