DocumentationAEM as a Cloud ServiceUser Guide

About add a domain mapping add-domain-mapping

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Applies to:
  • Experience Manager as a Cloud Service

CREATED FOR:

  • Admin
  • Developer

To link a domain with an SSL certificate on the Adobe-managed CDN within your program, you must add a CDN (Content Delivery Network) configuration.

For Adobe managed CDNs, when using a DV SSL certificate, only sites with ACME validation are permitted.

IMPORTANT
Have you added a custom domain name and added an SSL certificate, respectively? If not, you must complete these two tasks before you can add a CDN configuration.

See also Adobe Managed CDN.

To add a domain mapping:

  1. Log into Cloud Manager at my.cloudmanager.adobe.com and select the appropriate organization.

  2. Depending on your use case, do one of the following:

    table 0-row-2 1-row-2 2-row-2
    Use case Steps
    I want to add a CDN configuration to an existing Edge Delivery site in Cloud Manager a. In the left side menu, under Services, click Webpages icon Edge Delivery Sites.
    b. In the Edge Delivery table, at the end of a row that does not have a domain associated with it, click More icon .
    c. Click Configure CDN.
    I want to add a CDN configuration in Cloud Manager a. In the left side menu, under Services, click Social network icon Domain Mappings.
    b. Near the upper-right corner of the Domain Mappings page, click Add.

  3. In the Map Domain to CDN dialog box, select one of the following CDN types:

    • Adobe Managed CDN (Recommended) - An Adobe managed CDN is used for this configuration. It includes automated setup and management, and built-in security features.
    • Other CDN provider - A self-managed CDN provider network is used for this configuration.

  4. Based on the selected CDN type in the previous step, do the following:

    • Adobe Managed CDN

      Map Domain to CDN dialog box with Adobe managed CDN radio button selected

      1. In the Origin drop-down list, select one of the following:

        table 0-row-2 1-row-2 2-row-2
        Origin drop-down list Description
        Sites Select an Edge Delivery site.
        Environment Select a specific Cloud Service environment that you want to target within your AEM setup.
        In the Tier drop-down list, select one of the following:
        • Select Publish to target a live, production environment where content is delivered to end users.
        • Select Preview for staging or non-production environments where you test changes before they go live.

      2. In the Domain drop-down list, select the domain name that you want to use.
        No verified domains available in the drop-down list? See Add a custom domain name.

      3. In the SSL certificate drop-down list, select a certificate that you want to use.
        No SSL certificates available in the drop-down list? See Add an SSL certificate.

      4. Click Save.

    • Other CDN provider

      Map Domain to CDN dialog box with Adobe managed CDN radio button selected

      Use the listed configuration steps to apply the required settings in your CDN and confirm the mapping. See also Add a custom domain name.

      1. Click I’ve Configured My CDN.

  5. Adobe recommends that you test the domain mapping.

Test the domain mapping test-domain-mapping

You can verify that a new domain mapping is live on the Adobe-managed CDN without waiting for public DNS propagation.

Run a curl command that overrides DNS resolution and points straight to the CDN edge:

curl -svo /dev/null https://www.example.com \
--resolve www.example.com:443:151.101.3.10
  • Replace www.example.com with your domain.
  • The IP address 151.101.3.10 is one of the IPs that can be used to access AEM Cloud Service. See also APEX record.

The --resolve flag forces the request to the specified IP and returns success only after the certificate and routing for your domain have been installed correctly.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab