DingTalk QR code login and in-app passwordless login configuration

# DingTalk QR Code Login and DingTalk In-App Auto-Login Configuration

MrDoc Pro edition supports DingTalk "Enterprise Internal Application" QR code login integration.

## 0. Obtain CorpId

In the developer console of the "DingTalk Open Platform", you can see your enterprise's CorpId, as shown in the following figure:

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

## 1. Create a DingTalk Application

In the DingTalk Open Platform, click "Application Development" and select "Enterprise Internal Development":

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

Enter the enterprise internal development page, and as shown in the following figure, click "Create Application":

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

Select "H5 Micro Application" and fill in the application information as required:

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

After creation, you will enter the application's basic information page, as shown in the following figure:

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

The "AppKey" and "AppSecret" in the "Application Credentials" section of the page need to be copied down, as we will use them later.

## 2. Configure the DingTalk Application

As stated by the DingTalk Open Platform: before development, you need to configure the server egress IP, application homepage, etc. in the developer console.

For a newly created DingTalk application, you also need to configure the server egress IP, application homepage, and other information on the "Development Management" page.

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

>d The server egress IP must be configured as the IP of the server where MrDoc Pro edition is deployed.

>d The application homepage is the homepage URL of your deployed MrDoc.

## 3. Configure the Callback URL

On the "DingTalk Login and Sharing" page, enter `your domain or IP/oauth/dingtalk_callback/`, for example:

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

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

## 4. Enable DingTalk Application Permissions

Because the DingTalk QR code login integration of MrDoc Pro edition needs to read some information of DingTalk users to complete user authentication, authorization, and login, you also need to grant some permissions to the created DingTalk application.

Click the "Permission Management" menu on the left to enter the "Permission Management" page:

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

Enable the following three permissions:

- Member information read permission;
- Permission required for calling OpenApp proprietary APIs;
- Basic permission for calling enterprise APIs (enabled by default);

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

## 5. Configure MrDoc

Log in to MrDoc Pro edition as an administrator, and enter the "Third-Party Login" page under "Site Management":

![](/media/202202/2022-02-09_084051_293536.png)
In the "DingTalk" tab, select "Enable", and fill in the DingTalk application's "AppKey", "AppSecret", and "corpId" into the corresponding forms respectively.

Finally, click Save to complete the DingTalk QR code login configuration for MrDoc Pro edition.

## 6. Login

### 6.1 QR Code Login

After enabling DingTalk QR code login, the DingTalk icon will be displayed on the login page of MrDoc Pro edition.

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

Clicking the DingTalk icon will redirect to the DingTalk QR code scanning interface. After confirming the login by scanning the QR code with your phone, verification will be completed.

### 6.2 DingTalk In-App Auto-Login

If you access the application you just created through the workbench of the DingTalk PC client or mobile client, auto-login authentication to MrDoc will be achieved:

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