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. |
Browser login effect | | |
Client login effect | | |
2. DingTalk Authentication Preparation
2.1 Configuring a DingTalk Custom App
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.
|
Application Name | User-defined. Example: Tencent iOA. |
Application description | User-defined description. |
2.2 Obtaining the AppKey and AppSecret of the App
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.
4. For access sharing, configure the following information:
|
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
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.
|
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
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. CorpId: The CorpId of DingTalk. 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.