48. pepsi-stage-anti-spam¶
Riegelt eine Nachricht hinter einer GNU-Taler-Zahlung ab (Pay-to-Send).
48.1. Rolle¶
pepsi-stage-anti-spam verlangt für eine andernfalls nicht klassifizierte Nachricht eine GNU-Taler-Zahlung, bevor sie die Pipeline weiter durchlaufen darf. Beim ersten Antreffen erstellt es eine Händler-Bestellung und pausiert die Nachricht. Wird die Nachricht erneut geweckt, leitet die Stage sie weiter, lehnt sie ab oder lässt sie warten. Zwei Dinge wecken sie: der Händler-Webhook pepsi-resume, den pepsi-setup im Taler-Backend so einrichtet, dass er POST /resume auf pepsi-httpd aufruft, und der Ablauf der Frist. Referenz: pepsi-stage-anti-spam(1).
48.2. Entscheidung¶
Das state-JSON der Nachricht entscheidet:
spam: true→ verwerfen (den Datensatz löschen).spam: falseoderpaid: true→ weiterleiten zuNEXT_STAGE(eine explizite Klassifizierung überschreibt den Zahlungsablauf).paid: falsevorhanden → den Händler fragen, ob die Bestellung bezahlt ist:bezahlt → weiterleiten zu
NEXT_STAGE;unbezahlt über die gespeicherte Frist hinaus → ablehnen: umleiten zu
BOUNCE_STAGE(eine Ablehnungs-DSN durch pepsi-stage-bounce oder ein stilles Verwerfen durch pepsi-stage-discard) oder löschen, wenn keinBOUNCE_STAGEverdrahtet ist;unbezahlt, aber noch vor der Frist → mit gesetztem
DELAY_DSN_AFTERist dies der Delay-Kontrollpunkt: dem Absender eine einmalige verzögerte DSN mailen (RFC 3461, nur wenn erNOTIFY=DELAYangefordert hat), ohne die Nachricht freizugeben, dann bisPAYMENT_DEADLINEerneut pausieren; andernfalls mit einer Warnung bis zur Frist erneut pausieren (sollte nicht vorkommen). Der Datensatz bleibtpaused, niepending, was gegen das vorzeitige Aufwecken in einer Busy-Loop kreisen würde.
kein
paid-Feld, aber die Nachricht ist eine, die diese Installation selbst injiziert hat → ohne Bestellung anNEXT_STAGEweiterleiten. Eine solche Nachricht ist entweder eine im Secure-Link-Portal verfasste Antwort (state.secure_link.reply) oder eine Nachricht, deren eigener Header-Block einenPepsi-Origin:-Stempel trägt, der für injizierte Mail geprägt wurde und unter dem HMAC auch die Umschlagempfänger bindet (for=). Der Stempel muss sich verifizieren lassen und jeden Umschlagempfänger des Datensatzes nennen, und seine Nonce muss noch verfolgt werden. Das sind die Secure-Link-Benachrichtigungen, die über den MX dieser Installation wieder hereinkommen. Ein gewöhnlicher ausgehender Stempel nimmt eine Nachricht nie aus, da jeder Empfänger unserer Mail einen hält; ein in einem Nachrichtentext oder einer angehängten Nachricht zitierter Stempel zählt ebenfalls nicht.kein
paid-Feld → eine v1-Bestellung erstellen, bepreist durchORDER_CHOICES(order_idist das Nachrichten-Token), bisPAYMENT_DEADLINEpausieren (oder bis zumDELAY_DSN_AFTER-Kontrollpunkt, wenn dieser früher liegt), dabeipaid: falseundpay_deadlineinstatefesthalten, und dem Absender eine Zahlungsaufforderung mailen (siehe unten). Die Ausnahme ist ein Absender, der SPF oder DMARC eindeutig nicht bestanden hat (fail). Einem solchen Absender wird die Aufforderung nie gesendet, sodass niemand bezahlen könnte; die Nachricht erhält daher keine Bestellung und wird sofort als unbezahlt abgewiesen (BOUNCE_STAGE, sonst gelöscht), statt zwei Tage in der Bestelltabelle des Händlers und der Warteschlange gehalten zu werden (Ressourcenerschöpfung eines Durchsetzers von Portokontingenten).
Die Frist wird in state.pay_deadline gehalten, weil der Dispatcher das timeout des Datensatzes leert, wenn er eine pausierte Nachricht erneut einreiht.
Eine Nachricht mit dem leeren Umschlagabsender (ein Bounce oder eine Auto-Antwort) wird nie abgeriegelt: Die Stage versucht stattdessen, sie als Antwort auf Mail zu verifizieren, die diese Installation tatsächlich gesendet hat, unter Verwendung des Pepsi-Origin:-Herkunftsnachweis-Headers (siehe SMTP-Protokollerweiterungen). Ein Bounce, dessen eingebetteter Header sich verifizieren lässt, wird zu NEXT_STAGE weitergeleitet. Ein Bounce mit gefälschtem oder abgelaufenem Header ist nicht verifizierbar, und ebenso jeder Bounce, wenn der Herkunftsnachweis nicht konfiguriert ist. Ein nicht verifizierbarer Bounce wird zu BOUNCE_TARGET_STAGE geroutet, sofern eine solche konfiguriert ist, und sonst unverändert an der Schranke vorbei zu NEXT_STAGE weitergeleitet. Der Assistent bindet BOUNCE_TARGET_STAGE = discard-rejected ein (eine pepsi-stage-discard-Senke, die er ebenfalls ausgibt), sodass ein gefälschter Bounce verworfen statt zugestellt wird; eine Site, die die legitimen Bounces prüfen will, die sich ebenfalls nicht verifizieren lassen, richtet die Option stattdessen auf eine Quarantäne-Stage. pepsi-setup warnt vor einem von Hand geschriebenen Abschnitt ohne die Option.
Ist das Händler-Backend nicht erreichbar oder antwortet es mit einem Fehler, wird die Nachricht zurückgehalten: Sie bleibt paused mit dem Grund in state.last_error, und der Händler wird alle fünf Minuten erneut gefragt, nie über die Frist hinaus, die beim ersten Versuch festgelegt wird. Kann der Händler auch nach Ablauf der Frist nicht gefragt werden, ist die Stage fail-open und leitet die Nachricht mit einer Warnung an NEXT_STAGE weiter. Eine Bestellung, die der Händler nicht kennt (404), gilt als unbezahlt.
48.3. Zahlungsaufforderungs-Antwort¶
Nach diesem ersten Pausieren erzeugt die Stage eine Auto-Antwort an den Absender, wenn BLOCK_RESPONSE_STAGE gesetzt ist. Sie sendet keine Antwort, wenn RFC 3834 verlangt, dass die Nachricht nicht automatisch beantwortet werden darf (Auto-Submitted mit einem anderen Wert als no, Precedence: bulk|list|junk, X-Auto-Response-Suppress, irgendein List-*-Feld, ein Dienstabsender wie mailer-daemon oder eine VERP-Bounce-Adresse einer Liste, ein multipart/report), oder wenn REQUIRE_AUTHENTICATED eingeschaltet ist und der Absender weder SPF noch DMARC bestanden hat (softfail, neutral, none und vorübergehende Fehler werden andernfalls beantwortet; ein fail erhält, wie oben, überhaupt keine Bestellung). Das sind dieselben gemeinsamen Regeln, die auch der Abwesenheitsbeantworter anwendet. Die Nachricht wird in jedem Fall bis zur Zahlung zurückgehalten; nur die Aufforderung unterbleibt, sodass die Schranke Listenverkehr und andere automatische Beantworter nicht in Backscatter verwandelt. Dasselbe gilt innerhalb von BLOCK_RESPONSE_SUPPRESS (Standardwert 1 h) nach einer früheren Aufforderung an denselben Absender für dasselbe geschützte Postfach: Eine Flut mit einem einzigen gefälschten Absender löst eine Aufforderung pro Fenster aus, nicht eine pro Nachricht. Das Fenster wird in einer einzigen Anweisung beansprucht und festgehalten (payment_request_should_send über pepsi.payment_request_reply, nach dem Muster von vacation_should_reply), sodass nebenläufige Worker nicht beide senden können. Die Antwort erklärt, dass der Empfänger von unbekannten Absendern zuerst eine Zahlung verlangt, und trägt die taler://pay/<backend>/<token>-URI als Link und als QR-Code (ein eingebettetes image/png, per cid: referenziert, sodass es in der breitesten Palette von Clients gerendert wird, während die Nachricht in sich geschlossen bleibt), die akzeptablen Zahlungsoptionen (die ORDER_CHOICES, wobei Token-Familien-Wahlmöglichkeiten weggelassen werden) und einen Verweis auf https://wallet.taler.net/ für Absender ohne Wallet. Wenn der Absender SPF oder DMARC bestanden hat und das ursprüngliche From: einen Anzeigenamen trägt, wird der Absender damit angesprochen und der Betreff zitiert; jeder andere Absender erhält die Aufforderung ohne seine eigenen Worte, da ein Fälscher sonst diesen Host einen Text seiner Wahl an einen Dritten zustellen ließe (Benachrichtigungsabläufe von Anbietern senden vom Angreifer kontrollierte Mail). Der Nachrichtentext wird aus der payment-request.<lang>.body-Mustache-Vorlage unter [pepsi] TEMPLATE_DIR gerendert, ein Abschnitt pro erkannter Sprache, für die eine Vorlage existiert, mit Rückfall auf PAYMENT_MESSAGE_DEFAULT_LANGUAGE (standardmäßig en). Die Antwort verwendet den Null-Absender <> und tritt bei BLOCK_RESPONSE_STAGE ein (normalerweise eine Signier-/Relay-Kette), sodass sie wie jede andere Mail signiert und zugestellt wird. Die Antwort wird vor dem Pausieren gerendert; lässt sie sich nicht erzeugen (etwa eine fehlende Vorlage für die Standardsprache), wird die Nachricht ohne sie bis zur Zahlung zurückgehalten und eine Warnung protokolliert. Das anschließende Einreihen der gerenderten Antwort erfolgt nach bestem Bemühen: Ein Fehler wird protokolliert, das dafür beanspruchte Unterdrückungsfenster wird zurückgegeben, und das Pausieren wird nie rückgängig gemacht.
Die Antwort trägt außerdem zwei maschinenlesbare Header, damit ein sendendes Pepsi die Forderung automatisch begleichen kann (siehe pepsi-stage-auto-pay): einen Taler:-Header mit der taler://pay/…-URI und den Pepsi-Origin:-Header der ursprünglichen Nachricht, wörtlich kopiert (wenn vorhanden), sodass der Ursprungsstandort verifizieren kann, dass die Forderung seine eigene Mail betrifft, und seine Ausgaben pro Nachricht dosieren kann.
48.4. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-anti-spam, NEXT_STAGE (erforderlich — eine bezahlte Nachricht, eine als kein Spam klassifizierte Nachricht und ein verifizierter Bounce gehen alle dorthin), BOUNCE_STAGE, ORDER_CHOICES (das wörtliche choices-JSON-Array der Taler-v1-Bestellung, erforderlich), PAYMENT_DEADLINE (h/m/s-Einheiten; Standardwert 2 Tage), DELAY_DSN_AFTER (h/m/s; optional, eine verzögerte DSN mitten im Fenster senden — siehe oben), SUMMARY (Standardwert E-mail delivery) und FULFILLMENT_MESSAGE. Für die Zahlungsaufforderungs-Antwort: BLOCK_RESPONSE_STAGE (wo sie injiziert wird; nicht gesetzt deaktiviert die Antwort), BLOCK_RESPONSE_FROM (ihr From:; Standard der ursprüngliche Empfänger), BLOCK_RESPONSE_SUBJECT, BLOCK_RESPONSE_SUPPRESS (h/m/s; Standardwert 1 h, 0 s beantwortet jede Nachricht), REQUIRE_AUTHENTICATED (Standard aus; eingeschaltet geht die Aufforderung nur an einen Absender, der SPF oder DMARC bestanden hat) und PAYMENT_MESSAGE_DEFAULT_LANGUAGE (Standardwert en; die zugehörige Vorlage payment-request.<lang>.body muss existieren — pepsi-setup setzt das durch, wenn BLOCK_RESPONSE_STAGE gesetzt ist). BOUNCE_TARGET_STAGE nimmt einen nicht verifizierbaren Bounce auf (der Assistent schreibt discard-rejected); ist es nicht gesetzt, wird ein solcher Bounce unverändert zu NEXT_STAGE weitergeleitet. Erfordert das gemeinsame [pepsi-payments]-Händler-Backend und, für den Resume-Webhook, [pepsi-httpd] RESUME_AUTHORIZATION_TOKEN. Siehe pepsi-stage-anti-spam(1).
48.5. State¶
Eingaben:
state.spam/state.paid(Booleans),state.pay_deadline(Epoch-Sekunden),state.dsn(Empfänger-notify/orcpt).Ausgaben: Bei der ersten Begegnung wird
{paid: false, pay_deadline}instatezusammengeführt, der Datensatz pausiert und eine Zahlungsaufforderungs-Antwort beiBLOCK_RESPONSE_STAGEinjiziert;delay_sent: true, sobald eine Verzögerungs-DSN hinausgegangen ist;last_error, solange der Händler nicht verfügbar ist; bei einer Ablehnung einstate.bounce-Objekt (permanent) für die Bounce-Stage.
48.6. Sicherheit¶
Die Schranke antwortet einem Umschlagabsender, den niemand verifiziert hat, daher befolgt die Zahlungsaufforderung die gemeinsamen Regeln für automatische Antworten und ein Fenster je Absender; die Stage ist Teil der Abwehr gegen Ein entfernter Absender (kein Backscatter, gefälschte Bounces beiseite geleitet) und der Grenzen je Absender in Verfügbarkeit. Die an den Empfänger gebundene Pepsi-Origin-Ausnahme und ihr Schlüssel werden unter Wer die Konfiguration oder ein Geheimnis hat behandelt: Wer das Geheimnis des Herkunftsnachweises hält, kann Stempel prägen, die die Schranke passieren. Führen Sie die Stage nicht in EDITABLE_STAGES auf, wo das Filtern verpflichtend sein soll (Adressbezogene Einstellungen sind eine Vertrauensgrenze).
48.7. Siehe auch¶
pepsi-stage-bounce, pepsi-stage-discard, pepsi-httpd, pepsi-setup, SMTP-Protokollerweiterungen, pepsi-stage-anti-spam(1).