企业微信认证接入

MrDoc 专业版支持企业微信「企业内部应用」的**扫码登录**接入和**免登配置**。

## 一、创建企业微信应用

登录进入企业微信管理后台，在「应用管理」页面

![](/media/202109/2021-09-23_163858_446982.png)

滚动到页面底部，在「自建」分类下点击「创建应用」：

![](/media/202109/2021-09-23_163953_736840.png)

按照要求填写信息即可：

![](/media/202109/2021-09-23_164025_687267.png)

应用创建后会进入到应用的管理页面：

![](/media/202109/2021-09-23_164224_742444.png)

其中的「AgentId」和「Secret」信息需要复制下来，以备后面配置之用。

## 二、配置企业微信应用

### 可信域名验证

下载域名验证文件后，可以使用 Nginx 进行域名验证配置，或在觅思文档中进行配置，参考文档：[https://doc.mrdoc.pro/doc/3990/#h2-配置文本文件访问](https://doc.mrdoc.pro/doc/3990/#h2-配置文本文件访问)

### 应用主页配置

点击设置「应用主页」：

![](/media/202112/2021-12-25_081219_543010.png)

按照如下URL填入网页地址：

```
https://open.weixin.qq.com/connect/oauth2/authorize?appid={企业ID}&redirect_uri={域名}/oauth/wechatwork_callback/&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
```

![](/media/202112/2021-12-25_081253_823286.png)

例如，企业ID为`123456`，域名为`http://mrdoc.com`，那么应用主页地址为如下所示：

```
https://open.weixin.qq.com/connect/oauth2/authorize?appid=123456&redirect_uri=http://mrdoc.com/oauth/wechatwork_callback/&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
```

### 企业可信IP配置

配置企业可信IP为你的服务器IP地址

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/01/14/2023-01-14_101005_4555290.04902892920743951.png)

### 网页授权及JS-SDK配置

在「网页授权及JS-SDK」中点击「设置可信域名」

![](/media/202112/2021-12-25_080559_623140.png)

填入你的 MrDoc 域名地址：

![](/media/202112/2021-12-25_080622_897697.png)

### 企业微信授权登录配置

页面滚动到底部，在「开发者接口」中对「企业微信授权登录」进行设置：

![](/media/202109/2021-09-23_164415_884069.png)

在设置页面的「Web网页」下点击编辑，输入你的 MrDoc 专业版应用部署的域名或IP地址。

![](/media/202109/2021-09-23_164528_014945.png)

点击保存即可。

## 三、配置MrDoc

以管理员身份登录到 MrDoc 专业版，进入「站点管理」的「第三方登录」页面：

![](/media/202109/2021-09-23_164643_906007.png)

在「企业微信」选项卡中，选择「启用」、将企业微信应用的「AgentId」和「Secret」分别填入到对应表单之中。

至于「企业ID」，需要到企业微信管理后台的「我的企业」页面进行获取：

![](/media/202109/2021-09-23_164828_720968.png)

在企业信息页面滚动到底部，可以看到「企业ID」

![](/media/202109/2021-09-23_164945_292570.png)

将其复制填入到 MrDoc 专业版配置的表单中即可。

最后点击保存，即完成了 MrDoc 专业版企业微信扫码登录的配置。

## 四、扫码登录

开启企业微信扫码登录之后，在 MrDoc 专业版的登录页面，会显示企业微信的图标。

![](/media/202109/2021-09-23_165105_694802.png)

点击企业微信图标，会跳转到企业微信的扫码界面。手机扫码确认登录之后，会通过验证。

## 五、免登

完成上述配置，通过企业微信工作台应用列表中点击创建的应用，就可以免登访问 MrDoc。

## 六、其他配置

### 同步企业微信成员至觅思文档

你可以在「企业微信」认证接入的配置页面内将企业微信的成员批量同步至觅思文档。

目前支持如下三种同步方式：

- 导入企业微信用户为觅思文档用户；
- 导入企业微信用户为觅思文档用户，企业微信用户所属的部门导入为觅思文档用户组，用户添加进用户组；
- 清理觅思文档内的企业微信用户，企业微信中不存在的用户将被置为「禁用」状态；

### 企业微信账号与觅思文档账号绑定
如果直接通过企业微信进行登录，将会在觅思文档账号体系内创建一个新的账号。除此之外，你还可以将企业微信绑定到已存在的觅思文档账号中。

操作方法为：进入个人中心页面，点击「个人管理」菜单的「个人设置」，切换到「第三方账号」，点击「绑定企业微信账号」，进行配置即可。