Encabezados del servidor

Es posible que quieras configurar encabezados de servidor adicionales por motivos de seguridad. Los encabezados se devuelven cuando un cliente solicita tu sitio de documentación.

Algunos encabezados del servidor se aplican a todo el dominio personalizado en el que se aloja tu documentación. Si el mismo dominio personalizado también sirve otro contenido (por ejemplo, un sitio de marketing o una aplicación en rutas distintas), estos encabezados también pueden afectar a esas áreas.

¿Cómo configurar los encabezados del servidor?

Para configurar los encabezados del servidor:

  • Abre Project Settings → Hosting & Domain.

  • En la tarjeta Server headers, edita la lista en línea:

    • Cada encabezado debe estar en una sola línea.

    • Cada encabezado debe tener el nombre y el valor separados por :.

    • No puedes modificar ciertos encabezados, como Cache-Control o Server.

    • Cualquier encabezado no válido se eliminará.

  • Haz clic en Save changes en el menú superior.

Los cambios pueden tardar hasta 5 minutos en surtir efecto.

Ejemplos de encabezados de seguridad

Estos son algunos encabezados de seguridad que quizá quieras aplicar.

Precaución

Asegúrate de comprender bien qué es cada encabezado. Usar los encabezados de forma incorrecta podría provocar que todo tu dominio personalizado quede dañado de forma irreversible. DeveloperHub no se hace responsable de ningún daño causado por una configuración incorrecta.

Strict-Transport-Security: max-age=31536000
X-Frame-Options: DENY
Referrer-Policy: no-referrer

Content Security Policy

La política de seguridad de contenido (CSP) se puede configurar mediante los encabezados del servidor.

Advertencia

La política de seguridad de contenido solo debe ser configurada por profesionales de la seguridad. Cualquier configuración incorrecta podría dañar tu sitio de documentación o limitar funciones. Además, es de esperar que debas seguir actualizando la política de seguridad de contenido a medida que DeveloperHub incorpore nuevas funciones.

Para habilitar estilos y scripts en línea, debes añadir una configuración de nonce para las directivas style-src y script-src. La configuración de nonce debe ser nonce-%NONCE%, donde nuestros servidores backend reemplazarán %NONCE% en cada sesión por un nonce aleatorio.

Un ejemplo de política de seguridad de contenido inicial para proyectos es:

default-src 'self';
script-src 'self' 'nonce-%NONCE%' https://*.developerhub.io;
style-src 'self' 'nonce-%NONCE%' https://cdnjs.cloudflare.com/ajax/libs/font-awesome/ https://*.developerhub.io;
base-uri 'self';
connect-src 'self' https://*.developerhub.io https://www.google-analytics.com;
img-src 'self' https://*.developerhub.io;
font-src 'self' https://cdnjs.cloudflare.com/ajax/libs/font-awesome/ https://fonts.gstatic.com;
frame-src 'self';
base-uri 'self';
object-src 'none';

Modifícala según lo necesites para tu seguridad y las necesidades de tu proyecto.

También puedes añadir nonce=%NONCE% en tu pie de página personalizado para aplicar estilos en las etiquetas head.

  Última actualización