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:

StatusDescription
Needs validationIndicates you need to validate this domain. Select Validate certificate domain from the action menu and activate your property again.
Ready to deployIndicates you need to activate the property version to deploy your certificate.
PendingIndicates 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.
StalledIndicates 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 changeIndicates 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.
DeployingIndicates the deployment is in progress.
ExpiredIndicates 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.
ExpiringIndicates 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 EnabledIndicates 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.