Verbinden Sie Gmail oder Microsoft 365 mit Nextcloud Mail mithilfe von OAuth2

Um Gmail oder Microsoft 365 mit Nextcloud Mail über OAuth2 zu verbinden, registrieren Sie eine Webanwendung beim E-Mail-Anbieter, kopieren Sie die Umleitungs-URI von Nextcloud Mail in diese Registrierung und speichern Sie Client-ID und -Geheimnis in den Groupware-Verwaltungseinstellungen von Nextcloud. Verbinden Sie anschließend das Postfach in der Mail-App und bestätigen Sie die Anmeldeaufforderung des Anbieters. Eine funktionierende Einrichtung muss eingehende Nachrichten empfangen und eine Testnachricht senden können – es reicht nicht aus, lediglich eine Bestätigungsseite anzuzeigen.

Prüfen Sie, ob Ihr Konto und Ihre Nextcloud-Installation mit dieser Methode kompatibel sind.

Nextcloud Mail verwendet IMAP zum Lesen und SMTP zum Senden von Nachrichten. OAuth2 holt die Berechtigung vom Identitätsanbieter ein; XOAuth2 ist der Mechanismus, mit dem der Mailclient ein Zugriffstoken für diese Maildienste bereitstellt. Dadurch wird die Nextcloud-Anmeldung nicht zu einem universellen Single Sign-On für jeden Mailserver.

Die aktuelle Administrationsdokumentation von Nextcloud beschreibt die Integration von Gmail OAuth und Microsoft Outlook XOAUTH2. Die Microsoft-Unterstützung wurde in Mail 3.0.0 hinzugefügt; die Menübezeichnungen können je nach Mail- und Nextcloud-Version variieren. Diese Anleitung basiert auf dem Nextcloud-Administrationshandbuch für Mail 35 (Stand: Oktober 2026).

• Verwenden Sie eine HTTPS-Nextcloud-URL, die sich zuverlässig in einem Browser öffnen lässt, wobei die Mail-App installiert und aktiviert sein muss.
• Sie benötigen Administratorrechte für Nextcloud und die Berechtigung, eine OAuth-Anwendung in Google Cloud oder Microsoft Entra zu registrieren.
• Prüfen Sie, ob es sich um ein Gmail-/Google Workspace-Konto, ein Outlook.com-Konto oder ein Microsoft 365-Postfach handelt, das in Exchange Online gehostet wird.
• Vergewissern Sie sich, dass der Provider den IMAP-Zugriff und, zum Senden von Nachrichten, die authentifizierte SMTP-Authentifizierung gemäß den Richtlinien der Organisation zulässt.

Wichtiger Hinweis: Benutzerdefinierte IMAP-Anbieter, die OAuth2 akzeptieren, werden von den Gmail-/Microsoft-Konfigurationsbildschirmen von Nextcloud Mail nicht automatisch unterstützt. Dieser Unterschied wird im Nextcloud Mail-Funktionswunsch für generische OAuth2-Anbieter erläutert. Prüfen Sie bei anderen Anbietern Ihre genaue Mail-Version und die unterstützten Authentifizierungsmethoden, anstatt fremde Google- oder Microsoft-Anmeldedaten einzugeben.

Registrieren Sie einen OAuth-Client mit der richtigen Umleitungs-URI.

Gmail oder Google Workspace

1. Melden Sie sich in Nextcloud als Administrator an, öffnen Sie die Administrationseinstellungen → Groupware und suchen Sie die Gmail-Integration . Kopieren Sie die von Ihrer Instanz angezeigte Umleitungs-URI. Gehen Sie nicht davon aus, dass eine URL, die Sie von einer anderen Installation kopiert haben, korrekt ist.
2. Öffnen Sie die Google Cloud Console und wählen Sie ein Projekt aus oder erstellen Sie ein neues. Konfigurieren Sie die Einstellungen für Zustimmung/Branding und Zielgruppe der Google Auth Platform entsprechend Ihrer Workspace-Organisation oder externen Nutzern. Fügen Sie Testnutzer hinzu, falls sich die Anwendung noch im Testmodus befindet.
3. Erstellen Sie einen OAuth-Client vom Typ Webanwendung . Tragen Sie die exakte URL von Nextcloud in die Liste der autorisierten Umleitungs-URIs ein und speichern Sie anschließend Client-ID und Client-Geheimnis sicher. Google erfordert eine wortgetreue Übereinstimmung der Umleitungs-URI, einschließlich Schema, Pfad, Groß- und Kleinschreibung sowie abschließendem Schrägstrich.
4. Überprüfen Sie die Autorisierungsbereiche und Veröffentlichungsanforderungen. Der Gmail-IMAP- und SMTP-OAuth-Zugriff verwendet https://mail.google.com/einen weit gefassten, aber eingeschränkten Bereich, der den Richtlinien von Google zu Nutzerdaten und Verifizierung unterliegt. Der Administrator muss feststellen, ob die geplante Nutzung diese Anforderungen erfüllt.

Google dokumentiert den Registrierungsablauf des Webservers in seinen Anweisungen zur OAuth2-Webanwendung sowie im spezifischen Gmail XOAUTH2-Bereich und -Protokoll . Eine Testkonfiguration ist für die erste Validierung hilfreich. Eine externe OAuth-Anwendung im Testmodus erhält jedoch in der Regel Aktualisierungstoken, die nach sieben Tagen ablaufen, wenn sie auf Gmail-E-Mails zugreift. Weitere Informationen finden Sie in Googles Hinweisen zum Token-Ablauf . Eine wiederholte wöchentliche Reautorisierung kann daher eher auf eine Einschränkung des Veröffentlichungsstatus als auf ein fehlerhaftes IMAP-Passwort hindeuten.

Microsoft 365 oder Outlook.com

1. In den Administrationseinstellungen von Nextcloud unter „Groupware“ finden Sie die Option „Microsoft-Integration “. Kopieren Sie dort die angezeigte Umleitungs-URI.
2. Im Microsoft Entra Admin Center gehen Sie zu „App-Registrierungen“ und erstellen eine Registrierung. Wählen Sie für die im Nextcloud-Standardhandbuch beschriebenen Kontotypen sowohl organisatorische als auch persönliche Microsoft-Konten aus. Verwenden Sie eine Web- Umleitungsplattform und geben Sie die Nextcloud-URI exakt ein.
3. Kopieren Sie die Anwendungs-ID (Client-ID) . Erstellen Sie unter „Zertifikate & Geheimnisse“ ein Client-Geheimnis und kopieren Sie dessen Wert , nicht die geheime Kennung. Tragen Sie das Ablaufdatum in Ihren Betriebskalender ein.
4. Nutzen Sie die für den IMAP- und SMTP-OAuth-Ablauf des Anbieters erforderlichen delegierten Berechtigungen für E-Mails, gegebenenfalls mit Zustimmung der Organisation. Microsoft dokumentiert die IMAP.AccessAsUser.Allentsprechenden SMTP.SendBereiche sowie offline_accessdie Berechtigungen für Aktualisierungstoken. Verwechseln Sie diese Protokollberechtigungen nicht mit den Berechtigungen „Mail.Read“/„Mail.Send“ von Microsoft Graph.

Einzelheiten zur Registrierung finden Sie in der Dokumentation zur App-Registrierung von Microsoft und in den Anweisungen zu IMAP/SMTP OAuth von Exchange Online . Die dokumentierte allgemeine Einrichtung von Nextcloud belässt das Mandantenfeld auf „nicht vorhanden“ common. Ein mandantenspezifischer Wert oder eine engere Zielgruppe sollte nur dann verwendet werden, wenn der Administrator die zugehörigen Kontotypen und Richtlinienänderungen überprüft hat.

Speichern Sie die Zugangsdaten in Nextcloud und verbinden Sie das Postfach.

1. Gehen Sie zurück zu Administrationseinstellungen → Groupware . Fügen Sie die Client-ID und das Client-Geheimnis des Anbieters in den entsprechenden Abschnitt für die Gmail- oder Microsoft-Integration ein und speichern Sie die Einstellungen. Geben Sie das Geheimnis niemals im Feld „Umleitungs-URI“ an und veröffentlichen Sie es nicht in Screenshots, Tickets oder der Versionskontrolle.
2. Melden Sie sich als der gewünschte Postfachbenutzer an, öffnen Sie Mail und wählen Sie „E-Mail-Konto hinzufügen“. Geben Sie die E-Mail-Adresse ein, wählen Sie zunächst die automatische Kontokonfiguration und stellen Sie die Verbindung her. Der dokumentierte Microsoft-Ablauf von Nextcloud zeigt möglicherweise noch ein Passwortfeld an; der eingegebene Platzhalter wird bei der Konfiguration von Provider OAuth verworfen. Ersetzen Sie das Passwort nicht unnötig durch Ihr echtes Kontopasswort.
3. Wählen Sie im Pop-up-Fenster des Anbieters die korrekte Google- oder Microsoft-Identität aus, überprüfen Sie die angeforderten Zugriffsrechte und erteilen Sie die Zustimmung, sofern diese von Ihrer Organisation genehmigt wurde. Erlauben Sie Browser-Pop-ups und kehren Sie nach der Weiterleitung durch den Anbieter zum ursprünglichen Nextcloud-Tab zurück.
4. Falls die automatische Konfiguration den falschen Server auswählt, überprüfen Sie die manuell eingegebenen IMAP- und SMTP-Hostnamen sowie die Verschlüsselungsoptionen des jeweiligen Anbieters. Die OAuth-Schaltfläche ist mit bekannten Gmail-/Microsoft-Endpunkten verknüpft; manuell eingegebene, nicht zugehörige Hostnamen aktivieren möglicherweise nicht den erwarteten Anmeldevorgang.

Im Nextcloud-Mail-Kontoformular kann bei einem erkannten Google-Endpunkt mit konfigurierter OAuth-Authentifizierung die Option „ Mit Google anmelden“ angezeigt werden , beim entsprechenden Microsoft-Endpunkt die Option „Mit Microsoft anmelden“ . Der Quellcode des Nextcloud-Mail-Kontoformulars dokumentiert diese bedingten Bezeichnungen. Das Vorhandensein der anbieterspezifischen Schaltfläche ist ein nützliches frühes Anzeichen dafür, dass Nextcloud die beabsichtigte Integration erkannt hat, beweist aber nicht, dass die Autorisierung oder der Postfachzugriff abgeschlossen ist.

Beheben Sie Fehler auf der Ebene, auf der sie auftreten.

Microsoft erläutert die SMTP-Authentifizierung, einschließlich der Möglichkeit, diese pro Postfach anzupassen, in der Dokumentation zur Exchange Online SMTP-Authentifizierung . Vermeiden Sie es, die E-Mail-Sicherheit global zu schwächen, nur um ein einzelnes Postfach funktionsfähig zu machen. Wenn die Richtlinien das Protokoll untersagen, verwenden Sie stattdessen einen zugelassenen E-Mail-Client oder einen von Ihrer Organisation unterstützten Workflow.

Überprüfen Sie beide Richtungen des Postflusses.

1. Öffnen Sie den Posteingang in Nextcloud Mail, aktualisieren Sie die Ansicht und vergewissern Sie sich, dass eine kürzlich empfangene Nachricht mit dem erwarteten Absender, Betreff und Inhalt angezeigt wird.
2. Senden Sie eine kurze Test-E-Mail an ein anderes Postfach, über das Sie Zugriff haben. Überprüfen Sie dort die Zustellung und anschließend den Ordner „Gesendet“ in Nextcloud Mail. Dadurch lassen sich SMTP-Berechtigungsprobleme von IMAP-Synchronisierungsproblemen unterscheiden.
3. Melden Sie sich ab und wieder an und öffnen Sie anschließend Mail erneut. Bei produktiven Installationen überprüfen Sie die Funktion erneut, nachdem das Zugriffstoken normalerweise aktualisiert worden wäre; ein sofortiger Erfolg ist kein Garant für eine langfristige Token-Erneuerung.

Falls die Posteingangssynchronisierung weiterhin fehlschlägt, occ mail:account:exportdokumentiert Nextcloud die E-Mail-Konto-ID und occ mail:account:sync -vvv ACCOUNT_IDermöglicht eine gezielte Fehlerbehebung. Das zugehörige Handbuch zur Fehlerbehebung für Groupware erläutert außerdem die IMAP/SMTP-Debug-Protokollierung pro Konto und weist darauf hin, dass die Protokolle sensible Informationen enthalten können. Erfassen Sie daher nur die benötigten Daten, schwärzen Sie Tokens und Adressen vor der Weitergabe und deaktivieren Sie die ausführliche Debug-Protokollierung anschließend.

Die Einrichtung ist einsatzbereit, sobald die Zustimmung des Anbieters vorliegt, Mail aktuelle Nachrichten abrufen kann, ausgehende E-Mails ihr Ziel erreichen und die Verbindung ohne wiederholte Autorisierungsabfragen nutzbar bleibt. Sollte eine dieser Prüfungen fehlschlagen, beheben Sie das Problem in der betreffenden Phase, anstatt die gesamte OAuth-Anwendung sofort neu zu erstellen.