1. Create a domain
Click the Create Domain button.
In the Create Domain panel, enter a name (for example, "Distribution Cloud Drive"), select standard mode for the data storage method, enable the User personal space toggle, select Custom size for the default personal space size and set it to 1 GB, and then click Confirm.
Assume that you have created a domain with the domain ID bj001.
After you create the domain, click its name in the domain list. On the basic information tab, note the value of the ID field. This is the domain ID.
2. Create an OAuth application
(1) Create an OAuth application
On the OAuth applications page, click Create Application. In the panel on the right, enter the Application name and Display name. Set the Access token validity period to 3600 seconds and the Refresh token validity period to 2592000 seconds, and then click Save.
-
For Application type, select WebApp.
-
Use the following callback URL:
https://{domainId}.api.aliyunpds.com/v2/oauth/callback
For domains created before March 2, 2023, the callback URL format is https://{domainId}.auth.aliyunpds.com/v2/oauth/callback.
(2) Configure permissions for the application
On the Application OAuth scope tab, confirm that the application includes the following default authorized OAuth scopes: openid (retrieves the logged-in user's basic information; this is a default, non-removable scope), aliuid (the unique user identifier from Alibaba Cloud), and profile (the user's name and other profile information). Ensure the status for all three is Default authorization.
(3) Create an application secret
-
Important: The secret is displayed only once. Be sure to save it.
After the secret is created, the page displays the application ID and application secret. Copy and save them immediately.
Important: You need the application ID and application secret, not an AppSecretId and its corresponding secret.
3. Configure the domain's access method
Configure the domain properties with the application ID and application secret from the application you created in the RAM console.
Enable the Enable RAM sub-account logon option, and then enter values in OAuth2.0 client ID and Secret.
4. Enable the official BasicUI app
On the details page for the target domain, select the Application list tab. In the Official application list, find the BasicUI application and click Allow access in the Actions column.
When you enable BasicUI for the first time, you must log in as a super administrator to synchronize data.
On the Domain list page, click a domain's name to open its details page. Select the Application list tab. In the Official application list, find the BasicUI application and click Enter management in the Actions column.
5. Example
(1) Open the URL
Open the URL for the official BasicUI app: http://bj001.apps.aliyunpds.com.
Opening the URL redirects you to the Distribution Cloud Drive login page. Click the General login button.
(2) Select the logon method
At the bottom of the login page, in the Other logon methods section, click RAM logon.
(3) Redirect to the RAM user login page
The username format is <username>@<default_domain> or <username>@<account_alias>, for example, username@company.onaliyun.com.
-
Enter the RAM username and password to access the application.
-
You can create a RAM user and password in the RAM console: https://ram.console.alibabacloud.com
On the Create user page, set the Logon name and Display name to user1. For access mode, select Console access and choose Custom password to set a login password.
(4) Automatic redirection to BasicUI
After you log in, you land on the My Space page of Distribution Cloud Drive. The left navigation pane includes My Space, My Favorites, My Shares, and Recycle Bin. By default, the main content area shows a folder named Default.