41. pepsi-stage-aliases¶
Expandiert Umschlagempfänger über eine Alias-/Mailinglisten-Map.
41.1. Rolle¶
pepsi-stage-aliases schreibt die Umschlagempfänger einer Nachricht vor der Zustellung über eine Zuordnungsdatei um: Jeder Empfänger, der auf einen Eintrag in der Map passt, wird durch die Zieladressen dieses Eintrags ersetzt, Empfänger, die auf nichts passen, bleiben unverändert, die resultierende Liste wird dedupliziert, sodass jede Adresse höchstens einmal zugestellt wird, und die Nachricht schaltet zu NEXT_STAGE weiter. Es ist der klassische /etc/aliases-/Virtual-Domain-Expansionsschritt und wird normalerweise direkt vor der lokalen Zustellung platziert. Es lädt nur den Umschlag und state, nie die Header oder den Nachrichtentext, und es lässt eine Nachricht nie fehlschlagen und schließt sie nie ab (eine nicht lesbare Map wird wiederholt, siehe unten). Referenz: pepsi-stage-aliases(1).
41.2. Funktionen¶
Map-Datei im Postfix-Stil.
ALIASESbenennt eine menschenlesbare Datei, die wie eine Postfix-virtual(5)-Tabelle geparst wird: Jede nicht-leere Zeile bildet einen Schlüssel auf eine oder mehrere Zieladressen ab, getrennt durch Kommas oder Leerraum. Ein Schlüssel ist eine Volladresse, ein@domain-Catch-All oder ein*-Glob wiesales-*@example.org. Die Ziele werden wörtlich übernommen; sie müssen vollständigelocal@domain-Adressen sein und dürfen selbst keine Wildcard enthalten. Ein Schlüssel ohne Ziele wird ignoriert, sodass ein Empfänger nie stillschweigend gelöscht wird.Spezifischster Treffer gewinnt. Ein Empfänger wird kleingeschrieben und wörtlich nachgeschlagen; bei einem Fehlschlag wird der
@domain-Catch-All versucht, dann die spezifischste passende*-Wildcard (ein engessales-*@example.orgschlägt ein breites*@example.org, und dieses schlägt ein bloßes*). Die Subadresse (+tag) wird nicht entfernt, sodass eine bestimmte Listenadresse ihren eigenen Alias haben kann.Transitive Expansion mit Schleifendurchbrechung. Wenn ein Ziel selbst ein Schlüssel ist, wird es seinerseits expandiert, sodass verschachtelte Verteilerlisten zu ihren Blattadressen auflösen; ein Zyklus oder eine Kette mit mehr als 32 Schritten wird durchbrochen, indem der wiederholte Schlüssel auf seine literale Adresse aufgelöst wird, statt ewig zu rekursieren.
Zwischengespeichert. Die Map wird in einen prozessglobalen Cache gelesen und nur dann neu geparst, wenn sich die Identität der Datei (Änderungszeit, Größe oder Inode) ändert, sodass ein ausgelasteter Worker sie nicht pro Nachricht neu liest. Eine fehlende Datei wird als leere Map behandelt (keine Aliase konfiguriert). Eine Datei, die existiert, aber nicht gelesen werden kann (Berechtigungen, ein E/A-Fehler), ist ein Fehler: Die Nachricht wird pausiert und wie jeder andere Fehler des Hosts wiederholt, statt ohne Alias-Auflösung zugestellt zu werden.
pepsi-setupprüft die Datei zur Installationszeit auf Syntax, wenn sie existiert.
41.3. Zustellungsstatusbenachrichtigungen¶
state.dsn.rcpt läuft parallel zur Empfängerliste, daher wird es im Gleichschritt mit den umgeschriebenen Empfängern neu aufgebaut. Ein expandiertes Ziel erbt das NOTIFY des ursprünglichen Empfängers ohne ein etwaiges SUCCESS (ein NOTIFY, das nur SUCCESS war, wird zu NEVER), sodass eine einzige Einlieferung an einen Alias nicht eine positive DSN pro Mitglied nach sich zieht. Gemäß RFC 3461 §5.2.7 trägt das Ziel außerdem ein ORCPT, das auf diesen ursprünglichen Empfänger zeigt (sein bestehendes ORCPT, falls vorhanden, sonst rfc822;<original-recipient>), und ein expanded_from, das ihn nennt. So nennt eine DSN über das Ziel nur den ursprünglichen Empfänger, mit einer generischen Diagnose (pepsi-stage-bounce). Dieselbe Markierung lässt pepsi-stage-srs einem Ziel außerhalb der Site eine Weiterleitungs-Rücksendeadresse statt einer SRS-Adresse geben, sodass ein Bericht, den der eigene Server des Ziels sendet, hierher zurückkommt und auf dieselbe Weise beantwortet wird (Weiterleitungsadressen in Zustellberichten). Ein nicht expandierter Empfänger behält seinen DSN-Eintrag, und RET/ENVID auf Nachrichtenebene sowie jeder andere state-Schlüssel bleiben erhalten.
41.4. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-aliases, der ALIASES-Map-Dateipfad und das NEXT_STAGE, zu dem die expandierte Nachricht weiterschaltet. pepsi-setup erstellt eine Starter-ALIASES-Vorlage, wenn die Datei fehlt, und prüft sie auf Syntax, wenn vorhanden. Siehe pepsi-stage-aliases(1) und Konfiguration.
41.5. State¶
Eingaben: das Umschlag-
rcpt_tound das parallelestate.dsn.rcpt.Ausgaben: ein umgeschriebenes
rcpt_tound ein passendesstate.dsn.rcpt(nur wenn ein Alias zutraf oder ein Duplikat entfernt wurde); kein anderesstatewird berührt.Übergänge: weiterschalten zu
NEXT_STAGE(der einzige Übergang), nach einem zufälligen Zurückhalten von bis zu[pepsi] REFLECTION_HOLD_MAX(30 s), wenn ein Alias angewendet wurde, denn eine expandierte Nachricht ist reflektierte Mail (Unbekannte Empfänger und Backscatter).
41.6. Siehe auch¶
pepsi-stage-relay-to-maildir, pepsi-stage-relay-to-lmtp, pepsi-stage-if, Unterstützte Funktionen, pepsi-stage-aliases(1).