Aller au contenu
Epsight
Fiche pratiqueEpsight Infra. & Modern Workplace

Proxy OAuth2 et SSL/TLS pour POP3 et IMAP4

Exchange Online impose le chiffrement et l’authentification moderne (OAuth 2.0) pour POP et IMAP. Certaines applications métier anciennes ne savent ni l’un ni l’autre. Plutôt que de bloquer la migration vers Microsoft 365, un proxy local fait le lien : l’application lui parle comme avant, et le proxy s’authentifie auprès d’Entra ID. Voici le mode opératoire que nous utilisons.

Par Emmanuel, Directeur GénéralPublié le Mis à jour le 4 min de lecture
L’essentiel
  • 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#

  1. L’application se connecte au proxy en POP3 ou IMAP4, sans chiffrement, sur l’adresse locale.
  2. Le proxy obtient un jeton auprès d’Entra ID avec l’identité d’une application dédiée.
  3. Le proxy se connecte à Exchange Online en POP3S ou IMAP4S et s’authentifie avec ce jeton.
  4. Il indique à l’application que la connexion est établie, comme après une authentification par identifiant et mot de passe.
  5. 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é :

INIemailproxy.config
[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 = False

Remplacez 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.

  1. Dans Entra ID, ouvrez App registrations puis New registration.
  2. Donnez un nom explicite et choisissez Accounts in this organizational directory only.
  3. Dans Redirect URI, choisissez Web et saisissez http://localhost, puis Register.
  4. Dans API permissions, Add a permission, puis APIs my organization uses et Office 365 Exchange Online.
  5. Sélectionnez POP.AccessAsApp ou IMAP.AccessAsApp selon le protocole ; ajoutez SMTP.SendAsApp si l’application doit aussi envoyer.
  6. Cliquez sur Grant admin consent. La permission User.Read, inutile ici, peut être retirée.
  7. Dans Certificates & secrets, créez un New client secret et notez sa valeur immédiatement : elle ne sera plus affichée.
  8. 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 :

PowerShellposte d’administration
# 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 FullAccess

4. 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 :

Bashserveur du proxy
pip install -r requirements-core.txtpip install -r requirements-gui.txtpip install pyinstallerpyinstaller --onefile emailproxy.py # Lancement sans interface graphiqueemailproxy.exe --no-gui

L’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.

Sources#

  1. Simon Robinson, Email OAuth 2.0 Proxy (GitHub)
  2. Microsoft, authentifier une connexion IMAP, POP ou SMTP avec OAuth
Pas encore prêt pour un échange ?Chaque mois, un retour d’expérience terrain sur la sauvegarde, le cloud, la cybersécurité ou l’IA. Désinscription en un clic.