Important
If you are a new customer who started with Acquia Edge after January 1, 2021, see Understanding a managed CNAME setup.
This documentation page includes the following information you will need to configure Acquia Edge:
- Configuring your DNS
- Setting up a domain for Acquia Edge
- Testing Acquia Edge
- Launching on Acquia Edge
- Confirming traffic is going through Acquia Edge
Configuring your DNS
As part of the Acquia Edge setup process, your team has the option to configure your DNS using one of the following methods:
- Authoritative DNS or Full setup: Move your DNS to Acquia Edge, and use Acquia Edge as your full, authoritative DNS service.
- Partial CNAME setup: Keep your DNS with your current DNS service and direct your traffic through Acquia Edge using a CNAME record.
Both the options can be referred to as Direct setups because you directly add your domain to Acquia Edge.
You must select and implement one of these methods to fully launch your domain with Acquia Edge. For more information about the Acquia Edge DNS options, see Acquia Academy.
Setting up a domain for Acquia Edge
To set up your domain with your Acquia 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 Edge. The TXT record will look similar to this example:
Type: TXT
Name: cloudflare-verify.example.com
Content: 86XXXXXXX-1XXXXXXX
Add this TXT record to your current authoritative DNS for the domain. Acquia 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 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 Edge, and the level of encryption the SSL certificate will enforce.
Within your Acquia Edge subscription, you have three options for your SSL certificate: Universal SSL, Custom SSL, or a combination of both.
Universal SSL
Edge CDN and Edge Security include a Universal SAN certificate, covering any hostnames that you may have active on Edge. The Universal certificate renews every year without requiring a certificate maintenance by your team. For these types of certificates, Cloudflare is displayed as the owner of the certificate.
The Universal SSL certificate is available for each domain that you set up within your Edge subscription.
For the Authoritative DNS method, the Universal certificate is deployed after you update your nameservers to move to the Acquia Edge-provided nameservers. A single certificate is issued covering the zone apex and a wildcard on any first-level subdomains.
For the Partial CNAME DNS method, Universal SSL certificates attempt to issue for each proxied hostname that you set on the DNS tab of your zone(s). A single certificate is issued for each proxied hostname, with no wildcards. For domain control validation to complete for each certificate, you must have a CNAME record in your DNS to set the resolution to Acquia Edge for each hostname. For any HTTP request to the respective hostnames, certificates are issued within minutes.
Custom SSL
If you want to use your own custom SSL certificates with Acquia Edge, upload the same certificate you use on Cloud Platform to Acquia Edge. However, if you then change or re-key your SSL certificate, you must apply the updated or new certificate to both Cloud Platform and Acquia 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 Edge
You can test Acquia 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 Edge must use a CNAME instead of an A record. If you use CNAME integration with Acquia 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.
Find the IP address of the subdomain to be routed through Acquia Edge using a command similar to the following:
dig [domain_name].cdn.cloudflare.netwhere
[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.netThe response will display like the following 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- Select one of the IP addresses in the
ANSWER SECTIONof thedigresponse. - Ensure the Edge dashboard lists the subdomain record with an orange cloud. See What subdomains are appropriate for orange / gray clouds?.
Edit your
/etc/hostsfile to add a line based on the following format, using the IP address and your domain name:111.22.33.44 test.example.comFor information about how to edit your
/etc/hostsfile, see Using a hosts file for custom domains during development.- Enter the domain name in your browser and examine the page response headers.
If Acquia Edge is functioning properly, your webpage’s response headers will include a cf-ray header.
Launching on Acquia Edge
You must thoroughly test your Acquia Edge configurations using the steps in the previous section before you schedule your launch.
Important
If you are a new customer who started with Acquia Edge after January 1, 2021, see Launching with Partial CNAME method.
Launching with Partial CNAME method
With a CNAME setup, the authoritative DNS for your domain is not managed in Acquia Edge, and one or more subdomains are redirected to Acquia 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 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 Edge as your authoritative DNS provider.
To launch a domain using the Partial CNAME DNS method for Acquia Edge, complete the following steps:
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.comwould point to a CNAME ofwww.example.com.cdn.cloudflare.net- Sign in to your DNS provider.
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.netwhere
[www.example.com]is the full name of the destination hostname.
Confirming traffic is going through Acquia Edge
After updating your DNS with Acquia Edge, you must test to confirm website requests are being sent through the Acquia Edge network. You can perform these tests in one of two ways:
Using the browser address bar
Enterwww.example.com/cdn-cgi/tracein any browser, wherewww.example.comis 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=offUsing 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 Edge. Confirm the DNS configurations have been made correctly.