Aller au contenu
Liant

Migration Office 365 vers IMAP

· IMAP, imapsync, OAuth2, Microsoft Office 365, migration

Introduction

La migration des boîtes courriels d’Office 365 vers IMAP est devenue plus complexe récemment. En effet, l’authentification à double facteur et l’adoption du protocole OAuth2 ont compliqué le processus. Cependant, ces changements ont aussi renforcé la sécurité des comptes.

Dans cet article, nous vous guiderons graduellement pour migrer vos boîtes Office 365 vers un système IMAP. Nous utiliserons l’outil imapsync tout en respectant les nouveaux mécanismes d’authentification de Microsoft.

Promotion

Vous préférez éviter ce processus complexe ? Notre équipe expérimentée peut s’en charger pour vous. Rendez-vous sur notre boutique, choisissez le nombre de boîtes à migrer, et nous nous occuperons du reste.

Sommaire

Préparation à la connexion

Avant de commencer, deux étapes sont cruciales :

Autorisation du protocole IMAP

Microsoft a désactivé le protocole IMAP (et POP) car il n’est pas compatible avec OAuth2. Cependant, cette décision peut être discutable selon votre politique de sécurité.

Pour la plupart des utilisateurs, l’activation de l’IMAP ne pose pas de problème majeur. Il est souvent préférable d’utiliser une solution adaptée à vos besoins plutôt qu’un système trop complexe.

Vérification de l’activation de l’IMAP

Pour cela, allez sur votre interface d’ administration :

Page d’accueil de l’interface d’administration Office 365

Page d’administration Office 365, liste des utilisateurs actifs

Fenêtre d’un utilisateur dans l’administration Office 365, zone de réglages du courrier

Fenêtre de gestion des applications de courrier d’un utilisateur Office 365, avec la case IMAP

Autorisation d’accès aux autres comptes

Pour faciliter le transfert, accordez temporairement à l’utilisateur le droit d’accéder aux e-mails des autres. Suivez ces étapes pour chaque utilisateur :

Page d’administration Office 365, utilisateur actif, onglet Courrier : accès aux autorisations de lecture et de gestion

Dans la sous fenêtre « Autorisations de lecture et de gestion », cliquez sur « Ajouter des autorisations » :

Fenêtre « Autorisations de lecture et de gestion » avec le bouton Ajouter des autorisations

La liste des utilisateurs disponible s’affiche alors, et sélectionnez celui que vous avez précédemment configuré (1), puis cliquez sur « Add » (2) :

Liste des utilisateurs pour ajouter des autorisations sur les boîtes aux lettres : sélection de l’utilisateur configuré (1) puis bouton Add (2)

Enregistrement de l’application IMAPSYNC

Cet enregistrement déclare la manière et le type d’autorisation utilisé pour accéder au service IMAP.

Nous emploierons OAuth2 avec le flux implicite qui devra avoir une durée de vie faible.

Création de l’application

Page Entra, Inscriptions des applications, avec le bouton Nouvelle inscription

Formulaire d’inscription d’une nouvelle application dans Entra : nom, usage et URL de rappel

Cliquez sur « S’inscrire », ce qui vous dirige vers la page d’information de l’inscription de l’application.

Configuration de l’authentification

Page d’authentification de l’application dans Entra, avec l’option Jetons d’accès cochée

Allez ensuite dans le menu latéral 2 sur « Certificats & secrets » (1), cliquez sur « Nouveau secrétaire client » (2), écrivez une petite description qui vous parle pour ce secret (3), éventuellement réduisez la date d’expiration du secret et enfin, cliquez sur « Ajouter » (4) :

Page Certificats et secrets de l’application dans Entra : création du secret client et copie de sa valeur

Création du secret client

Configuration des API autorisées

Dans « API autorisées », ajoutez les permissions nécessaires :

Allons activer les API auxquels aura le droit d’accéder notre application. Dans le menu latéral 2 cliquez sur « API autorisées » (1), puis cliquez sur « Ajouter une autorisation » (2), sélectionner « Microsoft Graph », puis « Autorisations déléguées » (3) :

Page API autorisées de l’application dans Entra : ajout d’une autorisation Microsoft Graph, autorisations déléguées

Page API autorisées de l’application dans Entra, après ajout des droits IMAP.AccessAsUser.All et offline_access

Page API autorisées de l’application dans Entra : octroi du consentement de l’administrateur

Récupération des identifiants

Notez les valeurs suivantes :

Page Vue d’ensemble de l’application dans Entra, avec la copie de l’ID d’application (client)

Page Vue d’ensemble de l’application imapsync dans Entra, avec l’ID d’annuaire entouré en rouge, et un terminal où sont notées les variables APP_ID, APP_SECRET et TENANT_ID

Ces étapes vous permettront d’utiliser oauth2c pour obtenir un jeton d’accès au service IMAP d’Outlook avec imapsync.

Obtenir le jeton

Pour commencer, lancez la commande suivante dans votre terminal :

oauth2c https://login.microsoftonline.com/$TENANT_ID/v2.0 \
--client-id "$APP_ID" --client-secret "$APP_SECRET" \
--scopes 'https://outlook.office365.com/.default' \
--login-hint 'roland@liant.dev' --grant-type implicit \
--auth-method client_secret_basic --response-mode form_post \
--response-types token --browser-timeout 1m

Ensuite, votre navigateur par défaut s’ouvrira sur la page d’authentification Microsoft. Vous devrez alors autoriser l’application « imapsync » à accéder à vos ressources courriel.

Si vous avez besoin de plus de temps, augmentez l’option « browser-timeout ».

Une fois l’autorisation accordée, copiez l’access_token affiché. Puis, enregistrez-le dans un fichier avec la commande :

echo '<access_token>' > tokenfile

Vous disposez maintenant d’un jeton pour vous connecter en IMAP au serveur Outlook.

Lancer la synchronisation avec imapsync

Maintenant que vous avez le fichier contenant le jeton, utilisez-le avec l’option –oauthaccesstoken.

Voici la commande complète de synchronisation :

imapsync --addheader --automap \
--office1 --oauthaccesstoken1 tokenfile --user1 <utilisateur>@liant.dev \
--host2 mail.liant.email --user2 <utilisateur>@liant.dev --password2 <p2>

Pour comprendre les différentes options, consultez la documentation. Cependant, voici quelques explications essentielles :

Suffixes 1 (source serveur Office 365)

Suffixes 2 (destination IMAP)

Erreurs fréquentes

Renouvellement du jeton

Si le processus dépasse la durée de vie du jeton (quelques heures), celui-ci expirera. Dans ce cas, recommencez la procédure d’obtention du jeton.

Utilisateur authentifié, mais pas d’accès à la boîte

Si vous obtenez l’erreur « User is authenticated but not connected », vérifiez que vous avez bien autorisé l’accès au compte administrateur pour cette boîte.