serveurs_* -> serveur_, clients_ -> client_, suffixes pluriels au singulier (serveur_web_dorsal/frontal, client_metrique, client_journal). Renommage par tokens exacts : repertoires de roles, playbooks de groupes, group_vars, variables internes des roles (serveur_nginx_*, conformite ansible-lint), groupes du plan, constantes de code, docs. Faux-amis preserves (serveurs_bd, scripts/serveurs.py, fonctions Python). Groupes d'etat gardes au pluriel (hotes_actifs/planifies, modeles_vm). Valide : ansible-lint 0 echec (0 var-naming), diff vide de la generation, node --check, tous les registres. Ajout de .ansible-lint excluant docs/ (registres de donnees, pas du contenu Ansible). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
serveur_step_ca
Autorité de certification interne Smallstep step-ca avec provisioner ACME,
pour émettre les certificats internes de Chezlepro (client_pki est le client ACME).
Rôle
- Ajoute le dépôt apt officiel Smallstep (clé + source deb822) et installe
step-ca+step-cli. - Crée l'utilisateur système
stepetSTEPPATH=/etc/step-ca. - Déploie les mots de passe (CA et provisioner) depuis Vault.
- Initialise l'AC une seule fois (
step ca init, standalone + provisioner ACME), garde-foucreates: config/ca.json. - Déploie l'unité systemd durcie officielle et démarre le service.
Secrets requis (Vault)
Obligatoires dès l'installation :
serveur_step_ca_password: "{{ vault_step_ca_password }}"
serveur_step_ca_provisioner_password: "{{ vault_step_ca_provisioner_password }}"
À placer dans inventories/production/group_vars/serveur_step_ca/vault.yml (chiffré),
les variables en clair référençant ces secrets dans .../serveur_step_ca/main.yml.
Variables principales
| Variable | Défaut | Rôle |
|---|---|---|
serveur_step_ca_nom |
Chezlepro Internal CA |
Nom de l'AC |
serveur_step_ca_dns |
FQDN + IP | SAN/DNS du certificat de l'AC |
serveur_step_ca_adresse |
:8443 |
Adresse d'écoute |
serveur_step_ca_provisioner |
admin@chezlepro.internal |
Provisioner JWK admin |
serveur_step_ca_acme |
true |
Ajoute un provisioner ACME |
Notes
- La ligne
step ca initutilise les drapeaux documentés par Smallstep ; selon la version destep-cliinstallée, un ajustement mineur peut être nécessaire. L'init ne s'exécute qu'une fois (présence deconfig/ca.json). - L'unité systemd provient de la doc de production Smallstep (sandboxing systemd).
- Émission/renouvellement côté clients : voir le futur rôle
client_pki(ACME).
Hors périmètre
- Sauvegarde/HA de l'AC, RA (registration authority), rotation des clés racine.