Solde la dette documentaire repérée à l'audit du 2026-07-03. Tous les rôles ont
désormais un README, au format maison (intention → rôle → variables →
notes/limites → prérequis). Ils documentent ce qui ne se lit PAS dans les tâches :
- serveur_debian : rôle-catégorie sans tâches — il ne porte que le flux SSH du
plan de gestion, sans quoi les nftables générés couperaient l'accès Ansible à
toute la flotte ; le vrai travail est dans le playbook de groupe.
- hosts_statiques : le plancher /etc/hosts comme CONDITION de l'ordre de
reconstruction (résolution par nom avant que PowerDNS existe) ; fichier
entièrement géré, alias d'exposition best-effort.
- resoudre_base / resoudre_annuaire : entrées, sorties (facts), et pourquoi le
FQDN plutôt que le nom court (fédération + nom canonique pour verify-full).
- serveur_dovecot : les 3 réglages Dovecot 2.4 qui conditionnent la remise
(static_allow_all_users, mail_inbox_path vide, mail_path par utilisateur) et
le local-part seul comme chemin commun LMTP/IMAP ; limite mono-domaine.
- serveur_postfix : liens mailstore/milter, recopie de /etc/hosts dans le chroot.
- serveur_rspamd : clé DKIM idempotente ; le domaine signé doit être PUBLIC en
prod, sinon la signature ne vaut rien pour les MX distants.
- client_backup / serveur_backup : jobs déclaratifs, chiffrement côté client,
deux pièges (jobs vides = silencieux ; dépôt neuf vide après un from-zero) ;
hors-nœud n'est pas hors-site.
- serveur_oauth2_proxy : le patron réutilisable Keycloak-devant-n'importe-quoi,
et pourquoi allow_unverified_email est nécessaire avec un annuaire LDAP.
- serveur_icingaweb2 : modes ldap vs external, écoute à restreindre en SSO.
- client_unbound : le garde-fou de bascule (apply ET confirm, validation réelle
avant de toucher /etc/resolv.conf).
docs/carte-set-ops.md ne décrivait plus l'état du code :
- expose EST consommé au déploiement (annoncé comme « Phase 3 à venir ») :
expositions_des_applications + expositions.conf.j2, alias /etc/hosts, SANs
d'edge dérivés par instancier.py ;
- 3 mécanismes transverses ajoutés (résolution d'annuaire, plancher de
résolution, resoudre_base nommé dans les bindings app→base) ;
- 5 entrées d'index ajoutées : réseau/pare-feu, ordre de déploiement,
preuve/recette, exploitation courante, wiki — pans du corpus non indexés ;
- ce qui reste ouvert est marqué : meta/liens.yml sur le seul serveur_postfix,
requiert non consommé au déploiement (l'ordre vient des couches + du graphe).
make verifier vert : ansible-lint 514 fichiers, tests, syntax-check,
23 preuves CONFORME / 0 échec / 0 sauté.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Rôle utilitaire (pas un groupe déployable) : dérive la connexion à l'annuaire interne
(OpenLDAP) de façon déclarative, à partir du domaine_interne et de l'hôte d'annuaire.
Remplace le câblage LDAP qui était répété dans serveur_dovecot, serveur_postfix,
serveur_keycloak et serveur_icingaweb2. Un seul endroit fixe le nom de l'hôte
d'annuaire.
Usage
- name:Résoudre l'annuaire (rôle partagé)ansible.builtin.include_role:name:resoudre_annuaire- name:Adopter la connexion annuaire pour <service>ansible.builtin.set_fact:<service>_ldap_uri:"{{ resoudre_annuaire_uri }}"<service>_ldap_base_dn:"{{ resoudre_annuaire_base_dn }}"
Sorties (facts, persistent après include_role)
Fact
Exemple
resoudre_annuaire_fqdn
id-ldap-01.exemple.internal
resoudre_annuaire_uri
ldaps://id-ldap-01.exemple.internal
resoudre_annuaire_base_dn
dc=exemple,dc=internal
resoudre_annuaire_users_dn
ou=people,dc=exemple,dc=internal
resoudre_annuaire_bind_dn
cn=admin,dc=exemple,dc=internal
resoudre_annuaire_bind_password
Déréférencé de la voûte (no_log)
Variables
Variable
Défaut
Rôle
resoudre_annuaire_hote
id-ldap-01
Le point où le nom d'hôte est fixé (surchargeable par instance)
resoudre_annuaire_port
636
Port LDAPS
resoudre_annuaire_encryption
ldaps
Schéma de l'URI
resoudre_annuaire_bind_cn
admin
CN du compte de bind
resoudre_annuaire_secret
vault_openldap_admin
Nom de la variable de voûte
Notes
Les sorties sont posées en set_fact (pas en defaults) : les defaults d'un rôle inclus
ne survivent pas à la fin de son exécution, contrairement aux facts.
Le base DN est dérivé du domaine_interne (a.b → dc=a,dc=b) : aucun DN codé en dur.
Le rôle exige un domaine_interne non vide (assertion).
LDAPS suppose la confiance step_ca posée par client_pki sur le nœud consommateur.
Daniel Allaire
4a1d0836d0