---
title: AWS Route 53 y CloudFront
description: "Enruta el tráfico de /docs con AWS CloudFront y Route 53 hacia tu sitio Jamdesk. Incluye configuración de distribución, origen y reglas de caché."
---

Configura una distribución de CloudFront para reenviar `/docs/*` a tu sitio de Jamdesk, con Route 53 para DNS. Tarda aproximadamente 15 minutos.

## Requisitos previos

- Una cuenta de AWS con acceso a CloudFront y Route 53
- Tu dominio gestionado en Route 53 (o capacidad para actualizar el DNS en otro lugar)
- Tu subdominio de Jamdesk (disponible en la configuración del dashboard)

## Paso 1: Crear una distribución de CloudFront

1. Abre la [consola de CloudFront](https://console.aws.amazon.com/cloudfront/)
2. Haz clic en **Create Distribution**
3. Configura el origen:

| Configuración | Valor |
|---------|-------|
| Origin domain | `YOUR_SLUG.jamdesk.app` |
| Protocol | HTTPS only |
| Name | `jamdesk-docs-origin` |

<Note>
Reemplaza `YOUR_SLUG` con tu subdominio real de Jamdesk.
</Note>

## Paso 2: Configurar los ajustes del origen

En los ajustes del origen, añade encabezados personalizados para identificar tu dominio:

| Nombre del encabezado | Valor |
|-------------|-------|
| `X-Forwarded-Host` | `yoursite.com` |
| `X-Jamdesk-Forwarded-Host` | `yoursite.com` |

Estos encabezados indican a Jamdesk qué dominio está realizando la solicitud. El encabezado `X-Jamdesk-Forwarded-Host` es obligatorio para la verificación del dominio.

<Warning>
Tu dominio debe estar verificado en el dashboard de Jamdesk antes de que CloudFront pueda servir contenido. Completa el proceso de verificación DNS después de añadir tu dominio.
</Warning>

## Paso 3: Crear comportamientos de caché

Añade comportamientos para enrutar `/docs/*` y las solicitudes de recursos hacia tu origen de Jamdesk:

1. Ve a la pestaña **Behaviors**
2. Haz clic en **Create Behavior**
3. Crea tres comportamientos con estos ajustes:

| Patrón de ruta | Origen | Política de caché | Política de solicitud al origen |
|-------------|--------|-------------|----------------------|
| `/docs/*` | `jamdesk-docs-origin` | CachingOptimized | AllViewerExceptHostHeader |
| `/_next/*` | `jamdesk-docs-origin` | CachingOptimized | AllViewerExceptHostHeader |
| `/_jd/*` | `jamdesk-docs-origin` | CachingOptimized | AllViewerExceptHostHeader |

Establece la **Viewer protocol policy** en **Redirect HTTP to HTTPS** para los tres.

<Note>
Los comportamientos `/_next/*` y `/_jd/*` son necesarios para que los recursos estáticos de Next.js (JS, CSS) y los recursos de Jamdesk (fuentes, imágenes, branding) se carguen correctamente.
</Note>

<Warning>
La política `AllViewerExceptHostHeader` es obligatoria. Reenvía todos los encabezados excepto `Host`, lo que permite a Jamdesk recibir la información de solicitud necesaria.
</Warning>

## Paso 4: Añadir nombre de dominio alternativo

1. En la pestaña **General**, haz clic en **Edit**
2. En **Alternate domain name (CNAME)**, añade `yoursite.com`
3. Selecciona o solicita un certificado SSL para tu dominio

## Paso 5: Configurar Route 53

Crea un registro de alias que apunte a tu distribución de CloudFront:

1. Abre la [consola de Route 53](https://console.aws.amazon.com/route53/)
2. Selecciona tu zona alojada
3. Haz clic en **Create Record**
4. Configura:

| Configuración | Valor |
|---------|-------|
| Record name | `yoursite.com` (o déjalo en blanco para el apex) |
| Record type | A |
| Alias | Yes |
| Route traffic to | CloudFront distribution |
| Distribution | Selecciona tu distribución |

## Paso 6: Verificar

Tras la propagación DNS (normalmente entre 5 y 15 minutos), visita `https://yoursite.com/docs` para confirmar que tu documentación se carga correctamente.

## Resumen completo de la configuración de CloudFront

```bash
Distribution Settings:
├── Origin: YOUR_SLUG.jamdesk.app
│   ├── Custom Header: X-Forwarded-Host = yoursite.com
│   └── Custom Header: X-Jamdesk-Forwarded-Host = yoursite.com
├── Behavior: /docs/*
│   ├── Cache Policy: CachingOptimized
│   └── Origin Request Policy: AllViewerExceptHostHeader
├── Behavior: /_next/*
│   ├── Cache Policy: CachingOptimized
│   └── Origin Request Policy: AllViewerExceptHostHeader
├── Behavior: /_jd/*
│   ├── Cache Policy: CachingOptimized
│   └── Origin Request Policy: AllViewerExceptHostHeader
└── Alternate Domain: yoursite.com (with SSL certificate)
```

## Solución de problemas

<Accordion title="Errores 403 Forbidden">
Asegúrate de que el dominio de origen sea exactamente `YOUR_SLUG.jamdesk.app` sin el prefijo `https://`.
</Accordion>

<Accordion title="Advertencias de contenido mixto">
Verifica que la política de protocolo del visor esté configurada como "Redirect HTTP to HTTPS" y que tu certificado SSL sea válido.
</Accordion>

<Accordion title="Contenido desactualizado tras actualizaciones">
Crea una invalidación de CloudFront para `/docs/*` para borrar el contenido en caché tras publicar cambios.
</Accordion>

<Accordion title="Error 403: dominio no autorizado">
Si ves "Domain is not authorized to serve this content":

1. Verifica que tu dominio esté registrado en el dashboard de Jamdesk
2. Completa la verificación DNS (registro TXT) para tu dominio
3. Asegúrate de que los encabezados personalizados `X-Forwarded-Host` y `X-Jamdesk-Forwarded-Host` estén configurados en tu configuración de origen
4. Comprueba que tu dominio esté asignado al proyecto correcto

El dominio debe estar verificado antes de que CloudFront pueda servir la documentación.
</Accordion>

## ¿Qué sigue?

<Columns cols={3}>
  <Card title="Descripción general del despliegue" icon="cloud-arrow-up" href="/es/deploy/overview">
    Comparar opciones de alojamiento
  </Card>
  <Card title="Alojamiento en subruta" icon="folder-tree" href="/es/deploy/subpath-hosting">
    Servir documentación en /docs
  </Card>
  <Card title="Dominios personalizados" icon="globe" href="/es/deploy/custom-domains">
    Verificar DNS y solucionar problemas
  </Card>
</Columns>