Configurar TLS
Puedes configurar la Seguridad de la capa de transporte (TLS) en tu instancia de servidor de GitHub Enterprise para poder usar un certificado firmado por una entidad de certificación confiable.
En este artículo
- Acerca de la Seguridad de la capa de transporte
- Prerrequisitos
- Cargar un certificado TLS personalizado
- Acerca de la asistencia de Let's Encrypt
- Configurar TLS usando Let's Encrypt
Acerca de la Seguridad de la capa de transporte
El TLS, que reemplazó al SSL, se habilita y configura con un certificado autofirmado cuando se inicia el Servidor de GitHub Enterprise por primera vez. Como los certificados autofirmados no son confiables para los navegadores web y los clientes de Git, estos clientes informarán advertencias de certificados hasta que inhabilites TLS o cargues un certificado firmado por una entidad confiable, como Let's Encrypt.
El aparato Servidor de GitHub Enterprise enviará encabezados de Seguridad de transporte estricta de HTTP mientras SSL esté habilitado. Inhabilitar TLS hará que los usuarios pierdan acceso al aparato, porque sus navegadores no permitirán que un protocolo se degrade a HTTP. Para obtener más información, consulta "Seguridad de transporte estricta de HTTP (HSTS)" en Wikipedia.
Warning: When terminating HTTPS connections on a load balancer, the requests from the load balancer to Servidor de GitHub Enterprise also need to use HTTPS. Downgrading the connection to HTTP is not supported.
Para permitir que los usuarios utilicen FIDO U2F para la autenticación de dos factores, debes habilitar TLS para tu instancia. Para obtener más información, consulta "Configurar autenticación de dos factores".
Prerrequisitos
Para utilizar TLS en la producción, debes tener un certificado en un formato de PEM no cifrado firmado por una entidad de certificación confiable.
Tu certificado también deberá tener configurados Nombres alternativos de sujeto para los subdominios detallados en "Habilitar aislamiento de subdominio" y deberá incluir toda la cadena de certificación si lo firmó una entidad de certificación intermedia. Para obtener más información, consulta "Nombre alternativo de sujeto" en Wikipedia.
Puedes generar una solicitud de firma de certificados (CSR) para tu instancia usando el comando ghe-ssl-generate-csr. Para obtener más información, consulta "utilidades de línea de comandos"
Cargar un certificado TLS personalizado
-
In the upper-right corner of any page, click .
-
En la barra lateral izquierda, haz clic en Consola de administración.
-
In the left sidebar, click Privacy.
-
Select TLS only (recommended).
-
En "TLS Protocol support" (Asistencia de protocolo TLS), selecciona los protocolos que quieres permitir.
-
En "Certificate" (Certificado), haz clic en Choose File (Elegir archivo) para elegir el certificado TLS o la cadena de certificación (en formato de PEM) que quieras instalar. Este archivo suele tener una extensión .pem, .crt o .cer.
-
En "Unencrypted key" (Clave no cifrada), haz clic en Choose File (Elegir archivo) para elegir la clave TLS (en formato de PEM) que quieras instalar. Ese archivo suele tener una extensión .key.
Advertencia: Tu clave TLS no debe tener contraseña. Para obtener más información, consulta "Eliminar la contraseña de tu archivo clave".
-
Under the left sidebar, click Save settings.
Acerca de la asistencia de Let's Encrypt
Let's Encrypt es una entidad de certificación pública que emite certificados TLS gratuitos y automáticos que son confiables para los navegadores que usan el protocolo ACME. De hecho, puedes obtener y renovar los certificados de Let's Encrypt para tu aparato sin la necesidad de realizar ningún mantenimiento manual.
To use Let's Encrypt automation, your appliance must be configured with a hostname that is publicly accessible over HTTP. The appliance must also be allowed to make outbound HTTPS connections.
Cuando habilites la automatización de la gestión de certificado TLS con Let's Encrypt, tu instancia de servidor de GitHub Enterprise se contactará con los servidores de Let's Encrypt para obtener un certificado. Para renovar un certificado, los servidores de Let's Encrypt deben validar el control del nombre de dominio configurado con las solicitudes HTTP entrantes.
También puedes usar la utilidad de la línea de comando ghe-ssl-acme en tu instancia de servidor de GitHub Enterprise para generar un certificado de Let's Encrypt de manera automática. Para obtener más información, consulta "Utilidades de la línea de comando."
Configurar TLS usando Let's Encrypt
To use Let's Encrypt automation, your appliance must be configured with a hostname that is publicly accessible over HTTP. The appliance must also be allowed to make outbound HTTPS connections.
-
In the upper-right corner of any page, click .
-
En la barra lateral izquierda, haz clic en Consola de administración.
-
In the left sidebar, click Privacy.
-
Select TLS only (recommended).
-
Selecciona Enable automation of TLS certificate management using Let's Encrypt (Habilitar la automatización de la gestión de certificado TLS con Let's Encrypt).
-
Under the left sidebar, click Save settings.
-
In the left sidebar, click Privacy.
-
Haz clic en Request TLS certificate (Solicitar certificado TLS).
-
Haz clic en Save configuration (Guardar configuración).