Aller au contenu

Gestion des secrets

L’installeur génère les secrets une fois et les conserve dans un coffre chiffré, plutôt qu’en clair dans un fichier d’environnement.

  • Les secrets sont scellés dans <install_dir>/secrets.enc, chiffrés en AES-256-GCM.
  • La clé maître vit dans /etc/vuisio/secrets.key, volontairement en dehors du répertoire d’installation : ainsi, une sauvegarde ou un instantané de ce répertoire ne suffit pas à divulguer les secrets.
  • L’accès aux commandes de secrets est protégé par une phrase de passe administrateur, stockée uniquement sous forme de condensat Argon2id dans /etc/vuisio/secrets.meta.
  • Au démarrage, les secrets sont déchiffrés vers un tmpfs (/run/vuisio/secrets) avant le lancement des services.
Fenêtre de terminal
vuisio secrets # affiche les secrets, masqués
vuisio secrets show --reveal # affiche les valeurs en clair
vuisio secrets show VUISIO_METRICS_TOKEN # un seul secret
vuisio secrets set MON_SECRET # ajoute un secret personnalisé (valeur demandée sans écho)
vuisio secrets rotate REDIS_PASSWORD # régénère un secret, rescelle, redémarre

Chacune de ces commandes demande d’abord la phrase de passe administrateur et doit être lancée en root. set et rotate redémarrent la pile pour livrer la nouvelle valeur.

Une mise à jour ne touche pas au coffre, à une exception près : un secret qu’une version a ajouté depuis l’installation du serveur y est généré, avant que les services redémarrent. Les secrets déjà présents ne changent jamais.

Faire tourner VUISIO_REPLAY_SECRET invalide les liens de relecture déjà distribués : c’est le but quand un lien a fuité. Une plateforme pédagogique en reçoit de nouveaux à chaque fois qu’elle liste les enregistrements. Les liens de partage gardent leurs réglages (destinataire, durée, droits) mais changent d’adresse : la nouvelle se recopie depuis la page de l’enregistrement, et l’ancienne reste valable tant que l’ancienne clé est déclarée dans VUISIO_REPLAY_SECRET_PREVIOUS.

Le mot de passe du relais de mails, VUISIO_SMTP_PASSWORD, est le seul secret que l’installeur ne génère pas : c’est celui que votre fournisseur vous a donné. Il entre dans le coffre par l’assistant (ou la section [mail] du fichier de réponses) et en change de la même façon, avec vuisio reconfigure. Voir Envoi de mails.

Le registre des clés API change pendant le service : chaque clé créée par l’API d’administration y entre. Depuis la version 0.15.5, il est rescellé dans le coffre à chaque modification (unité systemd vuisio-tenants-sync.path), si bien qu’un redémarrage du serveur rend exactement les clés qu’il avait. Un registre qui perd des clés garde la version précédente dans le coffre, sous VUISIO_TENANTS_PREVIOUS, et un fichier illisible n’est jamais scellé : l’unité vuisio-tenants-sync.service passe alors en échec, visible dans systemctl --failed.

La commande set ajoute un secret personnalisé au coffre, puis redémarre la pile pour le livrer. Ces secrets sont mis à disposition du client web via process.env.<CLÉ> (par exemple un jeton pour brancher un service externe). Si vous omettez la valeur, elle est demandée sans être affichée à l’écran.

Plutôt que par variable d’environnement, un secret peut être fourni par un fichier : pour la variable concernée, définissez <VARIABLE>_FILE avec le chemin du fichier (la convention des secrets Docker et des tmpfs systemd). La valeur est lue depuis le fichier, le saut de ligne final est ignoré, et un fichier vide est traité comme absent.

Par exemple : VUISIO_REDIS_URL_FILE, VUISIO_ENCRYPTION_KEY_FILE, VUISIO_METRICS_TOKEN_FILE.