You can use Identity as a Service (IDaaS) to synchronize data from DingTalk to Secure Access Service Edge (SASE). This allows you to use SASE to manage access permissions for DingTalk users. This topic describes how to synchronize DingTalk data to SASE.
Prerequisites
You have activated Secure Access Service Edge (SASE) and installed the SASE client. For more information, see Apply for a free trial and Set up SASE.
You have activated Identity as a Service (IDaaS). For more information, see Create an instance for free.
Workflow
Before you use SASE, you must synchronize DingTalk data to IDaaS and then connect SASE to IDaaS.
The DingTalk procedures in this topic apply to the new version of the DingTalk console.
Step 1: Create a DingTalk application
To synchronize DingTalk data to SASE, you must create a DingTalk application on the DingTalk Open Platform. This provides an AppKey and an AppSecret, which are required for logon-free authentication.
Log on to the DingTalk Open Platform with an administrator account.
In the top navigation bar, click Application development.
In the left-side navigation pane, click DingTalk application. Then, click Create application.
In the Create application panel, set the parameters as described in the following table.
Parameter
Description
Example
Application name
The name of the application.
The application name can contain only Chinese characters, uppercase letters, lowercase letters, and digits.
Alibaba Cloud SASE
Application description
A description of the application.
Alibaba Cloud SASE
App icon
The icon for the application.
Upload a JPG or PNG image that is 240×240 pixels or larger, has a 1:1 aspect ratio, is smaller than 2 MB in size, and does not have rounded corners.
IconClick Create.
Step 2: Add an authentication source
To enable external authentication for logging on to SASE, you must add and enable an authentication source in IDaaS.
Log on to the IDaaS console with an administrator account. On the tab, click the ID of your instance.
In the left-side navigation pane, choose .
On the Authentication Source page, click Add DingTalk Authentication Source in the upper-right corner.
On the Add Authentication Source page, find DingTalk Mini Program Login and click Add Authentication Source in the Actions column.
In the Add authentication source (DingTalk micro app) panel, set the parameters as described in the following table and then click Submit.
Parameter
Description
Example
Authentication Source Name
The name of the authentication source. Use the default value DingTalk Mini Program Login.
DingTalk micro app
AgentID
Obtain the AgentID from the Credentials and basic information page of your application on the DingTalk Open Platform.
320543****
CorpID
Obtain the CorpID from the homepage of the DingTalk Open Platform.
ding191d0eb30a8aadf2ee0f45d8e4f7****
AppKey
Obtain the AppKey from the Credentials and basic information page of your application on the DingTalk Open Platform.
ding191d0eb30a8aadf2ee0f45d8e4f7****
AppSecret
Obtain the AppSecret from the Credentials and basic information page of your application on the DingTalk Open Platform.
7G2uP_iIvyQ8L4phZ1neu1bKpPQZT4B_s3xFD_EChpxJscqGiOopPIYuWXI5****
After you add the authentication source, return to the Authentication Source page and enable the DingTalk Mini Program Login.
Step 3: Configure and publish DingTalk application
After you add and enable the authentication source, configure and publish the DingTalk application.
Log on to the DingTalk Open Platform with an administrator account.
In the top navigation bar, click Application development.
In the left-side navigation pane, click DingTalk application.
On the DingTalk application page, click the Alibaba Cloud SASE application that you created.
In the left-side navigation pane of the Alibaba Cloud SASE H5 micro app page, choose Development configuration > Security settings.
On the Security settings page, add the server egress IP and in-app logon-free URL.
NoteTo obtain the server egress IP for IDaaS, contact the IDaaS service team.
Obtain the application homepage URL from the Authentication Source Details panel for the target authentication source in the IDaaS console.
Example: https://aliyundoc.com/api/public/bff/v1.2/authenticate/ddMicro/login?agentId={id}&appId={id}, where
agentIdis the AgentID of the DingTalk application andappIdis the appId of the IDaaS (SAML) application. For instructions on creating an IDaaS (SAML) application, see Step 2: Create a SAML application and grant access permissions.
On the Version management and release page, click Confirm release.
Step 4: Synchronize DingTalk data
Log on to the IDaaS console with an administrator account. On the tab, click the ID of your instance.
Synchronize DingTalk data.
In the left-side navigation pane, choose .
On the Organizations and Groups page, click Configure DingTalk Sync.
In the DingTalk Sync Configuration panel that appears on the right, click Create Configuration.
Set the parameters as described in the following table and then click Save.
Parameter
Description
Example
Name
The name of the DingTalk sync configuration. The name can contain Chinese characters, uppercase letters, lowercase letters, and digits.
SASEtest
CorpID
Obtain the CorpID from the homepage of the DingTalk Open Platform.
ding191d0eb30a8aadf2ee0f45d8e4f7****
AppKey
Obtain the AppKey from the Credentials and basic information page of your application on the DingTalk Open Platform.
ding191d0eb30a8aadf2ee0f45d8e4f7****
AppSecret
Obtain the AppSecret from the Credentials and basic information page of your application on the DingTalk Open Platform.
7G2uP_iIvyQ8L4phZ1neu1bKpPQZT4B_s3xFD_EChpxJscqGiOopPIYuWXI5****
Enable
You must enable this feature. Otherwise, DingTalk data cannot be synchronized.
Enabled
Email Field
Specify the email to use as the primary email address.
Personal email
Default Password
The default password for logging on to the IDaaS platform.
ImportantThe password must comply with the current password policy. Otherwise, the DingTalk data synchronization fails.
****
On the Organizations and Groups page, choose .
Select the target DingTalk application and click Import on the right. Then, click Confirm.
Grant users synchronized from DingTalk access to the SAML application.
In the left-side navigation pane, choose .
On the Application Authorization Entity tab, click the application that you created in the Application area on the left. On the Accounts tab on the right, select the synchronized accounts and click OK.
Step 5: Connect SASE and IDaaS
After you synchronize DingTalk data to IDaaS, you must connect SASE and IDaaS. This allows you to use SASE to manage access permissions for DingTalk users. For more information, see Use SASE to ensure secure access for IDaaS (legacy version) users.
After you connect SASE and IDaaS, you can log on to SASE by scanning a DingTalk QR code without entering a username and password.