钉钉扫码登录和钉钉内免登配置

MrDoc 专业版支持钉钉「企业内部应用」的扫码登录接入。

## 零、获取CorpId

在「钉钉开放平台」的开发者后台中，可以看到自己企业的CorpId，如下图所示：

![](/media/202604/4c32ca73e99d48acad0c3b1ce02c6c697207.png)

## 一、创建钉钉应用

在钉钉开发平台中点击「应用开发」，选择「企业内部开发」：

![](/media/202604/4a1ced37ddea41acbed31235b008f9fb1354.png)

进入到企业内部开发的页面，按照下图所示，点击「创建应用」：

![](/media/202604/479595858d244c53a09b8871cf3273486075.png)

选择「H5微应用」，按要求填写好应用信息：

![](/media/202604/a522fedec7cf45be8fcd4bff7756d0602494.png)

创建好之后会进入到应用的基本信息页面，如下图所示：

![](/media/202604/8494e49e13d24b329e2999e74e1eeb698271.png)

页面中的「应用凭证」中的「AppKey」和「AppSecret」需要复制下来，后面我们将使用到。

## 二、配置钉钉应用

正如钉钉开发平台所说：在开发前，需要在开发者后台配置服务器出口IP、应用首页等。

新创建的钉钉应用，还需要在「开发管理」页面中对服务器出口IP、应用首页等信息进行配置。

![](/media/202604/f0d3c793393f44a5a3237c2ed6a3a37b7817.png)

>d 服务器出口IP必须配置成 MrDoc 专业版部署的服务器的IP。

>d 应用首页即是你部署的 MrDoc 的首页URL。

## 三、配置回调URL

在「钉钉登录与分享」页面，输入`你的域名或IP/oauth/dingtalk_callback/`，例如：

```
https://doc.mrdoc.pro/oauth/dingtalk_callback/
```

![](/media/202604/443a331056394d8b9d990f524f60e1ac5088.png)

## 四、开通钉钉应用权限

因为 MrDoc 专业版对接钉钉的扫码登录需要读取到钉钉用户的一些信息以完成用户的认证、鉴权和登录，所以还需要为创建的钉钉应用赋予一些权限。

点击左侧「权限管理」菜单，进入到「权限管理」页面：

![](/media/202604/88bb34fb0df5441cacde540636d71fea5544.png)

开通以下三个权限：

- 成员信息读取权限；
- 调用OpenApp专有API时需要具备的权限；
- 调用企业API基础权限（默认开通）；

![](/media/202604/de4174dc8a434337925c6c80bc7e46f77525.png)

## 五、配置MrDoc

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

![](/media/202604/c2437d98fe454baa96fce2a3efe1f79d5490.png)
在「钉钉」选项卡中，选择「启用」、将钉钉应用的「AppKey」、「AppSecret」和「corpId」分别填入到对应表单之中。

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

## 六、登录

### 6.1、扫码登录

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

![](/media/202604/4296f593e807401fabca21714d18af226248.png)

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

### 6.2、钉钉内免登

如果你通过钉钉PC端或移动端的工作台访问创建刚刚创建的应用，那么会实现免登认证MrDoc：

![](/media/202604/b651e3a315bf4a70a5740cb28a30c16f9675.png)