Connecter des credentials dans n8n : Google, Slack, OAuth

Ce que sont les credentials

Dans n8n, un credential est un identifiant de connexion à une application, enregistré et chiffré. Vous le créez une fois et le réutilisez dans chaque workflow. Les credentials sont chiffrés avec la clé de chiffrement de votre instance et, sur les offres payantes, peuvent être partagés avec vos collègues sans révéler le secret.

Il en existe trois types courants :

• Clé d’API / jeton : collez une clé issue des paramètres de l’application (OpenAI, personal access token Airtable, clé secrète Stripe).
• OAuth2 : vous cliquez sur « Se connecter avec… » et autorisez l’accès (Google, Slack, Microsoft, HubSpot).
• Basic auth / header auth : pour les webhooks et les API simples.

Avant de commencer : l’URL de redirection OAuth

Chaque credential OAuth2 dans n8n affiche une OAuth Redirect URL, par exemple https://n8n.yourcompany.com/rest/oauth2-credential/callback. Vous la collez dans la console développeur de l’application. Elle doit correspondre exactement, https compris.

Sur n8n Cloud, de nombreuses applications (Google, Slack, Microsoft) proposent un bouton Sign in en un clic, sans configuration côté développeur. Sur n8n auto-hébergé, vous créez généralement d’abord votre propre application OAuth.

Google (Sheets, Gmail, Drive, Calendar)

Sur n8n auto-hébergé :

1. Ouvrez la Google Cloud Console et créez un projet.
2. Allez dans APIs & Services → Library et activez les API nécessaires, comme Google Sheets API, Gmail API et Google Drive API.
3. Configurez l’OAuth consent screen. Choisissez Internal si vous utilisez Google Workspace et que seule votre organisation se connectera ; sinon External, et ajoutez-vous comme utilisateur de test.
4. Allez dans Credentials → Create credentials → OAuth client ID, type Web application.
5. Collez l’URL de redirection OAuth de n8n dans Authorized redirect URIs.
6. Copiez le Client ID et le Client Secret dans le credential n8n (Google OAuth2 API ou celui propre à l’application) et cliquez sur Sign in with Google.

Astuce : une application External au statut « Testing » émet des jetons qui expirent au bout de 7 jours. Publiez l’application (ou utilisez Internal) pour les workflows qui tournent en continu.

Slack

1. Allez sur api.slack.com/apps et cliquez sur Create New App → From scratch.
2. Dans OAuth & Permissions, ajoutez l’URL de redirection de n8n.
3. Ajoutez les scopes nécessaires. Pour publier des messages : chat:write ; pour lire les canaux : channels:read, channels:history.
4. Copiez le Client ID et le Client Secret dans le credential Slack OAuth2 de n8n et connectez-vous.
5. Invitez l’application dans chaque canal où elle doit publier (/invite @YourApp).

Pour un seul espace de travail, un jeton de bot (commençant par xoxb-) avec le credential Slack API est plus simple qu’OAuth.

Microsoft (Outlook, Teams, OneDrive)

1. Dans le portail Azure, ouvrez App registrations → New registration.
2. Ajoutez l’URL de redirection de n8n comme redirect URI de type Web.
3. Dans Certificates & secrets, créez un client secret.
4. Dans API permissions, ajoutez des autorisations déléguées Microsoft Graph comme Mail.ReadWrite, Mail.Send et offline_access.
5. Collez l’Application (client) ID et le secret dans le credential Microsoft OAuth2 de n8n.

OAuth2 générique pour n’importe quelle application

Si n8n n’a pas de credential dédié, utilisez OAuth2 API avec le nœud HTTP Request. Il vous faut l’URL d’autorisation, l’URL du jeton d’accès, le client ID, le client secret et les scopes indiqués dans la documentation développeur de l’application.

Checklist de sécurité

• Donnez à chaque credential les scopes minimaux nécessaires.
• Utilisez un compte de service ou un utilisateur bot dédié, pas le compte d’une personne, pour les workflows critiques.
• Conservez N8N_ENCRYPTION_KEY en lieu sûr ; si vous la perdez, il faut recréer tous les credentials.
• Renouvelez les secrets quand quelqu’un quitte l’équipe.

Pourquoi c’est important pour une migration

Quand vous quittez Zapier ou Make, les workflows peuvent être reconstruits à partir des exports, mais les credentials ne se transfèrent pas. Les recréer est souvent l’étape la plus longue d’une migration : configurez-les en premier. Consultez le guide de migration de Zapier vers n8n.