tencent cloud

iOA SaaS Integration with DingTalk

Download
Focus Mode
Font Size
Last updated: 2026-09-08 20:19:35
AI-Translated & Reviewed

1. Implementation Results

Note:
To use DingTalk integration on iOS, contact the iOA projecttechnical supportteam. We need to configure the login parameters in the backend and can provide an iOS login Demo.
Type
Select Organization Domain
Login Effect
Browser login effect






Client login effect



2. DingTalk Authentication Preparation

2.1 Configuring a DingTalk Custom App

1. Log in to the DingTalk admin console, and in the left sidebar, click DingTalk Apps.
2. To create a self-built application, go to Application Development > DingTalk Apps > Mini Programs, and click Create Application.



3. In the Create Application window, configure the relevant parameters and click Save to complete the creation.



Parameter Name
Description
Application Name
User-defined. Example: Tencent iOA.
Application description
User-defined description.

2.2 Obtaining the AppKey and AppSecret of the App

1. On the Application Development page, click the self-built application you just created.



2. On the Credentials and Basic Information page, copy the AppKey and AppSecret. The DingTalk Client ID (formerly AppKey and SuiteKey) corresponds to the AppKey on the iOA console, and the DingTalk Client Secret (formerly AppSecret and SuiteSecret) corresponds to the AppSecret on the iOA console. Keep them safe because they will be used in the subsequent iOA console general configuration.




2.3 Obtaining the Callback Domain

1. On the Sharing Settings page, you can add the following iOA gateway callback domain links to the Callback Domain list.
Callback domain: https://scs.gateway.tencent.com/akpage/qrcode/redirect.
Micro-application callback URL: https://scs.gateway.tencent.com/akpage/login.

2. Click Add to add the iOA gateway callback domain to the DingTalk callback domain list.

2.4 Configuring Permission Management

1. On the DingTalk app details page, click Permission Management and select the permissions required by the app, such as:
Call the basic Enterprise API permissions.
Basic permissions required for calling SNS APIs.
Enterprise employee mobile phone number information.
Personal information such as email addresses.
Permission to read contact department information.
Permission to read member information.
Permission to obtain basic member information by mobile phone number.
Permission to read contact department members.
Personal mobile phone number information.
Permission to read personal information in contacts.
2. After selecting the target permission, click Request Permission in the Operation column to grant the required permissions to the application.




2.5 Configuring the Homepage URL

1. On the Application Capabilities > Add Application Capability page, add a web application.



2. Go to the web application page and add the application homepage URL and PC homepage URL.
Format: https://scs.gateway.tencent.com/akpage/login?Tenant-Id=xxx(appid).
Attention:
Replace xxx at the end of the link with appid.



AppID acquisition URL: https://console.tencentcloud.com/developer.




2.6 Enabling DingTalk Mobile App Login (Optional)

1. If the mobile client also needs to use DingTalk for login, configure the DingTalk mobile app login feature.
2. In Development Configuration > Sharing Settings, configure access sharing.
3. Access login has been configured in 2.3 Obtain the Callback Domain.

4. For access sharing, configure the following information:
Parameter Name
Description
iOS sharing
iOS Bundle ID
com.tencent.ioa.saas
Android sharing
Android package name
com.tencent.ioa.saas
Android signature
9e4e6594cd64562c6ae8e3ae0288dd5a
5. After the configuration is completed, click Save.


2.7 App Publishing

1. In Application Release - Version Management and Release, click Create New Version.



Attention:
After any configuration is modified, you must publish a new version for the changes to take effect.
2. The app availability scope must be set to All Employees.




3. Configuring the iOA SaaS Console

3.1 Creating a Directory

1. Log in to the Tencent iOA Zero Trust Management Platform console. In the left sidebar, click Employees and Identity Management > Organizational Structure Management.
2. On the Organizational Structure Management page, click Add New Organizational Structure.

3. On the Import Organizational Structure page, select DingTalk as the import type and click Next.

4. On the Import Organizational Structure page, enter AppKey and AppSecret, and other parameters.

Parameter Name
Description
Type
DingTalk
App Key
App Secret
Automatically update organizational structure
Customize the interval for pulling the latest organizational structure.
Performing a Connectivity Test
After entering the App Key and App Secret, you can perform a connectivity test, which also checks whether the basic configuration is valid.
Client login display
Whether to display the DingTalk organizational structure entry on the iOA client login page.
Enable: The iOA client login page displays the DingTalk login option, allowing users to log in with DingTalk.
Disable: The iOA client login page does not display the DingTalk login option, and users cannot log in with DingTalk.
Synchronize architecture nodes
Supports on-demand synchronization of the organizational structure based on department IDs. Click Add to select the departments to synchronize, and query and expand level by level in real time without synchronizing the entire organizational structure.
Root department ID: If only a specific department is needed, enter the correct department ID. Do not change it unless necessary, because arbitrary changes may cause data exceptions when data is already being synchronized normally.
Department hierarchy completion: Click

to enable this feature. When this feature is enabled, the system automatically completes all parent department hierarchies for the selected department. When this feature is disabled, only synchronized departments are mounted under the root node.
User Attribute Field Mapping
Do not modify unless necessary.
If a field is not mapped, the system-defined status will be used, where 0 indicates an abnormal user status and 1 indicates a normal user status.
Mapping supports three data types, and the value for the normal status must be specified:
1. For Bool and String types, identical values are mapped to status 1, and different values are uniformly mapped to 0.
2. For the Int type, identical values are mapped to status 1, and other values are retained by default.
In attribute mapping, if a mapped field does not exist or you do not want to synchronize the corresponding field, enter any non-existent attribute name, and the corresponding attribute will be set to null during synchronization.
5. Click Test Connectivity. After the test is successful, click completed.




3.2 Configuring an Authentication Source

1. Log in to the Tencent iOA Zero Trust Management Platform console, and in the left sidebar, click Identity Security Management > Authentication Source Configuration.
2. On the authentication source configuration page, click Add Authentication Source Instance.



3. On the Add Authentication Source Instance page, select DingTalk as the type, configure other parameters, and click Save.
Note:
AppKey: The AppKey of DingTalk.
AppSecret: The AppSecret of DingTalk.
CorpId: The CorpId of DingTalk.

How to obtain CorpId: DingTalk Open Platform > Home.

4. After completing the configuration, click Save.

3.3 Setting an Authentication Policy

1. On the Identity Security Management > Authentication Policy page, select the target directory and click Edit.



2. On the Edit Authentication Policy page, you can set the primary and challenge authentication sources for the PC client as needed. Multiple authentication sources can be configured, as shown in the following figure, where the authentication source instance is named "DingTalk Integration Test".
Attention:
If you want to use password-free login for apps within DingTalk, you also need to configure the primary and challenge authentication sources for the mobile client. The configuration method is the same as that for the PC client.



3. Click Add to complete the authentication policy configuration.
 
 
 


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback