Daniel Allaire
4a1d0836d0
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>
49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# resoudre_annuaire
|
|
|
|
**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
|
|
```yaml
|
|
- 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.
|
|
|
|
## Prérequis
|
|
- `domaine_interne` défini ; voûte déverrouillée (`ANSIBLE_VAULT_PASSWORD_FILE`).
|