StackPath EdgeRules allow you to customize the way the StackPath CDN responds to requests for websites. To make the setup process even easier, the most popular rules are included in single-click presets.
The StackPath preset EdgeRules take effect as soon as the CDN receives the request and are compatible with the WAF for CDN and WAF integrations.
These rules will only work with domains that resolve to the StackPath CDN systems. When using a custom delivery domain, or full site integration, this will require making changes to your DNS records, you can read more here.
Force HTTPS Connections
The Force HTTPS Connections rule will take any request for regular, unsecured HTTP and automatically redirect it to secure HTTPS. This works for requests towards the StackPath CDN URL as well as any custom delivery domains added. This rule can be used in any instance where the goal is to force HTTPS redirection, either in a Static Assets, or a Full Site integration.
To use a custom delivery domain you will be required to upload a custom SSL Certificate or obtain a free one from StackPath that covers that domain. Learn more here.
Force WWW Connections
The Force WWW Connections Rule redirects every request to a WWW subdomain. This works on all requests towards the StackPath CDN URL and any delivery domains that have been set up. Because of this, this rule is only recommended to redirect the apex domain to your WWW subdomain, assuming both already resolve to the CDN through DNS. It is recommended that this rule to only be used with a Full Site CDN Integration.
This rule will affect the StackPath CDN URL and any subdomains you have set up as delivery domains. This will redirect any assets at h8j6g5r2.stackpathcdn.com to be at www.h8j6g5r2.stackpathcdn.com, when using the CDN URL For integration, preventing anything from loading. Similarly, if you have any custom subdomains in use as delivery domains, cdn.yourdomain.com, for example, will redirect to www.cdn.yourdomain.com and become unusable.
EdgeRules instantly become active as soon as they are enabled. This allows for instant testing and configuration adjustments. Testing in a browser is ideal because this will provide visual feedback to indicate the rules are redirecting properly. A complete integration will automatically cause the desired redirect to the appropriate protocol or subdomain.
The 301 Response Code indicates a permanent redirect, so based on the above example image, the initial request redirects to a secure domain (green lock) which then redirects to an unusable WWW subdomain.
Alternatively, using cURL commands on a Mac OS or Linux terminal will show the desired behavior as well. A cURL command with the -IL options will force the process to follow any 301 redirects and show the response headers through the entire process (as shown above with cURLs towards a CDN URL).
If you have any questions about EdgeRules, StackPath Support is available 24/7 via live chat or ticket.