辅助组件鉴权说明

调用格式

调用地址

格式:

[embed_link]?[params]&timestamp=[timestamp]&sign=[signature]

其中括号包含的部分含义如下:

变量 说明
embed_link: 嵌入链接 系统 - 辅助组件,外部网页中配置的嵌入链接
params: 请求参数 访问嵌入链接时附带参数
timestamp: 时间戳 发起请求时的时间戳,'1970-01-01 00:00:00'至今的秒数。如无特别说明,默认过期时间五分钟
signature: 签名 身份认证签名,详细生成算法请查阅鉴权方法

参数

参数分为三类:

类型 说明
用户标识 当前登录用户邮箱,以agent_email作为健,值为用户邮箱
字段 系统 - 辅助组件,外部网页中配置选择的字段,以字段api_name作为健,值为关联对象记录字段的值
鉴权参数 时间戳(timestamp),签名(sign)

鉴权方法

规则说明

url中的签名sign是由Key+请求参数+时间戳MD5生成,服务器收到请求后按照相同的规则重新生成一遍,然后比对是否一致,验证请求的合法性

sign 的计算方法如下:

sign=md5Hex(params&timestamp&secretKey)

其中:

示例

假设要嵌入以下链接:

https://demo.udesk.cn/test/convertor

鉴权所需数据:

名称
params a=1&b=2&c=test&agent_email=1@test.cn
secretKey 957a542817ebcda1cccacd9a7c1fc711
timestamp 1496631984

计算签名:

md5Hex("a=1&b=2&c=test&agent_email=1@test.cn&timestamp=1496631984&957a542817ebcda1cccacd9a7c1fc711") -> cfecf8262c1203fc9aa6ac03f5e16c5a

最终请求URL:

https://demo.udesk.cn/test/convertor?a=1&b=2&c=test&agent_email=1@test.cn&timestamp=1496631984&sign=cfecf8262c1203fc9aa6ac03f5e16c5a