All Products
Search
Document Center

Drive and Photo Service:Custom domain name configuration

Last Updated:Apr 19, 2025

After you purchase Alibaba Cloud Drive for Enterprise, the system automatically assigns a dedicated second-level domain name to you. You can configure a custom domain name to access CDE. After configuring a custom domain name, you can increase the daily share creation limit beyond 500 and remove restrictions that prevent users from downloading APK and IPA files from external shares.

Notes

  • To increase the daily share creation and access limit beyond 500 or remove restrictions on downloading APK and IPA files from external shares, you must configure both the Enterprise Domain Name and Data Access Domain Name.

  • If you encounter any issues during use, please contact us.

Prerequisites

Important

If the ICP filing is not completed by using 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.

Scenarios

Enterprise domain name

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

image

Data access domain name

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

File transfer

This domain name is mainly used to access files in the drive and external links for file transfer. For example, it is used for file uploads and downloads.

image

Value-added services

This domain name is mainly used for value-added services such as audio and video transcoding and playback. For example, it is used for online video playback and package downloads.

Procedure

Step 1: Configure DNS records

  1. Obtain DNS record values.

    Important

    This document contains multiple domain name record values. Obtain the values as needed.

    Enterprise domain name

    Perform the following steps to obtain the DNS record value for the enterprise domain name:

    1. Log on to Enterprise File Management to access the Management Console.

    2. In the left navigation bar, select Enterprise Settings > Standard Customization.

    3. Save the Default Domain Name under Enterprise Domain Name. For example: example.apps.aliyunpds.com.

    image

    Data access domain name

    Perform the following steps to obtain the DNS record value for the data access domain name:

    1. Log on to Enterprise File Management to access the Management Console.

    2. In the left navigation bar, select Enterprise Settings > Standard Customization > More Configurations > Data Access Domain Name.

    3. Save the Default Domain Name under Data Access.

      Important
      • You need to configure two CNAME records for each Service Type to set up a custom domain name and verify DNS domain ownership. For more information, see Example of DNS binding for data access domain names.

      • example.example.com is your custom data access domain name.

      • example.data.aliyunpds.com is the Default Domain Name.

      1. Custom data access domain name:

        Record value: example.data.aliyunpds.com.

      2. Verify DNS domain ownership:

        Host record: _dnsauth.example.example.com.

        Record value: _dnsauth.www.example.com.example.data.aliyunpds.com.

    4. Obtain the Default Domain Name for File Transfer or Value-added Services as needed.

      image

  2. Based on the service provider and account that owns the domain name, follow the corresponding steps to resolve the domain name to the PDS service.

    Configure DNS records for Domain Names registered with Alibaba Cloud

    Perform the following steps to map a domain name registered with Alibaba Cloud to PDS:

    1. Log on to the Alibaba Cloud DNS console.

    2. In the authoritative domain name list, click Configure in the Actions column of the target domain name.

    3. Click Add Record and enter the domain name resolution information.

    Parameter

    Description

    Example

    Record Type

    Select CNAME.

    CNAME

    Host Record

    Fill in according to your business needs. This depends on which domain name you want to use to access PDS.

    www

    Line

    The DNS line that is used to resolve the domain name. We recommend that you select Default, and the system will automatically select the optimal line.

    Default

    Value

    Enter the default domain name for your enterprise.

    example.apps.aliyunfile.com

    TTL

    The update cycle of the domain name. The minimum TTL value is 1 second.

    Note

    There is a certain delay before the TTL setting takes effect.

    10 minutes

    Configure DNS records for Domain Names not registered with Alibaba Cloud

    Perform the following steps to map a domain name registered with another domain name service provider to PDS:

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

    Parameter

    Description

    Example

    Record Type

    Select CNAME.

    CNAME

    Host Record

    Fill in according to your business needs. This depends on which domain name you want to use to access PDS.

    www

    Line

    The DNS line that is used to resolve the domain name. We recommend that you select Default, and the system will automatically select the optimal line.

    Default

    Value

    Enter the default domain name for your enterprise.

    example.apps.aliyunfile.com

    TTL

    The update cycle of the domain name. The minimum TTL value is 1 second.

    Note

    There is a certain delay before the TTL setting takes effect.

    10 minutes

  3. Verify whether the DNS records have taken effect.

    After you map the custom domain name, you can use the Alibaba Cloud Network Detection Tool to check the CNAME resolution results.

    If the domain name resolution result shows the public endpoint of your PDS, the CNAME resolution for the custom domain name has taken effect.

Step 2: Configure a custom domain name

Important
  • Before you configure a custom domain name, make sure that the DNS records have taken effect.

  • Before you configure a custom domain name, download an SSL certificate with the service type set to Other. The certificate includes two files: example.key and example.pem.

  1. Log on to Enterprise File Management to access the Management Console.

  2. In the left navigation bar, select Enterprise Settings > Standard Customization.

  3. Click Configure Domain Name.

    Parameter

    Description

    Example

    Custom domain name

    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 of the example.pem file of the SSL certificate.

    Note

    If the certificate is issued by an intermediate provider, the certificate content consists of your downloaded certificate and the certificate issued by the intermediate provider.

    -----BEGIN CERTIFICATE-----

    example

    -----END CERTIFICATE-----

    Certificate private key

    The entire content of the example.key file of the SSL certificate.

    -----BEGIN RSA PRIVATE KEY-----

    example

    -----END RSA PRIVATE KEY-----

    image

  4. Click Configure Now to complete the Custom Domain Name configuration.

Appendix

Example of DNS binding for data access Domain Names

Note

The following domain names are examples. Replace them with your actual domain names when configuring DNS records.

For example, your domain name is: aliyundoc.com.

  • The custom File Transfer domain name you want to use: data.aliyundoc.com.

  • The File Transfer default domain name: 5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com.

  1. Example of a custom data access domain name.

    • DNS record configuration:

      Parameter

      Example

      Record Type

      CNAME

      Host Record

      data

      Line

      Default

      Value

      5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com

      TTL

      10 minutes

    • Example of DNS record configuration:

  2. Example of DNS domain ownership verification.

    • DNS record configuration:

      Parameter

      Example

      Record Type

      CNAME

      Host Record

      _dnsauth.data

      Line

      Default

      Value

      _dnsauth.data.aliyundoc.com.5b3ede2bf7464bcd8a76eed52975****.data.aliyunpds.com

      TTL

      10 minutes

    • Example of DNS record configuration:

      image

FAQ

Can I continue to use the default domain name after mapping a custom domain name?

Yes, you can.

How do I unmap a custom domain name?

If you no longer need to use a custom domain name, you can perform the following steps to unmap it:

  1. Unmap the custom domain name.

    1. Log on to Enterprise File Management to access the Management Console.

    2. In the left navigation bar, select Enterprise Settings > Standard Customization.

    3. On the Standard Customization page, click Delete Configuration under Enterprise Domain Name to delete the Enterprise Domain Name.

    4. If you have configured a Data Access Domain Name, select More Configurations -> Delete Configuration on the current page to delete the Data Access domain name.

  2. Delete DNS records related to the custom domain name.

    After you unmap the custom domain name, you need to manually delete the CNAME records that you configured. For more information, see Delete records.

Error message "Failed to add certificate. Please try again" when configuring a domain name

If an error occurs when you configure a domain name: Failed to add the certificate. Please add it again.

If you receive the error message "Failed to add certificate. Please try again" when configuring a domain name, check whether the certificate is configured correctly or has expired.

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

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

The custom domain name does not take effect after mapping

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