Connectez Gmail ou Microsoft 365 à Nextcloud Mail via OAuth2.

Pour connecter Gmail ou Microsoft 365 à Nextcloud Mail via OAuth2, enregistrez une application web auprès de votre fournisseur de messagerie, copiez l'URI de redirection de Nextcloud Mail dans cet enregistrement et conservez l'identifiant client et le secret dans les paramètres d'administration de Nextcloud Groupware. Connectez ensuite la boîte aux lettres dans Mail et autorisez l'authentification. Une configuration fonctionnelle doit permettre de charger les messages entrants et d'envoyer un message de test ; l'affichage d'un écran d'autorisation réussie ne suffit pas.

Vérifiez que votre compte et votre installation Nextcloud correspondent à cette méthode.

Nextcloud Mail utilise IMAP pour la lecture des messages et SMTP pour leur envoi. OAuth2 obtient l'autorisation du fournisseur d'identité ; XOAUTH2 est le mécanisme utilisé par le client de messagerie pour présenter un jeton d'accès à ces services. Il ne transforme pas la connexion Nextcloud en une authentification unique universelle pour tous les serveurs de messagerie.

La documentation d'administration actuelle de Nextcloud décrit les intégrations dédiées à Gmail (OAuth) et Microsoft Outlook (XOAUTH2). La prise en charge de Microsoft a été ajoutée dans Mail 3.0.0 ; le libellé des menus peut varier selon les versions de Mail et de Nextcloud. Ce guide est basé sur le manuel d'administration de Nextcloud 35 Mail , mis à jour en octobre 2026.

• Utilisez une URL Nextcloud HTTPS qui s'ouvre de manière fiable depuis un navigateur, avec l'application Mail installée et activée.
• Disposer d'un accès administrateur Nextcloud et de l'autorisation d'enregistrer une application OAuth dans Google Cloud ou Microsoft Entra.
• Sachez si le compte est un compte Gmail/Google Workspace, Outlook.com ou une boîte aux lettres Microsoft 365 hébergée sur Exchange Online.
• Vérifiez que le fournisseur autorise l'accès IMAP et, pour l'envoi, l'authentification SMTP conformément aux politiques de l'organisation.

Limite importante : un fournisseur IMAP personnalisé acceptant OAuth2 n’est pas automatiquement pris en charge par les écrans de configuration Gmail/Microsoft de Nextcloud Mail. La demande de fonctionnalité Nextcloud Mail concernant les fournisseurs OAuth2 génériques documente cette distinction. Pour tout autre fournisseur, veuillez vérifier votre version de Mail et ses méthodes d’authentification prises en charge plutôt que de saisir des identifiants Google ou Microsoft non liés à votre compte.

Enregistrez un client OAuth avec l'URI de redirection appropriée.

Gmail ou Google Workspace

1. Dans Nextcloud, connectez-vous en tant qu'administrateur, ouvrez Paramètres d'administration → Groupware et repérez l'intégration Gmail . Copiez l'URI de redirection affichée par votre instance. Ne présumez pas qu'une URL copiée depuis l'installation d'un autre utilisateur soit correcte.
2. Ouvrez la console Google Cloud et sélectionnez ou créez un projet. Configurez les paramètres de consentement, de marque et d'audience de la plateforme d'authentification Google en fonction de votre organisation Workspace ou des utilisateurs externes ; ajoutez des utilisateurs de test si l'application est encore en phase de test.
3. Créez un client OAuth de type application Web . Indiquez l'URL exacte de Nextcloud dans les URI de redirection autorisées , puis enregistrez l'ID client et le secret client en lieu sûr. Google exige une correspondance littérale de l'URI de redirection, incluant le schéma, le chemin, la casse et la barre oblique finale.
4. Veuillez examiner les autorisations et les exigences de publication. L'accès OAuth IMAP et SMTP de Gmail utilise https://mail.google.com/un périmètre d'autorisation étendu et restreint, soumis aux politiques de Google en matière de données utilisateur et de vérification. L'administrateur doit s'assurer que l'utilisation envisagée respecte ces exigences.

Google documente le processus d'enregistrement du serveur web dans ses instructions relatives aux applications web OAuth2 , ainsi que le protocole et le périmètre spécifiques à Gmail XOAUTH2 . Une configuration de test est utile pour la validation initiale, mais une application OAuth externe laissée en mode test reçoit généralement des jetons d'actualisation qui expirent au bout de sept jours lors des demandes d'accès à la messagerie Gmail. Consultez les instructions de Google concernant l'expiration des jetons . Des réautorisations hebdomadaires répétées peuvent donc indiquer une limitation de l'état de publication plutôt qu'un mot de passe IMAP incorrect.

Microsoft 365 ou Outlook.com

1. Dans les paramètres d'administration de Nextcloud → Groupware , recherchez l'intégration Microsoft et copiez l'URI de redirection affichée.
2. Dans le centre d'administration Microsoft Entra , accédez à « Inscriptions d'applications » et créez une inscription. Pour les types de comptes décrits dans le guide standard de Nextcloud, sélectionnez les comptes Microsoft professionnels et personnels ; utilisez une plateforme de redirection Web et saisissez l'URI de Nextcloud exactement.
3. Copiez l' ID de l'application (client) . Dans la section « Certificats et secrets » , créez un secret client et copiez immédiatement sa valeur , et non l'identifiant du secret. Notez sa date d'expiration dans votre calendrier opérationnel.
4. Utilisez les autorisations déléguées relatives à la messagerie requises pour le flux OAuth IMAP et SMTP du fournisseur, avec le consentement de l'organisation lorsque nécessaire. Microsoft documente les étendues et IMAP.AccessAsUser.Allles jetons d'actualisation. Ne confondez pas ces autorisations de protocole avec les autorisations Mail.Read/Mail.Send de Microsoft Graph.SMTP.Sendoffline_access

Pour plus d'informations sur l'enregistrement, consultez la documentation d'enregistrement des applications Microsoft et les instructions OAuth IMAP/SMTP d'Exchange Online . La configuration générale documentée de Nextcloud laisse le champ « locataire » par défaut common. Une valeur spécifique au locataire ou une audience prise en charge plus restreinte ne doivent être utilisées que si l'administrateur a vérifié le type de compte et les modifications de stratégie associés.

Enregistrez les identifiants dans Nextcloud et connectez la boîte mail.

1. Retournez dans les paramètres d'administration → Logiciels de groupe . Collez l'ID client et le secret client du fournisseur dans la section d'intégration Gmail ou Microsoft correspondante , puis enregistrez. Ne saisissez jamais le secret dans le champ URI de redirection et ne le publiez jamais dans des captures d'écran, des tickets ou un système de contrôle de version.
2. Connectez-vous avec le compte utilisateur prévu pour la boîte mail, ouvrez Mail et choisissez d'ajouter un compte de messagerie. Saisissez son adresse e-mail, sélectionnez d'abord la configuration automatique du compte, puis lancez la connexion. Le processus Microsoft documenté pour Nextcloud peut encore afficher un champ de mot de passe ; le texte saisi sera ignoré lors de la configuration de l'authentification OAuth du fournisseur. N'utilisez pas inutilement le mot de passe réel de votre compte.
3. Dans la fenêtre contextuelle du fournisseur, sélectionnez l'identité Google ou Microsoft appropriée, vérifiez l'accès demandé et donnez votre consentement si votre organisation l'approuve. Autorisez les fenêtres contextuelles du navigateur et retournez à l'onglet Nextcloud d'origine une fois la redirection effectuée.
4. Si la configuration automatique sélectionne le mauvais serveur, vérifiez les noms d'hôte IMAP et SMTP ainsi que les options de chiffrement de ce fournisseur. Le bouton OAuth est associé aux points de terminaison Gmail/Microsoft reconnus ; la saisie manuelle de noms d'hôte non pertinents peut ne pas activer le processus de connexion attendu.

Dans le formulaire de compte Nextcloud Mail, un point de terminaison Google reconnu avec OAuth configuré peut afficher « Se connecter avec Google » , et son équivalent Microsoft peut afficher « Se connecter avec Microsoft » . Le code source du formulaire de compte Nextcloud Mail en production documente ces libellés conditionnels. La présence du bouton spécifique au fournisseur est un premier indicateur utile que Nextcloud a reconnu l'intégration prévue, mais elle ne prouve pas que l'autorisation ou l'accès à la boîte aux lettres a été effectué.

Résolvez les défaillances en fonction de l'étape à laquelle elles surviennent.

Microsoft explique le contrôle d'authentification SMTP, y compris la possibilité de dérogation par boîte aux lettres, dans sa documentation relative à l'authentification SMTP d'Exchange Online . Évitez d'affaiblir globalement la sécurité du courrier électronique pour qu'une seule boîte aux lettres fonctionne ; si la politique de l'entreprise interdit le protocole, utilisez plutôt un client de messagerie approuvé ou une procédure standard de votre organisation.

Vérifiez le flux du courrier dans les deux sens.

1. Ouvrez votre boîte de réception dans Nextcloud Mail, actualisez-la et vérifiez qu'un message récemment reçu apparaît bien avec l'expéditeur, l'objet et le contenu attendus.
2. Envoyez un court e-mail de test à une autre boîte mail que vous gérez. Vérifiez la réception, puis consultez le dossier « Éléments envoyés » dans Nextcloud Mail. Cela permet de distinguer les problèmes d'autorisation SMTP des problèmes de synchronisation IMAP.
3. Déconnectez-vous puis reconnectez-vous et rouvrez Mail. Pour les déploiements opérationnels, vérifiez à nouveau après le renouvellement normal du jeton d'accès ; un succès immédiat ne garantit pas le renouvellement à long terme du jeton.

Si la synchronisation de la boîte de réception échoue toujours, Nextcloud fournit une documentation occ mail:account:exportpour trouver l'identifiant du compte de messagerie et occ mail:account:sync -vvv ACCOUNT_IDproposer un dépannage ciblé. Son manuel de dépannage des outils collaboratifs explique également la journalisation de débogage IMAP/SMTP par compte et avertit que les journaux peuvent contenir des informations sensibles. Il est recommandé de ne capturer que les données nécessaires, de masquer les jetons et les adresses avant le partage, et de désactiver le débogage détaillé par la suite.

La configuration est prête à l'emploi une fois le consentement du fournisseur obtenu, la messagerie accessible, les courriels sortants parvenus à destination et la connexion maintenue sans demande d'autorisation répétée. En cas d'échec d'une de ces vérifications, il convient de résoudre le problème à cette étape précise plutôt que de recréer immédiatement l'intégralité de l'application OAuth.