Skip to content

Commit

Permalink
TR-4556: Update Microsoft Azure setup guide (#741)
Browse files Browse the repository at this point in the history
* TR-4556 Updating Microsoft Azure guide

* TR-4556 Update lastUpdated information

* TR-4556 Add warning about host and user-agent headers
  • Loading branch information
josecls committed Jul 6, 2023
1 parent 0179cdf commit 61f841c
Show file tree
Hide file tree
Showing 10 changed files with 13 additions and 9 deletions.
Original file line number Diff line number Diff line change
@@ -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."
---
Expand Down Expand Up @@ -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:

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 61f841c

Please sign in to comment.