Configurar nombres y TLS
Tu servidor de Excubius responde a un nombre principal y a cualquier cantidad de alias, y sirve HTTPS en uno de seis modos, desde un certificado de Let's Encrypt hasta una puerta de enlace que termina TLS delante de él. Las respuestas del instalador fijan los primeros valores. Después los cambias en la consola, y el cambio se aplica en menos de un minuto sin reiniciar. Esta guía muestra cómo elegirlos y cambiarlos.
Antes de empezar
- Para cambiar los nombres y TLS en la consola, necesitas el rol Superadministrador.
- Para trabajar desde el servidor, necesitas acceso SSH y
sudo, para poder actuar como la cuenta de servicio (excubiusde forma predeterminada). - Crea primero los registros DNS. Cada nombre debe resolverse al servidor, o a la puerta de enlace que tiene delante, desde donde las personas usarán Excubius.
Los tres tipos de nombre
| Nombre | Qué es |
|---|---|
| Nombre principal | El nombre de host de la dirección pública, por ejemplo monitoring.ciguapa.example. Los enlaces que envía Excubius, en los mensajes de Slack y en las incidencias de Jira, lo usan. El inicio de sesión siempre ocurre en él: a quien abre un alias se le envía al nombre principal para iniciar sesión |
| Alias | Otros nombres que las personas pueden abrir, por ejemplo monitoring.areito.example en un dominio que controlas cuando la zona DNS del cliente está fuera de tu alcance. El servidor responde a todos ellos |
| Nombres del certificado | Los nombres para los que se solicita un certificado. De forma predeterminada, todos los nombres, y los alias nuevos se agregan automáticamente. Desmarca un nombre que un certificado no pueda cubrir, por ejemplo uno cuyo DNS no controlas |
Un servidor tiene como máximo 100 nombres en total.
Las direcciones de redirección registradas para el inicio de sesión con Microsoft Entra ID y Google empiezan por el nombre principal. Cuando cambies el nombre principal, actualízalas primero; consulta Configurar proveedores de inicio de sesión.
Elegir un modo
| Modo en la consola | Respuesta del instalador | Úsalo cuando |
|---|---|---|
| Let's Encrypt por HTTP | letsencrypt | Todos los nombres del certificado están en el DNS público apuntando a este servidor, y el puerto 80 es accesible desde internet, directamente o reenviado por un NAT o una puerta de enlace |
| Let's Encrypt por DNS | letsencrypt-dns | Tienes credenciales de API para la zona DNS de los nombres. El servidor no necesita ser accesible desde internet, por eso es la opción habitual para un servidor al que se llega por VPN |
| Autofirmado | selfsigned | En cualquier lugar. Los navegadores muestran una advertencia hasta que las personas confían en el certificado en sus computadoras y teléfonos |
| Certificado propio | custom | Tu organización emite certificados. Pegas la cadena y la clave, y las reemplazas antes de que venzan |
| Pasarela delante | gateway | Un equilibrador de carga o un proxy inverso, como Azure Application Gateway o Front Door, termina TLS y reenvía HTTP sin cifrar. Se respeta su encabezado X-Forwarded-Proto |
| HTTP sin cifrar | later | Una primera prueba, o una red en la que confías por completo. Nada se cifra |
Cambiar los nombres o el modo en la consola
- Abre Configuración y selecciona Servidor y certificados. También puedes llegar desde Configuración › Instancia con Nombres del servidor y HTTPS.
- En Nombres, revisa el Nombre principal. Para agregar un alias, escríbelo y selecciona Agregar; para quitar uno, selecciona Quitar junto a él.
- En HTTPS, elige el modo y completa lo que pide. Las secciones siguientes describen cada uno.
- En Nombres del certificado, desmarca los nombres que un certificado no pueda cubrir.
- Selecciona Aplicar. La página muestra Guardado. El servicio de certificados lo está aplicando.
En Certificado actual ves lo que se está sirviendo: el emisor, los nombres, Válida hasta, el Último intento con su resultado y la Próxima comprobación. Si un intento falla, Qué falló lo explica.
Cada cambio se valida antes de guardarse y se escribe en el registro de auditoría.
Let's Encrypt por HTTP
Escribe el Correo de la cuenta de Let's Encrypt. Antes de aplicar, asegúrate de que todos los nombres del certificado se resuelvan públicamente al servidor y de que el puerto 80 esté abierto desde internet. Un nombre que no puede ser público, como una dirección IP o un nombre que termina en .local, .internal o .corp, se rechaza: desmárcalo o usa un certificado autofirmado.
Let's Encrypt por DNS
-
Escribe el Correo de la cuenta de Let's Encrypt.
-
Elige el Proveedor de DNS de la zona de los nombres. Para un proveedor que no esté en la lista, elige Otro (id de dnsapi de acme.sh) y escribe su id de
dnsapide acme.sh. -
En Credenciales de la API, escribe los valores que lee el proveedor. La consola los enumera para cada proveedor:
Proveedor Id de dnsapiVariables Cloudflare dns_cfCF_Token,CF_Account_IDDreamHost dns_dreamhostDH_API_KEYAzure DNS dns_azureAZUREDNS_SUBSCRIPTIONID,AZUREDNS_TENANTID,AZUREDNS_APPID,AZUREDNS_CLIENTSECRETAmazon Route 53 dns_awsAWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEYGoDaddy dns_gdGD_Key,GD_SecretDigitalOcean dns_dgonDO_API_KEYGandi dns_gandi_livednsGANDI_LIVEDNS_TOKENHetzner dns_hetznercloudHETZNER_TOKENIONOS dns_ionosIONOS_PREFIX,IONOS_SECRETLinode (Akamai) dns_linode_v4LINODE_V4_API_KEYNamecheap dns_namecheapNAMECHEAP_USERNAME,NAMECHEAP_API_KEY,NAMECHEAP_SOURCEIPOVHcloud dns_ovhOVH_END_POINT,OVH_AK,OVH_AS,OVH_CKPorkbun dns_porkbunPORKBUN_API_KEY,PORKBUN_SECRET_API_KEY -
Si quieres, establece Servidor de Let's Encrypt en Pruebas para ensayar sin afectar los límites de frecuencia de Let's Encrypt. Los navegadores no confían en los certificados de prueba; vuelve a Producción cuando funcione.
Los valores de las credenciales son de solo escritura: se guardan cifrados y no se vuelven a mostrar. Para conservar un valor guardado cuando editas la configuración, deja su campo vacío.
Autofirmado
No hay nada que escribir. El certificado es válido durante 825 días y se renueva igual que los demás. Para evitar las advertencias del navegador, selecciona Descargar el certificado e instálalo como de confianza en las computadoras y los teléfonos que usan el servidor.
Certificado propio
Pega la Cadena de certificados en formato PEM, con el certificado del servidor primero, y la Clave privada en formato PEM sin frase de contraseña. La clave debe ser RSA de 2048 bits o más, o ECDSA. La consola rechaza un certificado vencido, que no cubre los nombres del servidor o cuya clave no coincide. Reemplaza ambos antes de que el certificado venza; Excubius no lo renueva por ti.
Pasarela delante
No hay nada que escribir. Configura la puerta de enlace para que reenvíe HTTP sin cifrar al puerto 80 del servidor y envíe el encabezado X-Forwarded-Proto.
Renovación
La renovación es automática para los certificados de Let's Encrypt y los autofirmados. El servicio de certificados revisa el certificado activo cada día y lo renueva cuando le quedan 30 días o menos. No hay que configurar ningún temporizador en el servidor.
- Un intento fallido nunca quita lo que funciona. Se sigue sirviendo el certificado anterior, o HTTP sin cifrar; el error aparece en la página con la hora del próximo reintento, primero a los 15 minutos y luego con el doble de espera cada vez, hasta un día.
- Un cambio de la configuración se intenta de inmediato.
- Renovar ahora solicita un certificado nuevo de inmediato.
- Usar autofirmado ahora cambia a un certificado autofirmado, la forma rápida de tener HTTPS mientras Let's Encrypt todavía no puede funcionar.
Las cookies de sesión se marcan como Secure siempre que una solicitud llega por HTTPS, así que cambiar de modo no requiere reiniciar. Deja COOKIE_SECURE vacío en el archivo de configuración; solo fuerza el comportamiento en un sentido o en el otro.
Las direcciones /healthz y /heartbeat responden por HTTP sin cifrar en todos los modos, así que un vigilante externo sigue funcionando mientras cambias TLS.
Cambiar TLS desde el servidor
Cuando la consola no está a tu alcance, por ejemplo porque el certificado está dañado y el navegador rechaza la página, cambia la misma configuración desde el servidor. El script pasa por las mismas validaciones y el mismo registro de auditoría que la consola.
-
Conéctate por SSH y cambia a la cuenta de servicio:
sudo -iu excubius -
Muestra la configuración y el certificado actuales:
/opt/excubius/current/scripts/enable-tls.sh --status -
Cambia lo que necesites. Por ejemplo, cambia a un certificado autofirmado:
/opt/excubius/current/scripts/enable-tls.sh --mode selfsignedO usa Let's Encrypt por DNS con Cloudflare, con dos nombres y un certificado solo para el segundo. Las credenciales se leen como líneas
KEY=VALUEdesde la entrada estándar:/opt/excubius/current/scripts/enable-tls.sh --mode letsencrypt-dns \--email ops@areito.example --dns-provider dns_cf \--names "monitoring.ciguapa.example monitoring.areito.example" \--cert-names monitoring.areito.example < credentials.txt -
Para renovar de inmediato, ejecuta
enable-tls.sh --renew.
Reemplaza /opt/excubius si elegiste otro directorio de instalación. Ejecuta enable-tls.sh --help para ver todas las opciones, incluidas --staging y --production. Un certificado propio solo se puede cargar desde la consola.
Cambiar las respuestas con el instalador
sudo ./install.sh --reconfigure vuelve a hacer todas las preguntas. Las respuestas de TLS que des entonces se aplican a la plataforma en ejecución, como si las hubieras cambiado en la consola.