Validate a domain using HTTP file

In this method, you create a file containing a token and save it on your origin server at the provided URL. This method is available for hosts (single hostnames).

Use this method when:

  • You don’t have access to a DNS zone.
  • You’re using multiple CDNs. In this Multi-CDN scenario, you need to manage domain validation through files on the origin server.

Don't use this method when:

  • You want to validate a domain with a WILDCARD or DOMAIN validation scope.
  • You don’t want to manually obtain the new challenge tokens from ​​Akamai​ and add them to a file on your origin server.

How to

To validate a domain using HTTP file, first submit your domain for validation in Domain Ownership Manager and then update your server configuration.

1. Add a domain to Domain Ownership Manager

  1. From the ​​Control Center​ menu, select Domain Ownership Manager.
  2. Click + Validate a domain.
  3. In the Validate domain window:
    1. Enter the domain name. You can enter more than one name to validate more domains.
      • Domain names can contain letters (a-z), numbers (0-9), and hyphens (-).
      • You can use hyphens, but not at the beginning or end of the domain name.
      • Spaces or special characters aren't supported.
      • The maximum length of each label is 63 characters, and a full domain name can have a maximum of 253 characters.
    2. Select one of the validation scopes:
      • HOST. Use for exact domains. For example, blog.example.com.
      • WILDCARD. Use for first-level subdomains. For example, when you enter example.com, blog.example.com and 123.example.com are validated, but not xyz.blog.example.com or top level example.com.
      • DOMAIN. Use for exact domains and all subdomains. For example, when you enter example.com, then blog.example.com, 123.blog.example.com, and x.123.blog.example.com are validated.
  4. Click Submit.

You can see the newly added domain in the Pending tab. The initial status is Request accepted.

2. Update your HTTP configuration

  1. View the domain details.
  2. In Domain validation details, navigate to the HTTP file tab and copy the challenge token.
  3. On your HTTP server, create a file and paste the challenge token as the file contents:
    cd <web-server-www-root> mkdirs /.well-known/akamai/akamai-challenge echo -n "your-verification-token" > /web-server/.well-known/akamai/akamai-challenge/<challenge-path-token>
  4. Place the file on your HTTP server, in the location given as the HTTP Redirect> Source URL in the Domain Ownership Manager's UI. The last part of the URL must be the file name.

👍

After you update your DNS or HTTP configuration, you can either wait for the next background job or start an instant validation. The validation process starts right away or after a short delay, depending on the number of requests in the queue.

Check the domain status to monitor the validation progress. After it completes, your domain status changes to Validated.