Crea una distribución con tu host actual como origen para el comportamiento Predeterminado (*), añade el origen y los comportamientos de Ferndesk anteriores, y añade tu dominio con un certificado SSL de AWS Certificate Manager en la región de EE. UU. Este (Norte de Virginia). Luego apunta tu dominio a la distribución, por ejemplo, con un registro de alias en Route 53.
Coloca tu centro de ayuda en una subcarpeta con AWS CloudFront
Publica tu centro de ayuda en una ruta de un sitio que use Amazon CloudFront, como yourcompany.com/help, añadiendo Ferndesk como segundo origen con tres comportamientos de caché y una pequeña función de CloudFront. Tu dominio ya debe apuntar a la distribución de CloudFront.
Requiere un método de pago registrado; una prueba con tarjeta cumple este requisito. Los propietarios y administradores pueden cambiar esta opción.
Configúralo
Configura la subcarpeta en Ferndesk
En Centro de ayuda > Personalizar > Dominio personalizado, elige Subcarpeta personalizada, introduce el dominio de tu sitio y una ruta como /help, y haz clic en Configurar subdirectorio. Copia el Host del proxy que te mostramos (tiene un aspecto como yourcompany.hc.ferndesk.com). Los ejemplos siguientes usan /help y www.yourcompany.com; sustitúyelos por los tuyos.
Crea la función
En CloudFront > Funciones, crea una función con el entorno de ejecución cloudfront-js-2.0, pega el código siguiente y publícala. Esta función elimina /help de la ruta antes de que la solicitud llegue a Ferndesk. Si usas otra ruta, cambia help en el código.
function handler(event) {
var request = event.request;
request.uri = request.uri.replace(/^\/help/, '') || '/';
return request;
}Añade Ferndesk como origen
En la pestaña Orígenes de tu distribución, crea un origen con el host del proxy como dominio de origen y establece el protocolo en Solo HTTPS. Añádele dos encabezados personalizados: X-Ferndesk-Base-Path con tu ruta y X-Ferndesk-Original-Host con el host de tu sitio, como www.yourcompany.com.
Añade tres comportamientos
En la pestaña Comportamientos, crea un comportamiento para cada una de estas rutas: /help, /help/* y /_ferndesk/*; todos deben apuntar al origen de Ferndesk. Configura cada uno con estos ajustes:
Política del protocolo del visitante: Redirigir HTTP a HTTPS
Métodos HTTP permitidos: GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
Política de caché: CachingDisabled
Política de solicitud al origen: AllViewerExceptHostHeader
En los comportamientos /help y /help/*, en Asociaciones de funciones, asocia la función como función de Solicitud del visitante. No la asocies a /_ferndesk/*. Tu sitio conserva el comportamiento Predeterminado (*). Espera a que termine de implementarse la distribución.
Si administras la distribución con CloudFormation, los mismos ajustes se verían así:
# 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-68738e2966acPara qué sirve cada ajuste:
AllViewerExceptHostHeader reenvía las cookies, las cadenas de consulta y los encabezados a Ferndesk, y envía el host del proxy como encabezado
Host. Si CloudFront reenvía en su lugar tu propio encabezadoHost, todas las páginas mostrarán un error 403 o 502. No necesitas enviarX-Forwarded-Host: el encabezadoX-Ferndesk-Original-Hostcumple esa función.Se necesitan todos los métodos HTTP porque el inicio de sesión, las respuestas de IA y el formulario de comentarios envían solicitudes
POSTdentro de/help.CachingDisabled mantiene privadas las páginas para los lectores que iniciaron sesión. Ferndesk establece sus propios encabezados de caché.
Se necesita la función porque Ferndesk espera rutas sin
/help. Sin ella, los artículos se cargan, pero no funcionan el inicio de sesión, los comentarios, las respuestas de IA ni el mapa del sitio.
Esta configuración sigue la documentación de CloudFront de AWS. No la hemos probado nosotros en CloudFront; si algo no funciona, escribe a [email protected] e incluye tu configuración y la dirección que falla.
Comprueba que funcione
Abre https://www.yourcompany.com/help. Tu centro de ayuda debería cargarse con sus estilos, y los enlaces entre artículos deberían permanecer en tu dominio. Si algo no funciona bien, consulta Solucionar problemas del centro de ayuda.
Preguntas frecuentes
Mi sitio aún no usa CloudFront
¿Puedo usar un Application Load Balancer en su lugar?
No por sí solo. Un balanceador de carga solo puede enviar solicitudes a tus propios servidores, direcciones IP privadas o funciones de Lambda, no a un nombre de host público como el host del proxy. Coloca CloudFront delante o ejecuta Nginx en tus servidores y sigue la guía de Nginx.
El centro de ayuda se carga sin estilos
Falta el comportamiento /_ferndesk/* o apunta al origen de tu sitio. Este comportamiento sirve los scripts y estilos del centro de ayuda desde la raíz de tu dominio.
Todas las páginas muestran un error 403 o 502
CloudFront está reenviando el encabezado Host de tu sitio. Configura la política de solicitud al origen como AllViewerExceptHostHeader en los tres comportamientos, no como AllViewer.
Si prefieres usar un subdominio o quieres conectar otros hosts, consulta Conectar un dominio personalizado a tu centro de ayuda.