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.since fest und lässt den Datensatz paused ohne timeout stehen, sodass pepsi-dispatch ihn nie von sich aus aufweckt.

  • Freigegeben durch einen Betreiber: pepsi-queue quarantine release TOKEN gibt den Datensatz an die Stage zurück, die released_at festhält und die Nachricht an RELEASE_STAGE weiterschickt. pepsi-queue quarantine delete TOKEN entfernt sie (festgehalten im Maillog, sofern aktiviert). Der Zahlungs-Webhook (POST /resume von pepsi-httpd) lässt eine zurückgehaltene Nachricht unberührt.

  • Ein optionales Ende: Mit MAX_HOLD (zum Beispiel 14 days) endet das Zurückhalten von selbst; die Nachricht geht dann an EXPIRE_STAGE, so markiert, wie pepsi-queue gc eine abgelaufene Quarantäne markiert (failure_class = quarantine-expired, in einer DSN nur der Header-Block), oder sie wird gelöscht. Ohne MAX_HOLD erzeugt pepsi-queue gc einen 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.reason und by, geschrieben von dem, der die Nachricht hierher geschickt hat.

  • Ausgaben: state.quarantine: since, until (mit MAX_HOLD), released_at oder expired (pepsi.state(7)).

62.5. Siehe auch

pepsi-queue, pepsi-stage-milter, Pepsi betreiben, pepsi-stage-quarantine(1).