使用Token进行系统集成与Token重命名

1. 概述

1.1 功能概述

在标准集成方案中，Wyn支持通过URL直接传递Token参数（如：?token=xxx）实现快速接入。但当与泛微等第三方系统集成时，会遇到参数名冲突（比如当泛微同样使用'token'作为授权参数），您可以通过修改Wyn的Token参数名称（如改为'productToken'）来避免命名冲突，确保两个系统的授权机制互不干扰。

2. 生成Token

步骤一：进入生成令牌界面

1. 使用系统管理员账号登录，依次单击「系统管理>安全设置>生成令牌」，即可进入生成令牌界面。

   
   

步骤二：配置令牌

1. 在生成令牌界面，输入名称，用户、密码，选择组织路径和过期时间，最后单击生成令牌按钮，即可生成对应用户的令牌。

   
   

步骤三：获取令牌

1. 生成令牌后，单击令牌右侧的更多按钮，选择获取令牌即可将令牌拷贝，然后可以直接粘贴至集成用的URL中即可。集成单个文档时直接使用即可。

   
   

   注意： 生成令牌的用户必须具有对应文档的查看权限。

步骤四：将 Token 添加到 URL 中组成完整的集成 URL

1. 例如，在「文档门户>工作空间>仪表板」打开一个仪表板，单击在新窗口浏览仪表板按钮，即可在打开新页面并查看文档。

   
   

2. 将获取的令牌使用“&token=”拼接在URL上。

   
   

   注意： 将token拼接在URL上时，Token值会直接暴露在地址栏可能会引发泄露风险，建议使用AuthToken进行集成。

3. 之后，将浏览器地址栏的url转发给其他用户，其他用户均可以查看文档。

   注意： 这里需要注意令牌的过期时间，若令牌已过期，则令牌已失效则不能查看文档。

3. 修改Token

将 Wyn 的令牌名称修改为其他字符串，这样一来就不会出现冲突的现象，从而解决与泛微等第三方系统集成时，遇到参数名冲突问题。

1. 在 Wyn.conf 文件中的 Server 节点下 添加如下描述 ，比如将令牌名修改为WYN_Token。

   <IntegrationTokenName>WYN_Token</IntegrationTokenName>

2. 这样一来，我们在进行嵌入式集成时，但凡需要用到令牌的地方，都必须使用新令牌才能生效。

   1）例如本例中则需要使用 “WYN_Token”。

   2）比如在进行 URL 集成时，URL 形如：

   http://localhost:51980/dashboards/create?WYN_Token=2cb6c4d1717902b9a...&datasetId=b0082554-9c66-4605-8cf3-5f1ffbd9c314

   3）而在 DIV 集成中，则需要在代码中指定新的参数名。如下图：