Credentials in n8n verbinden: Google, Slack, OAuth

Was Credentials sind

In n8n ist ein Credential ein gespeicherter, verschlüsselter Login für eine App. Sie legen ihn einmal an und verwenden ihn in jedem Workflow wieder. Credentials werden mit dem Verschlüsselungsschlüssel Ihrer Instanz verschlüsselt gespeichert und können in bezahlten Tarifen mit Teammitgliedern geteilt werden, ohne das Geheimnis preiszugeben.

Es gibt drei gängige Typen:

• API-Schlüssel / Token: einen Schlüssel aus den Einstellungen der App einfügen (OpenAI, Personal Access Token von Airtable, Secret Key von Stripe).
• OAuth2: Sie klicken auf „Anmelden mit …“ und erlauben den Zugriff (Google, Slack, Microsoft, HubSpot).
• Basic Auth / Header Auth: für Webhooks und einfache APIs.

Bevor Sie beginnen: die OAuth-Redirect-URL

Jedes OAuth2-Credential in n8n zeigt eine OAuth Redirect URL an, etwa https://n8n.yourcompany.com/rest/oauth2-credential/callback. Diese fügen Sie in der Entwicklerkonsole der App ein. Sie muss exakt übereinstimmen, einschließlich https.

In n8n Cloud bieten viele Apps (Google, Slack, Microsoft) eine Sign in-Schaltfläche mit einem Klick, ganz ohne Entwickler-Einrichtung. Bei selbst gehostetem n8n legen Sie meist zuerst eine eigene OAuth-App an.

Google (Sheets, Gmail, Drive, Calendar)

Bei selbst gehostetem n8n:

1. Öffnen Sie die Google Cloud Console und legen Sie ein Projekt an.
2. Gehen Sie zu APIs & Services → Library und aktivieren Sie die benötigten APIs, etwa Google Sheets API, Gmail API und Google Drive API.
3. Konfigurieren Sie den OAuth consent screen. Wählen Sie Internal, wenn Sie Google Workspace nutzen und sich nur Ihre Organisation verbindet; andernfalls External, und fügen Sie sich selbst als Testnutzer hinzu.
4. Gehen Sie zu Credentials → Create credentials → OAuth client ID, Typ Web application.
5. Fügen Sie die OAuth-Redirect-URL von n8n unter Authorized redirect URIs ein.
6. Kopieren Sie Client ID und Client Secret in das n8n-Credential (Google OAuth2 API oder das app-spezifische) und klicken Sie auf Sign in with Google.

Tipp: Eine External-App im Status „Testing“ stellt Tokens aus, die nach 7 Tagen ablaufen. Veröffentlichen Sie die App (oder nutzen Sie Internal) für dauerhaft laufende Workflows.

Slack

1. Gehen Sie auf api.slack.com/apps und klicken Sie auf Create New App → From scratch.
2. Fügen Sie unter OAuth & Permissions die Redirect-URL aus n8n hinzu.
3. Ergänzen Sie die benötigten Scopes. Zum Posten von Nachrichten: chat:write; zum Lesen von Kanälen: channels:read, channels:history.
4. Kopieren Sie Client ID und Client Secret in das Slack-OAuth2-Credential von n8n und verbinden Sie es.
5. Laden Sie die App in jeden Kanal ein, in dem sie posten soll (/invite @YourApp).

Für einen einzelnen Workspace ist ein Bot-Token (beginnt mit xoxb-) mit dem Slack-API-Credential einfacher als OAuth.

Microsoft (Outlook, Teams, OneDrive)

1. Öffnen Sie im Azure-Portal App registrations → New registration.
2. Fügen Sie die Redirect-URL von n8n als Web-Redirect-URI hinzu.
3. Erstellen Sie unter Certificates & secrets ein Client Secret.
4. Fügen Sie unter API permissions delegierte Microsoft-Graph-Berechtigungen hinzu, etwa Mail.ReadWrite, Mail.Send und offline_access.
5. Fügen Sie die Application (client) ID und das Secret in das Microsoft-OAuth2-Credential von n8n ein.

Generisches OAuth2 für jede App

Wenn n8n kein eigenes Credential für eine App hat, nutzen Sie OAuth2 API mit dem HTTP-Request-Node. Sie brauchen Authorization-URL, Access-Token-URL, Client ID, Client Secret und Scopes aus der Entwicklerdokumentation der App.

Sicherheits-Checkliste

• Geben Sie jedem Credential nur die minimal nötigen Scopes.
• Nutzen Sie für geschäftskritische Workflows ein eigenes Dienstkonto oder einen Bot-Benutzer, nicht das Konto einer Person.
• Bewahren Sie N8N_ENCRYPTION_KEY sicher auf; geht er verloren, müssen Sie jedes Credential neu anlegen.
• Erneuern Sie Secrets, wenn jemand das Team verlässt.

Warum das für die Migration wichtig ist

Beim Wechsel von Zapier oder Make lassen sich Workflows aus Exporten nachbauen, Credentials aber nicht übertragen. Das Neuanlegen ist meist der langsamste Teil einer Migration, also richten Sie sie zuerst ein. Siehe den Leitfaden zur Migration von Zapier zu n8n.