diff --git a/content/docs/tech-resources/enabling-https-engagement-tracking-on-sparkpost.md b/content/docs/tech-resources/enabling-https-engagement-tracking-on-sparkpost.md index 4da46276d..4fee7e368 100644 --- a/content/docs/tech-resources/enabling-https-engagement-tracking-on-sparkpost.md +++ b/content/docs/tech-resources/enabling-https-engagement-tracking-on-sparkpost.md @@ -1,5 +1,5 @@ --- -lastUpdated: "06/30/2023" +lastUpdated: "07/05/2023" title: "Enabling HTTPS Engagement Tracking on SparkPost" description: "SparkPost supports HTTPS engagement tracking for customers via self-service for all SparkPost customers. To enable SSL engagement tracking for a domain, additional configuration for SSL keys is required." --- @@ -580,48 +580,52 @@ The steps below are based on [this guide](https://docs.microsoft.com/en-us/azure ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-select-resource-group.png) -1. From the home page or the Azure menu, select Create a resource. Select Networking > See All > Front Door. +1. From the home page or the Azure menu, select Create a resource. Select Media > Front Door and CDN profiles. ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door1.png) - Choose Create. + Choose Explore other offerings, choose Azure Front Door (classic) and then Continue. ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door2.png) Select your resource group. Select "Next: Configuration". + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png) + 1. In Frontends/domains, select `+` to open "Add a frontend host". Give your host a name - this needs to be a valid, unique subdomain of the domain `.azurefd.net`. Choosing a name based on your custom tracking domain should help to ensure uniqueness; you should see a green check mark appear on the right. (We will change this later to be your actual custom domain.) - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png) 1. Next, we create a backend pool that contains just the SparkPost tracking domain. In Backend pools, select + to open Add a backend pool. Give this a name. - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png) 1. Select "Add a backend". Set the backend host type to be "Custom host". Set the backend host name to be the correct endpoint address for your service, see [here](#sparkpost-tracking-endpoints). - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png) * The backend host header field will be automatically filled in for you. Leave the HTTP port and HTTPS port settings at defaults. Click Add. * Leave the Health probe inactive, as there is only one backend. + * This will forward the `Host` and `User-Agent` HTTP headers to SparkPost properly, which is necessary for Engagement Tracking to work as expected. + 1. On "Routing rules", select `+`. Give your rule a name. Leave "Accepted protocol" as the default "HTTP and HTTPS". Ensure your "Frontends/domains" setting is your previously configured subdomain name. Set the Path to `/*` to match all incoming requests. Leave Route type set to the default "Forward", and set Forwarding Protocol to "Match request". Select "Add". - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png) 1. Select "Review + create", then "Create". - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png) You should see "Deployment is in progress", followed by a "deployment complete" message. - ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png) + ![](media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door9.png) Your front door is now active on the subdomain we set up, and can be checked using `curl` with added path `/f/a/b/c/d`, for example: diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door1.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door1.png index dc4dbb2cb..21236570e 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door1.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door1.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door2.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door2.png index d455165ec..e0fd1d8b2 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door2.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door2.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png index cb1fb34cd..f4d090846 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door3.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png index 58cf458cd..468a9942d 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door4.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png index d6cec5313..3331be1a4 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door5.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png index 71580b515..d6cec5313 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door6.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png index 45ba73a77..a91b71799 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door7.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png index e8666ab0d..d985880fd 100644 Binary files a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door8.png differ diff --git a/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door9.png b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door9.png new file mode 100644 index 000000000..7d3ebf913 Binary files /dev/null and b/content/docs/tech-resources/media/enabling-https-engagement-tracking-on-sparkpost/azure-front-door9.png differ