62. pepsi-stage-quarantine¶
Hält eine Nachricht zurück, bis ein Betreiber sie freigibt oder löscht.
62.1. Rolle¶
pepsi-stage-quarantine ist der Ort, an dem Mail in Quarantäne wartet. Eine Quarantäne-Anforderung eines Milters (QUARANTINE_STAGE von pepsi-stage-milter oder ein Pre-Queue-Milter bei pepsi-ingress), QUARANTINE_STAGE von pepsi-stage-decrypt oder jede andere Route kann eine Nachricht dorthin schicken. Die Stage hält sie zurück, bis ein Betreiber mit pepsi-queue quarantine handelt, und versendet selbst keine Benachrichtigung. Weil die Quarantäne eine Stage ist, kann eine Site an ihre Stelle einen anderen Handler setzen. Referenz: pepsi-stage-quarantine(1).
62.2. Funktionen¶
Zurückgehalten ohne Zeitgeber: Beim Eintreffen hält die Stage
state.quarantine.sincefest und lässt den Datensatzpausedohnetimeoutstehen, sodass pepsi-dispatch ihn nie von sich aus aufweckt.Freigegeben durch einen Betreiber:
pepsi-queue quarantine release TOKENgibt den Datensatz an die Stage zurück, diereleased_atfesthält und die Nachricht anRELEASE_STAGEweiterschickt.pepsi-queue quarantine delete TOKENentfernt sie (festgehalten im Maillog, sofern aktiviert). Der Zahlungs-Webhook (POST /resumevon pepsi-httpd) lässt eine zurückgehaltene Nachricht unberührt.Ein optionales Ende: Mit
MAX_HOLD(zum Beispiel14 days) endet das Zurückhalten von selbst; die Nachricht geht dann anEXPIRE_STAGE, so markiert, wiepepsi-queue gceine abgelaufene Quarantäne markiert (failure_class = quarantine-expired, in einer DSN nur der Header-Block), oder sie wird gelöscht. OhneMAX_HOLDerzeugtpepsi-queue gceinen Bounce für eine Nachricht, die[pepsi-queue] QUARANTINE_MAX_AGE_DAYS(14) Tage nach ihrem Eintreffen noch zurückgehalten wird, wie bei jeder Quarantäne-Stage, denn zurückgehaltene Mail liegt als Klartext gespeichert vor.Kein Orakel am Ende: Die Kopie eines Listenbeitrags für ein Mitglied und eine Nachricht, deren Inhalt aus einem Chiffrat ohne Integritätsschutz stammt, werden beim Ablauf gelöscht, statt geroutet zu werden (Bounces und Antworten auf verschlüsselte Mail).
Nach einer Freigabe erneut zurückgehalten: Eine Nachricht, die nach einer früheren Freigabe wieder zu einer Quarantäne-Stage kommt, wird von Neuem zurückgehalten.
Nicht den Korrespondenten überlassen: Die Optionen werden aus der Basiskonfiguration gelesen, nie aus Einstellungen pro Adresse.
62.3. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-quarantine, RELEASE_STAGE (Standardwert NEXT_STAGE; eines der beiden ist erforderlich), MAX_HOLD (eine Zeitspanne; ein Tag zählt als 24 Stunden) und EXPIRE_STAGE (erfordert MAX_HOLD). Eine Nachricht, die Ingress in Quarantäne gestellt hat, hat jede Stage vor dieser übersprungen; für diesen Einsatz ist RELEASE_STAGE daher normalerweise init. pepsi-setup validate und die Startprüfung des Workers weisen ein Ziel zurück, das nicht existiert oder die Stage selbst ist.
62.4. State¶
Eingaben:
state.quarantine.reasonundby, geschrieben von dem, der die Nachricht hierher geschickt hat.Ausgaben:
state.quarantine:since,until(mitMAX_HOLD),released_atoderexpired(pepsi.state(7)).
62.5. Siehe auch¶
pepsi-queue, pepsi-stage-milter, Pepsi betreiben, pepsi-stage-quarantine(1).