DingTalk Login

MrDoc Professional supports DingTalk "Internal Enterprise Application" scan code login integration.

## 0. Obtain CorpId

In the developer backend of the "DingTalk Open Platform," you can find your enterprise's CorpId, as shown in the figure below:

![](/media/202511/b9bad5cf70244baf9f6d549dea0b91f91804.png)

## 1. Create a DingTalk Application

In the DingTalk development platform, click "Application Development" and select "Internal Enterprise Development":

![](/media/202511/114ce84e21974f1a9afae622d07aebbe3285.png)

Navigate to the internal enterprise development page and click "Create Application" as shown below:

![](/media/202511/5a2762a55a50436180b0c218322bc94d4718.png)

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

![](/media/202511/b7844b48cf5b468da52988a1d1c935921962.png)

After creation, you will be directed to the application's basic information page, as shown below:

![](/media/202511/c72cb367d8514514b29ecd2905f0f0587029.png)

The "AppKey" and "AppSecret" under "Application Credentials" on this page need to be copied for later use.

## 2. Configure the DingTalk Application

As stated by the DingTalk development platform: Before development, you need to configure the server exit IP, application homepage, etc., in the developer backend.

For newly created DingTalk applications, you must configure the server exit IP, application homepage, and other information on the "Development Management" page.

![](/media/202511/23ebf23e6604478195424061b55579c45620.png)

> The server exit IP must be configured as the IP of the server where MrDoc Professional is deployed.

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

## 3. Configure Callback URL

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

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

![](/media/202511/e2eab98e34454bb5a871d72526af28478144.png)

## 4. Enable DingTalk Application Permissions

Since MrDoc Professional's integration with DingTalk scan code login requires reading certain user information to complete user authentication, authorization, and login, you need to assign specific permissions to the created DingTalk application.

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

![](/media/202511/0b87b876a7ee41e4bfe5ca51ad494e621180.png)

Enable the following three permissions:

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

![](/media/202511/cfc8cb8f245c427baa8982cc425afbff5883.png)

## 5. Configure MrDoc

Log in to MrDoc Professional as an administrator and navigate to the "Third-Party Login" page under "Site Management":

![](/media/202511/07756c1ae94444238b3cb57af4c3099c9122.png)

In the "DingTalk" tab, select "Enable," and fill in the "AppKey," "AppSecret," and "corpId" of the DingTalk application into the corresponding form fields.

Finally, click "Save" to complete the configuration of DingTalk scan code login for MrDoc Professional.

## 6. Login

### 6.1. Scan Code Login

After enabling DingTalk scan code login, the DingTalk icon will appear on the login page of MrDoc Professional.

![](/media/202511/2068da88825d4569ba479ddc281e82ab1064.png)

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

### 6.2. Seamless Login Within DingTalk

If you access the newly created application through the DingTalk PC or mobile workbench, seamless authentication with MrDoc will be achieved:

![](/media/202511/d3843475216746f3b732ad1040b5e4354400.png)