Verbind Gmail of Microsoft 365 met Nextcloud Mail via OAuth2.

Om Gmail of Microsoft 365 met Nextcloud Mail te verbinden via OAuth2, registreert u een webapplicatie bij de e-mailprovider, kopieert u de redirect-URI van Nextcloud Mail naar die registratie en slaat u de client-ID en het clientgeheim op in de Groupware-beheerinstellingen van Nextcloud. Verbind vervolgens de mailbox in Mail en keur de aanmeldingsprompt van de provider goed. Een werkende configuratie moet inkomende berichten laden en een testbericht verzenden – niet alleen een scherm met een succesvolle autorisatie weergeven.

Controleer of uw account en Nextcloud-installatie aan deze methode voldoen.

Nextcloud Mail gebruikt IMAP om berichten te lezen en SMTP om ze te verzenden. OAuth2 verkrijgt toestemming van de identiteitsprovider; XOAUTH2 is het mechanisme dat de e-mailclient gebruikt om een ​​toegangstoken aan deze e-mailservices te presenteren. Het maakt van de Nextcloud-login geen universele single sign-on voor elke mailserver.

De huidige beheerdocumentatie van Nextcloud beschrijft specifieke integraties met Gmail OAuth en Microsoft Outlook XOAUTH2. Microsoft-ondersteuning werd toegevoegd in Mail 3.0.0; de menu-aanduidingen kunnen variëren afhankelijk van de Mail- en Nextcloud-releases. Deze handleiding is gebaseerd op de Nextcloud 35 Mail-beheerhandleiding , zoals deze in oktober 2026 is geraadpleegd.

• Gebruik een HTTPS Nextcloud-URL die betrouwbaar opent vanuit een browser, met de Mail-app geïnstalleerd en ingeschakeld.
• U moet beheerdersrechten hebben voor Nextcloud en de juiste machtigingen om een ​​OAuth-applicatie te registreren in Google Cloud of Microsoft Entra.
• Weet of het account een Gmail/Google Workspace-, Outlook.com- of een Microsoft 365-mailbox is die wordt gehost in Exchange Online.
• Controleer of de provider IMAP-toegang en, voor het verzenden van berichten, geauthenticeerde SMTP toestaat volgens het beleid van de organisatie.

Belangrijke beperking: een aangepaste IMAP-provider die OAuth2 accepteert, wordt niet automatisch ondersteund door de Gmail/Microsoft-configuratieschermen van Nextcloud Mail. Het Nextcloud Mail-functieverzoek voor generieke OAuth2-providers beschrijft dit onderscheid. Controleer voor een andere provider uw specifieke Mail-versie en de ondersteunde authenticatiemethoden in plaats van irrelevante Google- of Microsoft-gegevens in te voeren.

Registreer een OAuth-client met de juiste omleidings-URI.

Gmail of Google Workspace

1. Meld je in Nextcloud aan als beheerder, open Beheerinstellingen → Groepsware en zoek de Gmail-integratie . Kopieer de omleidings-URI die door jouw instantie wordt weergegeven. Ga er niet vanuit dat een URL die je van een andere installatie kopieert, correct is.
2. Open de Google Cloud Console en selecteer of maak een project aan. Configureer de toestemmings-/merkinstellingen en doelgroepinstellingen van het Google Auth-platform naar wens voor uw Workspace-organisatie of externe gebruikers; voeg testgebruikers toe als de applicatie zich nog in de testfase bevindt.
3. Maak een OAuth-client van het type webapplicatie aan . Voer de exacte URL van Nextcloud in bij 'Geautoriseerde omleidings-URI's' en bewaar de client-ID en het clientgeheim veilig. Google vereist een letterlijke overeenkomst met de omleidings-URI, inclusief schema, pad, hoofdlettergebruik en afsluitende schuine streep.
4. Bekijk de autorisatiebereiken en publicatievereisten. Gmail IMAP- en SMTP OAuth-toegang maakt gebruik van https://mail.google.com/een breed, beperkt bereik dat onderworpen is aan het beleid van Google inzake gebruikersgegevens en verificatie. De beheerder moet bepalen of het voorgestelde gebruik aan deze vereisten voldoet.

Google beschrijft de registratiestroom van de webserver in de instructies voor OAuth2-webapplicaties en de specifieke Gmail XOAUTH2-scope en het protocol . Een testconfiguratie is handig voor de eerste validatie, maar een externe OAuth-applicatie die in de testmodus blijft staan, ontvangt doorgaans vernieuwingstokens die na zeven dagen verlopen bij het aanvragen van toegang tot Gmail-mail. Zie de richtlijnen van Google met betrekking tot het verlopen van tokens . Herhaalde wekelijkse herautorisatie kan daarom wijzen op een beperking van de publicatiestatus in plaats van een defect IMAP-wachtwoord.

Microsoft 365 of Outlook.com

1. Ga in de beheerdersinstellingen van Nextcloud naar Groupware , zoek de Microsoft-integratie en kopieer de weergegeven omleidings-URI.
2. Ga in het Microsoft Entra-beheercentrum naar App-registraties en maak een registratie aan. Kies voor de accounttypen die in de standaardhandleiding van Nextcloud worden beschreven, zowel voor Microsoft-organisatieaccounts als voor persoonlijke Microsoft-accounts; gebruik een webomleidingsplatform en voer de URI van Nextcloud exact in.
3. Kopieer de applicatie-ID (client-ID) . Maak onder Certificaten en geheimen een clientgeheim aan en kopieer direct de waarde ervan , niet de geheime identificatiecode. Noteer de vervaldatum in uw operationele kalender.
4. Gebruik de gedelegeerde machtigingen voor e-mail die vereist zijn voor de IMAP- en SMTP OAuth-flow van de provider, met toestemming van de organisatie waar nodig. Microsoft documenteert de IMAP.AccessAsUser.Allscopes SMTP.Senden offline_accessvoor vernieuwingstokens. Verwar deze protocolmachtigingen niet met de Microsoft Graph Mail.Read/Mail.Send-machtigingen.

Raadpleeg voor registratiegegevens de documentatie van Microsoft over app-registratie en de IMAP/SMTP OAuth-instructies van Exchange Online . De algemene installatie-instructies van Nextcloud laten het veld 'tenant' op leeg common. Een tenantspecifieke waarde of een beperkter ondersteund publiek mag alleen worden gebruikt als de beheerder de bijbehorende wijzigingen in het accounttype en het beleid heeft geverifieerd.

Sla de inloggegevens op in Nextcloud en verbind de mailbox.

1. Ga terug naar Beheerinstellingen → Groupware . Plak de client-ID en het clientgeheim van de provider in het betreffende gedeelte voor Gmail-integratie of Microsoft-integratie en sla op. Voer het geheim nooit in het veld voor de omleidings-URI in en publiceer het nooit in schermafbeeldingen, tickets of versiebeheer.
2. Meld u aan als de beoogde mailboxgebruiker, open Mail en kies ervoor om een ​​e-mailaccount toe te voegen. Voer het e-mailadres in, selecteer eerst de automatische accountconfiguratie en start de verbinding. De gedocumenteerde Microsoft-workflow van Nextcloud kan nog steeds een wachtwoordveld weergeven; de ingevoerde placeholder wordt verwijderd wanneer provider OAuth is geconfigureerd. Vervang het wachtwoord niet onnodig door een echt accountwachtwoord.
3. Selecteer in het pop-upvenster van de provider de juiste Google- of Microsoft-identiteit, controleer de gevraagde toegang en geef toestemming indien goedgekeurd door uw organisatie. Sta pop-ups in de browser toe en keer terug naar het oorspronkelijke Nextcloud-tabblad nadat de provider u heeft teruggestuurd.
4. Als de automatische configuratie de verkeerde server selecteert, controleer dan de handmatig ingestelde IMAP- en SMTP-hostnamen en versleutelingsopties voor die specifieke provider. De OAuth-knop is gekoppeld aan herkende Gmail/Microsoft-eindpunten; handmatig ingevoerde, niet-gerelateerde hostnamen activeren mogelijk niet het verwachte aanmeldproces.

In het Nextcloud Mail-accountformulier kan een herkend Google-eindpunt met geconfigureerde OAuth ' Aanmelden met Google' weergeven , terwijl het Microsoft-equivalent ' Aanmelden met Microsoft' kan weergeven . De broncode van het live Nextcloud Mail-accountformulier documenteert deze voorwaardelijke labels. De aanwezigheid van de providerspecifieke knop is een nuttige eerste indicatie dat Nextcloud de beoogde integratie heeft herkend, maar het bewijst niet dat de autorisatie of toegang tot de mailbox is voltooid.

Los storingen op in het stadium waarin ze zich voordoen.

Microsoft legt de SMTP-authenticatiecontrole uit, inclusief de mogelijkheid om dit per mailbox uit te stellen, in de documentatie over SMTP-authenticatie voor Exchange Online . Vermijd het wereldwijd verzwakken van de e-mailbeveiliging alleen om één mailbox werkend te krijgen; als het beleid het protocol verbiedt, gebruik dan een goedgekeurde e-mailclient of een door de organisatie ondersteunde workflow.

Controleer de poststroom in beide richtingen.

1. Open de inbox in Nextcloud Mail, vernieuw de pagina en controleer of een recent ontvangen bericht wordt weergegeven met de verwachte afzender, onderwerp en inhoud.
2. Stuur een korte testmail naar een andere mailbox die u beheert. Controleer of de e-mail daar is bezorgd en controleer vervolgens de map 'Verzonden' in Nextcloud Mail. Dit scheidt problemen met SMTP-machtigingen van problemen met IMAP-synchronisatie.
3. Meld u af en weer aan, en open Mail vervolgens opnieuw. Controleer bij operationele implementaties opnieuw nadat het toegangstoken normaal gesproken vernieuwd zou zijn; direct succes is geen garantie voor een langdurige verlenging van het token.

Als de inbox nog steeds niet synchroniseert, beschrijft Nextcloud occ mail:account:exporthoe u de ID van het e-mailaccount kunt vinden en occ mail:account:sync -vvv ACCOUNT_IDhoe u gericht problemen kunt oplossen. De handleiding voor het oplossen van problemen met Groupware legt ook de IMAP/SMTP-debuglogs per account uit en waarschuwt dat logs gevoelige informatie kunnen bevatten. Leg alleen vast wat nodig is, anonimiseer tokens en adressen voordat u ze deelt en schakel de uitgebreide debuglogs daarna uit.

De configuratie is klaar voor gebruik wanneer de provider toestemming heeft gegeven, Mail actuele berichten kan ophalen, uitgaande e-mail de bestemming bereikt en de verbinding bruikbaar blijft zonder herhaalde autorisatieverzoeken. Als een van deze controles mislukt, los dan het probleem in die specifieke fase op in plaats van de hele OAuth-applicatie direct opnieuw te maken.