# 第三方平台

TA3.1 版本起,TA 超管可在系统管理功能模块,设置绑定第三方应用,实现:

  • 使用第三方扫码登录
  • 在第三方应用工作台一键登录 TA
  • 使用第三方应用接收 TA 动态

注意:该指南不适用于 SaaS 和使用 LDAP 鉴权登录的客户。

请按照文档按步骤操作,以实现以上全部功能

目前支持企业微信、钉钉或飞书的应用绑定,点击产品名称查看相应绑定指南:

# 一、绑定第三方应用

# 1.1 企业微信

步骤 1 创建应用

企业微信的管理员进入企业微信管理后台 (opens new window),在「应用管理」-「应用」-「自建」中创建应用

  • 上传应用 logo,若使用 TA logo,请点击下载 (opens new window)
  • 填写应用名称,如 TA 平台
  • 填写应用介绍
  • 选择可见范围,操作者本人需添加至可见范围,仅可见范围内的员工可通过企业微信授权登录 TA 平台

步骤 2 设置从企业微信客户端进入 TA 平台

点击进入创建的应用,在页面下方的「功能」模块,点击设置「工作台应用主页」,在弹框中填入应用主页地址:https://私有化集群地址/#/login (如https://ta.thinkingdata.cn/#/login)

步骤 3 获取企业微信帐号信息

在页面下方的「开发者接口」→「网页授权及 JS-SDK」,点击「设置可信域名」,在弹框中输入可信域名(私有化集群地址)

步骤 4 开通使用企业微信扫码登录

在「开发者接口」→「企业微信授权登录」,点击「设置」

在设置页面,选择 「Web 网页」→「设置授权回调域」。输入私有化集群地址,点击保存。

以上操作完成在企业微信管理后台的设置,请在 TA 平台完成以下配置。

步骤 5 在 TA 系统管理中绑定企业微信应用

TA 超管进入「系统管理」,点击「第三方平台管理」,选择企业微信,点击绑定。

  • 企业 ID: 企业微信的管理后台「我的企业」-「企业信息」
  • AgentId&Secret:创建的应用首页

以上操作即完成 TA 系统与企业微信的绑定。

# 1.2 钉钉

注意

鉴于钉钉 Cookie 安全策略要求,需使用 Https 访问钉钉工作台。请在完成以下操作后,联系 TA 运维人员更改 ta-web 组件配置。

步骤 1 创建应用

钉钉企业管理员登录后进入钉钉开放平台 (opens new window),在「工作台」中点击「自建应用」

在「企业内部开发」,选择「H5 微应用」,点击创建应用

  • 应用类型:H5 微应用
  • 应用名称:如 TA 平台
  • 应用描述
  • 应用图标:若使用 TA logo,请点击下载 (opens new window)
  • 开发方式:企业自助开发

步骤 2 设置从钉钉客户端工作台进入 TA 平台

在创建的微应用详情页,选择「开发管理」,编辑以下内容并保存

  • 开发模式:开发应用
  • 服务器出口 IP:调用钉钉服务端 API 时的合法 IP 列表
  • 应用首页地址:https://私有化集群地址/#/login,如https://ta.thinkingdata.cn/#/login
  • PC 端首页地址:https://私有化集群地址/#/login

步骤 3 获取钉钉登录帐号信息

在当前页面点击「权限管理」,设置权限范围,添加「通讯录只读权限」接口权限

步骤 4 设置应用使用范围&发布应用

选择员工进行授权,仅使用范围内的员工可通过钉钉授权登录 TA 平台

步骤 5 开通使用钉钉扫码登录

在左侧导航栏,「移动接入应用」模块选择「登录」,点击「创建扫码登录应用授权」

  • 名称:如 TA 平台
  • 描述
  • 授权 LOGO 地址:私有化集群地址
  • 回调域名:私有化集群地址

以上操作即完成在钉钉管理后台的设置,以下步骤为在 TA 平台的相应设置。

步骤 6 在 TA 系统管理中绑定钉钉应用

TA 超管进入「系统管理」,点击「第三方平台管理」,选择钉钉,点击绑定

以上操作即完成 TA 系统与钉钉的绑定。

# 1.3 飞书

步骤 1 飞书管理员进入飞书开放平台 (opens new window),点击「创建应用」,选择「创建企业自建应用」

步骤 2 设置从飞书客户端工作台进入 TA 平台

点击进入已创建的应用,点击「应用功能」→「网页」:

  1. 点击启用网页
  2. 配置桌面端主页:https://私有化集群地址/#/login。如https://ta.thinkingdata.cn/#/login
  3. 配置移动端主页:https://私有化集群地址/#/login

步骤 3 设置免登授权码 URL 白名单

点击「安全设置」,配置重定向 URL:https://私有化集群地址/v1/sso/thirdLogin/callback

步骤 4 配置消息接收功能

点击「权限管理」,添加“获取用户 userid”、”以应用的身份发消息“、”给多个用户批量发消息权限”

点击「应用功能」→「机器人」,点击“启用机器人”

步骤 5 设置应用可见范围&发布应用

选择员工进行授权,仅可见范围内的员工可通过飞书授权登录 TA 平台

注意

涉及人员权限变更的版本,需飞书管理员进行审核。审核通过后,发布版本方能生效。

以上操作即完成在飞书开放平台的应用设置,请在 TA 平台完成以下配置。

步骤 6 在 TA 系统管理中绑定飞书应用

TA 超管进入「系统管理」,点击「第三方平台管理」,选择飞书,点击绑定。

  • App ID & App Secret:在创建的应用「凭证与基础信息」中查看

以上操作即完成 TA 系统与飞书的绑定。

# 二、绑定 TA 帐号

超管完成 TA 系统与第三方应用的绑定后,TA 成员可进行个人帐号的绑定操作。

# 2.1 绑定已有 TA 帐号

(1)登录后,在「个人设置」页面完成绑定

TA 成员进入「个人设置」页面,点击绑定个人帐号。以企业微信为例,在「个人设置」页面点击绑定,扫码即可完成企业微信帐号与 TA 帐号的绑定

  • 注意:仅应用可见范围内的成员可完成该绑定

(2)在登录页完成绑定

在 TA 登录页点击应用登录入口,扫码后输入 TA 帐号密码后点击绑定即可

# 2.2 通过第三方应用获取 TA 帐号

超管在系统管理中完成绑定第三方应用后,用户可在 TA 登录页通过扫码创建 TA 帐号

  • 注意:仅应用可见范围内的成员可完成该创建

创建的新账号默认无项目权限,需联系管理员在项目管理中添加帐号至项目,完成项目授权。

# 三、解绑帐号

第三方帐号与 TA 帐号为一对一的绑定关系。若在绑定时提示帐号已绑定,希望切换绑定关系,可解绑当前帐号后再次绑定新帐号:

(1)扫码登录已绑定的帐号

(2)进入「个人设置」页面,解绑当前绑定

  • 解绑后的帐号只能通过 TA 帐号密码登录,若该帐号继续使用,请确保牢记帐号名和密码

(3)登录待绑定的 TA 帐号,重新完成绑定