Information for: DEVELOPERS   PARTNERS

Configuring Acquia Cloud Edge

This documentation page includes the following information you will need to configure Acquia Cloud Edge:

Configuring your DNS

As part of Acquia Cloud Edge setup process, your team has the option to configure your DNS using one of the following methods:

  1. Authoritative DNS: You move your DNS to Acquia Cloud Edge, and use Acquia Cloud Edge as your authoritative DNS service.
  2. Partial CNAME setup: You keep your DNS with your current DNS service and direct your traffic through Acquia Cloud Edge using a CNAME record.

You must select and implement one of these methods to fully launch your domain with Acquia Cloud Edge. For more information about the Acquia Cloud Edge DNS options, see Acquia Academy

Setting up a domain for Acquia Cloud Edge

To set up your domain with your Acquia Cloud Edge subscription, you must complete a security measure to confirm your ownership of the domain you plan to manage. Acquia will provide your team a TXT record in the welcome email sent to you when you purchase Acquia Cloud Edge. The TXT record will look similar to this example:

Type: TXT
Name: cloudflare-verify.example.com
Content: 86XXXXXXX-1XXXXXXX

TXT record

Add this TXT record to your current authoritative DNS for the domain. Acquia Cloud Edge will detect the record in your DNS, confirming your ownership of the domain. For security purposes, you cannot proceed with setting up your domain until you add this record and Acquia Cloud Edge verifies it.

If you are setting up multiple domains, you must add the respective TXT records provided in the welcome email to their respective domains. This TXT record is available on the Overview tab for each domain as a reference until it is added to your DNS record.

SSL Certificates

To enable SSL, you must first determine the type of SSL certificate you want to deploy on Acquia Cloud Edge, and the level of encryption the SSL certificate will enforce.

Within your Acquia Cloud Edge subscription, you have three options for your SSL certificate: Universal SSL, Custom SSL, or a combination of both.

Universal SSL

Acquia Cloud Edge CDN and Acquia Cloud Edge Protect include a single Universal SAN certificate per domain, covering the bare domain and wildcard third-level domains. The Universal certificate renews every year, requiring no certificate maintenance by your team. For these types of certificates, Acquia Cloud Edge is displayed as the owner of the certificate.

The Universal SSL certificate is available for each domain you set up within your Edge subscription.

For the Authoritative DNS method, the Universal certificate will be deployed after you update your nameservers to move to the Acquia Cloud Edge-provided nameservers.

For Partial CNAME DNS method, your Universal SSL will be deployed after you add the three Acquia-generated CNAME records to DNS.

Custom SSL

If you want to use your own custom SSL certificates with Acquia Cloud Edge, upload the same certificate you use on Acquia Cloud to Acquia Cloud Edge. However, if you then change or re-key your SSL certificate, you must apply the updated or new certificate to both Acquia Cloud and Acquia Cloud Edge to maintain consistency and simplify support.

Note for China and HTTPS usage

If you anticipate website traffic based in China using HTTPS, Cloudflare requires you to place your private SSL keys in their China data centers.

Testing Acquia Cloud Edge

You can test Acquia Cloud Edge by editing your /etc/hosts file to point your domain to the CloudFlare IP address for the domain. To test, complete the following steps:

Note

Domains protected by Acquia Cloud Edge must use a CNAME instead of an A record. If you use CNAME integration with Acquia Cloud Edge, you must handle the termination of the apex (root) domain, and the redirect of subdomains such as the www subdomain must be handled outside of Acquia.

  1. Find the IP address of the subdomain to be routed through Acquia Cloud Edge using a command similar to the following:

    dig [domain_name].cdn.cloudflare.net
    

    where [domain_name] is your fully qualified domain name (FQDN).

    For example, if your domain name is test.example.com, the command would be:

    dig test.example.com.cdn.cloudflare.net
    

    The response will appear similar to these results:

    ; <<>> DiG 9.8.3-P1 <<>> test.example.com.cdn.cloudflare.net
    ;; global options: +cmd
    ;; Got answer:
    ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 64242
    ;; flags: qr rd ra; QUERY: 1, ANSWER: 5, AUTHORITY: 0, ADDITIONAL: 0
    ;; QUESTION SECTION:
    ;test.example.com.cdn.cloudflare.net. IN A
    
    ;; ANSWER SECTION:
    test.example.com.cdn.cloudflare.net. 300 IN A 111.22.33.44
    test.example.com.cdn.cloudflare.net. 300 IN A 111.22.34.44
    test.example.com.cdn.cloudflare.net. 300 IN A 111.22.35.44
    test.example.com.cloudflare.net. 300 IN A 111.22.36.44
    test.example.com.cdn.cloudflare.net. 300 IN A 111.22.37.44
    
  2. Select one of the IP addresses in the ANSWER SECTION of the dig response.

  3. Ensure the Edge dashboard lists the subdomain record with an orange cloud. See What subdomains are appropriate for orange / gray clouds?.

  4. Edit your /etc/hosts file to add a line based on the following format, using the IP address and your domain name:

    111.22.33.44 test.example.com
    

    For information about how to edit your /etc/hosts file, see Using a hosts file for custom domains during development.

  5. Enter the domain name in your browser and examine the page response headers.

If Acquia Cloud Edge is functioning properly, your webpage’s response headers will include a cf-ray header.

Launching on Acquia Cloud Edge

You must thoroughly test your Acquia Cloud Edge configurations using the steps in the previous section before you schedule your launch.

Launching with Authoritative DNS method

To configure Acquia Cloud Edge as the authoritative domain name server for your website, complete the following steps:

  1. Contact Acquia support by submitting a ticket when you are ready to launch. Provide your intended launch date, and request the nameservers for your Acquia Cloud Edge account.

  2. Acquia Support will update the ticket with the nameservers associated with your Acquia Cloud Edge subscription. You will use these nameservers for launch.

  3. Determine the registrar for your website’s domain name, and then sign in to your domain name registrar’s website.

    Note

    Domain registrar information is publicly available online from the WHOIS database. If you are not sure of your domain registrar, use a website such as whois.net to determine your domain name registrar.

  4. On your registrar’s website, update your nameserver records with the nameserver information provided by Acquia Support. If you are not sure how to update your nameserver information with your registrar, contact your registrar’s support for assistance.

  5. In your Acquia Cloud Edge dashboard, confirm your changes have taken effect by reviewing the displayed status message from the following list:

    • Status: Active: Your domain setup is complete.
    • Status: Pending: Your nameserver updates have not yet propagated, or were not updated correctly.
  6. If your nameserver updates are marked Pending, click Overview in the Acquia Cloud Edge dashboard, and then click Recheck Nameservers, as displayed in the following example:

    How to force Acquia Cloud Edge to recheck your nameservers

    If the issue persists, use a website such as whois.net to check whether your nameserver records match the records provided in Acquia Cloud Edge.

Launching with Partial CNAME method

With a CNAME setup, the authoritative DNS for your domain is not managed in Acquia Cloud Edge, and one or more subdomains are redirected to Acquia Cloud Edge using CNAME DNS record(s). Although you can add multiple CNAME records to your authoritative DNS, each CNAME record you add must contain a corresponding enabled record (marked with an orange cloud icon) in the Acquia Cloud Edge DNS tab. Before you launch your domain using the Partial CNAME method, ensure you properly configure the redirects for your apex (root) domain as described in Redirecting bare domain names to the “www” subdomain. For information about limitations of this approach, see the Configuring your DNS section.

Important

Do not perform the following steps if you are using Acquia Cloud Edge as your authoritative DNS provider.

To launch a domain using the Partial CNAME DNS method for Acquia Cloud Edge, complete the following steps:

  1. Plan your CNAME records for launch. In this step, you are not updating your DNS, but instead confirming you have the correct CNAME records for your DNS update on your scheduled launch date.

    To create a CNAME record for your domain, append your domain name with .cdn.cloudflare.net. Your CNAME records will always follow the same pattern. For example:

    www.example.com would point to a CNAME of www.example.com.cdn.cloudflare.net

  2. Sign in to your DNS provider.

  3. Add the CNAME you planned in Step 1 for your desired domain to your authoritative DNS provider. Your CNAME domain name will be in the following format:

    [www.example.com].cdn.cloudflare.net
    

    where [www.example.com] is the full name of the destination hostname.

Confirming traffic is going through Acquia Cloud Edge

After updating your DNS with Acquia Cloud Edge, you must test to confirm website requests are being sent through the Acquia Cloud Edge network. You can perform these tests in one of two ways:

  • Using the browser address bar
    Enter www.example.com/cdn-cgi/trace in any browser, where www.example.com is the domain you are testing. The response will display details similar to the following:

    fl=4f64
    h=www.camilia.me
    ip=108.162.209.36
    ts=1437437272.84
    visit_scheme=http
    uag=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.134 Safari/537.36
    colo=SJC
    spdy=off
    
  • Using the Claire plugin for Chrome
    The Claire plugin is a free download available from the Chrome web store.
    After you install the plugin, any website you access through the Edge network will cause the plugin to display an orange cloud icon in the Chrome address bar, indicating the request was processed by the Edge network.

    If you do not receive the expected results, the domain is not yet correctly configured for Acquia Cloud Edge. Confirm the DNS configurations have been made correctly.