OAuth2 est la méthode privilégiée pour connecter de nombreux comptes de messagerie hébergés à Nextcloud Mail, car le fournisseur de messagerie émet des jetons au lieu d'exiger que Nextcloud utilise systématiquement le mot de passe habituel de la boîte mail de l'utilisateur. En pratique, cependant, une configuration réussie ne se mesure pas à la simple fermeture de la fenêtre de consentement OAuth. L'important est que Nextcloud Mail puisse charger les dossiers via IMAP, envoyer des e-mails via SMTP, actualiser l'authentification sans que l'utilisateur ait à se saisir du mot de passe à chaque fois, et continuer à le faire même après l'expiration du premier jeton d'accès.
Ce guide traite des deux intégrations OAuth documentées directement par Nextcloud Mail : les comptes Google et les comptes Microsoft Outlook/Microsoft 365 hébergés. À compter du 6 octobre 2026, l’App Store de Nextcloud indique que Mail 5.12.3 est la version stable pour Nextcloud 32 à 35, tandis que le manuel d’administration actuel documente la configuration de Google OAuth et de Microsoft XOAUTH2. Si vous utilisez une version antérieure de Mail, effectuez la mise à jour dans la plage de compatibilité prise en charge par votre serveur Nextcloud avant de tenter de résoudre un problème de comportement qui pourrait avoir changé.
Les références officielles utilisées ici incluent le manuel d'administration de Nextcloud Mail , la page Nextcloud Mail App Store , la documentation OAuth IMAP, POP et SMTP de Google et la documentation OAuth de Microsoft pour IMAP et SMTP .
Avant de modifier les paramètres du fournisseur, définissez le résultat attendu. Une configuration fonctionnelle doit satisfaire à tous ces critères :
Si la configuration réussit uniquement l'étape de l'écran de consentement mais pas les tests IMAP et SMTP, considérez-la comme incomplète. L'autorisation OAuth et l'accès au protocole de messagerie sont des étapes liées mais distinctes.
Nextcloud Mail propose actuellement une gestion intégrée de l'authentification OAuth pour les comptes Google et Microsoft. Les serveurs de messagerie de Google prennent en charge OAuth 2.0 avec SASL XOAUTH2 pour IMAP et SMTP. Microsoft documente la prise en charge d'OAuth 2.0 pour IMAP, POP et SMTP dans Microsoft 365 et Outlook.com. Nextcloud utilise ensuite le jeton fourni par le fournisseur lors de l'authentification auprès des protocoles de messagerie.
Ne présumez pas que n'importe quel serveur de messagerie compatible OpenID Connect ou OAuth2 peut être intégré à la même interface. Une demande d'amélioration de Nextcloud Mail datant de 2026, concernant les fournisseurs OAuth/OpenID tiers génériques, est restée une simple amélioration et non une procédure de configuration générale documentée. Si votre fournisseur n'est ni Google ni Microsoft, vérifiez sa compatibilité avant de déployer OAuth2 en production. La discussion relative à ce projet est disponible dans le ticket « Nextcloud Mail generic OAuth2 enhancement issue » .
Connectez-vous en tant qu'administrateur Nextcloud, ouvrez les paramètres d'administration, accédez à la section « Groupware » et recherchez l'intégration Gmail . Le manuel d'administration de Nextcloud indique de saisir un ID client et un secret client Google dans cette section. Utilisez l'URI de redirection affichée par votre instance lors de la configuration de Google ; ne reconstruisez pas le chemin à partir d'un exemple, car les proxys inverses, les modifications du répertoire racine web et la configuration du déploiement peuvent affecter l'URL visible de l'extérieur.
Contrôle qualité : l’URI de redirection doit utiliser le nom d’hôte HTTPS de votre environnement de production et être accessible depuis le navigateur de l’utilisateur. Si Nextcloud affiche un nom d’hôte interne alors que les utilisateurs accèdent à un nom d’hôte public, corrigez d’abord la configuration d’URL de Nextcloud/proxy. OAuth ne compensera pas une URL publique incorrecte.
Dans Google Cloud, configurez la plateforme d'authentification Google et les paramètres de consentement pour le projet, puis créez un client OAuth pour l' application Web . Ajoutez l'URI de redirection copiée depuis Nextcloud en tant qu'URI de redirection autorisée. Google exige que l'URI de redirection dans la requête d'autorisation corresponde exactement à une valeur autorisée : le schéma, la casse, le chemin et la barre oblique finale sont importants. Google documente ce comportement dans la section « Utilisation d'OAuth 2.0 pour les applications serveur Web » .
L'accès à la messagerie Gmail est important du point de vue de la conformité. Google considère l' https://mail.google.com/accès étendu, incluant l'utilisation d'IMAP, SMTP et POP3, comme un accès restreint. Selon que l'application soit interne, en phase de test ou destinée à une utilisation en production à grande échelle, les exigences de vérification de Google peuvent s'appliquer. Consultez la documentation de Google relative aux accès restreints et les instructions de vérification des applications OAuth avant d'intégrer un grand nombre d'utilisateurs.
Retournez dans les paramètres d'administration > Groupware > Intégration Gmail , collez l'identifiant client Google et le secret client, puis enregistrez. Évitez de divulguer ce secret dans des captures d'écran, des tickets, l'historique du shell ou des notes partagées. Si vous modifiez ultérieurement le secret client OAuth, mettez à jour Nextcloud sans tarder et planifiez une vérification contrôlée des comptes existants.
Ouvrez Nextcloud Mail en tant qu'utilisateur et ajoutez le compte Gmail. Le code actuel de Mail reconnaît Gmail grâce aux hôtes IMAP/SMTP standard et bascule la méthode d'authentification vers XOAUTH2 lorsque l'administrateur a configuré Google OAuth. Consultez la documentation Google imap.gmail.com:993relative à l'IMAP sur SSL et smtp.gmail.comau TLS sur les ports SMTP compatibles.
Connectez-vous à votre compte Google et consultez l'écran de consentement. Le fournisseur peut afficher des avertissements ou restreindre l'accès si l'application OAuth n'a pas été configurée ou vérifiée pour les autorisations et le public concernés.
Ne vous arrêtez pas à l'étape « compte connecté ». Chargez la boîte de réception, ouvrez au moins un message, envoyez un message à une autre boîte mail que vous contrôlez, répondez-y et confirmez l'échange. Ce test est bien plus concluant qu'une simple redirection OAuth.
Ouvrez le centre d'administration Microsoft Entra et créez une inscription d'application. Le guide Nextcloud recommande aux administrateurs de choisir, dans son exemple général, des types de comptes autorisant les comptes Microsoft professionnels et personnels, et de configurer une URI de redirection Web copiée depuis Nextcloud. Si votre organisation utilise délibérément un seul locataire, ne copiez pas aveuglément l'exemple multilocataire : adaptez les types de comptes pris en charge et les paramètres du locataire à votre politique d'identité.
Microsoft exige que les URI de redirection soient enregistrées dans l'application. Une incohérence peut entraîner des erreurs AADSTS50011. Les recommandations actuelles de Microsoft sont disponibles dans la section « Bonnes pratiques et limitations relatives aux URI de redirection » .
Copiez l' ID de l'application (client) . Ouvrez ensuite « Certificats et secrets » , créez un nouveau secret client et copiez immédiatement sa valeur . Microsoft précise que cette valeur n'est plus affichée une fois la page fermée. La durée de vie des secrets clients est limitée à 24 mois et une période d'expiration plus courte est recommandée dans la documentation relative à l'enregistrement des applications.
Cette date d'expiration est une dépendance opérationnelle, et non un détail d'installation ponctuel. Intégrez-la au processus de renouvellement des identifiants de votre organisation. Sans cela, un déploiement Nextcloud Mail apparemment stable pourrait ultérieurement dysfonctionner, le renouvellement du jeton étant impossible.
Dans les paramètres d'administration de Nextcloud, ouvrez Groupware et la section d'intégration Microsoft. Saisissez l'ID client et le secret client. Le guide officiel de Nextcloud utilise la valeur du locataire commonpour la configuration Outlook hébergée standard et précise qu'un ID de locataire personnalisé n'est pas pris en charge, sauf si vous avez également modifié les types de comptes compatibles.
Concernant les autorisations de protocole sous-jacentes, Microsoft documente les étendues déléguées, notamment https://outlook.office.com/IMAP.AccessAsUser.Allpour IMAP et https://outlook.office.com/SMTP.SendSMTP, ainsi que offline_accessles cas où un jeton d'actualisation est requis. Nextcloud construit le flux du fournisseur ; vous devez néanmoins vérifier que les stratégies du locataire et les règles d'accès conditionnel autorisent l'accès délégué demandé.
Ajoutez votre adresse Outlook ou Microsoft 365 dans Nextcloud Mail et suivez la procédure de connexion/autorisation Microsoft. Le manuel d'administration de Nextcloud explique qu'une fois OAuth configuré, le mot de passe saisi lors de la création du compte est supprimé et l'utilisateur est invité à donner son consentement à Microsoft.
Là encore, le résultat de consentement visible n'est qu'un signal intermédiaire. Vérifiez que la liste des dossiers se charge, qu'un message de test peut être lu, qu'un message peut être envoyé et que le dossier « Éléments envoyés » contient bien la copie attendue.
| Signal | Ce que cela signifie | Que faire ensuite ? |
|---|---|---|
| L'autorisation est accordée et la boîte de réception se charge. | L'autorisation et l'IMAP fonctionnent probablement correctement. | Test du comportement d'envoi et d'actualisation SMTP |
| L'autorisation est accordée, mais les dossiers ne se chargent pas. | La redirection a peut-être été effectuée alors que la connexion de messagerie a échoué. | Vérifiez la politique du fournisseur, l'accès IMAP, les journaux Nextcloud et les paramètres du compte. |
| La réception fonctionne, mais l'envoi échoue. | IMAP fonctionne ; l’autorisation SMTP ou la politique du serveur peuvent ne pas fonctionner. | Vérifiez le service SMTP, l'autorisation déléguée et les restrictions du locataire/fournisseur |
| Cela fonctionne au début, mais demande ensuite une connexion à répétition. | L'utilisation du jeton d'actualisation, la validité du secret, l'état de l'application ou la politique du fournisseur peuvent être défaillants. | Vérifiez l'expiration du secret, l'état de publication/vérification de l'application OAuth, les erreurs de jeton et les modifications récentes de la politique. |
| Erreur de redirection | L'URL de rappel enregistrée ne correspond pas exactement à la requête. | Copiez à nouveau l'URI depuis Nextcloud et comparez-la caractère par caractère. |
Modifiez la configuration de l'application OAuth si l'URI de redirection, l'audience de compte prise en charge, les paramètres du locataire ou la configuration du consentement ne correspondent pas à votre déploiement. Les tentatives répétées ne corrigeront pas une incohérence structurelle.
Modifiez l'URL de déploiement/la configuration du proxy lorsque Nextcloud génère une adresse de rappel interne, HTTP ou publique incorrecte. Commencez par corriger l'URL externe canonique, puis recréez ou mettez à jour l'URI de redirection du fournisseur.
Utilisez une administration spécifique au fournisseur plutôt que des hypothèses OAuth génériques lorsque l'accès conditionnel, la politique de consentement de l'administrateur, la vérification de l'application Google ou les étendues restreintes empêchent les utilisateurs de s'authentifier. Ces contrôles sont appliqués intentionnellement par le fournisseur d'identité.
Envisagez une autre méthode d'authentification uniquement si votre fournisseur et votre politique de sécurité l'autorisent explicitement. Par exemple, l'interface de Nextcloud Mail indique qu'un mot de passe d'application Google peut servir d'alternative lorsque Google OAuth n'est pas configuré et que le compte Google utilise l'authentification à deux facteurs. Cette méthode n'est pas équivalente à OAuth2 et ne doit pas être considérée comme la solution de remplacement privilégiée à l'échelle de l'organisation simplement parce qu'elle est plus facile à configurer.
Il existe une mise en garde importante concernant le diagnostic dans l'historique du projet Nextcloud Mail. En juillet 2026, les responsables de la maintenance ont confirmé un rapport de bogue indiquant que des erreurs OAuth côté fournisseur pouvaient encore faire apparaître la même page de redirection « Compte connecté » comme une autorisation réussie. Le rapport concernait directement Microsoft et identifiait le même modèle de contrôleur pour Google. Un autre rapport, datant également de 2026, décrivait des difficultés à reconnecter un compte après que son jeton d'actualisation soit devenu inutilisable. Ces rapports concernaient le code de la version 5.10.7 de Mail ; il ne faut donc pas supposer que toutes les versions sont affectées de façon permanente, ni se fier à la page de redirection comme unique preuve de réussite.
Vous pouvez consulter les problèmes de gestion des erreurs de redirection OAuth et de reconnexion OAuth du projet . Si vous effectuez un dépannage sur une version actuelle, vérifiez d'abord la version de Mail installée et les dernières notes de version avant d'appliquer des solutions de contournement prévues pour une branche antérieure.
OAuth2 améliore le modèle d'authentification de Nextcloud Mail, mais ne dispense pas de la gestion des politiques des fournisseurs, des URI de redirection, des identifiants d'application et des accès aux protocoles de messagerie. Une configuration est prête pour la production lorsque l'ensemble du processus (autorisation du fournisseur, actualisation du jeton, récupération IMAP et envoi SMTP) fonctionne de manière prévisible, conformément aux politiques applicables à vos utilisateurs.
Comparez 10 outils de balayage ping pour une découverte rapide du réseau local, une analyse multiplateforme et la gestion des adresses IP. Découvrez ce qu'un balayage peut – et ne peut pas – vous révéler.
Comparez six outils de gestion de réseau pour la surveillance des performances, notamment la couverture SNMP, la cartographie, les alertes, les modèles de déploiement et les compromis en matière de coûts.
Comparez sept moniteurs de ping gratuits et open source, allant des suites réseau complètes aux sondes de latence ciblées, et choisissez celui qui convient le mieux à vos besoins en matière de disponibilité, de perte de paquets et d'historique.
Comparez les meilleurs analyseurs Wi-Fi pour Windows, iPhone et Android, incluant des outils pour la congestion des canaux, la couverture du signal, les cartes thermiques et le dépannage réseau.
Découvrez ce que signifie la QoS dans le domaine des réseaux, comment les marquages DSCP et les files d'attente de trafic priorisent la voix, la vidéo et les applications professionnelles, et ce que la QoS ne peut pas corriger.
Comparez les logiciels serveurs SFTP fiables pour Windows et Linux, notamment OpenSSH, Bitvise, SolarWinds et SFTPGo. Trouvez la solution idéale pour vos besoins en matière de sécurité et de transfert de fichiers.
Comparez sept outils de gestion d'adresses IP pour la découverte de sous-réseaux, la coordination DNS et DHCP, l'inventaire réseau et l'IPAM open source.
Mettez en place une surveillance réseau pratique avec une couverture claire des périphériques, des indicateurs de performance utiles, des alertes exploitables et une comparaison de SolarWinds NPM, PRTG et OpManager.
Comparez les outils d'analyse réseau pour la découverte rapide des périphériques, les analyses IP multiplateformes et la gestion des identités et des accès IP (IPAM) d'entreprise, avec des conseils pour adapter chaque option à votre réseau.
Utilisez l'option --traceroute de Nmap pour associer les sauts à un hôte autorisé, comprendre les résultats des sauts et du RTT, et résoudre les problèmes de réponses manquantes sans sur-analyse.
