32. pepsi-ingress¶
Der eingehende SMTP-Server (MTA) und der Einstiegspunkt der Pipeline.
32.1. Rolle¶
pepsi-ingress betreibt den SMTP-Server, der Mail empfängt, sie an der Grenze authentifiziert und jede angenommene Nachricht als einen pepsi.workqueue-Datensatz bei stage = init speichert, bevor er den Dispatcher benachrichtigt. Es ist die einzige Komponente, die mit externen sendenden Clients spricht; alles Nachgelagerte operiert auf dem gespeicherten Datensatz. Die vollständige Optionsreferenz ist pepsi-ingress(1) / pepsi.conf(5).
32.2. Funktionen¶
32.2.1. Empfang (RFC 5321)¶
SMTP/ESMTP-Server mit Transport pro Listener: Klartext, STARTTLS-Upgrade (RFC 3207) und implizites TLS (RFC 8314); Listener binden TCP-, UNIX- oder systemd-aktivierte Sockets.
Nachrichtentexte über DATA oder CHUNKING/BDAT (RFC 3030).
Kündigt SIZE an (setzt
MAX_MESSAGE_SIZEdurch →552), PIPELINING, ENHANCEDSTATUSCODES, 8BITMIME (RFC 6152), SMTPUTF8 (RFC 6531), DSN (RFC 3461) und RRVS (RFC 7293) sowie — nur auf einer TLS-geschützten Sitzung — REQUIRETLS (RFC 8689): Der Parameter markiert die Nachricht (state.tls_required) für validiertes TLS auf jedem weiteren Hop, einTLS-Required: No-Header-Feld markiert sie für das Gegenteil, und auf einer Klartextsitzung wird der Parameter mit530 5.7.10abgelehnt;VRFYantwortet252,EXPN502.Nimmt Mail nur für
ACCEPTED_DOMAINSan (andere →550 5.7.1Relaying, sofern die Sitzung nicht authentifiziert ist); nimmt das domainlose<Postmaster>immer an (RFC 5321 §4.5.1), umgeschrieben zuPOSTMASTERoderpostmaster@HOSTNAME.Unbekannte Empfänger in einer bedienten Domain werden bei
RCPTmit550 5.1.1abgelehnt, wenn etwas auf dem Host es feststellen kann (VERIFY_RECIPIENTS = auto, der Standard): ein lokales Konto, ein Alias, eine Mailingliste, eine Dienstadresse oder ein LMTP-/Gateway-Backend, das mitMAIL FROM:<>/RCPT TOgefragt wird. Jede Unsicherheit nimmt an;MAX_INVALID_RECIPIENTS(10) unbekannte Empfänger schließen die Sitzung mit421. Siehe Unbekannte Empfänger und Backscatter.Veraltete Routing-Syntax. Ein Local-Part mit
%(der Percent-Hack) oder!(ein Bang-Pfad) in einer bedienten Domain wird mit550 5.1.3abgelehnt, sofern keine Postfach-Autorität für die Adresse bürgt, sodass einem Backend hinter einer nicht verifizierten Domain nie ein Weg zu einem Dritten übergeben wird.Reverse DNS. Mit
IPREV_ACTION = rejectantwortet Ingress mit550 5.7.25(RFC 7372) auf die Empfänger einer nicht authentifizierten Sitzung, die keine Submission-Sitzung ist und deren Client-Reverse-DNS eindeutig fehlschlägt (iprev=fail);<postmaster>ist ausgenommen. Der Standardnonehält nur das Urteil fest.Dauerhafte Annahme: gibt
250erst zurück, nachdem der Datensatz committet wurde; ein Datenbankausfall ergibt ein vorübergehendes451.MAX_CONNECTIONSund ein Budget vonMAX_OPEN_SOCKETSDateideskriptoren begrenzen die Zahl gleichzeitiger Verbindungen. Gegen Verbindungsmissbrauch begrenzt Ingress die Rate neuer Verbindungen pro Quellbereich (CONN_RATE_PER_SECOND); ein Quellbereich ist eine IPv4-Adresse oder ein IPv6-Präfix /32. Ist diese Grenze erreicht und kommt eine neue Verbindung an, schließt Ingress die am längsten untätige Verbindung in dem Quellbereich, dessen Verbindungen zusammen am längsten untätig waren (ist keine Verbindung untätig, die älteste). Ein Quellbereich darfMAX_CONNECTIONS_PER_IP(16) Verbindungen halten, alle lokalen Verbindungen zusammenMAX_LOCAL_CONNECTIONS(32, höchstens die Hälfte davon je uid; ist es voll, verdrängt eine uid, die weniger hält, die am längsten untätige Verbindung der schwersten uid, die mindestens 5 s untätig ist, mit421 4.3.2).Grenzen je Sitzung und sitzungsübergreifend:
MAX_MESSAGES_PER_SESSION(100), höchstens 1000 Empfänger pro Transaktion (452 4.5.3), drei fehlgeschlageneAUTHpro Sitzung undAUTH_FAILURES_PER_HOUR(20) pro Quellbereich (dann421, ohne das SASL-Backend zu fragen),ACCOUNT_AUTH_FAILURES_PER_HOUR(10) pro Konto aus allen Quellen (dannACCOUNT_AUTH_DELAY, 20 s, vor jedem Versuch aus einem Bereich, aus dem sich das Konto nicht angemeldet hat, ein Versuch auf einmal; nie eine Sperre) sowieLOCAL_MESSAGES_PER_MINUTE/LOCAL_MESSAGE_BURSTje lokaler uid (451 4.7.1) undUSER_RECIPIENTS_PER_HOUR/USER_RECIPIENT_BURST(je 500) angenommene Empfänger je SASL-Konto (450 4.7.1).Routing-Schleifen: Eine Nachricht, die den Ingress dieses Hosts bereits
MAX_SELF_HOPS(5) Mal passiert hat, gezählt anhand ihrer eigenenReceived:-Felder, wird mit554 5.4.6abgelehnt.Zulassungskontrolle der Warteschlange: Solange die Warteschlange oder die Platte darunter an einer
[pepsi]-Grenze liegt (MAX_QUEUE_ROWS,MAX_QUEUE_BYTES,MIN_FREE_SPACE), antwortet der Ingress beiRCPT,DATA/erstemBDATund nach dem Ende der Daten mit452 4.3.1; jede Unsicherheit lässt zu. Die Grenzen und was sie schützen, sind in Verfügbarkeit und unter Ressourcengrenzen aufgeführt.Eine HTTP-Anfragezeile oder ein HTTP-Header (
GET/POST/CONNECT,Host:, …), an den SMTP-Port gesendet, schließt die Sitzung mit554, sodass ein Browser oder HTTP-Proxy nicht dazu benutzt werden kann, SMTP-Befehle in einem Anfrage-Rumpf einzuschmuggeln. Die zehnte Zeile, die überhaupt kein Befehl ist, schließt sie mit421 4.7.0, und ein TLS-ClientHello, dessen ALPN-Angebot nur HTTP-Protokolle nennt, wird mit einemno_application_protocol-Alert abgelehnt (der ALPACA-Vektor; RFC 9325).Lese-Timeouts pro Befehl (
COMMAND_TIMEOUT/DATA_TIMEOUT, RFC 5321 §4.5.3.2) schließen langsame oder ins Stocken geratene Sitzungen;TLS_HANDSHAKE_TIMEOUT(30 s) schließt eine Verbindung, deren TLS-Handshake, implizit oder nachSTARTTLS, bis dahin nicht abgeschlossen ist. Eine Verbindung, die auf die nächsten Bytes einesDATA/BDAT-Rumpfs wartet, gilt als untätig, sodass ein Client, der seinen Rumpf tröpfeln lässt, wie einer verdrängt werden kann, der keinen Befehl sendet.SESSION_TIMEOUT(30 m) begrenzt außerdem die ganze Sitzung: Die Timeouts pro Lesevorgang werden von jedem Byte zurückgesetzt, die Frist von nichts, sodass eine Transaktion nicht länger als das an einem Punkt nach Wahl des Clients geparkt werden kann.Ein übergroßer
DATA-Rumpf wird bis zu seinem Ende gelesen und mit552abgelehnt; treffen weitereMAX_MESSAGE_SIZEOktette ohne die Ende-der-Daten-Markierung ein, antwortet der Server stattdessen mit552und schließt.Header-Grenzen. Ein Header-Block der obersten Ebene mit mehr als
MAX_HEADER_FIELDS(1000) Feldern oder ein Feld größer alsMAX_HEADER_FIELD_SIZE(100 KiB entfaltet) wird auf jedem Listener mit552 5.3.4abgelehnt, die Grenze, die die Dovecot-Advisories CVE-2024-23184/23185 vom MTA vor dem Mailspeicher verlangen.Abwehr von SMTP-Smuggling. Ein bloßes LF in einem
DATA-Rumpf oder ein von einem bloßen CR eingerahmter Punkt (<CR>.<CR>,<CR>.<CR><LF>,<CR><LF>.<CR>) wird mit500 5.6.0abgelehnt und die Verbindung geschlossen, sodass keinem Empfänger, der ein einzelnes CR oder LF als Zeilenende behandelt, ein vorzeitiges Ende der Nachricht vorgespiegelt werden kann. Andere bloße CRs gehen unverändert durch.Nachsichtige Zeilenlängen. Die Grenzen aus RFC 5321 §4.5.3.1.4/§4.5.3.1.6 (512-Oktett-Befehlszeilen, 1000-Oktett-Textzeilen) binden Sender; gemäß dem Hinweis desselben Abschnitts, dass Empfänger liberal sein sollen, nimmt Ingress längere Zeilen an. Die internen Obergrenzen
MAX_CMD_LINEundMAX_DATA_LINEschützen nur vor Speichererschöpfung und setzen keine Konformität durch: Wächst eine Zeile ohne Terminator über die Obergrenze, lässt Ingress die Verbindung fallen.
32.2.2. Trace-Header¶
Stellt vor der Authentifizierung einen
Received:-Header gemäß RFC 5321 §4.4 voran (sodass die ARC-Versiegelung ihn abdeckt) und hält den Client (HELO/EHLO, Reverse-DNS, IP), diesen Server, den ÜbertragungstypSMTP/ESMTP/ESMTPS/ESMTPA/ESMTPSA(RFC 3848) und die Zeit fest; bei Einzelempfänger-Transaktionen wird einefor-Klausel hinzugefügt. Bei einer verschlüsselten Sitzung werden die ausgehandelte TLS-Version und -Chiffre als(version=… cipher=…)-Kommentar nach demESMTPS-Schlüsselwort angehängt (RFC 8314 §4.3).
32.2.3. Authentifizierung (an der Grenze festgehalten)¶
SPF (RFC 7208), DKIM-Verifikation (RFC 6376 / RFC 8463) und DMARC (RFC 7489), plus iprev/FCrDNS (RFC 8601).
Stellt einen Authentication-Results-Header (RFC 8601) mit dem Ingress-
HOSTNAMEalsauthserv-idvoran; die Urteile werden außerdem unterstate.auth(spf/dkim/dmarc/arc) gespeichert.Zählt nie eine
rsa-sha1-Signatur (RFC 8301,permerror) oder eine unter einem mitt=yveröffentlichten Schlüssel (Testmodus nach RFC 6376,neutral) als DKIM-Pass, beachtet dasadkim=sderFrom:-Domain instate.auth.dkimund begrenzt SPF auf zwei leere Abfragen (RFC 7208 Abschnitt 4.6.4,permerror).Fail-open: Nur ein eindeutiger DMARC-Fehlschlag unter
DMARC_ENFORCElehnt ab (550); DNS-/Parse-Fehler werden festgehalten und die Mail angenommen. Der Assistent schreibt für eine neue InstallationDMARC_ENFORCE = yes; der eingebaute Standard ist aus, sodass eine bestehende Konfiguration ihr Verhalten behält, undpepsi-setupwarnt vor einer, die die Option nicht setzt oder ausgeschaltet lässt, während eine bediente Domainp=rejectveröffentlicht. EinFrom:, das mehrere Domains nennt, wird für jede ausgewertet (bis zu 10), und unterDMARC_ENFORCElehnt Ingress nicht authentifizierte Mail ab, auf die DMARC nicht angewendet werden kann (keineFrom:-Adresse, mehr als 10 Domains). Die eine Übersteuerung ist eine validierende ARC-Kette (RFC 8617), deren letzter Versiegler inARC_TRUSTED_SEALERSgenannt ist, der Liste der Weiterleiter und Mailinglisten, denen der Betreiber vertraut (standardmäßig leer). Eine solche Nachricht wird alsstate.auth.arc_overridefestgehalten, währendstate.auth.dmarcweiterhinfaillautet. Jede Ablehnung wird mit dem letzten Versiegler der abgelehnten Kette protokolliert (arc-sealer=<domain>, wenn die Kette validiert), sodass das Protokoll die Kandidaten für diese Liste nennt.Begrenzte Arbeit: Höchstens
MAX_DKIM_SIGNATURES(10) Signaturen werden verifiziert, die mit derFrom:-Domain ausrichtbaren zuerst, unter einer einzigenVERIFY_TIMEOUT-Frist (20 s); ein Timeout ist eintemperror, der an seine eigene Signatur gebunden ist, sodass ein Fälscher das DNS nicht verlangsamen kann, umDMARC_ENFORCEzu entgehen.
32.2.4. Hygiene eingehender Header¶
Eine Nachricht mit mehr als einem
From:-Feld wird auf jedem Listener mit550 5.6.0abgelehnt, da Clients sich uneinig sind, welches sie anzeigen.Der Ingress entfernt jedes
Bcc:- undResent-Bcc:-Feld aus jeder Nachricht, ob eingeliefert oder nicht, und auf einer nicht authentifizierten Sitzung außerdem jedesX-Pepsi-List-Hops:(den Schleifenzähler der Mailinglisten). Beides geschieht nach SPF/DKIM/DMARC, sodass Signaturen anhand der Bytes beurteilt werden, die signiert wurden.Adressbehauptungen im Anzeigenamen. Ein
From:, dessen Anzeigename oder Kommentar eine andere Adresse als die der Mailbox selbst nennt ("ceo@example.com" <mallory@example.net>, beurteilt wie dargestellt: Encoded-Words dekodiert, Doppelgänger-@zurückgefaltet), wird markiert, nicht abgelehnt oder umgeschrieben: Jedes vom Absender geschriebeneX-Pepsi-Warningwird entfernt,X-Pepsi-Warning: display-name-claims-other-addresswird vorangestellt, und die behauptete Adresse wird alsstate.auth.display_name_mismatchfestgehalten. Eingelieferte Mail mit einem solchenFrom:wird stattdessen abgelehnt. Siehe Was ein Sicherheitsindikator bedeutet.Verborgene Zeichen in
From:. EinFrom:(Encoded-Words dekodiert), das ein bidirektionales Steuerzeichen, eine Richtungsmarke oder ein unsichtbares Zeichen trägt, das das Feld als etwas anderes erscheinen lassen kann (\u202Eelpmaxe.knab@oecliest sich alsceo@bank.example), wird mitX-Pepsi-Warning: from-has-bidi-or-invisible-charactersmarkiert; das Feld wird wie empfangen zugestellt. Der Zero-Width-Joiner und -Non-Joiner und die Variantenselektoren zählen nicht.Getarnte Anhangsnamen. Eine Nachricht mit einem Anhang, dessen Dateiname (RFC 2231 und RFC 2047 dekodiert, angehängte Nachrichten eingeschlossen) eines dieser Zeichen trägt, wird mit
X-Pepsi-Warning: attachment-name-has-bidi-or-invisible-charactersmarkiert; der Name wird wie empfangen zugestellt.Doppelgänger einer bedienten Domain. Eine
From:-Domain mit demselben UTS-#39-Skelett wie eine bediente Domain, aber anderem Namen (examp1e.org), wird mitX-Pepsi-Warning: from-domain-resembles-served-domainmarkiert, nur im Header, ohne die Markierung[external].Mehrdeutiges MIME (
MIME_ANOMALIES, Standardwertenforce). Die harten Klassen werden mit554 5.6.0abgelehnt: eine leere Begrenzung, ein NUL in einem MIME-Header, widersprüchliche doppelteContent-Type-/Content-Transfer-Encoding-Felder, eine Begrenzung aus Encoded-Words und abweichende Kopien einesDate,Subject,To,Reply-TooderSenderim Nachrichten-Header. AbweichendeCc-Felder werden wie empfangen gespeichert und mitX-Pepsi-Warning: duplicate-header-ccmarkiert;logmarkiert die anderen fünf auf dieselbe Weise (duplicate-header-<field>), statt sie abzulehnen. Die weichen Klassen werden vor dem Speichern auf die Lesart umgeschrieben, die RFC 2045/2046 vorschreiben: eine unbekannte Transfer-Encoding, Leerraum nach einem Quoted-Printable-Soft-Break, Nicht-Alphabet-Zeichen in Base64, ein fehlender schließender Begrenzer, eine Begrenzerzeile nach dem schließenden Begrenzer (der Epilog wird verworfen) und identische doppelte Felder, die Singleton-Header-Felder nach RFC 5322 eingeschlossen. Die Umschreibung geschieht nie innerhalb eines signierten oder verschlüsselten Teils; sie erfolgt nach SPF/DKIM/DMARC (anhand der Bytes wie empfangen beurteilt) und vor dem ARC-Siegel. Eine Nachricht mit einer ARC-Kette wird daher wie empfangen gespeichert, und pepsi-stage-arc schreibt sie um, sobald es die Kette verifiziert hat. Die Ergebnisse werden alsstate.mime_anomalies,state.mime_normalise(eine der ARC-Stage geschuldete Umschreibung) undstate.mime_normalised(wer umgeschrieben hat) festgehalten.logzählt und protokolliert nur. Siehe Mehrdeutiges MIME wird an der Grenze geklärt.Mail von außen, die behauptet, von uns zu sein. Nach der Verifikation markiert Ingress eine Nachricht aus einer nicht authentifizierten Sitzung in vier Fällen mit einem
X-Pepsi-Warning-Header:served-domain-not-authenticated, wenn ihrFrom:in einer bedienten Domain liegt, ohne dass ein DMARC-, ausgerichteter DKIM- oder ausgerichteter SPF-Pass dahintersteht;served-sender-not-authenticated, wenn ihrSender:in einer bedienten Domain liegt, ohne dass eine bestandene DKIM-Signatur oder ein damit ausgerichteter SPF-Pass besteht;from-ambiguous, wenn sich ihrFrom:nicht auf nur eine Weise lesen lässt oder Mailboxen in mehreren Domains nennt, gleich welche Urteile sie hat; unddmarc-fail-not-enforced, wenn ihr DMARC-failnicht umgesetzt wurde (DMARC_ENFORCEaus oderp=none), außer bei einem Fehlschlag, für den ein vertrauenswürdiger ARC-Versiegler gebürgt hat. Jede Markierung setzt außerdem[external](TAG_EXTERNAL) an den Anfang desSubjectund fügt das Feld hinzu, wenn es keines gibt; gerenderte Kopien der Markierung werden zuvor aus jedem eingehenden Betreff entfernt, sodass ein Absender sie nicht schreiben kann.state.auth.warningsführt die geschriebenen Werte auf;EXTERNAL_SUBJECT_TAG = nobehält die Header und lässt den Betreff unberührt. Siehe Mail von außen, die vorgibt, unsere zu sein, wird markiert.Die ARC-Verifikation/-Versiegelung wird hier nicht durchgeführt — das ist die pepsi-stage-arc-Stage, sodass Ingress keine ARC-Schlüssel hält. Ingress hält den Sitzungskontext, den die ARC-Stage benötigt, unter
state.originfest.
32.2.5. Submission (RFC 6409)¶
Ein Listener mit
SUBMISSION = yesmacht die Client-Authentifizierung verpflichtend und wendet die Submission-Korrekturen an (ein fehlendesDate:/Message-ID:wird ergänzt). Eines von vier Verfahren authentifiziert eine Sitzung: eine Gegenstellenadresse inMYNETWORKS, die Peer-Zugangsdaten eines UNIX-Sockets (AUTH_PEERCRED, der Standardwert bei einem UNIX-Listener und auf TCP abgelehnt), ein SASL-AUTH-Austausch (SASL_TYPE = dovecot, nur über TLS angeboten) oder ein TLS-Client-Zertifikat (TLS_AUTH_CLIENT,TLS_AUTH_CLIENT_CA), das nur von einem Client angefordert wird, der TLS 1.3 anbietet, das es verschlüsselt, sofern der Listener nichtTLS_AUTH_CLIENT_TLS12 = yessetzt. Eine authentifizierte Sitzung wird mitstate.local_origin = truefestgehalten und darf an jede Domain weiterleiten.Einlieferungsidentität (RFC 6409 §6/§8.1). Eine Sitzung mit einem Benutzernamen (SASL oder
AUTH_PEERCRED) darf nur die Adressen verwenden, dieUSERNAME_MAPihr gewährt (Standardusername@HOSTNAME; ein leerer Eintrag verweigert das Konto). DasMAIL FROMund jedeFrom:-Mailbox müssen erlaubt sein (550 5.7.1); ein fehlendesFrom:, eine reine Gruppe, eine Mailbox, die sich nicht strikt nach RFC 5322 parsen lässt, oder ein Anzeigename, der eine andere Adresse nennt, wird mit550 5.6.0abgelehnt. EinSender:wird ersetzt, hinzugefügt oder entfernt, sodass es die kanonische Identität des Kontos nennt.state.origin.from_boundhält fest, ob dasFrom:eine konkrete gewährte Adresse ist; nur dann darf eine Einlieferung für sie sprechen (Schlüsselregistrierung, Schlüsselbefehle).Absenderbindungen.
MYNETWORKS-Gegenstellen undTLS_AUTH_CLIENT-Zertifikate senden als die Adressen, an dieSENDER_MAPsie bindet (das spezifischste Netz oder der getroffene Pin), und bestehen dieselben Prüfungen. Ein Zertifikat, das die Datei nicht bindet, authentifiziert nichts. Deckt kein Schlüssel einenMYNETWORKS-Eintrag außerhalb von Loopback ganz ab, verweigert der Server den Start (pepsi-setup validatelehnt ihn ebenfalls ab); nur ein Loopback-Eintrag ist uneingeschränkt. Sowohl der Server beim Start als auchpepsi-setup validatewarnen vor einem Netz, das breiter als ein Host ist und an ein bloßes*gebunden ist. Die Datei wird einmal beim Start gelesen; ein Fehler darin hält den Server an.Siehe The submission identity in Sicherheitsmodell und Ein lokaler Shell-Benutzer.
Submission erfordert einen TLS-geschützten
MODE, außer auf einem lokalen UNIX-Domain-Socket, wo der Kernel die Identität liefert und es keinen Transport zu schützen gibt.Der Einliefernde bleibt privat. Auf einem Submission-Listener (
RECEIVED_PRIVACY, dort standardmäßig an) hat derReceived:-Header keinefrom-Klausel (keine Client-Adresse, keinen Reverse-Namen oder EHLO-Namen), undUser-AgentundX-Mailerdes Clients werden entfernt, gemäß draft-josefsson-email-received-privacy; dieby-Klausel, dieMAX_SELF_HOPSzählt, bleibt, ebenso der Eintrag des Journals über den Client.Der lokale Submission-Socket, den pepsi-sendmail verwendet, braucht überhaupt keinen Listener-Abschnitt: Ingress synthetisiert einen für
[pepsi-sendmail] SOCKET, sofern nicht bereits ein ausdrücklicher Abschnitt diesen Pfad bedient.SOCKET = noneist der einzige Schalter, der ihn abschaltet; ihn nicht binden zu können ist fatal.
32.2.6. Postfach-Quota¶
Ist eine Postfach-Quota-Richtlinie in Kraft, so wird ein Empfänger, dessen gemessene Belegung über seiner Grenze liegt, bei
RCPTabgewiesen (452 4.2.2oder552 5.2.2, gemäß[pepsi] MAILBOX_OVER_QUOTA). Ingress liestpepsi.mailbox_quotaausschließlich und weist nur aufgrund einer Messung ab, die jünger alsMAILBOX_QUOTA_MAX_AGEist; jede Ungewissheit (kein Datensatz, eine veraltete oder fehlende Messung, ein Datenbankfehler) nimmt an.MAILBOX_QUOTA_RCPT_CHECK = no(Standardwertyes) verlagert die gesamte Durchsetzung auf den Zeitpunkt der Zustellung. Siehe pepsi-quota.
32.2.7. DSN-Aufnahme (RFC 3461)¶
Ein Empfänger, den eine Transaktion ein zweites Mal nennt, in beliebiger Mischung aus Groß- und Kleinschreibung, wird mit
250beantwortet und nicht erneut gespeichert. Das ersteRCPT TObleibt bestehen, mit seinen DSN-Parametern.Validiert und speichert
RET/ENVID(MAIL FROM) undNOTIFY/ORCPT(RCPT TO) unterstate.dsn; fehlerhafte Werte werden mit501abgelehnt.
32.2.8. Wiederverwendete Logins (RFC 7293)¶
RRVS=<date-time>[;C|R]beiRCPT TOwird validiert (501 5.5.4) und unterstate.dsn.rcpt[i].rrvsgespeichert. Für eine bediente Domain wird das Login (Local-Part, Subadresse entfernt) inpepsi.login_assignmentnachgeschlagen; ein festgehaltener Inhaberwechsel nach der angeforderten Zeit wird mit550 5.7.17abgelehnt. Rollenadressen werden nie geprüft, und jede Unsicherheit nimmt an; die Relay- und lokalen Zustell-Stages greifen die Anforderung erneut auf. Siehe Ein Login, das den Eigentümer wechselt.
32.2.9. Internationalisierte / 8-Bit-Aufnahme¶
Nimmt rohe 8-Bit-Nachrichtentexte und UTF-8-Header/-Umschlag an; hält die
BODY=-Deklaration unterstate.origin.body_8bitfest.BINARYMIMEwird abgelehnt (501). Das erneute Ankündigen/Herabstufen pro Hop geschieht später in den Relay-Stages.
32.2.10. SRS-Rückwärts-Dekodierung¶
Ein Empfänger in
SRS_DOMAIN, dessen Local-Part ein gültiges SRS-Token ist, wird zum ursprünglichen Absender dekodiert und dorthin zum Relay angenommen (auch außerhalb bedienter Domains — der HMAC autorisiert es); ein gefälschtes/abgelaufenes Token wird abgelehnt (550). So kehren Bounces zu den ursprünglichen Absendern zurück. Siehe pepsi-stage-srs.Ein Empfänger in
SRS_DOMAIN, der eine Weiterleitungs-Rücksendeadresse ist (fwd+…, der Umschlagabsender einer Kopie, die ein Alias oder.forwardaußerhalb der Site gesendet hat), wird nur vom Null-Absender angenommen, nur solange er sich verifizieren lässt und jünger alsMAX_AGE_DAYSist, und nur als einziger Empfänger der Transaktion (jeder andere Empfänger daneben erhält452 4.5.3); andernfalls550 5.1.1, gezählt bei den ungültigen SRS-Empfängern. Der entfernte Bericht, den er trägt, wird protokolliert und verworfen; der Ingress reiht einen Datensatz bei der Bounce-Stage ein (demBOUNCE_STAGEder SRS-Stage, sonst einer Stagebounce, diepepsi-stage-bounceausführt, sonst der ersten solchen Stage), aus dem pepsi-stage-bounce die eigene DSN dieses Hosts an den ursprünglichen Absender über die vom Absender verwendete Adresse schreibt (Weiterleitungsadressen in Zustellberichten). Ohne Bounce-Stage wird der Bericht mit einer Warnung verworfen.
32.2.11. Speicherung und Benachrichtigung¶
Speichert die Nachricht aufgeteilt in
headers- undbody-Spalten, mit dem Umschlag, geparstemFrom:/Subject:und den Urteilen; fügt beistage = init/status = pendingein. Die eine Ausnahme ist der Datensatz, der aus einem Bericht über eine weitergeleitete Kopie entsteht und bei der Bounce-Stage eintritt.Weckt den Dispatcher außerhalb des Bandes und zusammengefasst, höchstens einmal je
DISPATCH_WAKE_INTERVAL(Standardwert 5 ms), nachdem der Datensatz committet wurde. Die Zulassungstransaktion selbst trägt keinNOTIFY: PostgreSQL hält von dem Moment an, in dem eine Transaktion eine Benachrichtigung einreiht, bis zu deren Commit eine datenbankweite Sperre, sodass ein benachrichtigendes Einfügen keinen Gruppen-Commit erlaubt. Ein verlorenes Wecken kostet nur die Latenz einesPOLL_INTERVALdes Dispatchers.
32.3. Privilegien¶
Als
rootgestartet (um die Ports 25/465/587 zu binden), liest der Server sein TLS-Material, bindet jeden Listener und wechselt dann ohne ergänzende Gruppen zum Kontopepsi-ingress; unter systemd läuft er von Anfang an unprivilegiert und erhält nur für root lesbare Zertifikate alsLoadCredential=-Kopien.Seine Datenbankrolle ist auf das zurechtgestutzt, was die Annahme braucht:
INSERTinworkqueue/workqueue_body, Lesezugriff auf die Konfigurationsüberlagerung,mailbox_quota,login_assignment, die Listennamen, die heruntergeladenen IP-Blocklisten und die Zertifikatssperrlisten sowie die von der Zulassungskontrolle verwendeten Größenspalten, dazu Anhängen an das Mail- und das Ereignisprotokoll — nie Nachrichteninhalt. Sie ist nie Mitglied vonpepsi-maildir. Siehe Die Privilegientrennung und Vertrauensgrenzen.
32.4. Konfiguration¶
Gelesen aus [pepsi-ingress] (Annahmerichtlinie, Grenzen, Timeouts, DNS), den [pepsi-ingress-listener-*]-Sockets (Transport und Client-Authentifizierung, je Listener) sowie den gemeinsamen Abschnitten [pepsi-postgres], [pepsi], [pepsi-sendmail] und [pepsi-srs]. Die Konfigurations-Überlagerung aus der Datenbank wird darüber angewendet. Vollständige Referenz: pepsi.conf(5) und Konfiguration.
32.5. Ausgaben an die Pipeline¶
Sät das state des Datensatzes mit origin (SMTP-Herkunft, einschließlich auth_method und from_bound), auth (den SPF/DKIM/DMARC-Urteilen und einem etwaigen display_name_mismatch), local_origin, spam = false für eine Nachricht, deren einziger Empfänger <Postmaster> ist, dsn (den RFC-3461-Parametern, wenn der Client sie angefordert hat) und, bei einer Nachricht mit mehrdeutigem MIME, mime_anomalies, mime_normalise und mime_normalised. Siehe Architektur für das State-Modell.
32.6. Siehe auch¶
pepsi-dispatch, pepsi-stage-arc, pepsi-stage-srs, Unterstützte Funktionen, pepsi-ingress(1), pepsi.conf(5).