应用入口配置

Teambition 开放平台提供了强大的应用间的集成能力，你可以在应用入口中进行配置，从而决定你的应用入口：

• 出现在 Web 端还是移动端；
• 出现的位置：全局导航入口，项目导航入口，项目菜单项，或者其他地方；
• 出现的形式：弹窗，新页面，或者其他形式。

下面以添加一个 Dock 入口为例，说明如何进行应用的入口配置。

1. 点击添加应用入口，选择基础入口分类下，Web 端的 Dock 功能；

1. 填写相关信息后，点击添加；

可以在应用的入口地址上拼接相应的参数，获取上下文信息，假设你的入口地址是 https://www.demo.com/path，则：

• 获取当前访问的企业：https://www.domain.com/path?org_id=$org_id$
• 获取用户的语言偏好：https://www.domain.com/path?lang=$lang$

除上述参数外，平台还会在调用应用的入口地址时传递以下参数：

• _userId：当前用户的 ID
• mode：应用的打开方式，可忽略
• timestamp：时间戳，用于计算下面的签名参数 sign
• sign：签名参数，用于验证请求是否可信，防止伪造请求。sign 参数的生成算法如下：

（1）假设完整的请求为：

https://www.domain.com?c=3&b=2&a=1&timestamp=1509691334567&sign=e041708dc45981f5...

提取所有的请求参数（除 sign 参数外），得到如下字符串：

c=3&b=2&a=1&timestamp=1509691334567

（2）按参数名进行正序排列，得到如下字符串：

a=1&b=2&c=3&timestamp=1509691334567

（3）拼接应用的 appSecret（如果是旧版开放平台上的应用，则拼接 clientSecret），得到如下字符串：

a=1&b=2&c=3&timestamp=1509691334567&appSecret=knQb5WJcs5x7ecwQ...

（4）对字符串进行 md5 运算：

md5("a=1&b=2&c=3&timestamp=1509691334567&appSecret=knQb5WJcs5x7ecwQ...")

（5）将得到的结果与 sign 参数对比，如果一致则可信任此请求

1. 返回列表后可以看到刚才添加的入口。