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 und hinterlege deine Domain mit einem SSL-Zertifikat aus dem AWS Certificate Manager in der Region US East (N. Virginia). Verweise dann deine Domain auf die Distribution, zum Beispiel mit einem Alias-Eintrag in Route 53.
Help Center mit AWS CloudFront in einem Unterordner bereitstellen
Stelle dein Help 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 und einer kleinen CloudFront Function hinzu. Deine Domain muss bereits auf die CloudFront-Distribution verweisen.
Hierfür muss eine Zahlungsmethode hinterlegt sein. Eine Testphase mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Administratoren können dies ändern.
Einrichten
Unterordner in Ferndesk festlegen
Gehe zu Help Center > Anpassen > Benutzerdefinierte Domain, wähle Benutzerdefinierter Unterordner, gib die Domain deiner Website und einen Pfad wie /help ein und klicke auf Unterverzeichnis konfigurieren. Kopiere den angezeigten Proxy-Host (er sieht etwa so aus: yourcompany.hc.ferndesk.com). Die folgenden Beispiele verwenden /help und www.yourcompany.com; ersetze sie durch deine eigenen Werte.
Funktion erstellen
Gehe zu CloudFront > Functions, erstelle eine Funktion mit der Laufzeit cloudfront-js-2.0, füge den folgenden Code ein und veröffentliche die Funktion. Sie entfernt /help aus dem Pfad, bevor die Anfrage Ferndesk erreicht. Wenn du einen anderen Pfad verwendest, ändere help im Code.
function handler(event) {
var request = event.request;
request.uri = request.uri.replace(/^\/help/, '') || '/';
return request;
}Ferndesk als Origin hinzufügen
Erstelle im Tab Origins deiner Distribution einen Origin mit dem Proxy-Host als Origin-Domain und dem Protokoll HTTPS only. 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.
Drei Verhaltensweisen hinzufügen
Erstelle im Tab Behaviors für jeden dieser Pfade eine Verhaltensweise: /help, /help/* und /_ferndesk/*. Sie müssen alle auf den Ferndesk-Origin verweisen. Verwende für jede Verhaltensweise folgende Einstellungen:
Viewer-Protokollrichtlinie: HTTP zu HTTPS umleiten
Zulässige HTTP-Methoden: GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
Cache-Richtlinie: CachingDisabled
Origin-Anfragerichtlinie: AllViewerExceptHostHeader
Füge unter Function associations bei den Verhaltensweisen /help und /help/* die Funktion als Viewer request-Funktion hinzu. Lass sie bei /_ferndesk/* weg. 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:
# The function (a separate resource in the same template)
FerndeskStripHelp:
Type: AWS::CloudFront::Function
Properties:
Name: ferndesk-strip-help
AutoPublish: true
FunctionConfig:
Comment: Remove /help before forwarding to Ferndesk
Runtime: cloudfront-js-2.0
FunctionCode: |
function handler(event) {
var request = event.request;
request.uri = request.uri.replace(/^\/help/, '') || '/';
return request;
}
# 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
FunctionAssociations:
- EventType: viewer-request
FunctionARN: !GetAtt FerndeskStripHelp.FunctionMetadata.FunctionARN
- 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
FunctionAssociations:
- EventType: viewer-request
FunctionARN: !GetAtt FerndeskStripHelp.FunctionMetadata.FunctionARN
- 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-68738e2966acWozu die einzelnen Einstellungen dienen:
AllViewerExceptHostHeader leitet Cookies, Abfragezeichenfolgen und Header an Ferndesk weiter und sendet den Proxy-Host als
Host-Header. Wenn CloudFront stattdessen deinen eigenenHost-Header weiterleitet, schlagen alle Seiten mit einem Fehler 403 oder 502 fehl. Du musstX-Forwarded-Hostnicht senden: Diese Aufgabe übernimmt der HeaderX-Ferndesk-Original-Host.Alle HTTP-Methoden sind erforderlich, da Anmeldung, KI-Antworten und das Feedbackformular
POST-Anfragen unter/helpsenden.CachingDisabled sorgt dafür, dass Seiten für angemeldete Leser privat bleiben. Ferndesk legt die Cache-Header selbst fest.
Die Funktion ist erforderlich, da Ferndesk Pfade ohne
/helperwartet. Ohne sie werden Artikel zwar geladen, aber Anmeldung, Feedback, KI-Antworten und die Sitemap funktionieren nicht.
Diese Einrichtung folgt der CloudFront-Dokumentation von AWS. Wir haben sie selbst nicht mit CloudFront getestet. Sollte etwas nicht funktionieren, sende eine E-Mail mit deiner Konfiguration und der fehlerhaften Adresse an [email protected].
Funktion überprüfen
Rufe https://www.yourcompany.com/help auf. Dein Help Center sollte mit der richtigen Gestaltung geladen werden und Links zwischen Artikeln sollten auf deiner Domain bleiben. Falls etwas nicht stimmt, lies den Artikel Probleme mit deinem Help Center beheben.
Häufige Fragen
Meine Website läuft noch nicht über 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 Help Center wird ohne Gestaltung geladen
Die Verhaltensweise /_ferndesk/* fehlt oder verweist auf den Origin deiner Website. Über sie werden die Skripte und Styles des Help Centers aus dem Stammverzeichnis deiner Domain bereitgestellt.
Auf jeder Seite wird ein Fehler 403 oder 502 angezeigt
CloudFront leitet den Host-Header deiner Website weiter. Lege für alle drei Verhaltensweisen die Origin-Anfragerichtlinie AllViewerExceptHostHeader fest, nicht AllViewer.
Wenn du stattdessen eine Subdomain oder andere Hosts verwenden möchtest, lies Benutzerdefinierte Domain mit deinem Help Center verbinden.