Configurer les noms et TLS
Votre serveur Excubius répond à un nom principal et à un nombre quelconque d'alias, et sert HTTPS selon l'un des six modes possibles, d'un certificat Let's Encrypt à une passerelle qui termine TLS en amont. Les réponses données au programme d'installation définissent les premières valeurs. Ensuite, vous les modifiez dans la console, et la modification s'applique en moins d'une minute, sans redémarrage. Ce guide explique comment les choisir et les modifier.
Avant de commencer
- Pour modifier les noms et TLS dans la console, vous devez disposer du rôle Super admin.
- Pour travailler plutôt depuis le serveur, vous avez besoin d'un accès SSH et de
sudo, afin d'agir en tant que compte de service (excubiuspar défaut). - Créez d'abord les enregistrements DNS. Chaque nom doit se résoudre vers le serveur, ou vers la passerelle placée devant lui, depuis les emplacements où les personnes utiliseront Excubius.
Les trois types de noms
| Nom | Description |
|---|---|
| Primary name (nom principal) | Le nom d'hôte de l'adresse publique, par exemple monitoring.ciguapa.example. Les liens qu'envoie Excubius, dans les messages Slack et les tickets Jira, l'utilisent. La connexion se fait toujours sur ce nom : une personne qui ouvre un alias est redirigée vers le nom principal pour se connecter |
| Aliases (alias) | Les autres noms que les personnes peuvent ouvrir, par exemple monitoring.areito.example dans un domaine que vous contrôlez lorsque la zone DNS du client est hors de votre portée. Le serveur répond à tous ces noms |
| Names in the certificate (noms dans le certificat) | Les noms pour lesquels un certificat est demandé. Tous les noms par défaut, et les nouveaux alias s'y ajoutent automatiquement. Décochez un nom qu'un certificat ne peut pas couvrir, par exemple un nom dont vous ne contrôlez pas le DNS |
Un serveur compte au maximum 100 noms au total.
Les adresses de redirection inscrites pour la connexion avec Microsoft Entra ID et Google commencent par le nom principal. Lorsque vous changez le nom principal, mettez-les d'abord à jour ; consultez Configurer les fournisseurs de connexion.
Choisir un mode
| Mode dans la console | Réponse au programme d'installation | Quand l'utiliser |
|---|---|---|
| Let's Encrypt over HTTP | letsencrypt | Chaque nom du certificat figure dans le DNS public et pointe vers ce serveur, et le port 80 est accessible depuis Internet, directement ou par un NAT ou une passerelle qui le redirige |
| Let's Encrypt over DNS | letsencrypt-dns | Vous disposez d'informations d'identification d'API pour la zone DNS des noms. Le serveur n'a pas besoin d'être accessible depuis Internet ; c'est donc le choix habituel pour un serveur atteint par un VPN |
| Self-signed | selfsigned | Partout. Les navigateurs affichent un avertissement tant que les personnes n'ont pas approuvé le certificat sur leurs ordinateurs et leurs téléphones |
| Your own certificate | custom | Votre organisation émet des certificats. Vous collez la chaîne et la clé, et vous les remplacez avant leur expiration |
| Gateway in front | gateway | Un équilibreur de charge ou un proxy inverse, comme Azure Application Gateway ou Front Door, termine TLS et transmet du HTTP simple. Son en-tête X-Forwarded-Proto est pris en compte |
| Plain HTTP | later | Un premier test, ou un réseau auquel vous faites entièrement confiance. Rien n'est chiffré |
Modifier les noms ou le mode dans la console
- Ouvrez Settings et sélectionnez Server and certificates. Vous pouvez aussi y accéder depuis Settings › Instance avec Server names and HTTPS.
- Sous Names, vérifiez le Primary name. Pour ajouter un alias, saisissez-le et sélectionnez Add ; pour en supprimer un, sélectionnez Remove à côté de celui-ci.
- Sous HTTPS, choisissez le mode et renseignez ce qu'il demande. Les sections ci-dessous décrivent chaque mode.
- Sous Names in the certificate, décochez les noms qu'un certificat ne peut pas couvrir.
- Sélectionnez Apply. La page affiche Saved. The certificate service is applying it.
Sous Current certificate, vous voyez ce qui est servi : l'émetteur, les noms, Valid until, la Last attempt avec son résultat, et la Next check. Si une tentative échoue, What went wrong en donne l'explication.
Chaque modification est vérifiée avant d'être enregistrée et elle est consignée dans le journal d'audit.
Let's Encrypt over HTTP
Saisissez l'E-mail for the Let's Encrypt account. Avant d'appliquer, assurez-vous que chaque nom du certificat se résout publiquement vers le serveur et que le port 80 est ouvert depuis Internet. Un nom qui ne peut pas être public, comme une adresse IP ou un nom se terminant par .local, .internal ou .corp, est refusé : décochez-le ou utilisez un certificat auto-signé.
Let's Encrypt over DNS
-
Saisissez l'E-mail for the Let's Encrypt account.
-
Choisissez le DNS provider de la zone des noms. Pour un fournisseur absent de la liste, choisissez Other (acme.sh dnsapi id) et saisissez son identifiant
dnsapid'acme.sh. -
Sous API credentials, saisissez les valeurs que lit le fournisseur. La console les indique pour chaque fournisseur :
Fournisseur Identifiant 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 vous le souhaitez, définissez Let's Encrypt server sur Staging pour faire un essai sans toucher aux limites de débit de Let's Encrypt. Les navigateurs n'approuvent pas les certificats de préproduction ; revenez à Production lorsque tout fonctionne.
Les valeurs des informations d'identification sont en écriture seule : elles sont stockées chiffrées et ne sont plus jamais affichées. Pour conserver une valeur stockée lorsque vous modifiez les paramètres, laissez son champ vide.
Self-signed
Rien à saisir. Le certificat est valide pendant 825 jours et il est renouvelé de la même façon que les autres. Pour faire disparaître les avertissements du navigateur, sélectionnez Download the certificate et installez-le comme certificat approuvé sur les ordinateurs et les téléphones qui utilisent le serveur.
Your own certificate
Collez la Certificate chain au format PEM, avec le certificat du serveur en premier, et la Private key au format PEM sans phrase secrète. La clé doit être une clé RSA de 2048 bits ou plus, ou une clé ECDSA. La console refuse un certificat expiré, qui ne couvre pas les noms du serveur ou dont la clé ne correspond pas. Remplacez les deux avant l'expiration du certificat ; Excubius ne le renouvelle pas à votre place.
Gateway in front
Rien à saisir. Configurez la passerelle pour qu'elle transmette du HTTP simple au port 80 du serveur et qu'elle envoie l'en-tête X-Forwarded-Proto.
Renouvellement
Le renouvellement est automatique pour les certificats Let's Encrypt et auto-signés. Le service de certificats vérifie le certificat actif chaque jour et le renouvelle lorsqu'il reste 30 jours ou moins. Aucun minuteur n'est à configurer sur le serveur.
- Une tentative qui échoue ne supprime jamais ce qui fonctionne. Le certificat précédent, ou le HTTP simple, continue d'être servi ; l'erreur apparaît sur la page avec l'heure de la prochaine tentative, au bout de 15 minutes, puis avec un délai qui double jusqu'à un jour.
- Une modification des paramètres est essayée immédiatement.
- Renew now demande immédiatement un nouveau certificat.
- Use self-signed now passe à un certificat auto-signé, la façon rapide d'obtenir HTTPS tant que Let's Encrypt ne peut pas encore fonctionner.
Les cookies de session sont marqués Secure chaque fois qu'une requête arrive en HTTPS ; changer de mode ne nécessite donc aucun redémarrage. Laissez COOKIE_SECURE vide dans le fichier de configuration ; il ne sert qu'à forcer le comportement dans un sens ou dans l'autre.
Les adresses /healthz et /heartbeat répondent en HTTP simple dans tous les modes ; un observateur externe continue donc de fonctionner pendant que vous modifiez TLS.
Modifier TLS depuis le serveur
Lorsque la console est inaccessible, par exemple parce que le certificat est défectueux et que le navigateur refuse la page, modifiez les mêmes paramètres depuis le serveur. Le script passe par les mêmes vérifications et le même journal d'audit que la console.
-
Connectez-vous en SSH et prenez l'identité du compte de service :
sudo -iu excubius -
Affichez les paramètres et le certificat actuels :
/opt/excubius/current/scripts/enable-tls.sh --status -
Modifiez ce dont vous avez besoin. Par exemple, passez à un certificat auto-signé :
/opt/excubius/current/scripts/enable-tls.sh --mode selfsignedOu utilisez Let's Encrypt via DNS avec Cloudflare, avec deux noms et un certificat pour le second uniquement. Les informations d'identification sont lues sous forme de lignes
KEY=VALUEdepuis l'entrée standard :/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 -
Pour renouveler immédiatement, exécutez
enable-tls.sh --renew.
Remplacez /opt/excubius si vous avez choisi un autre répertoire d'installation. Exécutez enable-tls.sh --help pour voir toutes les options, y compris --staging et --production. Votre propre certificat ne peut être chargé que depuis la console.
Modifier les réponses avec le programme d'installation
sudo ./install.sh --reconfigure pose de nouveau toutes les questions. Les réponses TLS que vous donnez alors sont appliquées à la plateforme en cours d'exécution, comme si vous les aviez modifiées dans la console.