SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-26

Outlook mit selbst gehostetem n8n verbinden

Registrieren Sie die Microsoft-Entra-App für selbst gehostetes n8n, korrigieren Sie die Redirect-URI und vermeiden Sie Ausfälle, wenn das Client-Secret abläuft.

So verbinden Sie Outlook mit selbst gehostetem n8n

Um Outlook mit selbst gehostetem n8n zu verbinden, registrieren Sie eine Anwendung in Microsoft Entra ID. Anschließend hinterlegen Sie für diese Anwendung die OAuth-Callback-URL, die Ihre n8n-Instanz ausgibt, und tragen die Client-ID sowie das Client-Secret der Anwendung in einer n8n-Anmeldeinformation ein. Nutzer von n8n Cloud überspringen diese Schritte, weil Cloud keine Verbindungsdaten von ihnen anfordert. Auf Ihrem eigenen Server gehört die Anwendungsregistrierung Ihnen. Daher verwalten Sie auch deren Einstellungen und das ablaufende Secret.

Zunächst einige Begriffe. OAuth (Open Authorization) ist der Anmeldevorgang, über den n8n auf Ihr Postfach zugreifen kann, ohne Ihr Passwort zu speichern. Microsoft Entra ID ist der Identitätsdienst von Microsoft und hieß früher Azure Active Directory. Microsoft Graph ist die API, die n8n zum Lesen und Senden von Outlook-E-Mails aufruft. Ein UPN (User Principal Name) ist der Anmeldename eines Microsoft-365-Kontos und sieht wie eine E-Mail-Adresse aus.

Die meisten Fehler entstehen durch zwei Einstellungen: die Redirect-URI und den Kontotyp. Ein dritter Fehler tritt Monate später auf, wenn das Client-Secret abläuft. Dieser Leitfaden behandelt alle drei Punkte und erstellt anschließend einen kleinen Workflow, der neue E-Mails beantwortet.

Was Sie vor dem Start benötigen

  • Eine selbst gehostete n8n-Instanz, die über HTTPS unter einer echten Domain erreichbar ist. n8n auf einem VPS mit Docker und HTTPS betreiben beschreibt diese Einrichtung ausführlich.
  • Ein Microsoft-Konto. Ein persönliches Outlook.com-Konto ist geeignet. Das gilt auch für ein Arbeits- oder Schulkonto in einem Microsoft 365-Tenant.
  • Für einen Arbeits-Tenant: die Berechtigung, der Anwendung selbst die erforderliche Zustimmung zu erteilen, oder einen Administrator, der diese Zustimmung für Sie erteilen kann.

Warum die Callback-URL von Ihrer öffentlichen URL abhängt

Die OAuth-Anmeldung endet damit, dass Microsoft Ihren Browser mit einem einmalig verwendbaren Code an n8n zurücksendet. Diese Rücksendeadresse ist die Callback-URL. n8n erstellt sie aus der eigenen öffentlichen URL, die n8n für gültig hält. Dazu werden drei Teile verbunden: die Basis-URL der Instanz, das Segment des REST-Endpunkts und /oauth2-credential/callback. Das REST-Segment stammt aus N8N_ENDPOINT_REST. Der Standardwert ist rest, daher lautet der Pfad bei einer Standardinstallation /rest/oauth2-credential/callback. Wenn Sie diese Variable ändern, ändert sich auch der Pfad. Die Basis-URL vor dem Pfad stammt aus Ihrer Konfiguration.

Wenn N8N_EDITOR_BASE_URL gesetzt ist, verwendet n8n diese Variable. Andernfalls greift n8n auf seine Webhook-URL zurück. Ist auch diese nicht gesetzt, erstellt n8n die Adresse aus N8N_PROTOCOL, N8N_HOST, N8N_PORT und N8N_PATH. Die Standardwerte dieser Variablen sind http, localhost, 5678 und /.

Diese letzte Rückfallebene verursacht häufig Probleme. Hinter einem Reverse Proxy kann n8n die Domain, unter der der Proxy antwortet, nicht erkennen. Eine Instanz ohne URL-Variablen gibt daher http://localhost:5678/rest/oauth2-credential/callback aus. Wenn Sie Ihre echte Domain in Entra registrieren, n8n aber localhost sendet, schlägt die Anmeldung mit diesem Fehler fehl:

AADSTS50011: The redirect URI 'http://localhost:5678/rest/oauth2-credential/callback' specified in the request does not match the redirect URIs configured for the application

Microsoft vergleicht die URI in der Anfrage Zeichen für Zeichen mit der registrierten Liste. Setzen Sie die öffentliche URL explizit in Ihrer Compose-Datei:

services:
  n8n:
    environment:
      - N8N_HOST=n8n.example.com
      - N8N_PROTOCOL=https
      - N8N_EDITOR_BASE_URL=https://n8n.example.com
      - N8N_WEBHOOK_URL=https://n8n.example.com/
      - N8N_PROXY_HOPS=1

Der Variablenname wurde kürzlich geändert. Ab n8n 2.35.0 lautet die Webhook-Variable N8N_WEBHOOK_URL. Der ältere Name WEBHOOK_URL funktioniert weiterhin als Alias, aber n8n protokolliert beim Start eine Deprecation-Warnung (Stand: October 2026). Verwenden Sie bei einer älteren Version WEBHOOK_URL. N8N_PROXY_HOPS=1 teilt n8n mit, dass es hinter einem Reverse Proxy ausgeführt wird. Dadurch vertraut n8n den Headern X-Forwarded-For, X-Forwarded-Host und X-Forwarded-Proto, die Ihr Proxy sendet.

docker compose up -d
docker compose exec n8n env | grep -E 'N8N_EDITOR_BASE_URL|WEBHOOK_URL'

up -d erstellt den Container neu, weil sich seine Umgebung geändert hat. Der zweite Befehl sollte beide Variablen mit Ihrer https-Domain ausgeben. Wenn Ihr Compose-Service einen anderen Namen hat, ersetzen Sie n8n im zweiten Befehl. n8n liest diese Werte nur beim Start ein. Änderungen an der Datei bleiben daher wirkungslos, bis der Container neu gestartet wird.

Führen Sie jetzt die entscheidende Prüfung durch. Erstellen Sie in n8n ein neues Credential und wählen Sie Microsoft Outlook OAuth2 API aus. Das Formular enthält ein Feld OAuth Redirect URL. Der Wert muss mit https:// und Ihrer Domain beginnen. Wenn weiterhin localhost angezeigt wird, korrigieren Sie zuerst die Variablen. Jeder spätere Schritt übernimmt diesen Wert.

Registrieren Sie die Anwendung in Microsoft Entra ID

Lassen Sie das n8n-Anmeldeformular für Anmeldedaten in einem Tab geöffnet. Führen Sie die folgenden Schritte in einem anderen Tab aus.

  1. Öffnen Sie das Portal für App-Registrierungen und melden Sie sich mit dem Microsoft-Konto an, dem die Anwendung gehören soll.
  2. Wählen Sie Neue Registrierung und geben Sie der Anwendung einen Namen, zum Beispiel n8n.
  3. Wählen Sie unter den unterstützten Kontotypen Konten in einem beliebigen Organisationsverzeichnis (beliebiges Azure AD-Verzeichnis – mandantenübergreifend) und persönliche Microsoft-Konten. Dies ist die Bezeichnung, die die n8n-Dokumentation verwendet. Neuere Portalversionen verwenden möglicherweise „Microsoft Entra ID-Mandant“ anstelle von „Azure AD-Verzeichnis“. Wählen Sie die Option, die beliebige Organisationen und persönliche Konten abdeckt.
  4. Wählen Sie unter Umleitungs-URI zunächst Plattform auswählen, dann Web, und fügen Sie die OAuth-Umleitungs-URL aus n8n ein.
  5. Wählen Sie Registrieren. Kopieren Sie anschließend die Anwendungs-ID (Client) von der Übersichtsseite in das Feld „Client-ID“ der n8n-Anmeldedaten.

Der Kontotyp ist relevant, weil sich die Microsoft-Anmeldedaten von n8n über den login.microsoftonline.com/common-Endpunkt anmelden. Microsoft erlaubt diesen Endpunkt nur für mandantenübergreifende Anwendungen. Wenn Sie eine Anwendung für einen einzelnen Mandanten registrieren, schlägt die Anmeldung mit folgendem Fehler fehl:

AADSTS50194: Application '<client id>'(n8n) is not configured as a multi-tenant application. Usage of the /common endpoint is not supported for such applications created after '10/15/2018'.

Auch die Plattform ist relevant. n8n tauscht den Code auf dem Server mithilfe des Clientschlüssels gegen Token ein. Dafür ist die Plattform Web vorgesehen. Wenn Sie die URI unter Einzelseitige Anwendung registrieren, schlägt der Austausch mit AADSTS9002327 fehl, weil Microsoft diesem Clienttyp nur erlaubt, Token aus JavaScript im Browser einzulösen.

Client Secret erstellen und Ablauf planen

  1. Öffnen Sie in Ihrer App-Registrierung im linken Menü Certificates & secrets.
  2. Wählen Sie unter Client secrets die Option New client secret.
  3. Fügen Sie eine Beschreibung hinzu, zum Beispiel n8n credential, und wählen Sie eine Ablaufdauer.
  4. Wählen Sie Add und kopieren Sie anschließend die Spalte Value in das Feld Client Secret der n8n-Anmeldedaten.

Kopieren Sie den Value, nicht die daneben angezeigte Secret ID. Das Portal zeigt den Wert nur einmal an. Sobald Sie die Seite verlassen, bleibt er dauerhaft verborgen, und Sie müssen ein neues Secret erstellen. Wenn Sie versehentlich die Secret ID einfügen, schlägt die Anmeldung mit AADSTS7000215: Invalid client secret provided fehl.

Prüfen Sie die Optionen für die Ablaufdauer sorgfältig. Das Portal bietet voreingestellte Laufzeiten und eine Option Custom. Microsoft begrenzt jedes Client Secret auf 24 Monate und empfiehlt eine Laufzeit von weniger als 12 Monaten. Kein Secret ist unbegrenzt gültig.

Der Grund für die Ablaufdauer ist wichtig. n8n speichert ein Refresh Token für Ihr Postfach. Sobald das kurzlebige Access Token abläuft, sendet n8n die Client ID, das Secret und das Refresh Token an Microsoft, um ein neues Token abzurufen. Nach Ablauf des Secrets schlägt diese Anfrage mit AADSTS7000222: The provided client secret keys for app '<client id>' are expired fehl. Ab diesem Zeitpunkt schlägt jeder Node fehl, der diese Anmeldedaten verwendet, einschließlich des Triggers bei jedem Polling. Vor diesem Tag erhalten Sie keine Warnung. Tragen Sie deshalb das Ablaufdatum beim Erstellen des Secrets in einen Kalender ein.

Rotieren Sie das Secret, bevor es abläuft:

  1. Fügen Sie ein neues Client Secret hinzu, solange das alte noch funktioniert. Eine App kann mehrere Secrets gleichzeitig enthalten.
  2. Fügen Sie den neuen Wert in das Feld Client Secret der Anmeldedaten ein und speichern Sie die Änderung.
  3. Führen Sie einen Outlook-Node manuell aus und prüfen Sie, ob er erfolgreich ist. Wenn n8n Sie auffordert, die Verbindung erneut herzustellen, tun Sie dies.
  4. Löschen Sie das alte Secret unter Certificates & secrets.

Anmeldedaten verbinden und angeforderte Berechtigungen prüfen

Klicken Sie bei den Anmeldedaten auf die Schaltfläche zum Verbinden. Ein Microsoft-Anmeldefenster wird geöffnet und listet die Berechtigungen auf, die n8n anfordert. Akzeptieren Sie die Berechtigungen. Das Fenster wird geschlossen, und die Anmeldedaten sind verbunden.

Die Microsoft Outlook-Anmeldedaten fordern die folgenden Scopes (Berechtigungen) an, wie in der n8n-Dokumentation und im Quellcode der Anmeldedaten aufgeführt:

openid offline_access Contacts.Read Contacts.ReadWrite Calendars.Read
Calendars.Read.Shared Calendars.ReadWrite Mail.ReadWrite Mail.ReadWrite.Shared
Mail.Send Mail.Send.Shared MailboxSettings.Read

offline_access ist der Scope, der n8n ein Refresh-Token bereitstellt. Dadurch bleibt die Verbindung länger als eine Stunde bestehen. Mit den .Shared-Scopes kann n8n auf Postfächer zugreifen, die Ihr Konto bereits öffnen kann. Diese Scopes gewähren allein keinen Zugriff. Für eine normale Anmeldung müssen Sie diese Berechtigungen in Entra nicht hinzufügen, weil die Anmeldedaten sie zum Zeitpunkt der Anmeldung anfordern. Lassen Sie die Option für benutzerdefinierte Scopes der Anmeldedaten deaktiviert und fordern Sie keine weiteren Berechtigungen an.

Wann ist für einen Work Tenant die Zustimmung eines Administrators erforderlich?

Die Dokumentation von n8n beschreibt die Voraussetzung: In einer Organisation, die Microsoft Entra verwendet, muss für den Benutzer die Einstellung aktiviert sein, mit der Benutzer der Anwendung den Zugriff auf Unternehmensdaten in ihrem Namen gestatten können. Ist dies nicht der Fall, muss ein Administrator die Zustimmung erteilen. Viele Tenants schränken die Zustimmung durch Benutzer ein. Sie erkennen dies daran, dass das Anmeldefenster anstelle der Berechtigungsliste Need admin approval anzeigt.

Die sauberste Lösung beschränkt die Berechtigungen genau auf die von n8n angeforderten. Ein Administrator öffnet die App-Registrierung, wechselt zu API permissions und fügt die delegierten Microsoft-Graph-Berechtigungen aus der obigen Liste hinzu. openid und offline_access befinden sich im Auswahlfeld unter OpenId permissions. Anschließend wählt der Administrator Grant admin consent for für den Tenant aus. Danach verbindet der Benutzer die Zugangsdaten wie gewohnt.

Bei persönlichen Outlook.com-Konten wird dieser Schritt nie angezeigt, weil kein Tenant-Administrator zwischen Ihnen und Ihrem eigenen Postfach steht.

So lesen Sie ein gemeinsames Postfach über UPN

Um ein gemeinsames Postfach wie support@example.com zu automatisieren, aktivieren Sie in den Zugangsdaten Use Shared Inbox und geben Sie die UPN oder ID des Zielpostfachs ein. Sie melden sich weiterhin mit Ihrem eigenen Konto an. n8n sendet seine Anfragen in Graph dann an /users/<UPN>/ statt an /me/.

Das hat zwei Folgen. Erstens muss Ihr eigenes Konto bereits Zugriff auf dieses Postfach haben. Ein Exchange-Administrator gewährt diesen Zugriff als Postfachberechtigung. Ohne diese Berechtigung antwortet Graph mit ErrorAccessDenied und der Meldung Access is denied. Check credentials and try again. Zweitens wird die UPN in den Zugangsdaten gespeichert. Eine Zugangskonfiguration liest daher jeweils ein Postfach. Erstellen Sie eine zweite Zugangskonfiguration für das gemeinsame Postfach und behalten Sie Ihre persönliche Konfiguration unverändert.

Workflow erstellen: Neue E-Mails automatisch beantworten

Dieser Workflow beantwortet jede neue Nachricht im Posteingang und markiert sie anschließend als gelesen. Verwenden Sie drei Nodes.

  1. Microsoft Outlook Trigger. Wählen Sie Ihre Anmeldedaten aus. Setzen Sie Trigger On auf Message Received und lassen Sie Output auf Simplified. Legen Sie unter Filters Folders to Include auf Inbox fest und lassen Sie Read Status auf ungelesenen Nachrichten, dem Standardwert. Setzen Sie während des Tests außerdem Sender auf eine Adresse, die Sie kontrollieren.
  2. Microsoft Outlook mit Resource Message und Operation Reply. Setzen Sie Message ID auf {{ $json.id }}. Schreiben Sie Ihren Text in Message. Aktivieren Sie Reply to Sender Only, da diese Option standardmäßig deaktiviert ist. Andernfalls wird an jeden Empfänger der ursprünglichen E-Mail geantwortet.
  3. Microsoft Outlook mit Resource Message und Operation Update. Setzen Sie Message ID auf {{ $('Microsoft Outlook Trigger').item.json.id }}. Fügen Sie unter Update Fields Is Read hinzu und aktivieren Sie es.

Der dritte Node verweist anhand des Namens auf den Trigger, weil $json nach dem Antwort-Node die Ausgabe der Antwort enthält und nicht mehr die ursprüngliche Nachricht. Wenn Sie den Trigger-Node umbenannt haben, verwenden Sie seinen Namen im Ausdruck.

Senden Sie zum Testen eine E-Mail von Ihrer Testadresse und verwenden Sie anschließend Fetch Test Event am Trigger. Im manuellen Modus ruft der Trigger die neueste passende Nachricht ab. Dadurch können Sie die Antwort Schritt für Schritt prüfen, ohne zu warten. Prüfen Sie den Eingang Ihres Testkontos auf die Antwort und bestätigen Sie in Outlook, dass die ursprüngliche Nachricht jetzt als gelesen angezeigt wird. Aktivieren Sie anschließend den Workflow, damit der Trigger nach seinem Zeitplan ausgeführt wird. Entfernen Sie den Filter Sender erst, wenn Sie sicher sind, dass der Antworttext korrekt ist. Eine automatische Antwort an einen anderen automatischen Antwortdienst, beispielsweise eine Abwesenheitsnachricht, kann eine E-Mail-Schleife erzeugen.

Wie prüft der Outlook-Trigger auf neue E-Mails?

Der Trigger führt Polling durch. Microsoft sendet ihm keine E-Mails. Die Einstellung Poll Times ist standardmäßig auf eine Abfrage pro Minute gesetzt. Bei jeder Abfrage fragt n8n Graph nach Nachrichten, deren receivedDateTime zum Zeitpunkt der letzten Prüfung oder danach liegt und vor dem aktuellen Zeitpunkt liegt. Anschließend speichert es den aktuellen Zeitpunkt als Beginn des nächsten Zeitfensters. Bei der ersten Aktivierung beginnt das Zeitfenster zum Aktivierungszeitpunkt. Bereits im Postfach vorhandene E-Mails lösen den Trigger daher nicht aus.

Ohne Folders to Include fragt der Trigger den /messages-Endpunkt von Graph ab, der alle Ordner einschließlich Sent Items umfasst. Deshalb beschränkt der obige Workflow den Trigger auf Inbox. Der Trigger führt außerdem keine Liste der Nachrichten-IDs, die er bereits verarbeitet hat. In den Hinweisen des n8n-eigenen Nodes steht, dass jede E-Mail genau einmal verarbeitet werden muss. Als Maßnahmen werden vorgeschlagen, die E-Mail als gelesen zu markieren, sie in einen Ordner zu verschieben oder ihre ID zu speichern. Der Update-Node setzt die erste dieser Maßnahmen um. Der Unread-Filter überspringt alles, was bereits verarbeitet wurde.

Wenn eine Abfrage pro Minute zu häufig ist, wählen Sie einen stündlichen oder täglichen Abfragezeitpunkt. Diese Zeitpläne verwenden die Zeitzone der Instanz. wie n8n Zeitzonen für Zeitpläne auflöst erklärt, welche Einstellung gilt, wenn Server und Workflow unterschiedliche Zeitzonen verwenden.

Fehlerbilder und die angezeigten Meldungen

  • AADSTS50011, Abweichung bei der Redirect-URI: Die OAuth Redirect URL in n8n und die Web URI in Entra unterscheiden sich. Korrigieren Sie die URL-Variablen, starten Sie den Dienst neu und kopieren Sie die URL erneut.
  • AADSTS50194: Die App ist auf einen einzelnen Mandanten beschränkt. Ändern Sie unter Authentication die unterstützten Kontotypen oder registrieren Sie eine neue App.
  • AADSTS7000215: Die Secret ID wurde anstelle des Secret Value eingefügt.
  • AADSTS7000222: Das Secret ist abgelaufen. Erstellen Sie ein neues Secret und fügen Sie dessen Wert ein.
  • Administratorgenehmigung erforderlich: Der Mandant blockiert die Zustimmung von Benutzern. Ein Administrator muss sie erteilen.
  • ErrorAccessDenied bei einem gemeinsam verwendeten Posteingang: Ihr Konto hat keinen Zugriff auf dieses Postfach in Exchange.

Dasselbe OAuth-Muster gilt für Google. Gmail mit selbst gehostetem n8n verbinden verwendet anstelle der Entra-App einen Google Cloud OAuth-Client mit derselben Callback-URL aus denselben Variablen. Für diese Anleitung ist kein kostenpflichtiger Tarif erforderlich. Die Unterschiede zwischen n8n Community und Enterprise betreffen Teamfunktionen, nicht die verfügbaren Nodes.

FAQ

Welche Redirect URI muss ich in Microsoft Entra für selbst gehostetes n8n registrieren?

Registrieren Sie unter der Plattform Web exakt die OAuth-Redirect-URL, die das n8n-Anmeldeformular für Zugangsdaten anzeigt. Bei einer Standardinstallation endet sie mit /rest/oauth2-credential/callback. Wenn Sie N8N_ENDPOINT_REST geändert haben, ersetzt Ihr Wert den Abschnitt rest. Wenn die URL mit http://localhost:5678 beginnt, kennt n8n seine öffentliche Adresse nicht. Setzen Sie N8N_EDITOR_BASE_URL und die Variable für die Webhook-URL auf Ihre HTTPS-Domain, starten Sie den Container neu und kopieren Sie die URL erneut.

Warum funktionieren meine n8n-Outlook-Zugangsdaten nach einigen Monaten nicht mehr?

Die wahrscheinlichste Ursache ist ein abgelaufenes Client Secret. Microsoft begrenzt Client Secrets auf 24 Monate. Nach Ablauf kann n8n das Zugriffstoken nicht mehr erneuern. Die Fehlermeldung lautet AADSTS7000222: The provided client secret keys for app ... are expired. Erstellen Sie unter Certificates & secrets ein neues Secret, fügen Sie dessen Wert in die Zugangsdaten ein und löschen Sie das alte Secret.

Kann n8n ein freigegebenes Postfach in Microsoft 365 lesen?

Ja. Aktivieren Sie in den Microsoft-Outlook-Zugangsdaten Use Shared Inbox und geben Sie den UPN des freigegebenen Postfachs ein. Sie melden sich mit Ihrem eigenen Konto an. Ihr Konto muss daher bereits Zugriff auf das Postfach in Exchange haben. Andernfalls gibt Graph ErrorAccessDenied zurück. Verwenden Sie für jedes Postfach eigene Zugangsdaten, weil der UPN in den Zugangsdaten gespeichert wird.

Wie oft prüft der n8n-Outlook-Trigger auf neue E-Mails?

Er fragt nach dem unter Poll Times festgelegten Zeitplan ab. Standardmäßig erfolgt die Abfrage jede Minute. Jede Abfrage fordert von Microsoft Graph die Nachrichten an, die seit der vorherigen Prüfung eingegangen sind. E-Mails, die vor der Aktivierung des Workflows eingegangen sind, lösen den Trigger nicht aus. Der Trigger verfolgt nicht, welche Nachrichten er bereits verarbeitet hat. Markieren Sie daher jede Nachricht nach der Verarbeitung als gelesen oder verschieben Sie sie.

War dieser Artikel hilfreich?

#n8n#outlook#microsoft-365#oauth#self-hosting