The Subcustomer Enablement behavior

This behavior in your Akamai Cloud Embed base configuration allows you to control which individual features can be included and set in a Subcustomer's "policy."

A policy is a set of rules and behaviors that are applied when an end user requests a specific Subcustomer's content. You use the ACE API to create individual Subcustomer policies. (They are defined in a PUT body component included with a specific call from the API.)

This behavior lets you enable or disable various options to limit the use of specific behaviors in Subcustomer policies.

Important: What you set here applies to all subcustomers assigned to this base configuration. For example, if you set an option to "Off," any subcustomer assigned to this base configuration cannot configure the associated behavior in their policies. If you want the subcustomer to access a behavior, ensure it's set to On."

Dynamic Policy

This switch enables Subcustomer Enablement settings.

  • Set to "On": This is typical. It applies if you want to set up individual policies for each Subcustomer. You can enable/disable individual behaviors to meet your needs. (If disabled, that specific behavior can't be modified in an individual Subcustomer policy.)
  • Set to "Off": This is uncommon, and only applies to some lesser-used use cases (for example, Subcustomer level billing, when different delivery configurations are not required, or for domain validation for certificates). Talk to your Account Representative for more details on these uses cases.

Partner Domain Suffix

Input the appropriate domain suffix. This is typically the same value you've input for use as your property hostname. We use this value internally to support two things:

  • Domains need to be flagged as trustworthy or acceptable ("whitelisted") for access by our Edge servers. Domain information is typically gathered from the Origin Server information defined in a Property Manager configuration. However, since an origin can be set dynamically via a policy in ACE, we whitelist the suffix you input here, and add it internally to all origin domains for this purpose.
  • We use VIP-based slot-matching in secure ACE configurations. As a result, URL Purge doesn’t work for vanity domains. So, you need to use this suffix to the domain names while making purge requests. For example, to purge abc.com/somepath should be requested as abc.com.<partner domain suffix>/somepath.

Optional Subcustomer Enablement Settings: Quick Reference

The remaining settings here can be enabled to customize these settings on a per-Subcustomer basis, by generating a policy using the ACE API.

Setting Description Additional Reference
Origin
  • Set to "On": An individual Subcustomer's policy can include settings to define a custom origin server, with all associated settings. (What's set for a policy's origin overrides what's set for the Origin Server behavior. If no origin settings are applied in a policy, what's set for the Origin Server behavior is used.)
  • Set to "Off": A Subcustomer policy cannot include origin server information. This applies if you want to use the origin you've set as the Origin Server behavior for all of the Subcustomers that are associated with this base configuration.
Caching
  • Set to "On": You can specify caching settings in an individual Subcustomer's policy. What you set for a policy caching settings will override what you've set for the Caching behavior here in the base configuration. (If caching settings are not applied in a policy, what's set for the Caching behavior is used.)
  • Set to "Off": You can't change caching settings for a Subcustomer via a policy. What is set here in the base configuration for the Caching behavior will be used for all Subcustomers.
Referrer Allow/Block Set this to "On" to allow dynamic setup of a referrer whitelist (allow referrers) or blacklist (deny referrers) in the policy for each Subcustomer.
IP Allow/Block Set this to "On" to allow dynamic setup of an IP whitelist (allow specified IP addresses) or blacklist (deny specified IP addresses) in the policy for each Subcustomer. Set to "Off" to block the inclusion of IP whitelists/blacklists in a Subcustomer policy.
Geo Allow/Block Set this to "On" to allow the inclusion of a geographic regions whitelist (allow specified continents, countries, regions and mesignated market areas—DMAs) or blacklist (deny specified geographic regions) in the policy for each Subcustomer.
Content Refresh If you set this to "On" you can set up content revalidation schedules for each Subcustomer in the associated policy.
Modify Forward Path When set to "On", you can dynamically modify the request path to the content server for each Subcustomer in the associated policy.
Cache Key Query Arguments When set to "On" you can apply various settings in Subcustomers' policies to customize which query string arguments can be included in the Akamai Edge server cache entry (cache-key).
Token Authentication Set this to "On" to configure whether or not Edge servers can control access to Subcustomer content through the use of tokens. (The token can be transmitted in the client request in a cookie, header, or query-parameter.)
Site Failover Set this to "On" to allow configuration of a unique failover site in each Subcustomers' policy.
Content Compressor Set this to "On" to configure file compression on a per Subcustomer basis, via their unique policy.
Access Control Set to "On," you can deny requests to a Subcustomer's content based on certain match conditions.(You set up these match conditions in the Subcustomer's policy.)
Dynamic Web Content When set to "On" you can apply various settings to Subcustomers' policies to support and streamline the delivery of dynamic web content. How to add dynamic web content support for a Subcustomer
Streaming Video On-demand Delivery Set this switch to "On" to allow addition of streaming on-demand video support via a Subcustomer policy. How to add streaming video support for a Subcustomer
Large File Delivery When set to "On" you can apply various settings in Subcustomers' policies to support and streamline the delivery of large files (up to 1.8 GB in size). How to add large file delivery support for a Subcustomer