Add docs for setting up the Akamai CDNs for managed dedicated

docs/dedicated/akamai/cdn.md

@@ -0,0 +1,82 @@
+---
+title: Setting up Akamai CDNs
+sidebar_label: Akamai CDN
+---
+
+When running managed dedicated on the Akamai Cloud, you need to set up 2 CDNs,
+one for your API endpoint deployments, and one for your developer portal.
+
+This document outlines the configurations you need to add to your Akamai CDNs to
+set them up to access your API gateway and developer portal.
+
+All configurations in this guide were done on the Akamai Property Manager, see
+the
+[Akamai docs](https://techdocs.akamai.com/property-mgr/docs/know-your-around)
+for more details.
+
+### Prerequisites
+
+1. Provision the domains that you would like these CDNs to have and certificates
+   for those domains. You will need a domain for the API gateway, as well as a
+   domain for the CDN.
+2. Request the Origin URLs for your API gateway and developer portal from your
+   Zuplo contact.
+3. Let your Zuplo point of contact know what hostnames/domains you will be using
+   in your CDNs.
+
+## API Gateway CDN
+
+This section guides you on how to configure your API Gateway CDN.
+
+Add the API gateway domain you provisioned to the Property Hostname for the API
+Gateway CDN. See the Akamai docs on
+[configuring HTTPS hostnames](https://techdocs.akamai.com/property-mgr/docs/serve-content-over-https).
+
+Make the following behavior changes:
+
+1. Configure the Origin URL to point to the URL given to you by Zuplo for your
+   API gateway. Ensure that the Forward Host Header is configured to be the
+   Origin Hostname. This would look something similar to below:
+   ![api_gateway_origin_url](../../../public/media/managed-dedicated-akamai/api_gateway_origin_url.png)
+
+2. Turn on Content Targeting (Edgescape) in the Geolocation rule in the Property
+   Manager Sidebar.
+   ![geolocation](../../../public/media/managed-dedicated-akamai/geolocation.png)
+
+3. Enable all Allowed Methods rules (POST, OPTIONS, PUT, DELETE, PATCH) in the
+   Property Manager sidebar.
+
+## Developer Portal CDN
+
+This section guides you on how to set up the Developer Portal CDN.
+
+Add a property hostname with a wildcard to your Developer Portal CDN, similar to
+below:
+
+![wildcard_domain](../../../public/media/managed-dedicated-akamai/dev_portal_cdn_wildcard_hostname.png)
+
+Under the Default Rule page, add the following behaviors:
+
+1.  Configure the origin URL to be the URL given to be the one given to you by
+    Zuplo for your Developer Portal. This will look similarly to how you
+    configured it for your API Gateway CDN.
+
+2.  Modify Incoming Request Header behavior, with the following fields: Action:
+    Add, Select Header Name: Other, Custom Header Name: X-Forwarded-Host, Header
+    Value: \{\{builtin.AK_HOST\}\}. This should look like the picture below:
+
+    ![dev_portal_cdn_base_path_and_incoming_header_behaviors](../../../public/media/managed-dedicated-akamai/default_rule_dev_portal_config.png)
+
+3.  Caching, which should have the following configurations: Caching Option
+    should be set to "Honor origin Cache-Control and Expires", Force Validation
+    of stale objects should be set to "Always revalidate with origin", Default
+    Maxage should be set to 0 seconds, and all the Cache-Control header
+    directives should be enabled. This will look like below:
+
+    ![dev_portal_caching_behavior](../../../public/media/managed-dedicated-akamai/dev_portal_cdn_caching_behavior.png)
+
+Congratulations, you've set up your Akamai CDNs to serve your API Gateway and
+Developer Portal! At this point, you should be able to test that these things
+are working by either hitting an endpoint in your API gateway (e.g
+mygateway.com/my/endpoint), or navigating to a page in your developer portal
+(e.g myportal.com/home).

sidebar.ts

@@ -136,6 +136,12 @@ export const docs: SidebarEntry = [
       "dedicated/architecture",
       "dedicated/networking",
       "dedicated/custom-domains",
+      {
+        type: "category",
+        label: "Akamai",
+        // link: "dedicated/akamai",
+        items: ["dedicated/akamai/cdn"],
+      },
     ],
   },
   {