This topic describes how to configure Lightweight Directory Access Protocol (LDAP) so that Drive and Photo Service (Developer Edition) can synchronize organizational structures and users from your LDAP server. After you complete the configuration, users can use their LDAP accounts to log in to Drive and Photo Service (Developer Edition), which enables convenient management of users and teams within the service.
Prerequisites
-
You have the permissions to operate the PDS console. If you log on as a RAM user that has not been granted the relevant permissions (AliyunPDSFullAccess), you need to grant the permissions to the RAM user.
-
A PDS Developer Edition domain is created.
-
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
Step 1: Configure LDAP login
-
Go to the Domains page of Drive and Photo Service (Developer Edition).
-
In the top-left corner, select the region where your domain is located.

-
Find the domain you want to configure for LDAP Logon, and click Details in the Actions column.

-
On the domain details page, select the User Systems tab and click Configure to open the Configure PDS Logon Page panel.
-
Turn on the Enable Logon by LDAP switch and configure the following parameters.
Parameter
Example
Description
Hostname
ldap://120.XX.XX.XXThe address of the LDAP server. The address must start with
ldap://. Supported formats are:-
IP address:
Idap://120.XX.XX.XX -
Domain name:
ldap://www.example.com
Port
389
The default port is 389. If your server uses a different port, enter the new port number.
UID
sAMAccountName
This field specifies the username for login. The value must match the corresponding field in the LDAP Attribute Editor.
Administrator DN
CN=admin,DC=chwl,DC=comThe distinguished name (DN) of an administrator account. This account must have permission to read 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: Obtaining the Administrator DN.
Administrator Password
*****
The password for the administrator account. Drive and Photo Service (Developer Edition) uses this account to connect to your LDAP server to read user information for synchronization and authentication.
BaseDN
DC=chwl,DC=comThe root of the LDAP directory tree where the search for users and groups begins. Only organizational units and users within this scope are synchronized. For instructions on how to obtain the BaseDN in a Windows AD environment, see Appendix 1: Obtaining the BaseDN.
ImportantConfigure this parameter with caution. Do not change the BaseDN after the initial synchronization. If you modify the BaseDN, Drive and Photo Service (Developer Edition) cannot match the directory structure with the LDAP or AD server, causing synchronization to fail.
-
-
Click OK to save the settings.
Step 2: Sign in by using LDAP
You can use the desktop client or a browser to access the URL
https://domainID.apps.aliyunpds.com.ImportantWhen a browser is used, replace domainID with the actual value.
-
On the logon page, click AD/LDAP.

-
Enter your LDAP username and password to sign in.
Step 3: Configure LDAP account synchronization
LDAP account synchronization is disabled by default. To use this feature, contact us to enable it.
-
Sign in to Drive and Photo Service (Developer Edition) with an administrator account and go to the Management Console.
-
In the navigation pane on the left, choose Exclusive Login Configuration > LDAP Configuration.

-
In the Synchronization Configuration section, click Edit.
-
Configure the Login Configuration settings.
-
On the LDAP Configuration page, configure the Login Configuration settings.

The following table describes the parameters.
Parameter
Example
Description
Login Username Field
sAMAccountName
This field serves as the account name for user login. It must be consistent with the field in the LDAP Attribute Editor.
Display Name Field
displayName
This field serves as the display name in the user's network drive. It must be consistent with the field in the LDAP Attribute Editor.
-
Click Next.
-
-
Configure the Synchronization Configuration settings.
-
You can skip this step if you do not need to synchronize users and groups from LDAP. If you only enable LDAP login without configuring synchronization, any user in your LDAP directory can sign in. An account is created automatically upon first login, but the user will not belong to any team.
-
If you enable synchronization, you can import users and organizational structures from your LDAP directory. Follow these steps:
-
On the Synchronization Configuration page, turn on the Synchronization Configuration switch and configure the synchronization information.

The following table describes the parameters.
Note-
To synchronize both LDAP organizations and users, you must configure settings for both teams and users.
-
To synchronize only LDAP organizations, configure only the settings for teams.
-
To synchronize only LDAP users, configure only the settings for users.
Parameter
Example
Description
Team Object Classes
organizationalUnitAn organizational unit (OU) is an AD container for users, groups, computers, and other OUs. It is the smallest scope for assigning group policy settings or delegating administrative permissions. The
groupobject class is not supported.User Object Classes
UserYou can enter
organizationalPerson,inetOrgPerson, orUser.-
organizationalPerson: Provides basic organization-related attributes. -
inetOrgPerson: Inherits all attributes fromorganizationalPersonand adds attributes related to internet communication. -
User: Contains a specific set of attributes that are customized for user accounts in a specific application or organization.
Synchronization Time Setting
Automatic synchronization
Valid values:
-
Manual synchronization: Synchronizes organizations or users to the service manually. If the source data is updated, you must run the synchronization again to apply the changes. For example, if new employees join your organization, their accounts are not created in the service until you perform another manual synchronization.
-
Automatic synchronization: Automatically synchronizes organizations or users to the service based on a specified frequency and time. You can set the frequency to Daily, Weekly, or Monthly, and select any hour of the day for the synchronization time.
-
-
Click Configuration Detection.
-
Click Synchronize Now.
After the synchronization is complete, the Import Result is displayed. If an import fails, the reason is shown in the Import Result section.

After the verification is complete, the Verification Result dialog box appears. The dialog box lists the logon name, display name, and verification result of each account in a table. An account that passes verification shows the status Verification successful, pending import. Verify the information, and then click Confirm Import to import the accounts.
-
Click Confirm Import.
-
In the Last Synchronization Information section, you can view the Last Synchronization Time and Last Synchronization Status. Click Details for more information.

-
-
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.