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>
57 lines
3 KiB
Markdown
57 lines
3 KiB
Markdown
# serveur_postfix
|
|
|
|
**MTA** : Postfix 3.x (Debian 13) sur le nœud *edge-mta* — réception SMTP :25, cartes LDAP
|
|
(domaines, boîtes, alias), remise **LMTP réseau** vers le mailstore (`serveur_dovecot`).
|
|
**Ne stocke aucune boîte.** Cf. `docs/courriel-conception.md`.
|
|
|
|
## Rôle
|
|
- Préconfigure Postfix par **debconf** (installation non interactive), installe
|
|
`postfix` + `postfix-ldap`.
|
|
- **Chroot** : recopie `/etc/hosts` dans `/var/spool/postfix/etc/` — le MTA hérite du
|
|
plancher de résolution (`hosts_statiques`), sinon il ne résout aucun nom interne.
|
|
- **TLS** : pont de certificat step_ca (`client_pki`) — script `setops-postfix-cert-sync`
|
|
+ unités `.service`/`.path`, recharge Postfix à chaque renouvellement.
|
|
- **Annuaire** : connexion fournie par `resoudre_annuaire` ; carte `ldap-mailboxes.cf`
|
|
(validation des destinataires contre LDAP).
|
|
- Soumission `:587` optionnelle, avec **SASL délégué à Dovecot** (passdb LDAP).
|
|
- Valide la configuration (`postfix check`) avant d'activer le service.
|
|
|
|
## Liaisons (`meta/liens.yml`)
|
|
Le rôle **accepte** deux liens déclarés côté application dans `plan/applications.yml` :
|
|
|
|
| Lien | Effet |
|
|
| --- | --- |
|
|
| `mailstore` | Injecte `serveur_postfix_mailstore_hote` = FQDN de la cible (Dovecot LMTP) |
|
|
| `milter` | Passe `serveur_postfix_rspamd_milter` à `true` (rspamd co-localisé) |
|
|
|
|
C'est le sens « **app→app** », résolu par `scripts/instancier.py`. Cf.
|
|
`docs/bindings-conception.md`.
|
|
|
|
## Variables principales
|
|
| Variable | Défaut | Rôle |
|
|
| --- | --- | --- |
|
|
| `serveur_postfix_mailstore_hote` | *(vide — **obligatoire**)* | Nœud Dovecot, normalement injecté par le lien `mailstore` |
|
|
| `serveur_postfix_lmtp_port` | `24` | LMTP vers le mailstore |
|
|
| `serveur_postfix_reseaux_confiance` | `127.0.0.0/8 [::1]/128` | `mynetworks` (relais autorisé) |
|
|
| `serveur_postfix_submission_actif` | `false` | Soumission :587 (SASL Dovecot) |
|
|
| `serveur_postfix_rspamd_milter` | `false` | Milter antispam/DKIM co-localisé |
|
|
| `serveur_postfix_lmtp_tls_verify` | `false` | Zéro-confiance : vérifier le certificat du mailstore |
|
|
|
|
## Flux (`meta/flux.yml`)
|
|
`25/tcp` entrant (externe + `client_smtp`) · `587/tcp` soumission (flotte) ·
|
|
`24/tcp` → Dovecot (TLS vérifié) · `12345/tcp` → Dovecot (SASL) ·
|
|
`11332/tcp` → rspamd local · `636/tcp` → OpenLDAP · `25/tcp` sortant (MX distants).
|
|
|
|
## Notes / limites
|
|
- Le rôle **exige** `serveur_postfix_mailstore_hote` (assertion) : pas de remise locale, la
|
|
remise finale appartient au mailstore. C'est la scission edge-mta / mail-store.
|
|
- `serveur_postfix_reseaux_confiance` est à adapter au réseau de l'instance — laissé au
|
|
strict minimum par défaut.
|
|
- `serveur_postfix_lmtp_tls_verify: true` demande que la racine step_ca soit lisible
|
|
(`/etc/step/certs/root_ca.crt`, posée en `0644` par `client_pki`).
|
|
- La frontière publique (MX, SPF/DKIM/DMARC publics, filtrage entrant) relève de
|
|
l'OPNsense — Étape B, hors flotte Ansible.
|
|
|
|
## Prérequis
|
|
- `serveur_postfix requiert serveur_dovecot actif` (`docs/dependances-groupes.yml`).
|
|
- `client_pki` appliqué sur le nœud.
|