How to configure custom domain names - Drive and Photo Service

Domain name types

Enterprise domain name

An enterprise domain name is a website address that should be easy to remember and reflects the enterprise identity.

Data access domain name

A data access domain name is used to access file data or used for transcoding and playback.

File transfer

This type of data access domain name is mainly used for transmission of files in the drive and external links. The following figures shows an example domain name used for file uploads and downloads.

Value-added services

This type of data access domain name is mainly used for value-added services such as audio and video transcoding and playback. For example, configure a data access domain name for online video playback and package downloads.

Usage notes

To remove the 500 shares per day limit and download APK/IPA files in external shares, configure both a custom enterprise domain name and a custom data access domain name.
If you encounter any issues during use, contact us.

Prerequisites

CDE is activated and a CDE instance is purchased. For more information, see Activation and purchase.
You have an account assigned as a super administrator or drive administrator in CDE.
You have registered a domain name.
If your service is deployed in a Chinese mainland region, ensure that you have completed ICP filing for the domain name.
A Secure Sockets Layer (SSL) certificate is prepared. If not, purchase one from Alibaba Cloud Certificate Management Service. For more information, see Purchase a commercial certificate and Apply for a certificate.

Important

If the ICP filing is not completed through the Alibaba Cloud ICP Filing system, the ICP filing status may not be found, which may cause the domain name mapping or access to fail.

Procedure

Step 1: Configure DNS records

Obtain DNS record values.

Important
This section provides the steps to obtain DNS record values of different types of domain names.
Enterprise domain name

To obtain the DNS record value of an enterprise domain name:
1. Log on to CDE and go to the admin console.
2. In the left-side navigation pane, choose Enterprise Settings > Standard Customization.
3. Record the Default Domain in the Enterprise Domain section. Example: example.apps.aliyunpds.com.
Data access domain name

To obtain the DNS record value of a data access domain name:
1. Log on to CDE and go to the admin console.
2. In the left-side navigation pane, choose Enterprise Settings > Standard Customization. Click More Configuration. The Data Access Domain Name section appears.
3. Record the Default Domain field in the Data Access Domain Name section.
  Important
  
  Configure two CNAME records for each service type: one to resolve the custom domain name and one to verify domain ownership. For more information, see DNS record configuration example.
  
  www.example.com is an example of a custom data access domain name.
  
  example2.data.aliyunpds.com is an example of a default domain.
  1. Resolve the custom data access domain name:
    
    Hostname: www.example.com
    
    Record value: example2.data.aliyunpds.com
  2. Verify the ownership:
    
    Hostname: _dnsauth.www.example.com
    
    Record value: _dnsauth.www.example.com.example2.data.aliyunpds.com
4. Check the Default Domain fields under File transfer and Value-added service as needed.

Based on the service provider and account that owns the domain name, follow the corresponding steps to resolve the domain name to Drive and Photo Service (PDS).

Resolve a domain name registered with Alibaba Cloud DNS

To map a domain name registered with Alibaba Cloud to PDS:

Log on to the Alibaba Cloud DNS console.
In the left-side navigation pane, choose Public DNS Resolution > Authoritative DNS Resolution. In the authoritative domain name list, find the target domain name and click DNS Settings in the Actions column.
On the page that appears, click Add DNS Record and fill in the information based on the following table.

Parameter	Description	Example
Record Type	Select CNAME.	CNAME
Hostname	Fill in the actual hostname that you want to use to access PDS.	www
DNS Request Source	The DNS line that is used to resolve the domain name. We recommend that you select Default. The system will automatically select the optimal line.	Default
Record Value	Enter the default domain for your enterprise.	example.apps.aliyunpds.com
TTL Period	The update interval of the record. The minimum TTL value is 1 second. Note There is a certain delay before the TTL setting takes effect.	10 minutes

Resolve a domain name not registered with Alibaba Cloud DNS

To map a domain name registered with another DNS provider (not Alibaba Cloud DNS) to PDS:

On the platform of your DNS provider, use the settings shown in the following table to add a CNAME record.

Parameter	Description	Example
Record Type	Select CNAME.	CNAME
Hostname	Fill in the actual hostname that you want to use to access PDS.	www
DNS Request Source	The DNS line that is used to resolve the domain name. We recommend that you select Default. This way, the system will automatically select the optimal line.	Default
Record Value	Enter the default domain for your enterprise.	example.apps.aliyunfile.com
TTL Period	The update interval of the record. The minimum TTL value is 1 second. Note There is a certain delay before the TTL setting takes effect.	10 minutes

Verify whether the DNS record takes effect.

After mapping the custom domain name, use the Alibaba Cloud Network Probing Tool to check the CNAME resolution results.

If the domain name resolution result shows the default enterprise domain, the CNAME record has taken effect.

Step 2: Configure the custom domain name

Important

Before you configure the custom domain name,

Ensure that the DNS record has taken effect.
Download an SSL certificate with the service type set to Other. The certificate includes two files: example.key and example.pem.

Log on to CDE and go to the admin console.
In the left-side navigation pane, choose Enterprise Settings > Standard Customization.

Click Configure Domain Name.

Parameter	Description	Example
Custom Domain	The domain name for which you have configured DNS records.	www.example.com
Certificate Name	The certificate name.	cert_xxxxx
Certificate Content	The entire content in the example.pem file of the SSL certificate. Note If the certificate is issued by an intermediate provider, include both your certificate and the intermediate certificate.	-----BEGIN CERTIFICATE----- example -----END CERTIFICATE-----
Certificate Private Key	The entire content in the example.key file of the SSL certificate.	-----BEGIN RSA PRIVATE KEY----- example -----END RSA PRIVATE KEY-----

Click Set Now to complete the configuration.

Appendix

DNS record configuration example

Note

The following domain names used are examples. Replace them with your actual domain names.

Assume that your domain name is aliyundoc.com.

You want to use the following custom domain name for file transfer: data.aliyundoc.com.
The default domain used for file transfer is 5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com.

Configure a DNS record that is used to resolve the custom data access domain name.

DNS record configuration:

Parameter	Example
Record Type	CNAME
Hostname	data
DNS Request Source	Default
Record Value	`5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com`
TTL Period	10 minutes

Example:

Configure a DNS record that is used to verify the ownership of the domain name.

DNS record configuration:

Parameter	Example
Record Type	CNAME
Hostname	_dnsauth.data
DNS Request Source	Default
Record Value	`_dnsauth.data.aliyundoc.com.5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com`
TTL Period	10 minutes

Example:

FAQ

Can I still use the default domain after mapping?

Yes.

How do I unmap a custom domain name?

To unmap a custom domain name:

Unmap the custom domain name.
1. Log on to CDE and go to the admin console.
2. In the left-side navigation pane, choose Enterprise Settings > Standard Customization.
3. On the Standard Customization page, click Delete Configuration in the Enterprise Domain Name section to delete the custom enterprise domain name.
4. If you configured a custom data access domain name, click More Configuration. In the Data Access Domain Name section, click Delete Configuration.
Delete the DNS records.

After unmapping, manually delete the configured DNS records. For more information, see Delete a DNS record.

What if certificate configuration fails?

If the error occurs when you configure a custom domain name, check whether the certificate is correctly configured or has expired. Take note of the following items:

Certificate content: The entire content that starts with "-----BEGIN CERTIFICATE-----".

Certificate private key: The entire content that starts with "-----BEGIN RSA PRIVATE KEY-----".

Why isn't my custom domain taking effect?

There is a certain delay after you configure DNS records. Wait for about 10 minutes and try again.