19. Microsoft Exchange als Gateway¶
Pepsi kann als transparentes Krypto-Gateway vor und hinter einer Microsoft-Exchange- oder Exchange-Online-Installation sitzen: Eingehende Mail wird entschlüsselt und verifiziert, bevor Exchange sie speichert, ausgehende Mail wird signiert und verschlüsselt, nachdem Exchange sie gesendet hat. Benutzer bekommen S/MIME und OpenPGP, ohne ihre Clients anzufassen.
Warnung
Nur der Mandantennachweis (Exchange Online: der Mandantennachweis) beruht auf Messungen an einem echten Exchange-Online-Mandanten. Der Rest dieses Kapitels wurde nicht gegen einen echten Exchange- oder Exchange-Online-Mandanten getestet: Pepsis eigene Testsuite verwendet einen einfachen SMTP-Stellvertreter und .invalid-Domains. Die untenstehenden Connector-Einstellungen folgen Microsofts dokumentiertem Verhalten, aber rechnen Sie damit, sie anzupassen, und lesen Sie Fehlersuche, bevor Sie schließen, dass Pepsi schuld ist.
19.1. Topologien¶
Drei Anordnungen werden unterstützt. Welche Sie wählen, entscheidet darüber, was Sie im Rest dieses Kapitels konfigurieren.
Beide Richtungen (das vollständige Gateway). Eine Pepsi-Instanz ist der MX der Organisation und der Smarthost, über den Exchange sendet. Das ist die Anordnung, die Ende-zu-Ende-Krypto in beide Richtungen liefert.
Internet ──▶ pepsi-ingress :25 ──▶ arc ──▶ decrypt ──▶ autocrypt-learn
──▶ aliases ──▶ route ──┬─▶ exchange (smarthost)
└─▶ internet (direct MX)
Exchange ──▶ pepsi-ingress :587 ──▶ encrypt ──▶ srs ──▶ dkim-sign ──▶ internet
(authenticated)
pepsi-stage-autocrypt-learn folgt auf decrypt, weil es den Klartext braucht. Diese Stage lernt die Schlüssel von Korrespondenten aus eingehender Mail: aus ihrem Autocrypt:-Header, aus angehängten Schlüsseln und S/MIME-Zertifikaten und aus dem Autocrypt-Gossip: einer verschlüsselt eingetroffenen Nachricht. Mit diesen Schlüsseln kann die ausgehende encrypt-Stage verschlüsseln, ohne das Netz zu fragen. Die Stage zeichnet außerdem den Nachweis auf, dass ein Korrespondent einen unserer Schlüssel besitzt, weil er Mail gesendet hat, die an diesen Schlüssel verschlüsselt und von ihm signiert ist. Dieser Eintrag hält ATTACH_KEYS_AS_FILES davon ab, unsere Schlüsseldatei an Mail für ihn anzuhängen. Wenn Sie die Stage weglassen, verlieren Sie beides.
Nur davor. Pepsi ist der MX und übergibt alles an Exchange; der eigene ausgehende Pfad von Exchange bleibt unangetastet. Eingehende Mail wird entschlüsselt und verifiziert; ausgehende Mail bleibt unberührt. Das ist eine realistische Wahl für eine Organisation, die ihren ausgehenden Fluss nicht ändern kann.
Nur dahinter. Exchange behält den MX; Pepsi ist nur der Smarthost, über den Exchange weiterleitet. Ausgehende Mail wird signiert und verschlüsselt; eingehende bleibt unberührt. Das passt zu einer Organisation, deren eingehender Verkehr bereits über ein Compliance- oder Filter-Gateway läuft.
Die beiden Teilfälle sind nicht zweitklassig: Die Routing-Stage, die Schleifenverhinderung und die ADDRESS_FAMILY-Steuerung verhalten sich in jedem Fall gleich. Unterschiedlich ist nur, welche Hälfte der Pipeline Sie konfigurieren.
19.2. Die Routing-Entscheidung¶
Ein Gateway vor einem anderen Mailsystem muss bei jeder eingehenden Nachricht eine Routing-Entscheidung treffen: Gehört dieser Empfänger zu dem System hinter mir oder ins Internet?
Eine falsche Entscheidung führt nicht zu einem Zustellfehler, sondern zu einer Schleife. Die Domains hinter dem Gateway sind genau die Domains, deren öffentlicher MX das Gateway ist. Wer eine Nachricht für eine von ihnen einem Direkt-zum-MX-Relay übergibt, schickt sie daher zurück in Pepsis eigenen Ingress; dieser nimmt sie an, leitet sie wieder hinaus, und das wiederholt sich.
pepsi-stage-route existiert für diese Entscheidung:
[stage-route]
PROGRAM = pepsi-stage-route
# Recipients at a domain we serve go to Exchange...
MANAGED_STAGE = exchange
# ...everything else out to the public internet.
NEXT_STAGE = internet
MANAGED_DOMAINS fällt auf [pepsi-ingress] ACCEPTED_DOMAINS zurück, sodass die Menge der als „hinter dem Gateway“ behandelten Domains nicht von der Menge abdriften kann, die Ingress annimmt. Fügen Sie ROUTES nur für Ausnahmen hinzu, etwa für eine alte Subdomain, die lokal zugestellt wird, oder eine Partnerdomain mit eigenem nächstem Hop.
Teilen Sie Pepsi mit, wie es herausfinden kann, ob eine Adresse in Exchange existiert. Dann kann pepsi-ingress eine unbekannte ablehnen, solange der Absender noch verbunden ist, statt sie anzunehmen und Exchange sie später bouncen zu lassen. Ein solcher Bounce geht an den Umschlagabsender, und den fälscht Spam (siehe Ein entfernter Absender). RECIPIENT_CHECK = probe fragt Exchange mit RCPT TO und ohne Nachricht. Das hilft nur dort, wo Exchange selbst unbekannte Empfänger bei RCPT ablehnt: on-premises mit Empfängerfilterung oder Exchange Online mit Directory-Based Edge Blocking. Andernfalls exportieren Sie die gültigen Adressen in eine Datei und verwenden RECIPIENT_CHECK = map:
[stage-route]
PROGRAM = pepsi-stage-route
MANAGED_STAGE = exchange
NEXT_STAGE = internet
RECIPIENT_CHECK = probe
PROBE_HOST = example-com.mail.protection.outlook.com
# or: RECIPIENT_CHECK = map
# RECIPIENT_MAP = /etc/pepsi/exchange-recipients
Ohne beides wird jede Adresse an den verwalteten Domains angenommen, und pepsi-setup run weist darauf hin.
In einer Installation nur dahinter gibt es keine Routing-Entscheidung zu treffen: Pepsi leitet nur nach außen weiter, und die Routing-Stage wird nicht gebraucht.
19.3. Exchange Online: der Mandanten-Endpunkt¶
Wichtig
Richten Sie den Smarthost auf den mandantenspezifischen Endpunkt, nie auf den öffentlichen MX Ihrer eigenen Domain.
Der MX-Eintrag Ihrer Domain zeigt auf Pepsi (das ist der Sinn des Gateways). Ein Smarthost mit example-com.mail.protection.outlook.com erreicht Microsoft; ein Smarthost mit mail.example.com erreicht Pepsi, und jede Nachricht läuft in einer Schleife.
Der Mandanten-Endpunkt wird im Microsoft-365-Admin-Center unter den DNS-Einträgen der Domain angezeigt. Er hat die Form <tenant>.mail.protection.outlook.com, wobei <tenant> normalerweise Ihre Domain ist, deren Punkte durch Bindestriche ersetzt sind (example.com → example-com). Regionale Mandanten können abweichen (etwa <tenant>-ch.mail.protection.outlook.com). Verwenden Sie daher den Namen, den das Admin-Center anzeigt, und keinen, den Sie selbst zusammensetzen.
[pepsi-stage-relay-to-smarthost-mta-exchange]
HOST = example-com.mail.protection.outlook.com
PORT = 25
MODE = starttls
TLS_VERIFY = yes
AUTH = none
DOMAINS = example.com example.net
# Exchange Online rejects a sending IPv6 address with no PTR; see below.
ADDRESS_FAMILY = ipv4
AUTH = none ist hier richtig: Exchange Online authentifiziert einen eingehenden Connector über die sendende IP-Adresse oder über das TLS-Zertifikat, nicht über SASL. Pepsi verwendet dennoch STARTTLS, das Exchange Online verlangt.
pepsi-setup lehnt einen Smarthost ab, dessen Host diese Maschine ist und dessen Port einer ist, an den ein Ingress-Listener gebunden ist, sodass die direkteste Form dieses Fehlers abgefangen wird, bevor er eine Schleife bilden kann.
Wichtig
Der Smarthost deckt nur den Weg hinein ab. Für den Weg hinaus braucht ein Exchange-Online-Mandant den Mandantennachweis (Exchange Online: der Mandantennachweis): einen Abschnitt [pepsi-ingress-exchange-online-<name>] mit Ihrer Mandanten-ID und die DKIM-Signierung für Ihre Domains in Microsoft 365. Ohne ihn lehnt Pepsi jede Nachricht ab, die der ausgehende Connector von Exchange Online über Pepsi an eine andere Domain sendet, denn alle Microsoft-365-Kunden senden von denselben Adressen, und sonst unterscheidet nichts Ihren Mandanten von den anderen. pepsi-setup --wizard fragt nach der Mandanten-ID, sobald der Exchange-Host ein Exchange-Online-Endpunkt ist, und pepsi-setup validate warnt, wenn ein Smarthost auf Exchange Online zeigt und kein Abschnitt den Mandanten nennt. Sendet Exchange Online stattdessen direkt, veröffentlichen Sie include:spf.protection.outlook.com in Ihrem SPF-Eintrag sowie Microsofts DKIM-Selektoren.
19.4. Auswahl der Adressfamilie¶
Exchange Online lehnt Mail von einer sendenden IPv6-Adresse ab, deren Reverse-DNS (PTR) fehlt, mit einem 550 5.7.1 ... S820-Fehler. Ein Dual-Stack-Host bevorzugt IPv6, sodass eine Maschine, deren IPv4-Reverse-DNS korrekt ist und deren IPv6-Reverse-DNS nie delegiert wurde, an alle einwandfrei zustellt außer an Exchange Online.
Die Abhilfe ist, dieses eine Ziel über IPv4 zu erreichen. ADDRESS_FAMILY nimmt any (den Standardwert), ipv4 (auch v4/v4only geschrieben) oder ipv6 (v6/v6only).
Die Präzedenz ist: der ``[…-mta-*]``-Eintrag, dann der besitzende ``[stage-*]``-Abschnitt, dann ``any``. Die Ebene je Eintrag ist die, auf die es ankommt: Die ganze Stage auf IPv4 festzunageln zwänge auch jedes andere Ziel auf IPv4, einschließlich eines, das nur AAAA veröffentlicht.
Wenn eine Zustellung eine Familie verwendet, die Sie nicht erwartet hatten, prüfen Sie zuerst den MTA-Eintrag, dann den Stage-Abschnitt, und denken Sie daran, dass die konfigurierte Familie mit dem geschnitten wird, was der lokale Host tatsächlich routen kann: Wer ipv6 auf einem Host ohne globale IPv6-Route festlegt, lässt kein Ziel übrig, zu dem sich Pepsi verbinden könnte.
Die bessere Abhilfe, wo Sie die Reverse-Zone kontrollieren, ist, den PTR-Eintrag zu veröffentlichen. ADDRESS_FAMILY ist für den Fall, dass Sie es nicht tun.
19.5. Schleifenverhinderung¶
Ein Gateway auf beiden Seiten eines anderen MTA ist die klassische Schleifentopologie, und Pepsi hat drei unabhängige Verteidigungen. Keine davon ist in dieser Installation optional.
1. Konfigurationsablehnung (``pepsi-setup``). Es führt zwei Prüfungen durch, und beide melden einen Fehler statt einer Warnung:
Eine Routing-Stage, von der aus eine bediente Domain
pepsi-stage-relay-to-interneterreichen kann.pepsi-setupläuft von jeder Stage aus vorwärts, die ein verwalteter Empfänger erreichen kann, und lehnt ab, wenn ein Direkt-zum-MX-Relay darunter ist. (BOUNCE_STAGEwird nicht verfolgt: Ein Bounce ist eine neue Nachricht mit leerem Absender über eine Zustellung, die bereits fehlgeschlagen ist, und er erreicht legitimerweise ein Relay.)Ein Smarthost, dessen
PORTeiner ist, an den ein Ingress-Listener gebunden ist, und dessenHOSTdieser Host ist: sein[pepsi-ingress] HOSTNAME,localhostoder eine Loopback-Adresse. Beide Hälften sind erforderlich: Ein Standort darf legitimerweise ein unabhängiges Relay auf demselben Host betreiben oder auf Port 25 eine andere Maschine erreichen.
2. Der Hop-Zähler (``MAX_HOP_COUNT``). Beide Relay-Stages zählen Received:-Header-Felder und weigern sich, eine Nachricht mit mehr als MAX_HOP_COUNT (Standardwert 30, RFC 5321 §6.3) weiterzuleiten. Das ist der Rückhalt, nicht die Verteidigung: Wenn er greift, haben dreißig Kopien der Nachricht das Gateway durchquert, und der Bounce, den er erzeugt, ist zurück in die Schleife adressiert.
3. Exchanges eigene Connector-Beschränkung. Beschränken Sie den eingehenden Connector auf Pepsis IP-Adressen (unten), sodass eine von anderswo eintreffende Nachricht nicht als Gateway-Verkehr behandelt wird.
19.6. Konfiguration der Exchange-Connectors¶
Die genauen Einstellungen hängen davon ab, ob Exchange an Pepsi sendet, von Pepsi empfängt oder beides.
19.6.1. Eingehend zu Exchange (Pepsi → Exchange)¶
In Exchange Online ist dies ein eingehender Connector (Exchange-Admin-Center → Nachrichtenfluss → Connectors → Von: E-Mail-Server Ihrer Organisation, An: Office 365):
Einstellung |
Wert |
|---|---|
Connector-Typ |
Vom E-Mail-Server Ihrer Organisation zu Office 365 |
Wie der Absender identifiziert wird |
Durch Prüfen, dass die IP-Adresse des sendenden Servers passt, oder vorzugsweise über den Subject-Namen des Zertifikats. Für die IP-Adresse führen Sie jede Adresse auf, von der Pepsi sendet: siehe |
Nachrichten ablehnen, wenn nicht über TLS gesendet |
Ja |
Bei On-Premises-Exchange ist die Entsprechung ein Receive Connector auf der Hub-Transport-/Frontend-Rolle, mit RemoteIPRanges auf Pepsis Adressen gesetzt und PermissionGroups einschließlich AnonymousUsers (mit gewährtem Ms-Exch-SMTP-Accept-Any-Recipient, falls Exchange für Domains annehmen muss, für die es nicht autoritativ ist).
Bemerkung
Wenn der Connector Pepsi über die IP identifiziert und Pepsi für dieses Ziel auf IPv4 festgelegt ist (Auswahl der Adressfamilie), führen Sie die IPv4-Adresse auf. Wenn Sie nur die IPv6-Adresse eines Hosts aufführen, der sie nie verwenden wird, schlägt die Authentifizierung stillschweigend fehl.
Nehmen Sie Mail für die verwalteten Domains nur von Pepsi an. Alles, was Pepsi auf dem eingehenden Weg tut, gilt nur für Mail, die tatsächlich durch Pepsi läuft: Entschlüsselung, Signaturprüfung, die Betreffmarke [verified], SPF/DKIM/DMARC-Auswertung sowie Spam- und Sprachfilter. Das System dahinter bleibt selbst erreichbar: Der Endpunkt <tenant>.mail.protection.outlook.com eines Exchange-Online-Mandanten ist öffentlich, und ein lokales Exchange lauscht oft noch auf Port 25. Ein Absender, der direkt dorthin zustellt, umgeht jede dieser Prüfungen, und eine Nachricht, die so gefälscht ist, als hätte Pepsi sie verarbeitet (ein X-Pepsi-*-Header, eine [verified]-Marke), sieht genau so aus wie eine, die tatsächlich verarbeitet wurde. Das nachgelagerte System muss daher Mail für die verwalteten Domains von allem außer Pepsi ablehnen: in Exchange Online ein eingehender Partner-Connector, der Mail für diese Domains ablehnt, sofern sie nicht von Pepsis Adressen oder mit Pepsis Zertifikat kommt (RestrictDomainsToIPAddresses / RestrictDomainsToCertificate); lokal eine Firewall, die nur Pepsi die Empfangsconnectors erreichen lässt, und keine anonyme Berechtigung auf irgendeinem anderen Connector. Dasselbe gilt für jeden MDA oder MTA hinter Pepsi, nicht nur für Exchange.
19.6.2. Ausgehend von Exchange (Exchange → Pepsi)¶
Wie Pepsi die ausgehende Mail von Exchange erkennt, hängt davon ab, wo Exchange läuft. On-Premises-Exchange kann sich mit einem eigenen Konto bei Pepsi anmelden. Exchange Online kann das nicht: Sein ausgehender Connector bietet weder SMTP AUTH noch ein eigenes Zertifikat, er liefert nur an Port 25 aus, und alle Microsoft-365-Kunden senden von denselben Microsoft-Adressen. Pepsi prüft deshalb jede dieser Nachrichten auf einen Nachweis, dass Ihr Mandant sie gesendet hat.
19.6.2.1. Exchange Online: der Mandantennachweis¶
Ein Abschnitt [pepsi-ingress-exchange-online-<name>] nennt Ihren Mandanten (siehe pepsi.conf(5)). Mail von Microsofts ausgehenden Adressen darf dann am MX-Listener Empfänger außerhalb Ihrer Domains nennen, und am Ende der Daten leitet Pepsi sie nur weiter, wenn alle folgenden Bedingungen erfüllt sind:
der Header enthält genau ein Feld
X-MS-Exchange-CrossTenant-Id, und es nennt Ihren Mandanten;das Feld
From:nennt ein einziges Postfach, und zwar in einer der Domains, die der Abschnitt aufführt;eine DKIM-Signatur dieser Domain wurde verifiziert; nur Ihr Mandant kann sie erzeugen.
Alles andere wird mit 550 5.7.1 abgelehnt. Die Regeln sind aus drei Gründen so streng, und alle drei beruhen auf Messungen an einem echten Mandanten:
Exchange Online schreibt die ID des sendenden Mandanten in jede Nachricht, entfernt aber keine Kopie, die der Absender geschrieben hat. Ein anderer Mandant kann Ihre ID beanspruchen, und seine Nachricht kommt dann mit zwei solchen Feldern an.
Microsofts DKIM-Signatur deckt die Empfänger nicht ab, daher könnte man eine signierte Nachricht erneut an beliebige Empfänger senden. Über einen anderen Mandanten gesendet, trägt sie zusätzlich die ID dieses Mandanten und wird abgelehnt.
Die Header-Felder bedeuten nur bei Mail etwas, die wirklich von Exchange Online kommt. Daher verlangt Pepsi den Nachweis nur von Microsofts veröffentlichten ausgehenden Adressen (
SENDER_NETWORKS).
So richten Sie ihn ein:
Signieren Sie die Mail Ihrer Domain in Microsoft 365. Erzeugen Sie im Microsoft Defender-Portal (E-Mail & Zusammenarbeit → Richtlinien → E-Mail-Authentifizierungseinstellungen → DKIM) die Schlüssel für Ihre Domain, veröffentlichen Sie die beiden
CNAME-Einträge, die das Portal anzeigt (selector1._domainkeyundselector2._domainkey), und schalten Sie dann die Signierung ein. In PowerShell:Set-DkimSigningConfig -Identity example.com -Enabled $true Get-DkimSigningConfig -Identity example.com | Format-List Enabled,Status
Nennen Sie den Mandanten in Pepsi. Die Mandanten-ID wird im Microsoft Entra Admin Center unter Übersicht angezeigt:
[pepsi-ingress-exchange-online-example] TENANT_ID = 00000000-0000-0000-0000-000000000000 DOMAINS = example.com
Jede Domain in
DOMAINSmuss auch in[pepsi-ingress] ACCEPTED_DOMAINSstehen. Starten Siepepsi-ingressnach der Änderung neu.Leiten Sie die ausgehende Mail von Exchange über Pepsi. Fügen Sie im Exchange-Admin-Center einen Connector von Office 365 zu Partnerorganisation hinzu, der für Mail an alle Domains gilt, über den Smarthost mit Pepsis MX-Hostnamen leitet und immer TLS verwendet, mit einem Zertifikat, das eine vertrauenswürdige CA für diesen Namen ausgestellt hat. In PowerShell:
New-OutboundConnector -Name "Pepsi" -ConnectorType Partner ` -RecipientDomains * -UseMXRecord $false -SmartHosts mail.example.com ` -TlsSettings DomainValidation -TlsDomain mail.example.com
Prüfen Sie zuerst, dass keine Transportregel dieselbe Mail an einen anderen Connector schickt: Eine Regel mit der Aktion Folgenden Connector verwenden hat Vorrang vor dem Geltungsbereich des Connectors.
Testen Sie zuerst mit einer Domain. Geben Sie dem Connector eine einzige Test-Empfängerdomain (
-RecipientDomains), bevor Sie ihn auf*erweitern. Das Journal vonpepsi-ingressnennt den Mandanten jeder weitergeleiteten Nachricht (relaying outbound mail of Exchange Online tenant) und den Grund jeder Ablehnung (not proven to come from a configured Exchange Online tenant).
Eine Nachricht, die eine Postfachregel in Ihrem Mandanten für einen externen Absender weiterleitet, trägt keine Signatur Ihrer Domain und wird abgelehnt. Pepsi leitet keine Mail weiter, von der es nicht nachweisen kann, dass sie von Ihrem Mandanten stammt.
19.6.2.2. On-Premises-Exchange: ein eigenes Konto¶
On-Premises sendet Exchange über einen Send Connector an einen Submission-Listener und authentifiziert sich dort:
[pepsi-ingress-listener-submission]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 587
MODE = starttls
SUBMISSION = yes
SASL_TYPE = dovecot
SASL_PATH = /run/dovecot/auth-client
Es gibt zwei Wege, es über Pepsi weiterleiten zu lassen, und sie sind nicht gleichwertig.
SASL mit einem eigenen Konto (empfohlen). Exchange authentifiziert sich mit Benutzername und Passwort. Ein Submission-Listener setzt RFC 6409 §6 durch: Ein Absender darf nur eine Adresse verwenden, zu der die authentifizierte Identität berechtigt ist. Das Konto des Connectors braucht daher einen USERNAME_MAP-Eintrag, der die bedienten Domains erlaubt, sonst wird jede Nachricht abgelehnt, die Exchange weiterleitet:
# /etc/pepsi/username.map — the connector account may send as any of our users.
exchange-connector: *@example.com *@example.net
Ohne diesen Eintrag darf das Konto nur als es selbst senden, und die erste Nachricht, die Exchange weiterleitet, bekommt ein 550.
Netzwerkvertrauen (``MYNETWORKS``). Das ist einfacher, weil Sie nur die Adressen von Exchange auflisten und auf Authentifizierung verzichten. Es birgt aber das Self-Relay-Risiko, um das es in diesem Kapitel geht: Jeder Host, der den Listener von einer vertrauenswürdigen Adresse aus erreicht, kann darüber weiterleiten, und ein Fehler im Bereich macht Pepsi zu einem offenen Relay. Ein vertrauenswürdiges Netz darf außerdem als beliebige Adresse senden, sofern SENDER_MAP nicht die Adressen bindet, die es verwenden darf. Dieselbe Datei bindet die Adressen eines Client-Zertifikats, das als niemand senden darf, bis die Datei sie bindet. Bevorzugen Sie SASL; wenn Sie MYNETWORKS verwenden, führen Sie einzelne Adressen statt Bereichen auf, binden Sie sie mit SENDER_MAP und nehmen Sie niemals Loopback auf. Ein an ein bloßes * gebundener Bereich erlaubt jedem Rechner darin, einschließlich anderer Mandanten eines gemeinsam genutzten Cloud-Bereichs, Mail zu senden, die Pepsi als eine beliebige Ihrer Adressen signiert (die EchoSpoofing-Konfiguration); pepsi-ingress und pepsi-setup validate warnen vor jedem solchen Bereich. Tragen Sie dort niemals Microsofts Exchange-Online-Adressen ein; verwenden Sie stattdessen den oben beschriebenen Mandantennachweis. Ein lokaler Shell-Benutzer legt dar, was die Einreichungsidentität schützt und was nicht.
19.7. Das Outlook-Add-in¶
Pepsis Verschlüsselungs-Stage wertet zwei Header aus, die eine Nachricht tragen kann: X-Pepsi-Sign und X-Pepsi-Encrypt. Das Add-in ermöglicht es einem Benutzer, sie in Outlook zu setzen (über seinen Bereich Protect message beim Verfassen). Dasselbe Add-in enthält einen zweiten Bereich für Mail, die der Benutzer empfängt: Gateway verdict zeigt im eigenen Aufgabenbereich von Outlook, außerhalb des Nachrichtenbereichs, was die Decrypt-Stage in X-Pepsi-Crypto und X-Pepsi-Warning festgehalten hat. Erweiterungen für Mail-Clients beschreibt, was dieser Bereich anzeigt, was er beweist und welche Outlook-Versionen ihn unterstützen; die folgende Bereitstellung deckt beide Bereiche ab.
Aktivieren Sie die Routen und laden Sie pepsi-httpd neu:
[pepsi-httpd]
ADDIN = yes
# Only needed when the request's own Host header does not name this gateway
# (for example behind a proxy that rewrites it).
# ADDIN_URL = https://mail.example.com
Das Manifest wird dann von https://<gateway>/addin/manifest.xml ausgeliefert, mit der Gateway-URL und einem installationsspezifischen Bezeichner für Sie eingesetzt.
Die Verteilung erfolgt per Sideloading. Gehen Sie im Microsoft-365-Admin-Center zu Einstellungen → Integrierte Apps → Benutzerdefinierte Apps hochladen, wählen Sie Link zur Manifestdatei angeben und geben Sie diese URL an. Es gibt keinen AppSource-Eintrag: Der Inhalt des Manifests hängt von der URL Ihres Gateways ab, es gibt also kein einzelnes Artefakt, das man veröffentlichen könnte. Außerdem wäre eine Store-Prüfung, die zwischen Ihnen und einer Fehlerbehebung steht, ein schlechter Tausch für eine Seite JavaScript.
Benutzer ohne das Add-in erzielen dieselbe Wirkung mit einem Betreff-Schlüsselwort: [sign], [encrypt] oder [secure] irgendwo im Subject. Die Verschlüsselungs-Stage reagiert darauf und entfernt es, bevor die Nachricht gesendet wird, sodass der Empfänger es nie sieht. Die Schlüsselwörter sind konfigurierbar (SUBJECT_KEYWORDS_SIGN, SUBJECT_KEYWORDS_ENCRYPT, SUBJECT_KEYWORDS_BOTH).
Bemerkung
Ein Betreff-Schlüsselwort bedeutet erforderlich, nicht versuchen: Eine Nachricht, die ein Benutzer bewusst mit [encrypt] markiert hat, wird nicht im Klartext gesendet, wenn ein Empfänger keinen Schlüssel hat. ON_NO_KEY entscheidet, was stattdessen geschieht. Nicht markierte Mail geht unter der Voreinstellung ENCRYPT = opportunistic weiterhin im Klartext hinaus, ohne dass der Absender davon erfährt, sodass ein vertipptes Schlüsselwort nicht bemerkt wird (siehe Benutzer senden Mail versehentlich unverschlüsselt, weil der Verschlüsselungszustand unklar ist). Die Ausnahme ist ein Empfänger, dessen Schlüsselsuche im DNS fehlgeschlagen ist: Dann wird die Nachricht nicht im Klartext gesendet, sondern zurückgestellt, an das Portal geschickt oder gebounct, sofern der Absender nicht [clear-ok] in den Betreff schreibt (oder der Betreiber CLEAR_ON_DNS_FAILURE setzt); siehe Ein Schlüssel-Lookup, der im DNS scheitert.
19.8. Der X-Pepsi-*-Header-Vertrag¶
Der Vertrag besteht aus drei Feldern in einem Namensraum und der Regel, die das Ergebnisfeld glaubwürdig macht. (Ingress fügt eingehender Mail ein viertes hinzu, X-Pepsi-Warning, wenn es Grund hat, ihr zu misstrauen, etwa wegen eines From:-Anzeigenamens, der eine andere Adresse nennt, einer Doppelgängerin einer bedienten Domain, versteckter Zeichen, doppelter Header-Felder oder Ähnlichem (Erweiterungen für Mail-Clients). Aus demselben Grund entfernt es zuvor jede Kopie, die ein Absender geschrieben hat.)
Feld |
Bedeutung |
|---|---|
|
Anforderung: diese Nachricht signieren. |
|
Anforderung: diese Nachricht verschlüsseln. |
|
Ergebnis: was die eingehende Stage festgestellt hat. Durch Semikolon getrennte |
Anforderungen werden nur bei lokal eingelieferter Mail (state.local_origin) beachtet und werden aus ausgehender Mail bedingungslos entfernt, was auch immer STRIP_REQUEST_HEADERS sagt: Ein Steuerkanal, der bis auf die Leitung überlebte, wäre ein Kanal, dem man den nächsten Hop gehorchen lassen könnte.
Dem Ergebnis-Header kann geglaubt werden, weil die eingehende Stage den gesamten ``X-Pepsi-*``-Namensraum aus jeder Nachricht entfernt, die sie sieht, bevor sie ihren eigenen hinzufügt. Das gilt auch für eine Nachricht, für die sie deaktiviert ist, für eine, die an eine Domain adressiert ist, die sie nicht bedient, und für eine, die sie gleich aufteilen wird. Das einzige Feld, das sie behält, ist das X-Pepsi-Warning von Ingress im äußeren Header-Block, das Ingress selbst erst schreibt, nachdem es jede von einem Absender geschriebene Kopie entfernt hat; eine Kopie innerhalb entschlüsselter Inhalte wird wie der Rest entfernt. Daraus folgt, dass eine Nachricht, die keine Decrypt-Stage durchlaufen hat, keinen vertrauenswürdigen Ergebnis-Header trägt, und nichts sollte einen als maßgeblich darstellen. Wir entfernen den Namensraum, damit kein Absender das Urteil fälschen kann (siehe Injektion in Statuszeilen und Ausgabe von GnuPG täuscht Frontends). Was ein Sicherheitsindikator bedeutet legt dar, was jeder Indikator einem Leser verspricht, und Mail für die verwalteten Domains nur von Pepsi annehmen weiter oben erklärt, warum das System hinter dem Gateway Mail nur von Pepsi annehmen darf.
Pepsi-Origin liegt bewusst nicht in diesem Namensraum und wird nie entfernt, weil der Pfad, der Zahlungen mit Nachrichten verknüpft, davon abhängt.
Der signature-Wert des Ergebnis-Headers ist eines von none, valid, partial, valid-untrusted, invalid oder unverifiable.
Gefahr
valid-untrusted bedeutet, dass die Signatur gegen einen Schlüssel verifiziert wurde, der in keinem Vertrauenspfad verankert ist, und jeder kann eine solche Signatur erzeugen. Sie darf in einer Benutzeroberfläche, einem Aufgabenbereich oder einer Mail-Client-Regel nie als verifiziert dargestellt werden (siehe Benutzer überspringen die Prüfung von Schlüssel-Fingerabdrücken, machen sie falsch oder können sie nicht nutzen).
19.9. Automatische Identitätsbereitstellung¶
[pepsi-crypto] AUTO_CREATE_IDENTITY (standardmäßig an) lässt Pepsi einen Schlüssel für einen lokalen Absender erzeugen, der keinen hat. ENABLE_PEP der Encrypt-Stage bestimmt, wann:
ENABLE_PEP = yes (der Standard, die Voreinstellung im pEp-Stil): bei der ersten eingelieferten Nachricht des Absenders, gleich worum sie bittet. Hinter Exchange deckt das jeden ab, der über den Connector sendet, sofern Pepsi auch Mail für die Domain des Absenders empfängt. Denn Mail, die der Connector weiterleitet, ist lokal eingeliefert, wie auch immer sich der Connector authentifiziert (SASL,
MYNETWORKSoder ein Client-Zertifikat), und die Voreinstellung gilt für einen solchen Absender auf jedem Einlieferungsweg.ENABLE_PEP = no: beim ersten Mal, dass dieser Absender ausdrücklich um Schutz bittet – mit dem Add-in oder mit einem Betreff-Schlüsselwort. Bei gewöhnlicher Mail greift es nicht.
In beiden Fällen bekommt eine Adresse, die bereits irgendeinen Schlüssel hat, nie automatisch einen weiteren. Das gilt auch für einen Schlüssel, den der Benutzer aus seinem Mail-Client registriert hat, und für einen widerrufenen Schlüssel.
So bekommt eine Organisation Ende-zu-Ende-Abdeckung ohne Arbeit je Benutzer: Ein Schlüssel erscheint, und er wird veröffentlicht, damit Korrespondenten ihn nutzen können.
So veröffentlicht eine Organisation aber auch die Adresse jeder Person, die Mail sendet (oder, ohne die Voreinstellung, die je um eine signierte Nachricht gebeten hat). Eine automatisch angelegte Identität wird als published markiert, und eine veröffentlichte Identität wird aus dem eigenen Web Key Directory dieses Hosts ausgeliefert. Genau das macht sie brauchbar, und genau das macht die Adresse auch für jeden auffindbar, der sie errät. Sie wird nicht auf einen öffentlichen Keyserver hochgeladen, es sei denn, ihr Besitzer bittet darum (vks_wanted); [pepsi-keys] VKS_PUBLISH entscheidet nur über den Standard für von Hand erzeugte Schlüssel.
Beide Hälften sind für eine Allzweckinstallation erwünscht, aber keine ist offensichtlich richtig für eine Organisation, deren Adressliste selbst sensibel ist, oder eine, die an eine Richtlinie zur Offenlegung von Mitarbeiteradressen gebunden ist. Die Einstellungen, von der am meisten bis zur am wenigsten automatischen:
alles auf dem Standard belassen: Jeder Absender bekommt bei seiner ersten Nachricht einen Schlüssel, der sich über das WKD dieses Hosts finden lässt. Um ihn zurückzuziehen, entveröffentlichen Sie also eine Identität, statt einen Keyserver zu bitten, ihn zu vergessen;
[stage-encrypt] ENABLE_PEP = nosetzen – Schlüssel erscheinen nur für Absender, die um Schutz gebeten haben;AUTO_CREATE_IDENTITYausschalten – die Schlüsselbereitstellung wird zu einem ausdrücklichen Akt (eines Betreibers mit pepsi-keys oder des Benutzers über die Web-Konsole oder die Steueradressepepsi-keys@), und ein Benutzer, der ohne Schlüssel um Verschlüsselung bittet, bekommt stattdessen, wasON_NO_KEYsagt.
19.10. Schlüsselverteilung¶
Ein Korrespondent kann nur an einen Schlüssel verschlüsseln, den er hat; deshalb reist der öffentliche Schlüssel des Absenders auf folgenden Wegen mit seiner Mail:
Autocrypt (der Standard). Jede lokal eingelieferte Nachricht trägt einen
Autocrypt:-Header mit dem minimalen OpenPGP-Schlüssel des Absenders ([stage-encrypt] AUTOCRYPT, Standardyes). Thunderbird, K-9/FairEmail, Delta Chat und andere Autocrypt-fähige Clients lernen ihn stillschweigend. Er fährt auch auf Klartext-Mail mit, und genau darum geht es: Solange ein Korrespondent den Schlüssel nicht hat, gibt es nichts, womit verschlüsselt werden könnte.Eine angehängte Schlüsseldatei (optional). Mit
ATTACH_KEYS_AS_FILES = yeswird der Schlüssel zusätzlich alsOpenPGP_0x<long key ID>.asc(application/pgp-keys) angehängt, der klassische OpenPGP-Weg, für Korrespondenten, deren Client Autocrypt nicht liest und Schlüssel aus Anhängen importiert. Bei verschlüsselter Mail liegt die Datei im Chiffrat; bei Klartext wird die Nachricht zumultipart/mixed. Die Datei wird nur so lange angehängt, bis der Korrespondent gezeigt hat, dass er den Schlüssel besitzt: indem er eine Nachricht zurückgesendet hat, die an diesen Schlüssel verschlüsselt und von ihm signiert ist. pepsi-stage-autocrypt-learn zeichnet das auf dem eingehenden Pfad auf. Regelmäßige Korrespondenten erhalten die Datei daher nicht mehr, und ein neuer Schlüssel löst sie erneut aus. Schalten Sie auchAUTOCRYPTab, wenn Sie nur die Datei wollen.Das Web Key Directory, von
pepsi-httpdfür jede veröffentlichte Identität ausgeliefert, für Clients, die Schlüssel nachschlagen, statt sie aus Mail zu lernen.
Hat ein Benutzer seinen eigenen Schlüssel aus seinem Mail-Client registriert, ist dieser Schlüssel sein öffentliches Gesicht: Pepsi fügt dann keinen Autocrypt:-Header und keine Schlüsseldatei hinzu (der Client bewirbt seinen eigenen), und das Web Key Directory liefert nur diesen Schlüssel aus. Siehe Schlüsselverwaltung.
19.11. Fehlersuche¶
- Nachrichten laufen zwischen Pepsi und Exchange im Kreis.
Der Smarthost ist auf Ihren öffentlichen MX statt auf den Mandanten-Endpunkt gerichtet, oder eine bediente Domain wird zur Direkt-zum-MX-Stage geroutet. Führen Sie
pepsi-setup validateaus; es prüft die Konfiguration genau wierun, ohne etwas zu ändern, und lehnt beide Fehler ab. Wenn die Mail dennoch im Kreis läuft, ist die laufende Konfiguration nicht die, die Sie validiert haben. (pepsi-setup checkist ein anderer Befehl: Es vergleicht das aktuelle DNS mit den Einträgen, dierunveröffentlichen würde, und validiert die Pipeline nicht.) Suchen Sie die Schleife mitpepsi-queue: Eine Nachricht mit sehr vielenReceived:-Header-Feldern verrät sie.- Exchange Online lehnt mit 550 5.7.1 … S820 ab.
Die sendende IPv6-Adresse hat keinen
PTR. Veröffentlichen Sie einen, oder setzen SieADDRESS_FAMILY = ipv4auf diesem MTA-Eintrag (Auswahl der Adressfamilie).- Exchange Online lehnt mit 550 5.7.64 TenantAttribution ab.
Der eingehende Connector erkennt den Absender nicht. Prüfen Sie, dass der Connector die Adresse aufführt, von der Pepsi tatsächlich sendet — die IPv4-Adresse, wenn
ADDRESS_FAMILYsie festnagelt.- Ausgehende Mail von Exchange Online erhält 550 5.7.1 Relaying denied.
Bei
message not proven to come from a configured Exchange Online tenantnennt das Journal vonpepsi-ingressdie Regel, die nicht erfüllt war. No DKIM signature … verified: Die DKIM-Signierung für die Domain ist in Microsoft 365 ausgeschaltet, oder die Einträgeselector1/selector2fehlen. Names tenant …:TENANT_IDist falsch. Two … fields: Die Nachricht kam nicht von Ihrem Mandanten. Schon beiRCPTabgelehnt (recipient not in a served domain): Die Client-Adresse liegt außerhalb vonSENDER_NETWORKS, oder der Umschlagabsender liegt in keiner derDOMAINSdes Abschnitts.- Alles, was Exchange weiterleitet, bekommt 550 5.7.1 Envelope sender not permitted.
RFC 6409 §6: Das SASL-Konto des Connectors darf nur als es selbst senden. Geben Sie ihm einen
USERNAME_MAP-Eintrag, der die bedienten Domains abdeckt.- Eine Zustellung verwendet die falsche Adressfamilie.
Die Präzedenz ist der
[…-mta-*]-Eintrag, dann der[stage-*]-Abschnitt, dannany; das Ergebnis wird dann mit dem geschnitten, was der Host routen kann.- X-MS-*-Header.
Exchange fügt eine Reihe von
X-MS-*-Headern hinzu und verbraucht sie. Pepsi liest, schreibt und entfernt sie nicht; nur derX-Pepsi-*-Namensraum wird angefasst. Beachten Sie jedoch, dass das Neukodieren einer Nachricht für einen nächsten Hop ohne8BITMIMEden Nachrichtentext umschreibt und damit jede Signatur darüber entwertet (siehe SMTP-Protokollerweiterungen).
19.12. Was Pepsi nicht tut¶
Journaling und Archivierung liegen außerhalb des Geltungsbereichs. Exchange-Installationen haben häufig eine Aufbewahrungsanforderung, und Pepsi beantwortet sie nicht: Es gibt keinen Archivspeicher, keine Aufbewahrungsmaschinerie, keine Suche und keine Möglichkeit für rechtliche Sicherungspflichten. Siehe docs/ROADMAP.md.
Warnung
[pepsi] MAIL_LOG ist kein Archiv und darf einem Prüfer nicht als solches vorgelegt werden. Es hält bei keiner Einstellung Nachrichteninhalte fest, sondern höchstens den Umschlag, das Ergebnis und, bei full, die Subject:-Zeile. Seine Datensätze werden nach [pepsi-admin] MAIL_LOG_RETENTION_DAYS entfernt, standardmäßig nach dreißig Tagen. Es ist ein Betriebsjournal mit einer Aufbewahrungs*grenze*, was das Gegenteil eines Aufbewahrungs*mechanismus* ist.
Wenn Sie eine Aufbewahrungspflicht haben, erfüllen Sie sie mit Exchanges eigenem Journaling oder einem dedizierten Archivierungsprodukt und behandeln Sie MAIL_LOG als etwas, das Ihnen sagt, was letzten Monat geschah, nicht was letztes Jahr gesagt wurde.
Ein Krypto-Gateway soll tatsächlich eine engere Frage beantworten: War diese Nachricht verschlüsselt, und was haben wir über sie entschieden? Diese Frage beantwortet MAIL_LOG, wenn es aktiviert ist. Beachten Sie, dass die Installation festhält, wer mit wem korrespondiert, sobald Sie es einschalten; pepsi.conf(5) erörtert diesen Kompromiss.