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

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

1. Dans **Architecture** > **Services**, ouvrez le service, puis l'onglet **Variables consommées**.
2. Cliquez sur **Ajouter une variable**.
3. Dans **Mode de consommation**, choisissez **Fichier monté**.
4. Dans **Chemin de montage**, saisissez le chemin absolu du fichier, par exemple `/etc/certs/client.p12`. Il ne se termine pas par `/`.
5. Dans **Permissions**, gardez **0400 (read-only owner)**, sauf si votre service tourne sous un autre utilisateur que le propriétaire du fichier.
6. Optionnel : dans **Description**, indiquez la nature du fichier.
7. Cliquez sur **Créer**.

Résultat : la ligne apparaît avec le mode **Fichier**.

## Déposer le fichier dans le coffre

1. Ouvrez l'environnement, onglet **Configuration**, puis cliquez sur **Ajouter**.
2. Dans **Nom**, saisissez un nom, par exemple `CLIENT_CERT_P12`.
3. Choisissez **Secret**, puis **Uploader un fichier**.
4. Dans **Valeur**, choisissez le fichier.
5. 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

1. Ouvrez le service déployé, onglet **Configuration du service**. La ligne du fichier affiche son chemin et le badge **Fichier**.
2. Dans la liste déroulante, choisissez le secret `CLIENT_CERT_P12`.
3. 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 :

```bash
openssl pkcs12 -in client.p12 -nokeys -passin pass:"$P12_PASSWORD" | openssl x509 -noout -fingerprint -sha256
```

## Voir aussi

- [Faire tourner un secret](/v1.0/variables-et-secrets/faire-tourner-un-secret)
- [Prise en compte des changements](/v1.0/variables-et-secrets/prise-en-compte-des-changements)
