辅助组件鉴权说明
调用格式
调用地址
格式:
[embed_link]?[params]×tamp=[timestamp]&sign=[signature]
其中括号包含的部分含义如下:
| 变量 | 说明 |
|---|---|
| embed_link: 嵌入链接 | 系统 - 辅助组件，外部网页中配置的嵌入链接 |
| params: 请求参数 | 访问嵌入链接时附带参数 |
| timestamp: 时间戳 | 发起请求时的时间戳，'1970-01-01 00:00:00'至今的秒数。如无特别说明，默认过期时间五分钟 |
| signature: 签名 | 身份认证签名，详细生成算法请查阅鉴权方法 |
参数
参数分为三类:
| 类型 | 说明 |
|---|---|
| 用户标识 | 当前登录用户邮箱，以 agent_email 作为健，值为用户邮箱 |
| 字段 | 系统 - 辅助组件，外部网页中配置选择的字段，以字段 api_name 作为健，值为关联对象记录字段的值 |
| 鉴权参数 | 时间戳（timestamp），签名（sign） |
鉴权方法
规则说明
url 中的签名 sign 是由[邮箱+时间戳+秘钥]MD5 生成，服务器收到请求后按照相同的规则重新生成一遍，然后比对是否一致，验证请求的合法性
sign 的计算方法如下:
sign=md5Hex([email]×tamp=[timestamp]&[secretKey])
其中:
- email: 邮箱
- timestamp: 时间戳，'1970-01-01 00:00:00'至今的秒数
- secretKey: 鉴权私钥，系统设置 - 密钥
示例
假设要嵌入以下链接:
https://demo.udesk.cn/test/convertor
鉴权所需数据:
| 名称 | 值 |
|---|---|
| demo@test.cn | |
| secretKey | 957a542817ebcda1cccacd9a7c1fc711 |
| timestamp | 1496631984 |
计算签名:
md5Hex("demo@test.cn×tamp=1496631984&957a542817ebcda1cccacd9a7c1fc711") -> cfecf8262c1203fc9aa6ac03f5e16c5a
最终请求 URL:
https://demo.udesk.cn/test/convertor?a=1&b=2&c=test&agent_email=1@test.cn×tamp=1496631984&sign=cfecf8262c1203fc9aa6ac03f5e16c5a