Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Habilitar el aislamiento de subdominio

Puedes configurar el aislamiento de subdominio para separar en forma segura el contenido suministrado por el usuario de las demás partes de tu aparato GitHub Enterprise Server.

Acerca del aislamiento de subdominio

El aislamiento de subdominio mitiga las vulnerabilidades del estilo cross-site scripting y otras vulnerabilidades relacionadas. Para obtener más información, consulta "Cross-site scripting" en Wikipedia. Es altamente recomendable que habilites el aislamiento de subdominio en tu instancia de GitHub Enterprise Server.

Cuando el aislamiento de subdominio está habilitado, GitHub Enterprise Server reemplaza varias rutas con subdominios. Después de haber habilitado el aislamiento de subdominios, los intentos para acceder a las rutas anteriores para encontrar algo del contenido que proporcionaron los usuarios, tal como http(s)://HOSTNAME/raw/, podría devolver errores de tipo 404.

Para utilizar Docker con Registro del paquete de GitHub, también debes habilitar el aislamiento de los subdominios. Para obtener más información, consulta la sección "Trabajar con el registro de Docker".

Nota: El Registro del paquete de GitHub se encuentra actualmente en beta para GitHub Enterprise Server 2.22. Para unirte al beta de tu instancia de GitHub Enterprise Server, utiliza el formato de registro.

Ruta sin aislamiento de subdominioRuta con aislamiento de subdominio
http(s)://HOSTNAME/assets/http(s)://assets.HOSTNAME/
http(s)://HOSTNAME/avatars/http(s)://avatars.HOSTNAME/
http(s)://HOSTNAME/codeload/http(s)://codeload.HOSTNAME/
http(s)://HOSTNAME/gist/http(s)://gist.HOSTNAME/
http(s)://HOSTNAME/media/http(s)://media.HOSTNAME/
http(s)://HOSTNAME/pages/http(s)://pages.HOSTNAME/
http(s)://HOSTNAME/raw/http(s)://raw.HOSTNAME/
http(s)://HOSTNAME/render/http(s)://render.HOSTNAME/
http(s)://HOSTNAME/reply/http(s)://reply.HOSTNAME/
http(s)://HOSTNAME/uploads/http(s)://uploads.HOSTNAME/
N/A, Docker, en conjunto con el Registro del paquete de GitHub no funcionará con el aislamiento de subdominios inhabilitado para el Registro del paquete de GitHub 2.22 beta.http(s)://docker.HOSTNAME/

Prerrequisitos

Advertencia: si se inhabilita el aislamiento de subdominios, recomendamos que también inhabilites Páginas de GitHub en tu empresa. No habrá forma de aislar el contenido de Páginas de GitHub que suministre un usuario del resto de los datos de tu empresa. Para obtener más información, consulta la sección "Configurar Páginas de GitHub para tu empresa".

Antes de que habilites el aislamiento de subdominio, debes configurar tus ajustes de red para el nuevo dominio.

  • Especifica un nombre de dominio válido como tu nombre del host, en lugar de una dirección IP. Para obtener más información, consulta "Configurar un nombre del host."

Advertencia: No cambies el nombre de host para GitHub Enterprise Server después de la configuración inicial. Cambiar el nombre del host ocasionará un comportamiento inesperado que puede incluir y llegar hasta la interrupción del servicio.

  • Configura un registro de Sistema de nombres de dominio (DNS) de carácter comodín o registros DNS individuales para los subdominios detallados más arriba. Recomendamos crear un registro A para *.HOSTNAME que apunte a la dirección IP de tu servidor así no tienes que crear múltiples registros para cada subdominio.
  • Obtén un certificado de Seguridad de la capa de transporte (TLS) de carácter comodín para *.HOSTNAME con un Nombre alternativo del firmante (SAN) para el HOSTNAME y para el *.HOSTNAME de dominio de carácter comodín. Por ejemplo, si tu nombre del host es *.github.octoinc.com obtén un certificado con el valor del nombre común configurado en *.github.octoinc.com y un valor SAN configurado en github.octoinc.com y *.github.octoinc.com.
  • Habilita TLS en tu aparato. Para obtener más información, consulta "Configurar TLS."

Habilitar el aislamiento de subdominio

  1. Desde una cuenta administrativa en GitHub Enterprise Server, da clic en la esquina superior derecha de cualquier página. Ícono de cohete para acceder a las configuraciones de administrador del sitio
  2. En la barra lateral izquierda, haz clic en Consola de administración. pestaña Consola de administración en la barra lateral izquierda
  3. En la barra lateral izquierda, da clic en Nombre de Host. Pestaña de nombre de host en la barra lateral
  4. Selecciona Subdomain isolation (recommended) (Aislamiento de subdominio [recomendado]). Casilla de verificación para habilitar el aislamiento de subdominio
  5. Debajo de la barra lateral izquierda, da clic en Guardar configuración. El botón de guardar en la Consola de administración
  6. Espera a que la configuración se ejecute por completo.