Skip to content

TR-4557: Update Fastly HTTPS setup guide #739

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 29, 2023
Merged

TR-4557: Update Fastly HTTPS setup guide #739

merged 5 commits into from
Jun 29, 2023

Conversation

gilesv
Copy link
Member

@gilesv gilesv commented Jun 27, 2023

Ticket: https://messagebird.atlassian.net/browse/TR-4557

What Changed

  • Updated Fastly guide on HTTPS Engagement Tracking, with screenshots of the new UI and more details about correctly forwarding the Host header to SparkPost.
  • Screen recording of the guide:
Screen.Recording.2023-06-27.at.17.59.03.mov

After setting up my tracking domain with HTTPS provided by Fastly, I noticed that it automatically forwards the Host if the Override host option is disabled:

~❯ curl -v https://click.redlabs.shop/f/woohoo/XhBKq2IoQzooHYGhQFI21w\~\~/AAUBzwA\~/RgRmfbURP0RJaHR0cHM6Ly9kb2NzLm5naW54LmNvbS9uZ2lueC9hZG1pbi1ndWlkZS9sb2FkLWJhbGFuY2VyL2h0dHAtbG9hZC1iYWxhbmNlclcDc3BjQgpkkREwm2TECMaQUiN2aW5pY2l1cy5naWxlcyt0ZXN0QG1lc3NhZ2ViaXJkLmNvbVgEAAAAAA\~\~
*   Trying 199.232.113.91:443...
* Connected to click.redlabs.shop (199.232.113.91) port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* successfully set certificate verify locations:
*  CAfile: /etc/ssl/cert.pem
*  CApath: none
* (304) (OUT), TLS handshake, Client hello (1):
* (304) (IN), TLS handshake, Server hello (2):
* (304) (IN), TLS handshake, Unknown (8):
* (304) (IN), TLS handshake, Certificate (11):
* (304) (IN), TLS handshake, CERT verify (15):
* (304) (IN), TLS handshake, Finished (20):
* (304) (OUT), TLS handshake, Finished (20):
* SSL connection using TLSv1.3 / AEAD-CHACHA20-POLY1305-SHA256
* ALPN, server accepted to use h2
* Server certificate:
*  subject: CN=click.redlabs.shop
*  start date: Jun 27 17:28:20 2023 GMT
*  expire date: Sep 25 17:28:19 2023 GMT
*  subjectAltName: host "click.redlabs.shop" matched cert's "click.redlabs.shop"
*  issuer: C=US; O=Let's Encrypt; CN=R3
*  SSL certificate verify ok.
* Using HTTP2, server supports multiplexing
* Connection state changed (HTTP/2 confirmed)
* Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0
* Using Stream ID: 1 (easy handle 0x12780f200)
> GET /f/woohoo/XhBKq2IoQzooHYGhQFI21w~~/AAUBzwA~/RgRmfbURP0RJaHR0cHM6Ly9kb2NzLm5naW54LmNvbS9uZ2lueC9hZG1pbi1ndWlkZS9sb2FkLWJhbGFuY2VyL2h0dHAtbG9hZC1iYWxhbmNlclcDc3BjQgpkkREwm2TECMaQUiN2aW5pY2l1cy5naWxlcyt0ZXN0QG1lc3NhZ2ViaXJkLmNvbVgEAAAAAA~~ HTTP/2
> Host: click.redlabs.shop
> user-agent: curl/7.79.1
> accept: */*
>
< HTTP/2 302
< content-type: text/plain
< location: https://docs.nginx.com/nginx/admin-guide/load-balancer/http-load-balancer
< server: msys-http
< x-robots-tag: noindex
< accept-ranges: bytes
< date: Tue, 27 Jun 2023 18:54:37 GMT
< via: 1.1 varnish
< age: 66
< x-served-by: cache-cgh11176-CGH
< x-cache: HIT
< x-cache-hits: 1
< x-timer: S1687892077.292871,VS0,VE38
< content-length: 0
<
* Connection #0 to host click.redlabs.shop left intact

Given this, I updated the guide to mention the absolute need for the Override host option to be off as the Host must be forwarded to SparkPost.

How To Test or Verify

  • Run it locally and make sure the updates are there

PR Checklist

All PRs Checklist

  • Give your pull request a meaningful name.
  • Use lowercase filenames.
  • Apply at least one team label according to which team is the content expert (ie. team-FE or team-SAZ)
  • Pull request approval from the FE team or content experts (see label applied above) that isn't the content creator.

Content Changes Checklist

  • Check that your article looks correct in the preview here or in a Netlify deploy preview.
  • Check the links in your article.
  • Check the images in your article (if there are any)
  • Check to make sure you are using markdown appropriately as outlined in examples/article.md in the root of the project directory and on the momentum doc's preface article
  • Check to make sure the Copy and Tone Guidelines are followed.

@netlify
Copy link

netlify bot commented Jun 27, 2023

Deploy Preview for support-docs ready!

Name Link
🔨 Latest commit f07da11
🔍 Latest deploy log https://app.netlify.com/sites/support-docs/deploys/649d7b484fb7860008f8860a
😎 Deploy Preview https://deploy-preview-739--support-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@gilesv gilesv changed the title TR-4552: Update Fastly HTTPS setup guide TR-4557: Update Fastly HTTPS setup guide Jun 27, 2023
@gilesv gilesv changed the title TR-4557: Update Fastly HTTPS setup guide TR-4557: Update Fastly CDHTTPS setup guide Jun 27, 2023
@gilesv gilesv changed the title TR-4557: Update Fastly CDHTTPS setup guide TR-4557: Update Fastly HTTPS setup guide Jun 27, 2023
@gilesv gilesv added the team - TR Transmissions team is the subject matter expert and need to approve this PR label Jun 27, 2023
@gilesv gilesv marked this pull request as ready for review June 28, 2023 10:48
Copy link
Contributor

@lucas-mitri-messagebird lucas-mitri-messagebird left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great!

Copy link
Contributor

@NupurKulkarni1 NupurKulkarni1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verified new screenshots by running locally. LGTM!


1. Select the **Configure** tab on the Dashboard, then "Create Service". Give your service a name, and add your tracking domain under "Domains".
1. Select the **Deliver** tab on the Dashboard, then click the **Create a delivery service** button. Give your service a name in the _Options_ menu and clicking **Edit service name**.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpicky - Give your service a name in the Options menu by clicking Edit service name.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@gilesv gilesv merged commit 5ffe95f into main Jun 29, 2023
@gilesv gilesv deleted the TR-4552 branch June 29, 2023 14:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:shipit: approved team - TR Transmissions team is the subject matter expert and need to approve this PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants