Aller au contenu principal
Version : 0.4 · actuelle

Configurer les noms et TLS

Guide pratiqueRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Installateur (administrateur Linux), Super-administrateur
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

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 (excubius par 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​

NomDescription
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.

attention

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 consoleRéponse au programme d'installationQuand l'utiliser
Let's Encrypt over HTTPletsencryptChaque 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 DNSletsencrypt-dnsVous 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-signedselfsignedPartout. 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 certificatecustomVotre organisation émet des certificats. Vous collez la chaîne et la clé, et vous les remplacez avant leur expiration
Gateway in frontgatewayUn é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 HTTPlaterUn 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​

  1. Ouvrez Settings et sélectionnez Server and certificates. Vous pouvez aussi y accéder depuis Settings › Instance avec Server names and HTTPS.
  2. 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.
  3. Sous HTTPS, choisissez le mode et renseignez ce qu'il demande. Les sections ci-dessous décrivent chaque mode.
  4. Sous Names in the certificate, décochez les noms qu'un certificat ne peut pas couvrir.
  5. 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​

  1. Saisissez l'E-mail for the Let's Encrypt account.

  2. 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 dnsapi d'acme.sh.

  3. Sous API credentials, saisissez les valeurs que lit le fournisseur. La console les indique pour chaque fournisseur :

    FournisseurIdentifiant dnsapiVariables
    Cloudflaredns_cfCF_Token, CF_Account_ID
    DreamHostdns_dreamhostDH_API_KEY
    Azure DNSdns_azureAZUREDNS_SUBSCRIPTIONID, AZUREDNS_TENANTID, AZUREDNS_APPID, AZUREDNS_CLIENTSECRET
    Amazon Route 53dns_awsAWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
    GoDaddydns_gdGD_Key, GD_Secret
    DigitalOceandns_dgonDO_API_KEY
    Gandidns_gandi_livednsGANDI_LIVEDNS_TOKEN
    Hetznerdns_hetznercloudHETZNER_TOKEN
    IONOSdns_ionosIONOS_PREFIX, IONOS_SECRET
    Linode (Akamai)dns_linode_v4LINODE_V4_API_KEY
    Namecheapdns_namecheapNAMECHEAP_USERNAME, NAMECHEAP_API_KEY, NAMECHEAP_SOURCEIP
    OVHclouddns_ovhOVH_END_POINT, OVH_AK, OVH_AS, OVH_CK
    Porkbundns_porkbunPORKBUN_API_KEY, PORKBUN_SECRET_API_KEY
  4. 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.

  1. Connectez-vous en SSH et prenez l'identité du compte de service :

    sudo -iu excubius
  2. Affichez les paramètres et le certificat actuels :

    /opt/excubius/current/scripts/enable-tls.sh --status
  3. Modifiez ce dont vous avez besoin. Par exemple, passez à un certificat auto-signé :

    /opt/excubius/current/scripts/enable-tls.sh --mode selfsigned

    Ou 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=VALUE depuis 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
  4. 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.