> For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/v4/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/v4/llms-full.txt.

# Integrate DingTalk authentication 
## About DingTalk

**DingTalk** authentication is an identity verification method based on DingTalk, supporting OAuth 2.0 authorization, QR code login, and enterprise identity binding, enabling secure and convenient enterprise user login and management.

## How to configure


1

In the right area of the top navigation bar, click .

![image](/docs/images/docs/navs/nav-settings.png)

2

Navigate to the **System settings > Authentication > DingTalk**.

3

In the **DingTalk** field, check to enable DingTalk authentication.

4

In the **Agent ID** field, type the DingTalk agent ID, which uniquely identifies a micro-application within the enterprise and is primarily used for sending work notifications.

5

In the **App key** field, type the DingTalk app key, a unique identifier for the application, similar to a username for API access.

6

In the **App secret** field, type the DingTalk app secret, similar to a password for API access, used to obtain AccessToken for calling APIs.

7

In the **User attribute** field, type the user attribute mapping. The key represents the JumpServer user attribute name (available options: name, username, email, phone, comment), while the value corresponds to the DingTalk user attribute name.
```json title="DingTalk User Attribute Example"
{
  "name": "name",
  "username": "name",
  "email": "email"
}
```

8

In the **Organization** field, after authentication and creation, the user will be added to the selected organization.

9

Click **Submit**.

## Test DingTalk connection


1

In the right area of the top navigation bar, click .

![image](/docs/images/docs/navs/nav-settings.png)

2

Navigate to the **System settings > Authentication > DingTalk**.

3

Scroll to the bottom of the page

4

Click **Test**.

## JumpServer DingTalk URLs

```md title="QR Login URL"
https://jumpserver.example.com/core/auth/dingtalk/qr/login/
```

```md title="QR Login Success Callback URL"
https://jumpserver.example.com/core/auth/dingtalk/qr/login/callback/
```

```md title="OAuth Login URL"
https://jumpserver.example.com/core/auth/dingtalk/oauth/login/
```

```md title="OAuth Login Success Callback URL"
https://jumpserver.example.com/core/auth/dingtalk/oauth/login/callback/
```