This topic describes how to configure the Lightweight Directory Access Protocol (LDAP) so that Alibaba Cloud Disk Enterprise Edition can synchronize the organizational structure and users from your LDAP directory. After you complete the configuration, users can log on directly to Alibaba Cloud Disk Enterprise Edition with their LDAP accounts, simplifying user and team management.
Notes
Only a super administrator or drive administrator can enable this feature.
Prerequisites
-
CDE is activated and a CDE instance is purchased. For more information, see Activate and purchase CDE.
-
You have an LDAP server. To integrate with it, you must provide the server address, port number, and BaseDN.
-
The LDAP server must be accessible over the internet.
Procedure
If you encounter any issues during use, contact us.
Step 1: Enable and configure LDAP
-
Enable the LDAP configuration.
-
Log on to CDE and go to the admin console.
-
In the left-side navigation pane, choose exclusive logon configuration > LDAP configuration, and then turn on the LDAP configuration switch.
-
-
Configure the server connection information.
-
On the LDAP configuration page, configure the Server connection information.
The following table describes the parameters.
Parameter
Example value
Description
server address
ldap://120.XX.XX.XXThe LDAP server address. The address must start with
ldap://. Valid formats include:-
IP address:
ldap://120.XX.XX.XX -
Domain name:
ldap://www.example.com
port number
389
The default port number is 389. If you use a custom port, enter the modified port number.
BaseDN
DC=chwl,DC=comSpecifies the scope for synchronization. You can only sync organizational units and users within this base distinguished name (DN) to Alibaba Cloud Disk Enterprise Edition. For instructions on how to obtain the BaseDN in a Windows AD environment, see Appendix: Obtain server connection information in a Windows environment.
ImportantEnter this value carefully and do not change it after the initial setup. If you modify the BaseDN after syncing data between Alibaba Cloud Disk Enterprise Edition and your LDAP or AD server, the directory paths may no longer match, causing synchronization to fail.
administrator DN
CN=admin,DC=chwl,DC=comEnter the full distinguished name (DN) of the administrator account. This account must have permissions to access all organizational units and users under the specified BaseDN. For instructions on how to obtain the administrator DN in a Windows AD environment, see Appendix 2: Obtain the administrator DN.
Password
*****
Enter the password for the administrator account in your LDAP system. The Alibaba Cloud Disk Enterprise Edition server uses this account to log on to your LDAP system to synchronize and authenticate users.
Type
Windows AD
Select the type of your directory server. Options are Windows AD, OpenLDAP, and Other. The Other option refers to any server that uses the LDAP protocol.
-
-
Click Test Connection. A Connection Successful message appears.
If the test fails, check your parameter configuration and ensure no firewall is blocking the server address and port.
-
Click Next.
-
-
Configure logon information.
-
On the LDAP configuration page, configure the logon information.
The following table describes the parameters.
Parameter
Example value
Description
logon username field
sAMAccountName
The attribute used as the logon username. This must match the corresponding attribute in the LDAP attribute editor.
display name field
displayName
The attribute used as the user's display name in the cloud disk. This must match the corresponding attribute in the LDAP attribute editor.
-
Click Next.
-
-
(Optional) Configure synchronization options.
-
If you do not need to enable LDAP synchronization, skip this step. If you enable only LDAP logon without synchronization, any LDAP user in your organization can log on to Alibaba Cloud Disk Enterprise Edition. The system automatically creates an account for them upon their first logon, but no organizational structure is imported.
-
If you enable synchronization, you can import users and the organizational structure from your LDAP server. Follow these steps:
-
On the synchronization configuration page, turn on the synchronization configuration switch and configure the settings.
The following table describes the parameters.
Note-
To sync both LDAP organizations and users, you must configure settings for both teams and users.
-
To sync only LDAP organizations, configure the settings for teams.
-
To sync only LDAP users, configure the settings for users.
Parameter
Example value
Description
team object classes
organizationalUnitAn Organizational Unit (OU) is an AD container for users, groups, computers, and other OUs. It is the smallest scope to which you can assign Group Policy settings or delegate administrative authority. The
groupobject class is not supported.user object classes
UserYou can enter
organizationalPerson,inetOrgPerson, orUser.-
organizationalPersonprovides basic organization-related attributes. -
inetOrgPersonprovides all attributes oforganizationalPersonand adds attributes for internet communication. -
Usercontains a specific set of attributes customized for user accounts in a particular application or organization.
Synchronization time settings
Automatic Synchronization
Specifies how to synchronize data. Valid values:
-
Manual synchronization: Manually syncs organizations or users to the cloud disk. If the source data is updated after a manual sync, the cloud disk does not automatically reflect the changes. You must run the synchronization again. For example, if new employees are added to your directory, they cannot log on to the cloud disk until you perform another manual sync.
-
Automatic synchronization: Syncs organizations or users to the cloud disk at a scheduled frequency and time. You can set the frequency to daily, weekly, or monthly, and select any hour of the day for the synchronization to occur.
-
-
After the synchronization is complete, the Import results appear. If an import fails, the reason is shown in the Import results.
In the Validation results dialog box, review the logon names, display names, and validation status of the users to be imported. After you confirm that all records show Validation successful, pending import, click Confirm import to import the users.
-
In the last synchronization information section, you can view the Last synchronization time and Last synchronization status. Click Details on the right to view details about the last synchronization.
-
-
Step 2: Log on using LDAP
-
On the enterprise exclusive logon page, click AD/LDAP.
-
You can now log on to Alibaba Cloud Disk Enterprise Edition with your LDAP username and password.
Appendix: Server connection information in Windows
Appendix 1: BaseDN
-
On your LDAP domain controller, open Active Directory Users and Computers.
-
Locate the root directory that you want to sync, for example,
chwl. You need to sync all organizational units and users under this directory to Alibaba Cloud Disk Enterprise Edition. -
Right-click the
chwldirectory, select Properties, and go to the attribute editor tab. -
Find the
distinguishedNameattribute. Double-click it to open the String attribute editor, and then copy the value, for example,DC=chwl,DC=com.In the properties dialog box, click the attribute editor tab.
Appendix 2: Administrator DN
-
On the LDAP domain controller, open Active Directory Users and Computers.
-
Find the administrator account that has permissions to access all organizational units and users under the BaseDN. Right-click the account, select Properties, and go to the attribute editor tab.
-
Find the
distinguishedNameattribute. Double-click the attribute to open the String attribute editor, and then copy the Value. For example,CN=admin,DC=chwl,DC=com.