Vault
Comment Volant lit les données d'Ansible Vault, d'où il tire les mots de passe, et pourquoi ils ne quittent jamais le processus du contrôleur.
Volant lit et écrit les formats vault 1.1 et 1.2 d’ansible-core 2.19.12. Les résultats, les messages d’erreur et les codes de sortie correspondent à ceux d’ansible-core.
D’où viennent les mots de passe
Section intitulée « D’où viennent les mots de passe »| Source | Remarques |
|---|---|
-J, --ask-vault-pass |
Demandé sur le terminal, sans écho. |
--vault-password-file, --vault-pass-file |
Un fichier, ou un exécutable qui affiche le mot de passe. Répétable. |
--vault-id LABEL@SOURCE |
La source est un fichier, un exécutable ou prompt. Répétable. |
[defaults] vault_password_file, vault_identity_list |
La même chose, depuis ansible.cfg. |
ANSIBLE_VAULT_PASSWORD_FILE, ANSIBLE_VAULT_IDENTITY_LIST |
La même chose, depuis l’environnement. |
Chaque mot de passe est essayé sur chaque valeur chiffrée, quel que soit son label.
Ce qui est déchiffré
Section intitulée « Ce qui est déchiffré »- Les valeurs
!vaulten ligne dans un playbook ou un fichier de variables. Elles se chargent sous forme chiffrée et se déchiffrent quand un modèle les lit. Une valeur déchiffrée garde la confiance qu’ansible-core lui accorde. - Les fichiers entièrement chiffrés :
vars_files,include_vars, et les fichiersgroup_varsethost_vars. Un fichier chiffré qui ne peut pas être lu échoue avec le message d’ansible-core. - Les filtres
vaultetunvault, les testsvault_encryptedetvaulted_file, et le lookupunvault. - Un
srcchiffré decopy,templateetscript, et une archive chiffrée d’unarchive. L’exécution la déchiffre dans un répertoire temporaire privé avant que le plugin ne la lise.decrypt: falsesurcopyouunarchivegarde le texte chiffré.
Une valeur !vault qu’aucun secret n’ouvre fait échouer la tâche qui la lit, avec les trois blocs qu’ansible-core affiche. debug: var=x se termine avec 2, avec la cause à la ligne où la valeur est écrite. is vault_encrypted répond pour les variables de l’hôte courant.
Les secrets restent sur le contrôleur
Section intitulée « Les secrets restent sur le contrôleur »Un mot de passe vault vit en mémoire dans le processus du contrôleur. Il n’est jamais écrit dans une ligne de commande, dans l’environnement d’un processus fils, dans un journal, dans un résultat ni dans le lien avec l’agent. Les mots de passe de connexion et d’élévation de privilèges suivent la même règle, et Connexions explique comment le mot de passe SSH parvient à ssh.
Les filtres, tests et lookups qui s’exécutent en Python ne voient jamais le mot de passe vault. Ceux de vault s’exécutent pour cette raison dans le processus du contrôleur. Voir Filtres, tests et lookups qui nécessitent Python.
Une valeur revenue d’un hôte géré n’est jamais déchiffrée avec les secrets de l’exécution, et n’est jamais rendue de nouveau comme modèle. Voir Les valeurs venues des hôtes ne sont jamais rendues comme modèles.
Chiffrer et afficher des fichiers
Section intitulée « Chiffrer et afficher des fichiers »volant vault encrypt, decrypt et view travaillent sur les mêmes fichiers qu’ansible-vault : un fichier chiffré par l’un est lu par l’autre, avec l’id par défaut comme avec un label.
encryptremplace chaque fichier par son texte vault etdecryptpar son texte en clair. Les deux laissent le résultat en mode0600et n’affichent rien ; sur un terminal, ils écriventEncryption successfulouDecryption successfulsur l’erreur standard. Un fichier sans saut de ligne final revient sans saut de ligne.- L’en-tête est
$ANSIBLE_VAULT;1.1;AES256pour l’id par défaut et$ANSIBLE_VAULT;1.2;AES256;LABELpour un autre.--vault-id LABEL@SOURCEfixe le label. Avec plusieurs--vault-id,--encrypt-vault-id(ouvault_encrypt_identity,ANSIBLE_VAULT_ENCRYPT_IDENTITY) choisit celui qui chiffre ; sans lui, la commande sort avec le code 5. --output FILEécrit à cet endroit et laisse la source intacte,--output -écrit sur la sortie standard, et sans nom de fichier, ou avec-, la commande lit l’entrée standard.viewaffiche le texte en clair de chaque fichier. Sur un terminal, il passe par le pager :PAGER, sinonANSIBLE_PAGER, sinon[defaults] pager, sinonless.- Sans aucune source de mot de passe, la commande le demande.
encryptle demande deux fois, commeNew Vault password:etConfirm New Vault password:. -vaffiche le fichier de configuration utilisé et-vvla version. Les lignes supplémentaires de-vvvvne sont pas affichées.
Créer, modifier et rechiffrer des fichiers
Section intitulée « Créer, modifier et rechiffrer des fichiers »volant vault create, edit et rekey travaillent sur les mêmes fichiers qu’ansible-vault.
createprend un seul nom de fichier. Il refuse avec le code de sortie 5 sauf si la sortie standard est un terminal ou si--skip-tty-checkest donné, et avec le code de sortie 1 quand le fichier existe. Un répertoire manquant est créé, avec un avertissement. L’éditeur peut laisser le fichier vide : le résultat est un fichier vault valide qui contient un texte vide.editdéchiffre chaque fichier, ouvre l’éditeur et chiffre le résultat avec le secret qui a ouvert le fichier et le label qu’il avait. Quand le texte n’a pas changé, le fichier n’est pas réécrit. Un fichier modifié garde son mode.- L’éditeur est
EDITOR, sinonANSIBLE_EDITOR, sinon[defaults] editor, sinonvi, découpé en mots comme le ferait un shell, avec le nom du fichier ajouté. Son statut de sortie n’est pas regardé, comme dans ansible-vault. - L’éditeur travaille sur une copie en mode
0600dans un répertoire privé sousANSIBLE_LOCAL_TEMP([defaults] local_tmp, sinon~/.ansible/tmp). La copie est écrasée puis supprimée à chaque sortie, y compris avec un éditeur en échec et avec SIGTERM ou SIGHUP. Ctrl-C va à l’éditeur. rekeydéchiffre chaque fichier avec les anciens secrets et le réécrit avec le nouveau, en gardant son mode. Le nouveau secret vient de--new-vault-password-file, de--new-vault-id LABEL@SOURCE, ou des invitesNew Vault password:etConfirm New Vault password:. Il afficheRekey successfulsur l’erreur standard, quelle que soit la sortie standard.
Chiffrer des chaînes
Section intitulée « Chiffrer des chaînes »volant vault encrypt_string transforme une valeur en bloc !vault | pour un fichier de variables. Chaque ligne du texte chiffré est indentée de dix espaces, et chaque bloc se termine par un saut de ligne :
mykey: !vault | $ANSIBLE_VAULT;1.1;AES256 66313561363937653234366564623639...-n NAMEnomme la chaîne placée au même rang et--stdin-name NAMEnomme l’entrée standard. Sans nom, le bloc commence par!vault |.--vault-id LABEL@SOURCEdonne un en-tête1.2avec le label.- Sans chaîne, ou avec
-, le texte est lu sur l’entrée standard jusqu’à la fin. Une entrée vide sort avec le code 5. - Avec plus d’une chaîne, l’erreur standard porte une ligne de commentaire par chaîne, et une note quand il y a moins de noms que de chaînes. La sortie standard ne contient que les blocs.
-pdemande un nom de variable, puis la chaîne, qui n’est pas affichée à la frappe sauf si--show-inputest donné. Il ne peut pas être combiné avec la lecture de l’entrée standard.- Sur un terminal,
Encryption successfulva sur l’erreur standard avant les blocs. --output FILEécrit les blocs dans le fichier, en mode0600.
Limites connues
Section intitulée « Limites connues »- L’argument
wrap_objectdu filtrevaultest refusé comme non encore pris en charge. Son argumentsaltfonctionne comme dans Ansible : le même sel donne toujours le même texte. - À
-vvvvv,vault view,decryptetrekeyn’affichent pas la trace d’ansible-core pour chaque secret essayé (Trying secret FileVaultSecret(...) for vault_id=...). Les secrets sont essayés dans le même ordre.
La page de la ligne de commande donne les options.