CORS Protocol Support

Add the CORS (cross-origin resource sharing) Protocol Support behavior if your property contains resources that can be requested by another domain that you may not control. This helps to specify which third-party web pages can request your content.


In CORS terminology, “origin” means the fully-qualified domain of the web page that is making the request for your content, including the scheme (http or https) and the port, typically defaulted. For example, a web page with a URL of which is making a request for your protected content has a CORS origin of

The CORS usage of “origin” is different from the common Akamai usage of “origin” that means your backend server from which your content is retrieved and served through Akamai.

In this document, use of the word “origin” should be taken to have the CORS meaning.

Why you need it

You may either add the CORS Protocol Support to optimize your content delivery, or—depending on the product you use and your property setup—this behavior might be required. For example, you need to add this behavior to your property if you use Bot Manager Premier's inline telemetry feature to cover cross-domain requests. If you need help determining which case applies to your configuration, contact your Professional Services representative.

You can either apply the CORS Protocol Support behavior to a whole property, making all your content available to the origins you specify in the behavior, or you can use it only for specific paths, such as /api/*.


Enabling the CORS behavior may permit requests which were previously blocked. Make sure this behavior is in line with your security settings or contact your Professional Services representative.

How it works

Imagine that a web page at makes an AJAX request for the content served by your property, whose hostname is By configuring the CORS Protocol Support behavior, you can permit these requests, while denying requests for the same content from a different web page, such as

You can find more detailed specifications for this protocol in the WHATWG's Fetch Living Standard. It only applies to a limited number and type of requests from browsers. CORS doesn’t apply to requests from command-line tools. It is the browser that decides whether a request uses CORS. In general, CORS protocol is most frequently used when a web page makes an AJAX request for content from another domain.

Features and options

FieldWhat it doesSub-options


Enables or disables this behavior.


Allow Origins

Select whether to accept requests from any web page domain or from specific web page domains.

  • Any
  • Specified


With Allow Origins set to Specified, displays a list of the specified web page domains to accept requests from. Requests from web pages that use other domains are rejected.


Allow Credentials

Accepts requests with credentials, such as cookies and client certificates. Allows browsers to process Set-Cookie responses.


Allow Headers

Select which request headers to allow in requests for your content.

  • Any
  • Specified


With Allow Headers set to Specified, select one or more request headers you want to allow. Requests with other headers are rejected.



Specifies any combination of the following methods: DELETE, GET, PATCH, POST, and PUT that are allowed when a web page accesses your property. Requests that use other methods are rejected.


Expose Headers

Lists names of response headers that the requesting browser can access using JavaScript. Headers not specified here can't be accessed this way by the browser. This feature supports variable expression syntax. Type {{ in the option field to trigger variable auto-complete.


Preflight Max Age

The number of seconds that the browser should cache the response to a preflight request. By specifying this value, you can reduce the number of requests the browser sends to your property.


Implementation with other ​Akamai​ products

Bot Manager

If you're using Bot Manager's Inline Telemetry, the browser may initiate additional CORS requests. Use the CORS Protocol Support behavior to allow those requests. See Bot Manager documentation for more details.

Common Media Client Data & AMD

Are you using Adaptive Media Delivery (AMD) to deliver your content and want to support Common Media Client Data (CMCD) with your media player? If so, you'll need to set up the CORS Protocol Support behavior to support it. Have a look at Common Media Client Data & AMD for full details.