- Le proxy s’intercale entre l’application et Exchange Online : il reçoit des connexions POP ou IMAP locales et s’authentifie en OAuth 2.0 auprès d’Entra ID.
- Nous utilisons l’outil open source Email OAuth 2.0 Proxy de Simon Robinson, en mode client credentials, sans interaction utilisateur.
- Une application Entra ID dédiée par boîte, avec les seules permissions POP.AccessAsApp ou IMAP.AccessAsApp, et un accès limité à cette boîte.
- Le proxy n’écoute que localement : le flux non chiffré ne quitte jamais le serveur.
- Public
- Administrateurs Microsoft 365 et systèmes
- Niveau
- Avancé
- Prérequis
- Droits d’administration Entra ID et Exchange Online
- Outil
- Email OAuth 2.0 Proxy (open source)
Le principe#
- L’application se connecte au proxy en POP3 ou IMAP4, sans chiffrement, sur l’adresse locale.
- Le proxy obtient un jeton auprès d’Entra ID avec l’identité d’une application dédiée.
- Le proxy se connecte à Exchange Online en POP3S ou IMAP4S et s’authentifie avec ce jeton.
- Il indique à l’application que la connexion est établie, comme après une authentification par identifiant et mot de passe.
- L’application envoie ses commandes POP ou IMAP habituelles pour lire le courrier.
1. Le fichier de configuration du proxy#
Le fichier emailproxy.config déclare les serveurs Exchange Online et le compte concerné :
[Email OAuth 2.0 Proxy configuration file] [Server setup][POP-1995]server_address = outlook.office365.comserver_port = 995local_address = 127.0.0.1 [IMAP-1993]server_address = outlook.office365.comserver_port = 993local_address = 127.0.0.1 [app@yourdomain.com]token_url = https://login.microsoftonline.com/Your-Tenant-Guid/oauth2/v2.0/tokenoauth2_scope = https://outlook.office365.com/.defaultoauth2_flow = client_credentialsredirect_uri = http://localhostclient_id = XXXXXclient_secret = YYYYY [Advanced proxy configuration][emailproxy]delete_account_token_on_password_error = Trueencrypt_client_secret_on_first_use = FalseRemplacez XXXXX par l’identifiant de l’application, YYYYY par son secret, app@yourdomain.com par l’adresse de la boîte, et Your-Tenant-Guid par l’identifiant de votre tenant, visible sur la page d’accueil d’Entra ID.
2. L’application Entra ID#
Créez une application dédiée pour chaque boîte déclarée dans le proxy : en cas de compromission d’un secret, l’impact reste limité à une seule boîte.
- Dans Entra ID, ouvrez App registrations puis New registration.
- Donnez un nom explicite et choisissez Accounts in this organizational directory only.
- Dans Redirect URI, choisissez Web et saisissez
http://localhost, puis Register. - Dans API permissions, Add a permission, puis APIs my organization uses et Office 365 Exchange Online.
- Sélectionnez POP.AccessAsApp ou IMAP.AccessAsApp selon le protocole ; ajoutez SMTP.SendAsApp si l’application doit aussi envoyer.
- Cliquez sur Grant admin consent. La permission User.Read, inutile ici, peut être retirée.
- Dans Certificates & secrets, créez un New client secret et notez sa valeur immédiatement : elle ne sera plus affichée.
- Notez l’Application (client) ID pour le fichier de configuration.
3. Donner à l’application l’accès à la boîte#
L’application doit ensuite être déclarée dans Exchange Online et recevoir un accès à la seule boîte concernée :
# Connexion à Azure et à Exchange OnlineConnect-AzAccountConnect-ExchangeOnline # Récupérer l’application Entra ID créée pour la boîte$objAzApp = Get-AzADServicePrincipal -SearchString "POP3 - app@yourdomain.com" # Déclarer le principal de service dans Exchange Online$strSPDisplayName = "EXO ServicePrincipal pour $($objAzApp.DisplayName)"New-ServicePrincipal -AppId $objAzApp.AppId -ObjectId $objAzApp.Id -DisplayName $strSPDisplayName # Donner à l’application l’accès à la seule boîte concernée$objEXOSP = Get-ServicePrincipal -Identity $strSPDisplayNameAdd-MailboxPermission -Identity "app@yourdomain.com" -User $objEXOSP.Identity -AccessRights FullAccess4. Compiler et lancer le proxy#
Le proxy est un script Python. Pour l’exécuter comme un programme autonome sous Windows, après avoir installé Python :
pip install -r requirements-core.txtpip install -r requirements-gui.txtpip install pyinstallerpyinstaller --onefile emailproxy.py # Lancement sans interface graphiqueemailproxy.exe --no-guiL’interface graphique est inutile avec un fichier de configuration complet. Déclarez ensuite le programme comme service, pour qu’il redémarre avec le serveur, et configurez l’application métier pour qu’elle se connecte à 127.0.0.1 sur les ports 1995 (POP) ou 1993 (IMAP).
Limites et alternatives#
- Cette solution est une passerelle : à terme, l’application devrait être mise à jour ou remplacée pour prendre en charge OAuth 2.0 nativement, ou utiliser Microsoft Graph.
- Le proxy devient un composant à superviser et à maintenir : mises à jour de l’outil, renouvellement des secrets, journaux.
- Pour l’envoi seul, d’autres options existent : relais SMTP authentifié, connecteur Exchange Online ou service d’envoi dédié.
Questions fréquentes#
Pourquoi Exchange Online refuse-t-il la connexion de mon application ?
Microsoft a désactivé l’authentification de base pour POP et IMAP dans Exchange Online : seules les connexions chiffrées avec authentification moderne (OAuth 2.0) sont acceptées.
Peut-on utiliser une seule application Entra ID pour plusieurs boîtes ?
C’est possible techniquement, mais une application par boîte limite l’impact en cas de fuite d’un secret.
Le proxy fonctionne-t-il sous Linux ?
Oui, le script Python fonctionne sous Linux et macOS ; la compilation en exécutable est surtout utile sous Windows.