19. Microsoft Exchange comme passerelle¶
Pepsi peut se placer devant et derrière un déploiement Microsoft Exchange ou Exchange Online comme passerelle cryptographique transparente : le courrier entrant est déchiffré et vérifié avant qu’Exchange ne le stocke, le courrier sortant est signé et chiffré après qu’Exchange l’a envoyé. Les utilisateurs obtiennent S/MIME et OpenPGP sans toucher à leurs clients.
Avertissement
Seule la preuve de locataire (Exchange Online : la preuve de locataire) repose sur des mesures faites avec un véritable locataire Exchange Online. Le reste de ce chapitre n’a pas été testé face à un véritable locataire Exchange ou Exchange Online : la suite de tests propre à Pepsi emploie un substitut SMTP simple et des domaines .invalid. Les réglages de connecteur ci-dessous suivent le comportement documenté par Microsoft, mais attendez-vous à devoir les ajuster, et lisez Dépannage avant de conclure que Pepsi est en cause.
19.1. Topologies¶
Trois agencements sont pris en charge. Celui que vous choisissez détermine ce que vous configurez dans le reste de ce chapitre.
Les deux sens (la passerelle complète). Une instance Pepsi est le MX de l’organisation et le smarthost par lequel Exchange envoie. C’est l’agencement qui donne de la cryptographie de bout en bout dans les deux sens.
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 suit decrypt parce qu’elle a besoin du texte en clair. Cette étape apprend les clés des correspondants à partir du courrier entrant : de leur en-tête Autocrypt:, des clés et certificats S/MIME joints, et de l”Autocrypt-Gossip: d’un message arrivé chiffré. Grâce à ces clés, l’étape sortante encrypt peut chiffrer sans interroger le réseau. L’étape enregistre aussi la preuve qu’un correspondant détient l’une de nos clés, parce qu’il a envoyé du courrier chiffré pour cette clé et signé par lui ; cet enregistrement empêche ATTACH_KEYS_AS_FILES de joindre notre fichier de clé au courrier qui lui est destiné. Si vous omettez l’étape, vous perdez les deux.
Devant seulement. Pepsi est le MX et remet tout à Exchange ; le chemin sortant propre à Exchange est laissé tel quel. Le courrier entrant est déchiffré et vérifié ; le courrier sortant n’est pas touché. C’est un choix réaliste pour une organisation qui ne peut pas modifier son flux sortant.
Derrière seulement. Exchange conserve le MX ; Pepsi n’est que le smarthost par lequel Exchange relaie. Le courrier sortant est signé et chiffré ; l’entrant n’est pas touché. Cela convient à une organisation dont l’entrant passe déjà par une passerelle de conformité ou de filtrage.
Les deux cas partiels ne sont pas de seconde classe : l’étape d’acheminement, la prévention des boucles et le contrôle ADDRESS_FAMILY se comportent de la même façon dans chacun. Seule diffère la moitié du pipeline que vous configurez.
19.2. La décision d’acheminement¶
Une passerelle placée devant un autre système de courrier doit prendre une décision d’acheminement pour chaque message entrant : ce destinataire appartient-il au système derrière moi, ou à l’internet ?
Une erreur ne provoque pas un échec de remise, mais une boucle. Les domaines situés derrière la passerelle sont exactement ceux dont le MX public est la passerelle. Remettre un message pour l’un d’eux à un relais direct-vers-MX le renvoie donc dans l’ingress de Pepsi lui-même, qui l’accepte, le relaie de nouveau vers l’extérieur, et recommence.
pepsi-stage-route existe pour cette décision :
[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 vaut par défaut [pepsi-ingress] ACCEPTED_DOMAINS, de sorte que l’ensemble des domaines traités comme « derrière la passerelle » ne puisse pas dériver de l’ensemble qu’accepte l’ingress. N’ajoutez ROUTES que pour des exceptions, comme un sous-domaine hérité remis localement ou un domaine partenaire ayant son propre saut suivant.
Indiquez à Pepsi comment savoir si une adresse existe dans Exchange. pepsi-ingress peut alors refuser une adresse inconnue tant que l’expéditeur est encore connecté, au lieu de l’accepter et de laisser Exchange la faire rebondir plus tard. Un tel rebond part vers l’expéditeur d’enveloppe, que le spam falsifie (voir Un expéditeur distant). RECIPIENT_CHECK = probe interroge Exchange avec RCPT TO et sans message. Cela n’aide que là où Exchange refuse lui-même les destinataires inconnus au RCPT : sur site avec le filtrage des destinataires, ou Exchange Online avec le Directory-Based Edge Blocking. Sinon, exportez les adresses valides dans un fichier et utilisez 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
Sans l’un ni l’autre, chaque adresse des domaines gérés est acceptée, et pepsi-setup run le signale.
Dans un déploiement derrière seulement, il n’y a aucune décision d’acheminement à prendre : Pepsi ne relaie que vers l’extérieur, et l’étape d’acheminement n’est pas nécessaire.
19.3. Exchange Online : le point de terminaison du locataire¶
Important
Pointez le smarthost vers le point de terminaison propre au locataire, jamais vers le MX public de votre propre domaine.
L’enregistrement MX de votre domaine pointe vers Pepsi (c’est tout l’intérêt de la passerelle). Un smarthost réglé sur example-com.mail.protection.outlook.com atteint Microsoft ; un smarthost réglé sur mail.example.com atteint Pepsi, et chaque message boucle.
Le point de terminaison du locataire est affiché dans le centre d’administration Microsoft 365 sous les enregistrements DNS du domaine. Il a la forme <tenant>.mail.protection.outlook.com, où <tenant> est normalement votre domaine avec les points remplacés par des tirets (example.com → example-com). Les locataires régionaux peuvent différer (par exemple <tenant>-ch.mail.protection.outlook.com) ; employez donc le nom qu’affiche le centre d’administration, plutôt qu’un nom que vous construisez vous-même.
[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 est correct ici : Exchange Online authentifie un connecteur entrant par l”adresse IP émettrice ou par le certificat TLS, pas par SASL. Pepsi emploie tout de même STARTTLS, qu’Exchange Online exige.
pepsi-setup refuse un smarthost dont l’hôte est cette machine et dont le port est un port auquel un écouteur d’ingress est lié : la forme la plus directe de cette erreur est donc attrapée avant de pouvoir boucler.
Important
Le smarthost ne couvre que le chemin entrant. Pour le chemin sortant, un locataire Exchange Online a besoin de la preuve de locataire (Exchange Online : la preuve de locataire) : une section [pepsi-ingress-exchange-online-<name>] portant l’identifiant de votre locataire, et la signature DKIM de vos domaines activée dans Microsoft 365. Sans elle, Pepsi refuse chaque message que le connecteur sortant d’Exchange Online envoie par lui vers un autre domaine, car tous les clients Microsoft 365 envoient depuis les mêmes adresses et rien d’autre ne distingue votre locataire des leurs. pepsi-setup --wizard demande l’identifiant du locataire dès que l’hôte Exchange est un point de terminaison Exchange Online, et pepsi-setup validate avertit lorsqu’un smarthost pointe vers Exchange Online sans qu’aucune section ne nomme le locataire. Si Exchange Online envoie plutôt directement, publiez include:spf.protection.outlook.com dans votre enregistrement SPF ainsi que les sélecteurs DKIM de Microsoft.
19.4. Choix de la famille d’adresses¶
Exchange Online rejette le courrier venant d’une adresse IPv6 émettrice dont le DNS inverse (PTR) est manquant, avec une erreur 550 5.7.1 ... S820. Un hôte à double pile préfère IPv6 : une machine dont le DNS inverse IPv4 est correct et dont le DNS inverse IPv6 n’a jamais été délégué remet donc parfaitement à tout le monde sauf à Exchange Online.
Le remède est d’atteindre cette destination-là en IPv4. ADDRESS_FAMILY prend any (la valeur par défaut), ipv4 (également écrit v4/v4only) ou ipv6 (v6/v6only).
La précédence est : l’entrée ``[…-mta-*]``, puis la section ``[stage-*]`` propriétaire, puis ``any``. C’est le niveau par entrée qui compte : clouer toute l’étape en IPv4 forcerait aussi toute autre destination en IPv4, y compris une qui ne publie que des AAAA.
Lorsqu’une remise emploie une famille à laquelle vous ne vous attendiez pas, vérifiez d’abord l’entrée MTA, puis la section d’étape, et souvenez-vous que la famille configurée est intersectée avec ce que l’hôte local peut réellement router : fixer ipv6 sur un hôte sans route IPv6 globale ne laisse rien à quoi se connecter.
Le meilleur remède, là où vous contrôlez la zone inverse, est de publier l’enregistrement PTR. ADDRESS_FAMILY est pour le cas où vous ne le faites pas.
19.5. Prévention des boucles¶
Une passerelle des deux côtés d’un autre MTA est la topologie de boucle classique, et Pepsi dispose de trois défenses indépendantes. Aucune n’est facultative dans ce déploiement.
1. Refus de configuration (``pepsi-setup``). Il effectue deux vérifications, et toutes deux signalent une erreur plutôt qu’un avertissement :
Une étape d’acheminement depuis laquelle un domaine servi peut atteindre
pepsi-stage-relay-to-internet.pepsi-setupparcourt vers l’avant depuis chaque étape qu’un destinataire géré peut atteindre et refuse si un relais direct-vers-MX s’y trouve. (BOUNCE_STAGEn’est pas suivi : un rebond est un nouveau message à expéditeur nul portant sur une remise qui a déjà échoué, et il atteint légitimement un relais.)Un smarthost dont le
PORTest un port auquel un écouteur d’ingress est lié et dont leHOSTest cet hôte : son[pepsi-ingress] HOSTNAME,localhostou une adresse de boucle locale. Les deux moitiés sont requises : un site peut légitimement exploiter un relais sans rapport sur le même hôte, ou joindre une autre machine sur le port 25.
2. Le compteur de sauts (``MAX_HOP_COUNT``). Les deux étapes de relais comptent les champs d’en-tête Received: et refusent de relayer un message qui en compte plus de MAX_HOP_COUNT (30 par défaut, RFC 5321 §6.3). C’est le filet de sécurité, pas la défense : quand il se déclenche, trente copies du message ont traversé la passerelle, et le rebond qu’il produit est adressé de nouveau dans la boucle.
3. La restriction propre des connecteurs Exchange. Restreignez le connecteur entrant aux adresses IP de Pepsi (ci-dessous), de sorte qu’un message arrivant d’ailleurs ne soit pas traité comme du trafic de passerelle.
19.6. Configuration des connecteurs Exchange¶
Les réglages exacts dépendent du fait qu’Exchange envoie à Pepsi, reçoit de Pepsi, ou les deux.
19.6.1. Entrant vers Exchange (Pepsi → Exchange)¶
Dans Exchange Online, c’est un connecteur entrant (centre d’administration Exchange → Flux de messagerie → Connecteurs → De : le serveur de messagerie de votre organisation, Vers : Office 365) :
Réglage |
Valeur |
|---|---|
Type de connecteur |
Du serveur de messagerie de votre organisation vers Office 365 |
Comment identifier l’expéditeur |
En vérifiant que l’adresse IP du serveur émetteur correspond, ou, de préférence, par le nom de sujet du certificat. Pour l’adresse IP, listez chaque adresse depuis laquelle Pepsi envoie : voir |
Rejeter les messages s’ils ne sont pas envoyés en TLS |
Oui |
Sur Exchange sur site, l’équivalent est un connecteur de réception sur le rôle Transport Hub / Frontend, avec RemoteIPRanges réglé sur les adresses de Pepsi et PermissionGroups incluant AnonymousUsers (avec Ms-Exch-SMTP-Accept-Any-Recipient accordé si Exchange doit accepter pour des domaines dont il n’est pas autoritaire).
Note
Si le connecteur identifie Pepsi par IP et que Pepsi est fixé en IPv4 pour cette destination (Choix de la famille d’adresses), listez l’adresse IPv4. Si vous ne listez que l’adresse IPv6 d’un hôte qui ne l’utilisera jamais, l’authentification échoue sans bruit.
N’acceptez les domaines gérés que depuis Pepsi. Tout ce que Pepsi fait sur le chemin entrant ne s’applique qu’au courrier qui le traverse effectivement : le déchiffrement, la vérification des signatures, l’étiquette d’objet [verified], l’évaluation SPF/DKIM/DMARC et les filtres de spam et de langue. Le système situé derrière lui reste joignable par lui-même : le point d’accès <tenant>.mail.protection.outlook.com d’un tenant Exchange Online est public, et un Exchange sur site écoute souvent encore sur le port 25. Un expéditeur qui remet directement là contourne chacune de ces vérifications, et un message falsifié pour sembler avoir été traité par Pepsi (un en-tête X-Pepsi-*, une étiquette [verified]) arrive exactement comme un message qui l’a été. Le système en aval doit donc refuser le courrier destiné aux domaines gérés venant d’autre chose que Pepsi : dans Exchange Online, un connecteur entrant partenaire qui rejette le courrier pour ces domaines sauf s’il provient des adresses ou du certificat de Pepsi (RestrictDomainsToIPAddresses / RestrictDomainsToCertificate) ; sur site, un pare-feu qui ne laisse que Pepsi atteindre les connecteurs de réception, et aucune permission anonyme sur aucun autre connecteur. Il en va de même pour tout MDA ou MTA derrière Pepsi, pas seulement Exchange.
19.6.2. Sortant depuis Exchange (Exchange → Pepsi)¶
La façon dont Pepsi reconnaît le courrier sortant d’Exchange dépend de l’endroit où Exchange s’exécute. Exchange sur site peut se connecter à Pepsi avec un compte qui lui est propre. Exchange Online ne le peut pas : son connecteur sortant n’offre ni SMTP AUTH ni certificat propre, il ne livre que sur le port 25, et tous les clients Microsoft 365 envoient depuis les mêmes adresses Microsoft. Pepsi vérifie donc, pour chacun de ces messages, qu’il prouve avoir été envoyé par votre locataire.
19.6.2.1. Exchange Online : la preuve de locataire¶
Une section [pepsi-ingress-exchange-online-<name>] nomme votre locataire (voir pepsi.conf(5)). Le courrier venant des adresses sortantes de Microsoft peut alors nommer, sur l’écouteur MX, des destinataires hors de vos domaines, et à la fin des données Pepsi ne le relaie que si toutes les conditions suivantes sont remplies :
l’en-tête porte exactement un champ
X-MS-Exchange-CrossTenant-Id, et celui-ci nomme votre locataire ;le champ
From:nomme une seule boîte aux lettres, dans l’un des domaines que la section énumère ;une signature DKIM de ce domaine a été vérifiée ; seul votre locataire peut la produire.
Tout le reste est refusé avec 550 5.7.1. Les règles sont aussi strictes pour trois raisons, et toutes trois reposent sur des mesures faites avec un véritable locataire :
Exchange Online écrit l’identifiant du locataire expéditeur dans chaque message, mais ne retire pas une copie écrite par l’expéditeur. Un autre locataire peut revendiquer votre identifiant, et son message arrive alors avec deux champs de ce type.
La signature DKIM de Microsoft ne couvre pas les destinataires, si bien qu’un message signé pourrait être renvoyé à n’importe qui. Envoyé par un autre locataire, il porte aussi l’identifiant de ce locataire, et il est refusé.
Les champs d’en-tête n’ont de sens que pour du courrier qui vient réellement d’Exchange Online ; Pepsi ne demande donc la preuve qu’aux adresses sortantes publiées par Microsoft (
SENDER_NETWORKS).
Pour la mettre en place :
Signez le courrier de votre domaine dans Microsoft 365. Dans le portail Microsoft Defender (E-mail et collaboration → Stratégies → Paramètres d’authentification des e-mails → DKIM), créez les clés de votre domaine, publiez les deux enregistrements
CNAMEqu’affiche le portail (selector1._domainkeyetselector2._domainkey), puis activez la signature. En PowerShell :Set-DkimSigningConfig -Identity example.com -Enabled $true Get-DkimSigningConfig -Identity example.com | Format-List Enabled,Status
Nommez le locataire dans Pepsi. L’identifiant du locataire est affiché dans le centre d’administration Microsoft Entra, sous Vue d’ensemble :
[pepsi-ingress-exchange-online-example] TENANT_ID = 00000000-0000-0000-0000-000000000000 DOMAINS = example.com
Chaque domaine de
DOMAINSdoit aussi figurer dans[pepsi-ingress] ACCEPTED_DOMAINS. Redémarrezpepsi-ingressaprès la modification.Faites passer le courrier sortant d’Exchange par Pepsi. Dans le centre d’administration Exchange, ajoutez un connecteur de Office 365 vers Organisation partenaire, utilisé pour le courrier vers tous les domaines, qui achemine par le smarthost portant le nom d’hôte MX de Pepsi et utilise toujours TLS, avec un certificat qu’une AC de confiance a émis pour ce nom. En PowerShell :
New-OutboundConnector -Name "Pepsi" -ConnectorType Partner ` -RecipientDomains * -UseMXRecord $false -SmartHosts mail.example.com ` -TlsSettings DomainValidation -TlsDomain mail.example.com
Vérifiez d’abord qu’aucune règle de transport n’envoie le même courrier vers un autre connecteur : une règle dont l’action est Utiliser le connecteur suivant l’emporte sur la portée propre du connecteur.
Testez d’abord avec un seul domaine. Donnez au connecteur un seul domaine de destinataires de test (
-RecipientDomains) avant de l’élargir à*. Le journal depepsi-ingressnomme le locataire de chaque message relayé (relaying outbound mail of Exchange Online tenant) et donne la raison de chaque refus (not proven to come from a configured Exchange Online tenant).
Un message qu’une règle de boîte aux lettres de votre locataire transfère pour un expéditeur extérieur ne porte aucune signature de votre domaine, et il est refusé. Pepsi ne relaie aucun courrier dont il ne peut pas prouver qu’il vient de votre locataire.
19.6.2.2. Exchange sur site : un compte propre¶
Sur site, Exchange envoie par un connecteur d’envoi (Send Connector) vers un écouteur de soumission et s’y authentifie :
[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
Il y a deux façons de le laisser relayer par Pepsi, et elles ne sont pas équivalentes.
SASL avec un compte dédié (recommandé). Exchange s’authentifie avec un nom d’utilisateur et un mot de passe. Un écouteur de soumission applique la RFC 6409 §6 : un expéditeur ne peut employer qu’une adresse à laquelle l’identité authentifiée a droit. Le compte du connecteur a donc besoin d’une entrée USERNAME_MAP qui autorise les domaines servis ; faute de quoi, chaque message qu’Exchange relaie est refusé :
# /etc/pepsi/username.map — the connector account may send as any of our users.
exchange-connector: *@example.com *@example.net
Sans cette entrée, le compte ne peut envoyer qu’en son propre nom, et le premier message qu’Exchange relaie reçoit un 550.
Confiance réseau (``MYNETWORKS``). C’est plus simple, puisque vous listez les adresses d’Exchange et vous passez d’authentification, mais cela comporte le risque d’auto-relais dont traite ce chapitre : tout hôte capable d’atteindre l’écouteur depuis une adresse de confiance peut relayer par lui, et une erreur dans la plage fait de Pepsi un relais ouvert. Un réseau de confiance peut aussi envoyer au nom de n’importe quelle adresse, à moins que SENDER_MAP ne lie les adresses qu’il peut utiliser. Le même fichier lie les adresses d’un certificat client, qui ne peut envoyer au nom de rien tant que le fichier ne les lie pas. Préférez SASL ; si vous utilisez MYNETWORKS, listez des adresses individuelles plutôt que des plages, liez-les avec SENDER_MAP, et n’incluez jamais le loopback. Une plage liée à un simple * permet à chaque machine qu’elle contient, y compris aux autres locataires d’une plage cloud partagée, d’envoyer du courrier que Pepsi signe au nom de n’importe laquelle de vos adresses (la configuration EchoSpoofing) ; pepsi-ingress et pepsi-setup validate avertissent pour chaque plage de ce type. N’y listez jamais les adresses Exchange Online de Microsoft ; utilisez plutôt la preuve de locataire décrite plus haut. Un utilisateur shell local indique ce que l’identité de soumission protège et ne protège pas.
19.7. Le module complémentaire Outlook¶
L’étape de chiffrement de Pepsi agit sur deux en-têtes qu’un message peut porter : X-Pepsi-Sign et X-Pepsi-Encrypt. Le complément est ce qui permet à un utilisateur de les positionner depuis Outlook (son volet Protect message, pendant la rédaction). Le même complément comporte un second volet pour le courrier que l’utilisateur reçoit : Gateway verdict affiche ce que l’étape de déchiffrement a consigné dans X-Pepsi-Crypto et X-Pepsi-Warning, dans le volet de tâches propre à Outlook, hors de la zone du message. Extensions pour clients de messagerie décrit ce que ce volet affiche, ce qu’il prouve et les versions d’Outlook qui le proposent ; le déploiement ci-dessous couvre les deux volets.
Activez les routes et rechargez pepsi-httpd :
[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
Le manifeste est alors servi depuis https://<gateway>/addin/manifest.xml, avec l’URL de la passerelle et un identifiant propre au déploiement substitués pour vous.
Le déploiement se fait par chargement latéral. Dans le centre d’administration Microsoft 365, allez dans Paramètres → Applications intégrées → Télécharger des applications personnalisées, choisissez Fournir le lien vers le fichier manifeste, et donnez-lui cette URL. Il n’y a pas de fiche AppSource : le contenu du manifeste dépend de l’URL de votre passerelle, il n’y a donc pas d’artefact unique à publier. De plus, une revue de boutique qui se dresse entre vous et un correctif est un mauvais marché pour une page de JavaScript.
Les utilisateurs sans le module complémentaire obtiennent le même effet avec un mot-clé d’objet : [sign], [encrypt] ou [secure] n’importe où dans le Subject. L’étape de chiffrement agit dessus et le retire avant l’envoi du message, de sorte que le destinataire ne le voie jamais. Les mots-clés sont configurables (SUBJECT_KEYWORDS_SIGN, SUBJECT_KEYWORDS_ENCRYPT, SUBJECT_KEYWORDS_BOTH).
Note
Un mot-clé d’objet signifie exigé, non essayer : un message qu’un utilisateur a délibérément marqué [encrypt] n’est pas envoyé en clair si un destinataire n’a pas de clé. ON_NO_KEY décide de ce qui se passe à la place. Le courrier non marqué, sous la valeur par défaut ENCRYPT = opportunistic, part toujours en clair sans que l’expéditeur en soit averti, si bien qu’un mot-clé mal tapé n’est pas détecté (voir Les utilisateurs envoient du courrier non chiffré par erreur parce que l’état du chiffrement n’est pas clair). L’exception est un destinataire dont la recherche de clé a échoué dans le DNS : le message n’est alors pas envoyé en clair, mais différé, envoyé au portail ou rebondi, sauf si l’expéditeur écrit [clear-ok] dans l’objet (ou si l’opérateur positionne CLEAR_ON_DNS_FAILURE) ; voir Une recherche de clé qui échoue dans le DNS.
19.8. Le contrat des en-têtes X-Pepsi-*¶
Le contrat comprend trois champs dans un même espace de noms, plus la règle qui rend crédible le champ de résultat. (Ingress en ajoute un quatrième, X-Pepsi-Warning, au courrier entrant dont il a une raison de se méfier, par exemple à cause d’un nom affiché dans From: qui désigne une autre adresse, d’un sosie d’un domaine servi, de caractères cachés, de champs d’en-tête dupliqués ou d’indices semblables (Extensions pour clients de messagerie). Pour la même raison, il retire d’abord toute copie qu’un expéditeur aurait écrite.)
Champ |
Signification |
|---|---|
|
Requête : signer ce message. |
|
Requête : chiffrer ce message. |
|
Résultat : ce que l’étape entrante a constaté. Des paires |
Les requêtes ne sont honorées que pour le courrier soumis localement (state.local_origin) et sont retirées du courrier sortant sans condition, quoi que dise STRIP_REQUEST_HEADERS : un canal de contrôle qui survivrait jusque sur le fil serait un canal auquel on pourrait ordonner au saut suivant d’obéir.
On peut croire l’en-tête de résultat parce que l’étape entrante retire tout l’espace de noms ``X-Pepsi-*`` de chaque message qu’elle voit, avant d’ajouter le sien. Cela vaut aussi pour un message pour lequel elle est désactivée, pour un message adressé à un domaine qu’elle ne sert pas, et pour un message qu’elle s’apprête à scinder. Le seul champ qu’elle conserve est le X-Pepsi-Warning d’ingress sur le bloc d’en-têtes extérieur, qu’ingress n’écrit lui-même qu’après avoir retiré toute copie écrite par un expéditeur ; une copie à l’intérieur d’un contenu déchiffré est retirée comme le reste. Il s’ensuit qu”un message qui n’a pas traversé une étape de déchiffrement ne porte aucun en-tête de résultat digne de confiance, et rien ne devrait en présenter un comme faisant foi. Nous retirons l’espace de noms pour qu’un expéditeur ne puisse pas falsifier le verdict (voir L’injection dans les lignes d’état et la sortie de GnuPG trompe les interfaces). Ce que signifie un indicateur de sécurité indique ce que chaque indicateur promet à un lecteur, et la section n’accepter les domaines gérés que depuis Pepsi, plus haut, explique pourquoi le système derrière la passerelle ne doit accepter de courrier que de Pepsi.
Pepsi-Origin n’est délibérément pas dans cet espace de noms et n’est jamais retiré, car le chemin qui met les paiements en correspondance avec les messages en dépend.
La valeur signature de l’en-tête de résultat vaut none, valid, partial, valid-untrusted, invalid ou unverifiable.
Danger
valid-untrusted signifie que la signature s’est vérifiée contre une clé qui n’est ancrée dans aucun chemin de confiance, et n’importe qui peut produire une telle signature. Elle ne doit jamais être présentée comme vérifiée dans une interface utilisateur, un volet de tâches ou une règle de client de messagerie (voir Les utilisateurs négligent, bâclent ou ne savent pas utiliser la vérification des empreintes de clés).
19.9. Provisionnement automatique d’identités¶
[pepsi-crypto] AUTO_CREATE_IDENTITY (activé par défaut) permet à Pepsi d’engendrer une clé pour un expéditeur local qui n’en a pas. L’option ENABLE_PEP de l’étape de chiffrement décide du moment :
ENABLE_PEP = yes (la valeur par défaut, le préréglage à la manière de pEp) : au premier message soumis par l’expéditeur, quoi qu’il ait demandé. Derrière Exchange, cela couvre tous ceux qui envoient par le connecteur, pourvu que Pepsi reçoive aussi le courrier du domaine de l’expéditeur. En effet, le courrier que relaie le connecteur est soumis localement quelle que soit la façon dont le connecteur s’authentifie (SASL,
MYNETWORKSou un certificat client), et le préréglage s’applique à un tel expéditeur sur chaque route de soumission.ENABLE_PEP = no : la première fois que cet expéditeur demande explicitement une protection – avec le module complémentaire, ou avec un mot-clé d’objet. Cela ne se déclenche pas sur du courrier ordinaire.
Dans les deux cas, une adresse qui a déjà une clé quelconque ne s’en voit jamais attribuer une autre automatiquement. Cela vaut aussi pour une clé que l’utilisateur a enregistrée depuis son client de messagerie, et pour une clé révoquée.
C’est ainsi qu’une organisation obtient une couverture de bout en bout sans travail par utilisateur : une clé apparaît, et elle est publiée pour que les correspondants puissent l’employer.
C’est aussi ainsi qu’une organisation publie l’adresse de chaque personne qui envoie du courrier (ou, sans le préréglage, de chaque personne ayant un jour demandé un message signé). Une identité créée automatiquement est marquée published, et une identité publiée est servie depuis le Web Key Directory propre à cet hôte. C’est exactement ce qui la rend utilisable, et c’est aussi exactement ce qui rend l’adresse découvrable par quiconque la devine. Elle n’est pas téléversée vers un serveur de clés public, sauf si son propriétaire le demande (vks_wanted) ; [pepsi-keys] VKS_PUBLISH ne décide que de la valeur par défaut pour les clés créées à la main.
Les deux moitiés sont souhaitables pour un déploiement à usage général, mais aucune n’est évidemment appropriée pour une organisation dont la liste d’adresses est elle-même sensible, ou tenue par une politique de divulgation des adresses du personnel. Les réglages, du plus au moins automatique :
tout laisser à sa valeur par défaut : chaque expéditeur obtient une clé à son premier message, que l’on peut découvrir via le WKD de cet hôte ; pour la retirer, il suffit donc de dépublier une identité, plutôt que de demander à un serveur de clés de l’oublier ;
définir
[stage-encrypt] ENABLE_PEP = no– des clés n’apparaissent que pour les expéditeurs qui ont demandé une protection ;désactiver
AUTO_CREATE_IDENTITY– le provisionnement de clés devient un acte explicite (d’un opérateur avec pepsi-keys, ou de l’utilisateur via la console web ou l’adresse de contrôlepepsi-keys@), et un utilisateur qui demande le chiffrement sans clé obtient à la place ce que ditON_NO_KEY.
19.10. Distribution des clés¶
Un correspondant ne peut chiffrer que vers une clé qu’il possède ; la clé publique de l’expéditeur voyage donc avec son courrier, de plusieurs façons :
Autocrypt (par défaut). Chaque message soumis localement porte un en-tête
Autocrypt:contenant la clé OpenPGP minimale de l’expéditeur ([stage-encrypt] AUTOCRYPT, par défautyes). Thunderbird, K-9/FairEmail, Delta Chat et les autres clients compatibles Autocrypt l’apprennent silencieusement. Elle accompagne aussi le courrier en clair, et c’est tout l’intérêt : tant qu’un correspondant n’a pas la clé, il n’a rien avec quoi chiffrer.Un fichier de clé joint (facultatif). Avec
ATTACH_KEYS_AS_FILES = yes, la clé est aussi jointe sous la formeOpenPGP_0x<long key ID>.asc(application/pgp-keys), la manière OpenPGP classique, pour les correspondants dont le client ne lit pas Autocrypt et importe les clés depuis les pièces jointes. Sur un courrier chiffré, le fichier se trouve à l’intérieur du texte chiffré ; en clair, le message devientmultipart/mixed. Le fichier n’est joint que jusqu’à ce que le correspondant ait montré qu’il détient la clé, en renvoyant un message chiffré vers elle et signé par lui ; pepsi-stage-autocrypt-learn le consigne sur le chemin entrant. Les correspondants réguliers cessent donc de recevoir le fichier, et une nouvelle clé le fait réapparaître. Désactivez aussiAUTOCRYPTsi vous ne voulez que le fichier.Le Web Key Directory, servi par
pepsi-httpdpour chaque identité publiée, pour les clients qui recherchent les clés plutôt que de les apprendre du courrier.
Lorsqu’un utilisateur a enregistré sa propre clé depuis son client de messagerie, cette clé est sa face publique : Pepsi n’ajoute alors ni en-tête Autocrypt: ni fichier de clé (le client annonce la sienne), et le Web Key Directory ne sert que cette clé. Voir Gestion des clés.
19.11. Dépannage¶
- Les messages bouclent entre Pepsi et Exchange.
Le smarthost est pointé vers votre MX public plutôt que vers le point de terminaison du locataire, ou un domaine servi est acheminé vers l’étape direct-vers-MX. Lancez
pepsi-setup validate: cette commande vérifie la configuration exactement commerun, sans rien modifier, et refuse les deux erreurs. Si le courrier boucle malgré tout, la configuration en fonctionnement n’est pas celle que vous avez validée. (pepsi-setup checkest une commande différente : elle compare le DNS en vigueur aux enregistrements querunpublierait, et ne valide pas le pipeline.) Cherchez la boucle avecpepsi-queue: un message qui porte un grand nombre de champsReceived:la trahit.- Exchange Online rejette avec 550 5.7.1 … S820.
L’adresse IPv6 émettrice n’a pas de
PTR. Publiez-en un, ou réglezADDRESS_FAMILY = ipv4sur cette entrée MTA (Choix de la famille d’adresses).- Exchange Online rejette avec 550 5.7.64 TenantAttribution.
Le connecteur entrant ne reconnaît pas l’expéditeur. Vérifiez que le connecteur liste l’adresse depuis laquelle Pepsi envoie réellement — l’adresse IPv4 si
ADDRESS_FAMILYla cloue.- Le courrier sortant d’Exchange Online reçoit 550 5.7.1 Relaying denied.
Avec
message not proven to come from a configured Exchange Online tenant, le journal depepsi-ingressnomme la règle qui a échoué. No DKIM signature … verified : la signature DKIM du domaine est désactivée dans Microsoft 365, ou les enregistrementsselector1/selector2manquent. Names tenant … :TENANT_IDest faux. Two … fields : le message ne vient pas de votre locataire. Refusé dès leRCPT(recipient not in a served domain) : l’adresse du client est hors deSENDER_NETWORKS, ou l’expéditeur d’enveloppe n’est dans aucun desDOMAINSde la section.- Tout ce qu’Exchange relaie reçoit 550 5.7.1 Envelope sender not permitted.
RFC 6409 §6 : le compte SASL du connecteur ne peut envoyer qu’en son propre nom. Donnez-lui une entrée
USERNAME_MAPcouvrant les domaines servis.- Une remise emploie la mauvaise famille d’adresses.
La précédence est l’entrée
[…-mta-*], puis la section[stage-*], puisany; le résultat est ensuite intersecté avec ce que l’hôte peut router.- En-têtes X-MS-*.
Exchange ajoute et consomme un certain nombre d’en-têtes
X-MS-*. Pepsi ne les lit, ne les réécrit ni ne les retire ; seul l’espace de nomsX-Pepsi-*est touché. Sachez toutefois que ré-encoder un message pour un saut suivant dépourvu de8BITMIMEréécrit le corps et invalide donc toute signature portant dessus (voir Extensions du protocole SMTP).
19.12. Ce que Pepsi ne fait pas¶
La journalisation d’archivage et l’archivage sont hors du périmètre. Les déploiements Exchange ont fréquemment une obligation de rétention, et Pepsi n’y répond pas : il n’y a ni magasin d’archives, ni moteur de rétention, ni recherche, ni dispositif de conservation légale. Voir docs/ROADMAP.md.
Avertissement
[pepsi] MAIL_LOG n’est pas une archive et ne doit pas être présenté comme telle à un auditeur. Il n’enregistre aucun contenu de message, quel que soit le réglage : tout au plus l’enveloppe, l’issue et, à full, la ligne Subject:. Ses lignes sont élaguées après [pepsi-admin] MAIL_LOG_RETENTION_DAYS, trente jours par défaut. C’est un journal d’exploitation assorti d’une limite de rétention, ce qui est l’opposé d’un mécanisme de rétention.
Si vous avez une obligation de rétention, satisfaites-la avec la journalisation d’archivage propre à Exchange ou avec un produit d’archivage dédié, et considérez MAIL_LOG comme ce qui vous dit ce qui s’est passé le mois dernier, pas ce qui a été dit l’an dernier.
Une passerelle cryptographique est en réalité censée répondre à une question plus étroite : ce message était-il chiffré, et qu’avons-nous décidé à son sujet ? MAIL_LOG répond bien à cette question, lorsqu’il est activé. Notez que, si vous l’activez, le déploiement conserve la trace de qui correspond avec qui ; pepsi.conf(5) discute de ce compromis.