企业微信

介绍

企业微信插件支持用户使用企业微信账号登录 Data Agent.

Warning

请先确保Data Agent容器应用能ping通企业微信官方服务器，否则会导致登录失败。命令：ping qyapi.weixin.qq.com。如果失败，先联系网络管理员。

激活插件

创建和配置企业微信自建应用

进入企业微信管理后台，创建企业微信自建应用。

点击应用进入详情页，下拉页面，点击「企业微信授权登录」。

设置授权回调域为 Data Agent 应用域名（不带协议头）。

回到应用详情页，点击「网页授权及 JS-SDK」。

在“可作为应用OAuth2.0网页授权功能回调地址”中设置可信域名为 Data Agent 应用域名（同上一步）。然后点击下面的“申请校验域名”。企业微信会要求下载一个txt文件，按网页提示将文件上传到 Data Agent 应用域名的根目录。如果是nginx，需要在nginx配置中添加一个location，将该文件映射到根目录。

# nginx 配置示例
location = /WW_verify_WYLzN4bBLyms97PU.txt {
      alias /etc/nginx/conf.d/WW_verify_WYLzN4bBLyms97PU.txt;
      add_header Content-Type text/plain;
    }

在应用详情页，点击「企业可信 IP」。

配置 Data Agent 应用 IP.

从企业微信管理后台获取密钥

在企业微信管理后台 - 我的企业，复制「企业 ID」.

在企业微信管理后台 - 应用管理，进入上一步创建的应用的详情页，复制 AgentId 和 Secret

在 Data Agent 上添加企业微信认证

进入用户认证插件管理页面。

添加 - 企业微信

配置

配置项	说明
When a phone number does not match an existing user, should a new user be created automatically	当使用手机号匹配不到已有用户时，是否自动创建新用户。
Company ID	企业 ID, 从企业微信管理后台获取。
AgentId	从企业微信管理后台自建应用配置获取。
Secret	从企业微信管理后台自建应用配置获取。
Origin	当前应用域,结尾不能带斜杠。
Workbench application redirect link	成功登录后跳转的应用路径,设置为和Origin相同的路径。结尾不能带斜杠。
Automatic login	在企业微信浏览器里打开应用链接时，自动登录。当配置有多个企业微信认证器的时候，只有一个能开启该选项。
Workbench application homepage link	工作台应用主页链接。

配置企业微信应用首页

进入企业微信管理员后台，将复制的工作台应用主页链接填写到对应应用的应用主页地址栏。

初次登录

从企业微信客户端进入工作台，下拉至底部，点击应用进入前面填写的应用主页，即可完成首次授权登录，之后就可以在 Data Agent 应用内使用企业微信登录。

#企业微信

#介绍

#激活插件

#创建和配置企业微信自建应用

#从企业微信管理后台获取密钥

#在 Data Agent 上添加企业微信认证

#配置

#配置企业微信应用首页

#登录

#初次登录