Monter un fichier secret
Déposer un certificat, une clé ou un fichier de configuration sensible en lecture seule dans le conteneur d'un service.
- Required access
- Droit « Infra Client » pour la définition ; « Gérer les secrets » pour le secret (et « Accès infrastructure en production » en prod)
- Duration
- 10 min
This page has not been translated yet and is shown in French.
Certains services lisent un fichier plutôt qu'une variable : un certificat client .p12, une clé privée, un fichier de comptes de service. Un fichier monté dépose le contenu d'un secret à un chemin précis du conteneur, en lecture seule.
Avant de commencer
- Le fichier fait 900 Ko au plus.
- Vous connaissez le chemin où votre service l'attend, nom de fichier compris, par exemple
/etc/certs/client.p12.
Déclarer le fichier dans la définition
- Dans Architecture > Services, ouvrez le service, puis l'onglet Variables consommées.
- Cliquez sur Ajouter une variable.
- Dans Mode de consommation, choisissez Fichier monté.
- Dans Chemin de montage, saisissez le chemin absolu du fichier, par exemple
/etc/certs/client.p12. Il ne se termine pas par/. - Dans Permissions, gardez 0400 (read-only owner), sauf si votre service tourne sous un autre utilisateur que le propriétaire du fichier.
- Optionnel : dans Description, indiquez la nature du fichier.
- Cliquez sur Créer.
Résultat : la ligne apparaît avec le mode Fichier.
Déposer le fichier dans le coffre
- Ouvrez l'environnement, onglet Configuration, puis cliquez sur Ajouter.
- Dans Nom, saisissez un nom, par exemple
CLIENT_CERT_P12. - Choisissez Secret, puis Uploader un fichier.
- Dans Valeur, choisissez le fichier.
- Cliquez sur Créer.
Résultat : le fichier est encodé en base64 par votre navigateur et stocké dans le coffre. Le conteneur recevra le fichier d'origine, décodé.
Important
Un fichier monté ne peut être relié qu'à un secret déposé en fichier. Un secret saisi comme texte, une valeur libre ou une autre entrée du pool ne produit pas de fichier.
Relier le fichier dans le service
- Ouvrez le service déployé, onglet Configuration du service. La ligne du fichier affiche son chemin et le badge Fichier.
- Dans la liste déroulante, choisissez le secret
CLIENT_CERT_P12. - Cliquez sur Enregistrer la configuration.
Résultat : le service redémarre ; le fichier est présent au chemin indiqué, avec les permissions choisies.
Vérifier le résultat
Dans l'onglet Logs du service, vérifiez que le fichier est lu au démarrage sans erreur. Si votre service journalise l'empreinte du certificat chargé, comparez-la à celle de votre fichier :
openssl pkcs12 -in client.p12 -nokeys -passin pass:"$P12_PASSWORD" | openssl x509 -noout -fingerprint -sha256