Connect SASE (Secure Access Service Edge) to Identity as a Service (IDaaS) so that your enterprise users can sign in to the SASE client directly with their IDaaS accounts. You can then manage user access permissions on the SASE console and secure your corporate data.
Use cases
SASE helps you manage intranet and internet access permissions for your employees, protect corporate data, and meet daily office security requirements. If you already use Alibaba Cloud Identity as a Service (IDaaS) to manage user information, you can connect SASE to IDaaS. This allows users to sign in to the SASE client directly with their IDaaS accounts, eliminating the need to maintain a separate identity management system for SASE and reducing your user information maintenance costs.
Prerequisites
-
SASE is activated, and the SASE client is installed.
-
Alibaba Cloud Identity as a Service (IDaaS) is activated.
Procedure
Step 1: Obtain the SP Entity ID and SP ACS URL
Before you connect SASE to IDaaS, you need to obtain the SP Entity ID and SP ACS URL to create a SAML application. You can obtain the SP Entity ID and SP ACS URL in two ways.
-
The SP Entity ID and SP ACS URL are fixed values. You can use the following values:
-
SP Entity ID: https://saml-csas.aliyuncs.com/saml/metadata
-
SP ACS URL: https://saml-csas.aliyuncs.com/saml/acs
-
-
You can obtain the values from the SASE console.
-
Log on to the SASE console.
-
In the left-side navigation pane, choose .
-
On the Identity synchronization tab, click Create IdP.
-
In the Create IdP panel, select IDaaS and click Configure.
-
In the Basic Configurations step, select Old Version for IDaaS Version to obtain the SP Entity ID and SP ACS URL information.
-
Step 2: Create a SAML application and grant permissions
Create a SAML application to allow SASE and IDaaS to exchange authentication and authorization data across security domains.
-
Activate an Alibaba Cloud Enterprise Identity Access Management (EIAM) instance. For more information, see Activate an EIAM instance for free.
-
Create a SAML application and grant access permissions.
-
Log on to the Alibaba Cloud Identity as a Service (IDaaS) console as an administrator. In the left-side navigation pane, click Alibaba Cloud Enterprise Identity Access Management (EIAM).
-
On the Old Version tab of the Alibaba Cloud Enterprise Identity Access Management (EIAM) page, find the EIAM instance that you activated and click Manage in the Operation column.
-
In the left-side navigation pane, choose .
-
Find the SAML application template and click Add Application in the Operation column.
You can enter SAML in the search box to quickly find the SAML application template.
-
In the Add Application (SAML) panel, click Add SigningKey. In the Add SigningKey panel, configure the settings to create a signing key. Then, click Submit.
-
In the Add Application (SAML) panel, find the SAML application that you added and click Select in the Operation column. Configure the following key parameters. After completing the configuration, click Submit.
Parameter
Description
Example value
Application Name
The name of the application.
SAML_test123
IDaaS IdentityId
The authentication parameter for the IdP. You must specify a custom value.
test
SP Entity ID
This value is fixed.
https://saml-csas.aliyuncs.com/saml/metadata
SP ACS URL (SSO Location)
This value is fixed.
https://saml-csas.aliyuncs.com/saml/acs
NameIdFormat
The format of the name identifier (NameID).
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
Binding
The method the IdP uses to call the ACS URL provided by the SP. Keep the default value POST.
POST
Assertion attribute
The assertion attributes. After configuration, the values are included in the SAML assertion. The name is a custom value, and the value corresponds to an account attribute. You must configure the following assertion attributes:
-
Account Name
-
Email
-
Mobile Phone Number
NoteThe assertion attributes must be consistent with the default fields of the Attribute Configuration for a single IdP of the IDaaS type in the IdP Management section of SASE.
-
Account Name: username
-
Email: email
-
Mobile Phone Number: telephone
Account linking type
-
account association: The system requires manual association based on the relationship between a primary account and a sub-account. After a user is added, an administrator must approve the association.
-
account mapping: The system automatically maps the primary account name or a specified field to the application's sub-account.
account mapping
-
-
After the application is added, click Authorize Immediately in the dialog box that appears.
-
On the Application Authorization page, click the Application authorization subject tab. Select the SAML application that you created (SAML_test123) and grant permissions to accounts. Then, click Save.
-
Step 3: Obtain metadata and API information
Obtain the metadata file and API information that you need to create an IDaaS IdP.
-
Log on to the Alibaba Cloud Identity as a Service (IDaaS) console as an administrator. In the left-side navigation pane, click Alibaba Cloud Enterprise Identity Access Management (EIAM).
-
On the Old Version tab of the Alibaba Cloud Enterprise Identity Access Management (EIAM) page, find the EIAM instance that you activated and click Manage in the Operation column.
-
In the left-side navigation pane, choose . On the Applications page, find the SAML application that you created (SAML_test123) and click Details in the Operation column.
-
In the Application Information section, click View Details.
-
In the Application Details (SAML) panel that appears on the right, click Export IDaaS SAML Metadata File.
-
On the Applications page, find the API section. Turn on the API switch and save the API Key and API Secret to your computer.
Step 4: Establish a connection between SASE and IDaaS
Create an IDaaS IdP configuration to connect SASE to IDaaS.
-
Log on to the SASE console.
-
In the left-side navigation pane, choose .
-
On the Identity synchronization tab, click Create IdP.
-
In the Create IdP panel, select IDaaS and click Configure.
-
In the Basic Configurations step, configure the following parameters. Then, click OK.
Parameter
Description
Example value
IdP Name
The name of the IDaaS configuration.
The name must be 2 to 100 characters in length and can contain Chinese characters, letters, digits, hyphens (-), and underscores (_).
test123
Description
The description of the configuration.
This description appears as the sign-in title on the SASE client, helping users identify the IdP when they sign in.
IDaaS sign-in
IdP Status
Configure the status for the identity source. The valid values are:
Enabled: The identity source is enabled after it is created.
Closed: The identity source is disabled after it is created.
ImportantIf you disable an identity source, end users cannot use the SASE app to access internal applications. Proceed with caution.
Enabled
IDaaS Version
Select the version of IDaaS.
Legacy Version
Configuration Name
A custom name for the configuration. The name must be 2 to 100 characters in length and can contain Chinese characters, letters, digits, underscores (_), and hyphens (-).
test123
SAML Metadata File
For information about how to obtain this file, see Step 3: Obtain metadata and API information.
-
Grant Read Permissions on Organizational Structure
Select whether to grant permissions to read the organizational structure. Valid values:
-
Yes: Enter the IDaaS API information to obtain the enterprise directory structure. You must set API Key and API Secret and configure automatic synchronization.
NoteAfter configuration, you can apply security policies in bulk based on the directory list. The system does not read your employee information when applying security policies.
-
Automatic Synchronization: After you enable the Automatic Synchronization switch, the system automatically synchronizes relevant information from IDaaS based on the synchronization mode.
If you do not enable Automatic Synchronization, you must manually synchronize the organizational structure. For more information, see View synchronization records.
-
Synchronize User Information: After you turn on the Synchronize User Information switch, the system automatically synchronizes employee information from WeChat Work based on the Automatic Synchronization Cycle.
NoteIf Automatic Synchronization is disabled, the Synchronize User Information function will not run.
-
Automatic Synchronization Cycle: Set the Automatic Synchronization Cycle. You can set the cycle to an interval of 1 to 24 hours.
-
-
No: Does not grant permissions to read the organizational structure.
For information about how to obtain the API Key and API Secret, see Step 3: Obtain metadata and API information.
-
API Key: dingwjlht8b93ara****
-
API Secret: 1Uji1mEjhmWq_SmE0KNScspYk0bBgDrlZ95vUTR-bn4FbfeVQQKNr1_1giWA****
-
If you selected No for Grant Read Permissions on Organizational Structure, click Ok to complete the configuration.
If you selected Yes, you can click Connectivity Test. After the test succeeds, click Ok to complete the configuration.
Step 5: Verify the connection
-
Open the SASE client that you installed.
Enter the enterprise verification ID and click OK.
You can log on to the Secure Access Service Edge console. In the navigation pane on the left, on the Settings page, obtain the Enterprise Authentication Identifier.
-
Optional: You can also sign in by scanning a QR code with the mobile app.
-
Sign in with your IDaaS username and password.
A successful sign-in confirms that SASE and IDaaS are connected.