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.
Le coffre chiffré
Section intitulée « Le coffre chiffré »- 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.
Consulter et faire tourner les secrets
Section intitulée « Consulter et faire tourner les secrets »vuisio secrets # affiche les secrets, masquésvuisio secrets show --reveal # affiche les valeurs en clairvuisio secrets show VUISIO_METRICS_TOKEN # un seul secretvuisio 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émarreChacune 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.
Secrets personnalisés
Section intitulée « Secrets personnalisés »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.
Livraison par fichiers (secrets Docker, systemd)
Section intitulée « Livraison par fichiers (secrets Docker, systemd) »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.