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 DNS configuration.
1. Add a domain to Domain Ownership Manager
- From the Control Center menu, select Domain Ownership Manager.
- Click + Validate a domain.
- In the Validate domain window:
- 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.
- 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.comand123.example.comare validated, but notxyz.blog.example.comor top levelexample.com. - DOMAIN. Use for exact domains and all subdomains. For example, when you enter
example.com, thenblog.example.com,123.blog.example.com, andx.123.blog.example.comare validated.
- HOST. Use for exact domains. For example,
- Enter the domain name. You can enter more than one name to validate more domains.
- Click Submit.
You can see the newly added domain in the Pending tab. The initial status is Request accepted.
2. Update your DNS configuration
- View the domain details.
- In Domain validation details, navigate to the HTTP file tab and copy the challenge token.
- 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> - 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 records or token, you can either wait for the next background job or request 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.
Instantly validate a domain
Once you’ve updated your DNS, you can request to instantly validate your domain. This skips the standard schedule of Domain Ownership Manager background jobs, and validates the domain straight away.
- In the Domain Ownership Manager, select the domain you want to validate and click the action menu icon.
- Select Validate Now.
- In the pop-up window, select HTTP as the preferred validation method.
- Click Validate Now.
The domain validation starts immediately.
Updated about 23 hours ago
