Map your domain to a property
Each property needs at least one property hostname assigned to it so that the Akamai servers know what rules and behaviors to apply while delivering your content. Property hostnames are basically the domains your end users see, such as www.my-site.com
and m.my-site.com
, as indicated by the Host header in their requests. While assigning hostnames to a property, you specify an edge hostname for each. That, coupled with mapping the property hostname to the edge hostname in your DNS record, redirects the traffic to your site from your origin server to the Akamai CDN.
Property hostnames are used to resolve the first phase of the request flow, and you can set them up to use secure HTTPS transfer (the recognized industry standard), or legacy, non-secure HTTP transfer.
Usually, you configure hostnames in the property version view. However, if you're a SaaS/PaaS provider that manages tens of thousands custom domain hostnames, use hostname buckets instead. This lets you add or remove hostnames from the property level without incrementing the property version.
Hostname statuses
In the Property Hostnames panel, you can verify all configuration details, such as hostname certificates, assigned edge hostnames, IP versions, optional mapping solutions and slots. You can also check the Status column for information on your hostname deployment:
- indicates that the requests for your domain are not yet directed to Akamai edge servers. Update your DNS record to contain a CNAME entry for this hostname.
- indicates that the security network you selected for your edge hostname doesn't match the network in your certificate. Update your edge hostname settings so that end users won't lose access to your site.
Note that if you configured hostnames with multiple CDNs, yellow status may be correct for you as your DNS record result can switch between different CNAMES.
- indicates that the DNS lookup either timed out or failed.
- indicates that Akamai can't determine if there's a DNS record directing requests to the edge hostnames. Verify your DNS record contains a CNAME entry for this hostname.
- indicates that the requests for your domain are directed to Akamai edge servers.
Certificate statuses
In the Property Hostnames panel, check the Certificate column for information on your edge certificate deployment on either staging or production networks:
Status | Description |
---|---|
Needs validation | Indicates you need to validate this domain. Select Validate certificate domain from the action menu and activate your property again. |
Ready to deploy | Indicates you need to activate the property version to deploy your certificate. |
Pending | Indicates you need to add the validation challenge to your DNS and activate the property version on staging or production to deploy your certificate to that network. |
Stalled | Indicates a problem with validation or deployment of your certificate. To try again, re-launch a default certificate validation or contact Akamai Professional Services for help. |
Needs CAA change | Indicates you need to configure your Certification Authority Authorization (CAA) policy to allow Let's Encrypt. Fix the underlying issue and re-launch a default certificate validation, or contact Akamai Professional Services for help. |
Failed (unknown) | To try again, re-launch a default certificate validation or contact Akamai Professional Services for help. |
Deploying | Indicates the deployment is in progress. |
Expired | Indicates your certificate expired. It remains active 30 days after expiration, then gets deleted. You need to add the validation CNAME record in your DNS again. |
Expiring | Indicates your certificate will expire soon. It remains active 30 days after expiration, then gets deleted. You need to add the validation CNAME record in your DNS again. |
TLS Enabled | Indicates the certificate is successfully validated on the network and ready to handle secure traffic. |
Failed (CAA) | Indicates you need to configure your Certification Authority Authorization (CAA) policy to allow Let's Encrypt. Fix the underlying issue and re-launch a default certificate validation, or contact Akamai Professional Services for help. |
Failed (LE allow list) | Indicates the hostname isn't in the Let's Encrypt Certificate Authority domain allow list. Fix the underlying issue and re-launch a default certificate validation, or contact Akamai Professional Services for help. |
Failed (Validation) | Indicates you need to validate this domain. Select Validate certificate domain from the action menu and activate your property again. |
Updated 11 months ago