95.1.33. pepsi-stage-secretary

hold mail from unknown senders until they confirm by replying

Handbuchabschnitt:

1

95.1.33.1.1. Name

pepsi-stage-secretary - die Confirm-to-Send-Stage der Pepsi-Pipeline.

95.1.33.1.2. Übersicht

pepsi-stage-secretary [GLOBAL-OPTIONS] worker

95.1.33.1.3. Beschreibung

pepsi-stage-secretary ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Es implementiert Confirm-to-Send (Senden nach Bestätigung) nach dem Vorbild von qmails qsecretary: Mail von einem Absender, den keine weiße Liste kennt, wird zurückgehalten, und der Absender wird in seiner Sprache gebeten, durch eine Antwort zu bestätigen. Die Antwort fügt den Absender der weißen Liste hinzu und gibt jede für ihn zurückgehaltene Nachricht frei; spätere Mail von ihm wird von pepsi-stage-check-whitelist(1) vor dieser Stage erkannt und nie wieder zurückgehalten.

Ohne Antwort bis HOLD_TIME nimmt die zurückgehaltene Mail den Zeitüberschreitungspfad: Sie wird zu BOUNCE_STAGE umgeleitet, wenn eine solche angeschlossen ist (eine DSN, eine Quarantäne oder ein Verwerfen, je nach Wahl des Betreibers), und andernfalls gelöscht. Jeder Empfänger der zurückgehaltenen Zeile erreicht BOUNCE_STAGE auf einer eigenen Zeile, damit eine DSN über jeden von ihnen berichtet und das NOTIFY jedes Empfängers beachtet.

Der Header-Block wird geladen, der Nachrichtentext nie: Eine Challenge zitiert nichts von der zurückgehaltenen Nachricht außer einem kurzen Hinweis auf ihren Betreff.

95.1.33.1.4. Was sie aufhält und was nicht

Confirm-to-Send ist schwächer als Pay-to-Send (pepsi-stage-anti-spam(1)). Ein Spammer mit einem funktionierenden Postfach kann die Antwort automatisieren, und die Erklärung, der der Absender zustimmt (PENALTY), ist eine rechtliche Abschreckung, keine wirtschaftliche. Nützlich ist sie dennoch: Die meiste Massenmail kommt von Adressen, die nicht empfangen können, und einen legitimen Korrespondenten kostet sie eine Antwort, einmal. Beides lässt sich kombinieren; siehe UNCHALLENGEABLE_STAGE.

95.1.33.1.5. Je Nachricht

Die Stage entscheidet in dieser Reihenfolge:

  1. Eine Antwort auf eine Challenge. Ein Empfänger ist die Antwortadresse <CONTROL_LOCAL_PART>-<cookie>@<domain>, wobei <cookie> aus 32 Hexadezimalziffern besteht und <domain> eine der LOCAL_DOMAINS ist (Standardwert [pepsi-ingress] ACCEPTED_DOMAINS). Ein Datensatz, der Antwortadressen mit gewöhnlichen Empfängern mischt, wird zuerst aufgeteilt, wobei beide Hälften zu dieser Stage zurückkehren. Dann gilt:

    • Eine Antwort mit Null-Absender bedeutet, dass die Challenge gebounct ist: Ihre Adresse kann nicht empfangen, also werden die zurückgehaltenen Nachrichten geweckt und nehmen den Zeitüberschreitungspfad jetzt statt nach HOLD_TIME;

    • eine als automatisch gekennzeichnete Antwort wird ignoriert: Auto-Submitted: mit einem anderen Wert als no, Precedence: bulk|list|junk, ein X-Auto-Response-Suppress:, das Auto-Antworten abdeckt, oder ein multipart/report-Nachrichtentext. Ein Abwesenheitsbeantworter, der From: statt des Null-Umschlagabsenders antwortet, darf nicht im Namen seines Inhabers zustimmen;

    • jede andere Antwort bestätigt, sofern ihr Umschlagabsender oder die Addr-spec ihres From: die herausgeforderte Adresse ist. Der Absender wird der weißen Liste hinzugefügt, jede für die Challenge zurückgehaltene Nachricht wird freigegeben, und die Challenge wird gelöscht. Eine Antwort auf ein unbekanntes oder abgelaufenes Cookie oder von irgendjemand anderem wird protokolliert und ändert nichts.

    Die Antwort selbst wird in jedem Fall verbraucht (gelöscht).

  2. Lokal eingelieferte Mail (state.local_origin) geht an NEXT_STAGE. Eine Nachricht mit Null-Absender (ein Bounce, eine automatische Antwort) kann nicht herausgefordert werden, also muss sie beweisen, dass sie auf Mail antwortet, die dieser Host gesendet hat. Sie geht durch, wenn sie ein Pepsi-Origin-Feld trägt, das sich gegen das [pepsi-origin]-Geheimnis verifizieren lässt und dessen Nonce noch verfolgt wird (zwei Wochen). Das Feld darf irgendwo in der Nachricht stehen, denn ein Zustellbericht gibt unseren Header-Block in seinem Nachrichtentext zurück. Jede andere Nachricht mit Null-Absender ist nicht herausforderbar (Schritt 6), sodass ein gefälschter Bounce die Mail eines Fremden nicht an der Schranke vorbeibringt. Mit ausgeschaltetem Herkunftsnachweis ([pepsi-origin] ENABLED = no) lässt sich kein Bounce beweisen, und jeder geht durch; pepsi-setup(1) warnt.

  3. state.spam = false (ein Absender auf der weißen Liste) geht durch; eine durch eine Bestätigung freigegebene Nachricht geht ebenfalls durch und erhält state.spam = false, sodass eine nachgelagerte Pay-to-send-Stage zustimmt.

  4. state.spam = true nimmt sofort den Zeitüberschreitungspfad.

  5. Eine zurückgehaltene Nachricht, die aufwacht: aufgegeben (ihre Challenge ist gebounct) oder über ihre Frist hinaus → der Zeitüberschreitungspfad, wobei die Challenge mit der letzten von ihr zurückgehaltenen Nachricht gelöscht wird, sofern ihre Challenge nicht beantwortet wurde; vorzeitig geweckt → erneut bis zur Frist pausiert.

  6. Erste Begegnung. Die Empfänger werden nach der weißen Liste gruppiert, zu der WHITELIST_NAME für jeden expandiert (eine {login}/{localpart}-Vorlage kann je Empfänger eine andere Liste benennen), und eine Nachricht, deren Empfänger in mehrere Gruppen fallen, wird in einen Datensatz je Gruppe aufgefächert. Dann ist die Nachricht nicht herausforderbar und geht zu UNCHALLENGEABLE_STAGE, wenn:

    • eine RFC-3834-Regel besagt, dass sie nicht beantwortet werden darf (dieselben Regeln, die pepsi-stage-vacation(1) anwendet: Mailinglisten-Mail, Precedence: bulk, Auto-Submitted:, Dienstabsender wie noreply@, Zustellberichte und ein Absender, dessen state.auth.spf oder state.auth.dmarc fail ist);

    • der Absender zugleich einer der Empfänger ist;

    • From: nicht genau ein Postfach nennt oder seine Addr-spec nicht der Umschlagabsender ist: Die Challenge geht an MAIL FROM, und die weiße Liste gleicht From: ab, also müssen beide eine Adresse sein;

    • REQUIRE_AUTHENTICATED an ist und weder state.auth.spf noch state.auth.dmarc pass ist;

    • dem Absender in den letzten 24 Stunden über alle weißen Listen hinweg MAX_CHALLENGES_PER_SENDER Challenges gesendet wurden;

    • WHITELIST_NAME für die Empfänger nicht expandiert (eine {login}-Vorlage und ein Empfänger ohne Konto) oder es keine bediente Domain gibt, unter die die Antwortadresse gesetzt werden kann.

    Andernfalls schließt sich die Nachricht der offenen Challenge für ihr Paar (weiße Liste, Absender) an oder eröffnet eine und sendet die Challenge, und sie wird pausiert, bis die Challenge abläuft. Eine Nachricht, die sich einer bestehenden Challenge anschließt, erbt deren Ablaufzeit, keine frische HOLD_TIME; nur die Nachricht, die eine Challenge eröffnet hat, sendet eine.

Ein zurückgehaltener Datensatz hält state.secretary fest: challenge (das Cookie), deadline (Epochensekunden) und whitelist, später confirmed oder abandoned; an UNCHALLENGEABLE_STAGE gesendete Mail trägt state.secretary.unchallengeable (den Grund). Der Zeitüberschreitungspfad entfernt state.secretary vollständig. Siehe pepsi.state(7).

95.1.33.1.6. Die Challenge

Die Challenge ist eine text/plain-Nachricht, injiziert bei RESPONSE_STAGE, wo sie wie jede ausgehende Mail signiert und weitergeleitet wird. Sie hat den Null-Umschlagabsender und Auto-Submitted: auto-replied (RFC 3834), sodass ein konformer Gegenüber — ein anderer Pepsi-Secretary eingeschlossen — sie nie beantwortet. Sie geht To: an den Umschlagabsender; From: ist die Antwortadresse, angezeigt mit der Adresse des geschützten Empfängers als Anzeigename, und Reply-To: wiederholt sie, sodass die Antworten-Funktion jedes Mail-Clients sie erreicht. Sie erscheint über In-Reply-To:/References: im Thread unter der zurückgehaltenen Nachricht und trägt Content-Language:.

Sie zitiert nie den Nachrichtentext oder die Anhänge der zurückgehaltenen Nachricht: Eine Challenge geht an eine Adresse, die bei Spam meist gefälscht ist, sodass alles, was sie zitierte, von uns an einen Fremden zugestellt würde.

95.1.33.1.6.1. Der Text

Je Sprache, höchste zuerst:

  1. MESSAGE_<LANG> im eigenen Abschnitt der Stage, der je Adresse überschreibbar ist, sodass ein Benutzer einen eigenen Text setzen kann, über pepsi-settings(1) oder pepsi-stage-edit-settings(1);

  2. <TEMPLATE>.<lang>.body unter [pepsi] TEMPLATE_DIR (Standardwert secretary-challenge.<lang>.body).

Die erste Quelle gewinnt je Sprache, nicht insgesamt: Das MESSAGE_EN eines Benutzers verdrängt nicht die mitgelieferte deutsche Vorlage für einen deutschen Absender. Die Sprache wird so gewählt, wie pepsi-stage-vacation(1) sie wählt: state.language in absteigender Konfidenz, dann DEFAULT_LANGUAGE, jeweils nach exaktem Tag, primärem Subtag oder einem verfeinernden Regions-Tag. Es gelten dieselben Regeln wie dort: Zwei Leerzeichen in einem Text werden zu einem Zeilenumbruch, und die unten aufgeführten Felder werden unverändert ausgegeben, gleich welcher Klammerstil verwendet wird.

Eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData stammt oder sich daraus nicht öffnen ließ (AES-CBC, kein Integritätsschutz), gilt als ohne erkannte Sprache: Die Sprache hängt davon ab, ob sich ein verändertes CBC-Chiffrat öffnen ließ, und eine in ihr geschriebene Challenge würde dem Absender verraten, ob es sich öffnen ließ.

Der Betreff ist SUBJECT_<LANG> für die Sprache, in der der Text gewählt wurde, sonst der mitgelieferte Betreff für diese Sprache (die zehn Sprachen, in denen die Vorlagen mitgeliefert werden), sonst SUBJECT; auch er ist ein Mustache-Text. Ein ausdrückliches SUBJECT schaltet die mitgelieferten Übersetzungen ab, sodass es für jede Sprache ohne SUBJECT_<LANG> verwendet wird. Wird nichts gerendert (kein Text für die Sprache oder den Standardwert, oder eine Vorlage, die nicht kompiliert), wird der eingebaute englische Text gesendet und eine Warnung protokolliert: Eine nicht gesendete Challenge kostet den Absender seine Nachricht.

95.1.33.1.6.2. Felder

{{SENDER_NAME}}

Der Anzeigename im From: des Absenders oder seine Adresse; immer die Adresse bei einem Absender, der weder SPF noch DMARC bestanden hat (nur unter REQUIRE_AUTHENTICATED = no herausgefordert), dessen Umschlagabsender gefälscht sein kann.

{{RECIPIENT}}

Der oder die Umschlagempfänger der zurückgehaltenen Nachricht, durch Kommas getrennt.

{{SUBJECT_HINT}}

Der Betreff der zurückgehaltenen Nachricht, RFC-2047-dekodiert und auf SUBJECT_HINT_LENGTH Zeichen gekürzt (mit …, wenn gekürzt). Das genügt, damit ein Korrespondent seine Mail wiedererkennt, ist aber zu wenig, um eine Nutzlast zu transportieren. Fehlt bei einem leeren Betreff, einer Länge von 0, einer verschlüsselt eingetroffenen Nachricht (deren Betreff das Ergebnis der Entschlüsselung trägt; siehe pepsi-stage-bounce(1)) oder einem Absender, der weder SPF noch DMARC bestanden hat: Seine Worte zu zitieren ließe einen Fälscher diesen Host einen Text seiner Wahl an einen Dritten zustellen.

{{ORIGINAL_DATE}}

Das Date: der zurückgehaltenen Nachricht — fehlt, wenn sie keines hat.

{{DEADLINE}}

Wann die Challenge abläuft, als YYYY-MM-DD HH:MM UTC.

{{REPLY_ADDRESS}}

Die Antwortadresse.

{{PENALTY}}

Die konfigurierte PENALTY — fehlt, wenn keine gesetzt ist, sodass eine Vorlage den Satz mit {{#PENALTY}}…{{/PENALTY}} weglässt.

95.1.33.1.6.3. Die Bestätigungsnotiz

Mit eingeschaltetem CONFIRM_NOTICE wird einem bestätigten Absender außerdem mitgeteilt, dass seine Mail zugestellt wurde: eine Benachrichtigung mit Null-Absender von <CONTROL_LOCAL_PART>@<domain>, deren Text aus CONFIRM_MESSAGE_<LANG> oder secretary-confirmed.<lang>.body stammt (mit eingebautem englischem Rückfall) und deren Betreff der mitgelieferte für die Sprache ist, in der der Text gewählt wurde (sonst Englisch); es gibt keine Betreff-Option dafür.

95.1.33.1.8. Optionen

Alle diese sind je Adresse überschreibbar, außer NEXT_STAGE und BOUNCE_STAGE, die immer aus der Konfiguration des Betreibers genommen werden.

NEXT_STAGE

Wohin durchgelassene, auf der weißen Liste stehende und bestätigte Mail geht. Erforderlich.

RESPONSE_STAGE

Stage, bei der die Challenge (und die Bestätigungsbenachrichtigung) injiziert wird, damit sie signiert und weitergeleitet wird. Erforderlich. Beide sind als Pepsis eigene markiert (state.notice, Art secretary), und eine NOTICE_SIGNER-Stage signiert sie (siehe pepsi-stage-encrypt(1)), außer solange für die herausgeforderte Nachricht eine adressbezogene Überschreibung gilt, da eine Überschreibung den Wortlaut ändern kann.

BOUNCE_STAGE

Der Zeitüberschreitungspfad. Nicht gesetzt, wird Mail mit abgelaufener Frist gelöscht, ebenso Mail, die nicht herausgefordert werden kann, wenn auch UNCHALLENGEABLE_STAGE nicht gesetzt ist. Die meisten Newsletter und Transaktions-Mails können nicht herausgefordert werden. Der Assistent von pepsi-setup(1) setzt die Option auf pepsi-stage-bounce(1), damit solche Mail sichtbar abgelehnt wird. Eine unbeantwortete Challenge kann einen gefälschten Absender bedeuten, und diese Stage sendet die DSN nur, wenn die Nachricht die Domain des Absenders authentifiziert hat (BOUNCE_UNAUTHENTICATED).

UNCHALLENGEABLE_STAGE

Wohin Mail geht, die nicht herausgefordert werden darf (siehe oben), einschließlich einer Nachricht mit Null-Absender ohne Herkunftsnachweis. Nicht gesetzt, nimmt sie den Zeitüberschreitungspfad, der sie über BOUNCE_STAGE ablehnt und eine Nachricht mit Null-Absender löscht (für einen Bounce wird nie ein Bounce erzeugt). Richten Sie sie auf eine pepsi-stage-anti-spam(1)-Stage, um solche Absender stattdessen um Zahlung zu bitten, auf NEXT_STAGE, um sie zuzustellen, oder auf einen Spamfilter.

WHITELIST_NAME

Die eine weiße Liste, zu der ein bestätigter Absender hinzugefügt wird; darf eine {login}/{localpart}-Vorlage sein, die je Empfänger expandiert wird, genau wie in pepsi-stage-check-whitelist(1). Erforderlich. Eine Check-Whitelist-Stage vor dieser muss sie konsultieren, sonst wird ein bestätigter Absender bei jeder Nachricht erneut herausgefordert (pepsi-setup(1) warnt).

Jeder Fremde, der eine Challenge beantwortet, wird in diese Liste eingetragen, daher darf ein Kontoinhaber sie nur in seinen eigenen Namensraum zeigen lassen: Ein Wert, den er per Mail über pepsi-stage-edit-settings(1) setzt, muss für seine Adresse zu einem Namen <login>/... des Kontos expandieren, zu dem diese Adresse aufgelöst wird (etwa {login}/friends), oder die Whitelist sein, die die Konfiguration des Betreibers bereits für ihn benennt. Ein globaler Name, die Liste eines anderen Benutzers oder irgendein Wert für eine Adresse, die kein lokales Konto ist, wird dort zurückgewiesen, und nichts ändert sich.

Der Betreiber darf jede Whitelist benennen, auch eine gemeinsame: in der INI-Datei, in pepsi.config_override in jedem Geltungsbereich (global, domain:, address:) und in einem mit pepsi-settings(1) geschriebenen pepsi.settings-Datensatz. Die Stage verwendet den effektiven Wert, so wie sie ihn vorfindet.

CONTROL_LOCAL_PART

Der Local-Part, mit dem Antwortadressen beginnen. Standardwert secretary. Höchstens 30 ASCII-Buchstaben, Ziffern, ., _ oder -, weder mit . oder - beginnend noch endend und ohne ..; er wird in Kleinbuchstaben umgewandelt.

HOLD_TIME

Wie lange eine zurückgehaltene Nachricht auf ihren Absender wartet. Standardwert 120 h. Verwenden Sie h/m/s-Einheiten.

REQUIRE_AUTHENTICATED

Nur einen Absender herausfordern, dessen Domain SPF oder DMARC bestanden hat. Standardwert yes: Dies ist die Schranke gegen Backscatter.

MAX_CHALLENGES_PER_SENDER

Challenges, die an eine Adresse je 24 Stunden über alle weißen Listen hinweg gesendet werden dürfen. Standardwert 5; 0 bedeutet keine Begrenzung. Eine gebouncte Challenge zählt dennoch.

DKIM_REQUIRED

auto (der Standardwert), yes oder no: das dkim_required des für einen bestätigten Absender geschriebenen Whitelist-Datensatzes. auto spiegelt die zurückgehaltene Mail: DKIM ist erforderlich, wenn irgendeine für die Challenge zurückgehaltene Nachricht DKIM (oder ARC zusammen mit DMARC) bestanden hat. Hat keine das getan, aber eine DMARC bestanden (ein ausgerichteter SPF-Pass oder die Übersteuerung durch einen vertrauenswürdigen ARC-Versiegler), wird der Datensatz stattdessen mit dmarc_required geschrieben, sodass ein Absender, dessen Domain nicht signiert, dennoch an eine authentifizierte Identität gebunden ist statt an eine Adresse, die jeder fälschen kann. no schreibt keines von beiden.

CONFIRM_NOTICE

Einem bestätigten Absender mitteilen, dass seine Mail zugestellt wurde. Standardwert no.

PENALTY

Freitext, der benennt, was der Absender zu zahlen zustimmt, falls seine Nachricht unerwünscht war (z. B. EUR:50). Standardmäßig nicht gesetzt.

SUBJECT_HINT_LENGTH

Zeichen des zurückgehaltenen Betreffs, die in der Challenge zitiert werden. Standardwert 8; 0 lässt den Hinweis weg; höchstens 64.

TEMPLATE

Basisname der Vorlagendateien der Challenge. Standardwert secretary-challenge.

SUBJECT

Betreff der Challenge, wenn kein SUBJECT_<LANG> passt. Standardwert Please confirm your message to {{RECIPIENT}}, das für seine mitgelieferten Übersetzungen steht: Nicht gesetzt, erhält ein in einer der zehn mitgelieferten Sprachen gewählter Text den Betreff dieser Sprache. Ausdrücklich gesetzt, wird er für jede Sprache ohne SUBJECT_<LANG> verwendet.

DEFAULT_LANGUAGE

Sprache, die verwendet wird, wenn keine der erkannten Sprachen des Absenders einen Text hat. Standardwert en; pepsi-setup(1) verlangt einen Text dafür.

MESSAGE_<LANG>, SUBJECT_<LANG>, CONFIRM_MESSAGE_<LANG>

Überschreibungen je Sprache für den Challenge-Text, seinen Betreff und den Bestätigungstext.

LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER

Die gemeinsamen Lokalitätsoptionen: unter welchen Domains eine Antwortadresse liegen darf und wie {login}/{localpart} expandieren.

95.1.33.1.9. Platzierung

Auf dem eingehenden Pfad:

  • nach pepsi-stage-detect-language(1), damit die Challenge in der Sprache des Absenders verfasst ist;

  • nach pepsi-stage-check-whitelist(1), deren state.spam = false einen bekannten Absender passieren lässt (diese Stage fragt die Whitelist selbst nie ab);

  • vor pepsi-stage-aliases(1), dem Listen-Router und der lokalen Zustellung, von denen keiner eine Antwortadresse zuerst sehen darf (ein @domain-Catch-all oder ein - als RECIPIENT_DELIMITER würde sie umschreiben).

Der ausgehende Pfad sollte pepsi-stage-auto-whitelist(1) in denselben WHITELIST_NAME schreiben lassen, damit die Personen, an die Ihre Benutzer schreiben, beim Antworten nie eine Challenge erhalten. Spam-Milter laufen standardmäßig vor check-whitelist; der Abschnitt „Spam filters and the secretary“ des Handbuchs beschreibt, wie man sie hinter diese Stage verlegt.

95.1.33.1.10. Datenbank

Drei Tabellen. pepsi.secretary_challenge enthält eine offene Challenge je (Whitelist, Absender): das Cookie, den Ablaufzeitpunkt und ob irgendeine zurückgehaltene Nachricht DKIM bestanden hat. pepsi.secretary_sent hält dass eine Challenge gesendet wurde, ohne ihr Cookie, für die 24-Stunden-Obergrenze fest. Sie wird getrennt gehalten, damit eine Challenge, die beantwortet wird, bouncet oder abläuft, ihrem Absender das Kontingent nicht zurückgibt. pepsi.secretary_answered hält fest, dass eine Challenge beantwortet wurde, bis einen Tag nach dem Zeitpunkt, zu dem sie abgelaufen wäre. Eine Nachricht, die sich in diesem Moment noch der Challenge anschloss, findet die Antwort dort, sobald sie pausiert ist. Keine Antwort wird je mit dieser Tabelle abgeglichen, daher passt eine verspätete Antwort weiterhin auf nichts. Fünf Funktionen erledigen die Arbeit mit je einer Anweisung: secretary_challenge_claim() (race-sicher: zwei Worker, die dasselbe Paar beanspruchen, eröffnen eine Challenge), secretary_confirm(), secretary_release_answered(), secretary_abandon() und secretary_expire(). Abgelaufene Zeilen werden beim Beanspruchen neuer Challenges aufgeräumt; es muss kein Cron-Job laufen.

95.1.33.1.11. Unterbefehle

worker

Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.

95.1.33.1.12. Globale Optionen

-c FILE, –config FILE

Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.

-L LOGLEVEL, –log LOGLEVEL

Setzt die Log-Ausführlichkeit (Standardwert [pepsi] LOG, sonst info).

-v, –verbose

Zeigt Log-Meldungen aus allen Quellen.

-h, –help; -V, –version

Gibt eine Verwendungsübersicht / die Version aus und beendet sich.

95.1.33.1.13. Exit-Status

Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) auf der Statuszeile des Workers gemeldet, nicht als Exit-Status. Eine Nachricht, die nicht running ist, oder eine Einstellung pro Adresse, die den Abschnitt der Stage unbrauchbar macht, lässt diese Nachricht fehlschlagen; ein Fehler des Hosts (die Datenbank, eine Vorlage oder ein Helfer, die sich nicht verwenden lassen) ist kein Fehlschlag: Die Nachricht wird pausiert und erneut versucht, wie Stage errors in pepsi-dispatch(1) beschreibt.

Eine Challenge, die sich nicht einreihen lässt, ist ein Fehler des Hosts. Sie wird zurückgezogen, und die Nachricht wird wiederholt, statt sie für eine Antwort zurückzuhalten, um die niemand gebeten wurde. Das Zurückziehen löscht die Challenge, sofern sich ihr nicht inzwischen eine andere zurückgehaltene Nachricht angeschlossen hat, und gibt dem Absender seinen MAX_CHALLENGES_PER_SENDER-Platz zurück.

0

Der Worker lief, bis seine Standardeingabe geschlossen wurde.

1

Ein fataler Fehler ist aufgetreten (unlesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, oder die Standardein- bzw. -ausgabe schlug fehl). Der Grund wird in das Protokoll geschrieben.

78

Der Worker hat den Start verweigert: Ein [stage-*]-Abschnitt, den er bedient, lässt sich nicht parsen. Der Dispatcher reiht wieder ein, was er übergeben hatte, und versucht die Stage später erneut.

95.1.33.1.14. Beispiele

Ein Pipeline-Abschnitt auf dem eingehenden Pfad:

[stage-check-whitelist]
PROGRAM = pepsi-stage-check-whitelist
NEXT_STAGE = secretary
WHITELIST_NAME = correspondents

[stage-secretary]
PROGRAM = pepsi-stage-secretary
NEXT_STAGE = local
RESPONSE_STAGE = dkim-sign
WHITELIST_NAME = correspondents
PENALTY = EUR:50

Der eigene Challenge-Text eines Benutzers, vom Betreiber eingetragen:

pepsi-settings -c /etc/pepsi/pepsi.conf set alice@example.org secretary \
    MESSAGE_EN "Hi {{SENDER_NAME}},  please reply once to reach me."

95.1.33.1.15. Siehe auch

pepsi-stage-check-whitelist(1), pepsi-stage-auto-whitelist(1), pepsi-stage-anti-spam(1), pepsi-stage-vacation(1), pepsi-whitelist(1), pepsi-settings(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)

RFC 3834 (automatische Antworten).

Das Kapitel Threat model des Handbuchs (die Abschnitte zum entfernten Absender und zur Verfügbarkeit) legt die Backscatter- und Ratenzusagen dar, an die die Challenge gebunden ist; sein Kapitel Security model (Unknown recipients and backscatter, Resource limits) beschreibt die gemeinsamen Regeln für automatische Antworten.

95.1.33.1.16. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.