在钉钉、飞书、企业微信中使用移动端
把移动端接入企业微信、钉钉、飞书：开通前的三个网络前提、各平台后台逐项配置、测试连接、账号试匹配与常见问题。
概述
接入后，员工在企业微信、钉钉或飞书的工作台里点开应用，就能直接进入移动端，不用再输入账号密码（免登）；订阅与预警消息也能推送到这些平台。
免登能否成功，取决于三个前提，缺一个就会失败：
| 前提 | 说明 | 在哪里确认 |
|---|---|---|
| 手机能打开移动端 | 需要一个外网可访问的 HTTPS 地址。企业微信要求这个域名已备案、且备案主体与企业一致 | 移动 > 设置 >「网络与部署」的「手机连通自检」 |
| 服务器能访问平台接口 | SightReport 要访问企业微信、钉钉、飞书的接口，并且服务器出口 IP 要登记到平台后台的白名单 | 「渠道」页的「测试连接」 |
| 账号能对应上 | 平台里的成员要能对应到 SightReport 的用户 | 「渠道」页的「试匹配账号」 |
功能入口
移动 > 设置 >「渠道」页签。企业微信、钉钉、飞书各有一块，包含：配置步骤、「要在对方后台填的值」（可一键复制）、凭证填写、「账号对应方式」、「试匹配账号」和「测试连接」。
操作步骤
准备工作
- 按移动端网络部署让外网手机能打开移动端，并在「基础」页填写「对外访问地址」。
- 在「网络与部署」的「钉钉 / 飞书 / 企业微信接口出站」确认服务器访问平台接口的方式。内网服务器不能上外网时，选「经移动网关」。
接入企业微信
- 在企业微信管理后台「应用管理」创建自建应用，记下 AgentId 和 Secret；企业 ID 在「我的企业」页面最下方。
- 在应用的「网页授权及 JS-SDK」里设置可信域名：
- 企业微信会提供一个校验文件（形如
WW_verify_xxxx.txt）。在「渠道 > 企业微信」点「上传校验文件（.txt）」上传，再点右上角「保存」；也可以把文件放到前置机网站的根目录。 - 回到企业微信点「验证」。可信域名填「要在对方后台填的值」里的「可信域名」。
- 企业微信会提供一个校验文件（形如
- 在「企业可信 IP」里填服务器出口 IP：先在 SightReport 点「测试连接」，「要在对方后台填的值」里会显示「服务器出口 IP」。
- 「应用主页」填「要在对方后台填的值」里的地址（对外访问地址 +
/m/m.html），并设置应用的可见范围。 - 在 SightReport 填入「企业 ID（CorpID）」「应用 AgentId」「应用密钥（Secret）」，选择「账号对应方式」，打开「启用」。
- 点「测试连接」，全部通过后点右上角「保存」。
接入钉钉
- 在钉钉开放平台创建企业内部应用（H5 微应用），记下 AppKey 和 AppSecret；CorpId 在开发者后台首页。
- 在「开发管理」里，应用首页地址（移动端）填「要在对方后台填的值」里的首页地址；「服务器出口 IP」填测试连接后显示的 IP。
- 开通「通讯录个人信息读权限」和「成员信息读权限」。
- 发布版本，并设置可见范围。
- 在 SightReport 填入「AppKey」「AppSecret」「AgentId」「企业 ID（CorpId）」，选择「账号对应方式」，打开「启用」。
- 点「测试连接」，通过后保存。
接入飞书
- 在飞书开放平台创建企业自建应用，记下 App ID 和 App Secret。
- 开启「网页应用」和「机器人」能力，网页应用的移动端主页填「要在对方后台填的值」里的地址。机器人用于推送订阅消息。
- 在「安全设置」里，「H5 可信域名」填「要在对方后台填的值」里的「H5 可信域名」；如果开启了「IP 白名单」，再填服务器出口 IP。
- 按「账号对应方式」开通所需权限，界面上会提示需要哪些权限。
- 创建版本、设置可用范围并发布（需要企业管理员审核）。可用范围之外的成员不能免登，也收不到推送。
- 在 SightReport 填入「App ID」「App Secret」，选择「账号对应方式」，打开「启用」，点「测试连接」，通过后保存。
试匹配账号
在每个渠道的「试匹配账号」里输入平台中某个成员的账号、手机号或工号（取决于「账号对应方式」），点「试匹配账号」，可以看到会对应到 SightReport 的哪个用户。这一步只查 SightReport 自己的用户，不访问平台接口，适合在正式开放前抽查几个人。
属性/参数说明
| 属性 | 说明 | 取值/默认值 |
|---|---|---|
| 账号对应方式 | 平台成员与 SightReport 用户的对应规则；对应不上的成员会被拒绝登录 | 「按登录账号」（默认）/「按手机号」/「按工号」 |
| 域名校验文件 | 企业微信设置可信域名时给出的校验文件，由 SightReport 在域名根目录提供 | 最多 5 个；文件名只含字母、数字、_、-，扩展名 .txt；内容不超过 2048 字节 |
| 服务器出口 IP | 平台看到的 SightReport 调用方 IP，需要登记到平台白名单 | 测试连接遇到「IP 不在白名单」时自动识别显示 |
示例
某企业用企业微信，对外访问地址为 https://m.example.com，内网服务器经移动网关出站，网关公网 IP 为 203.0.113.10。
- 企业微信后台创建应用「经营数据」，可信域名填
m.example.com，上传WW_verify_AbCd1234.txt到 SightReport 并保存，回企业微信点「验证」通过。 - SightReport 填入企业 ID、AgentId、Secret，「账号对应方式」选「按手机号」，点「测试连接」：提示服务器出口 IP
203.0.113.10未加入白名单。 - 企业微信「企业可信 IP」填
203.0.113.10，再次「测试连接」全部通过，保存。 - 「试匹配账号」输入一位员工的手机号，确认对应到正确的用户。
- 应用主页填
https://m.example.com/m/m.html，设置可见范围。员工在企业微信工作台点开「经营数据」即可直接进入。
注意事项
注意：企业微信的可信域名必须是已备案、且备案主体与企业一致（或有关联关系）的域名，IP 地址不行。
注意：平台上调整了权限、可见范围或可用范围后，钉钉和飞书通常需要重新发布版本才会生效。
提示：按手机号对应时，平台通讯录里的手机号应可信；飞书通讯录的手机号由管理员导入，未经本人验证。
提示：订阅推送的内容会经平台离开内网。哪些敏感级别的页面不能订阅，在「订阅与推送」里设置。
常见问题
| 现象 | 原因 | 解决方法 |
|---|---|---|
| 测试连接提示服务器出口 IP 未加入白名单 | 平台开启了 IP 白名单，出口 IP 没登记 | 把提示里的 IP 填到企业微信「企业可信 IP」、钉钉「服务器出口 IP」或飞书「IP 白名单」 |
| 测试连接提示暂时无法连接认证服务 | 服务器访问不了平台接口 | 在「网络与部署」调整「钉钉 / 飞书 / 企业微信接口出站」 |
| 企业微信提示可信域名未配置 | 应用的「网页授权及 JS-SDK」没有设置可信域名 | 按企业微信步骤 2 设置并验证 |
| 企业微信可信域名验证不通过 | 校验文件访问不到 | 确认已上传并保存；用浏览器打开「对外访问地址的域名/文件名」检查 |
| 员工打开应用提示不在可见范围 | 成员不在应用的可见范围或可用范围内 | 在平台后台调整范围并重新发布 |
| 员工打开应用提示账号对应不上 | 平台里的账号、手机号或工号在系统用户里找不到 | 用「试匹配账号」检查，调整「账号对应方式」或补全用户信息 |
| 手机打不开应用页面 | 外网访问不通 | 用「网络与部署」的「手机连通自检」排查 |
