Erstelle eine Distribution, bei der dein aktueller Host als Origin für die Verhaltensweise Default (*) dient. Füge den Ferndesk-Origin und die oben genannten Verhaltensweisen hinzu. Füge außerdem deine Domain mit einem SSL-Zertifikat von AWS Certificate Manager in der Region US East (N. Virginia) hinzu. Verweise anschließend deine Domain auf die Distribution, zum Beispiel mit einem Alias-Eintrag in Route 53.
Stelle dein Hilfe-Center mit AWS CloudFront in einem Unterordner bereit
Stelle dein Hilfe-Center unter einem Pfad auf einer Website bereit, die hinter Amazon CloudFront liegt, zum Beispiel unter yourcompany.com/help. Füge dazu Ferndesk als zweiten Origin mit drei Cache-Verhaltensweisen hinzu. Deine Domain muss bereits auf die CloudFront-Distribution verweisen.
Dafür muss eine Zahlungsmethode hinterlegt sein. Eine Testversion mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Administratoren können diese Einstellung ändern.
Richte es ein
Richte den Unterordner in Ferndesk ein
Wähle unter Hilfe-Center > Anpassen > Benutzerdefinierte Domain die Option Benutzerdefinierter Unterordner aus, gib die Domain deiner Website und einen Pfad wie /help ein und klicke auf Unterverzeichnis konfigurieren. Kopiere den Proxy-Host, den wir dir anzeigen (er sieht etwa so aus: yourcompany.hc.ferndesk.com). In den folgenden Beispielen verwenden wir /help und www.yourcompany.com; ersetze sie durch deine eigenen Angaben.
Füge Ferndesk als Origin hinzu
Erstelle im Tab Origins deiner Distribution einen Origin. Verwende den Proxy-Host als Origin-Domain und stelle das Protokoll auf „Nur HTTPS“ ein. Füge zwei benutzerdefinierte Header hinzu: X-Ferndesk-Base-Path mit deinem Pfad und X-Ferndesk-Original-Host mit dem Host deiner Website, zum Beispiel www.yourcompany.com.
Füge drei Verhaltensweisen hinzu
Erstelle im Tab Behaviors jeweils eine Verhaltensweise für /help, /help/* und /_ferndesk/*. Alle drei müssen auf den Ferndesk-Origin verweisen. Verwende für jede diese Einstellungen:
Viewer-Protokollrichtlinie: HTTP zu HTTPS umleiten
Zulässige HTTP-Methoden: GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
Cache-Richtlinie: CachingDisabled
Origin-Request-Richtlinie: AllViewerExceptHostHeader
Für deine Website bleibt die Verhaltensweise Default (*) bestehen. Warte, bis die Bereitstellung der Distribution abgeschlossen ist.
Wenn du die Distribution mit CloudFormation verwaltest, sehen dieselben Einstellungen so aus:
# Part of DistributionConfig in the AWS::CloudFront::Distribution resource
Origins:
- Id: ferndesk
DomainName: PROXY_HOST
CustomOriginConfig:
OriginProtocolPolicy: https-only
OriginSSLProtocols: [TLSv1.2]
OriginCustomHeaders:
- HeaderName: X-Ferndesk-Base-Path
HeaderValue: /help
- HeaderName: X-Ferndesk-Original-Host
HeaderValue: www.yourcompany.com
# ...your site's existing origin stays here
CacheBehaviors:
- PathPattern: /help
TargetOriginId: ferndesk
ViewerProtocolPolicy: redirect-to-https
AllowedMethods: [GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE]
CachedMethods: [GET, HEAD]
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad # CachingDisabled
OriginRequestPolicyId: b689b0a8-53d0-40ab-baf2-68738e2966ac # AllViewerExceptHostHeader
- PathPattern: /help/*
TargetOriginId: ferndesk
ViewerProtocolPolicy: redirect-to-https
AllowedMethods: [GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE]
CachedMethods: [GET, HEAD]
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad
OriginRequestPolicyId: b689b0a8-53d0-40ab-baf2-68738e2966ac
- PathPattern: /_ferndesk/*
TargetOriginId: ferndesk
ViewerProtocolPolicy: redirect-to-https
AllowedMethods: [GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE]
CachedMethods: [GET, HEAD]
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad
OriginRequestPolicyId: b689b0a8-53d0-40ab-baf2-68738e2966acWofür die einzelnen Einstellungen verwendet werden:
AllViewerExceptHostHeader leitet Cookies, Abfragezeichenfolgen und Header an Ferndesk weiter und sendet den Proxy-Host als
Host-Header. Wenn CloudFront stattdessen deinen eigenenHost-Header weiterleitet, schlägt jede Seite mit einem 403- oder 502-Fehler fehl.X-Forwarded-Hostmusst du nicht senden: Diese Aufgabe übernimmt der HeaderX-Ferndesk-Original-Host.Alle HTTP-Methoden werden benötigt, weil bei der Anmeldung, den KI-Antworten und dem Feedbackformular
POST-Anfragen unter/helpgesendet werden.CachingDisabled sorgt dafür, dass Seiten für angemeldete Leser privat bleiben. Ferndesk legt eigene Cache-Header fest.
X-Ferndesk-Base-Path teilt Ferndesk deinen Pfad mit. So erreichen Anfragen Ferndesk weiterhin mit
/helpim Pfad und Links bleiben unter/help.
Diese Einrichtung folgt der CloudFront-Dokumentation von AWS. Wir haben sie nicht selbst mit CloudFront getestet. Wenn also etwas nicht funktioniert, schreib an [email protected] und sende uns deine Konfiguration sowie die Adresse, bei der das Problem auftritt.
Überprüfe, ob alles funktioniert
Rufe https://www.yourcompany.com/help auf. Dein Hilfe-Center sollte mit seinen Formatierungen geladen werden, und Links zwischen Artikeln sollten auf deiner Domain bleiben. Falls etwas nicht stimmt, findest du unter Fehlerbehebung für dein Hilfe-Center weitere Informationen.
Häufige Fragen
Meine Website liegt noch nicht hinter CloudFront
Kann ich stattdessen einen Application Load Balancer verwenden?
Nicht allein. Ein Load Balancer kann Anfragen nur an deine eigenen Server, private IP-Adressen oder Lambda-Funktionen senden, nicht an einen öffentlichen Hostnamen wie den Proxy-Host. Schalte CloudFront davor oder führe Nginx auf deinen Servern aus und folge der Nginx-Anleitung.
Das Hilfe-Center wird ohne Formatierungen geladen
Die Verhaltensweise /_ferndesk/* fehlt oder verweist auf den Origin deiner Website. Sie stellt die Skripte und Formatierungen des Hilfe-Centers im Stammverzeichnis deiner Domain bereit.
Auf jeder Seite wird ein 403- oder 502-Fehler angezeigt
CloudFront leitet den Host-Header deiner Website weiter. Lege für alle drei Verhaltensweisen die Origin-Request-Richtlinie AllViewerExceptHostHeader und nicht AllViewer fest.
Informationen zu Subdomains oder anderen Hosts findest du unter Eine benutzerdefinierte Domain mit deinem Hilfe-Center verbinden.