Chez LBKE, nous appliquons nos compétences en web et en IA pour optimiser nos propres processus. L’un de nos chantiers en 2025 concerne l’automatisation des processus qualité de notre activité de formation à l’IA générative, mis en place dans le cadre de la démarche Qualiopi.
Pour cela, nous avons choisi de tester n8n, un outil d’automatisation open source, devenu très populaire grâce à sa capacité à intégrer des appels LLM.
Dans ce premier article, nous allons nous concentrer sur une étape essentielle : l’authentification OAuth, indispensable pour connecter certaines API comme celles de Google Drive, Google Calendar ou Gmail.
Pourquoi l’authentification OAuth est-elle utile pour automatiser des processus avec n8n ?
Le protocole OAuth permet à n8n d’accéder à des services tiers comme Google en toute sécurité, sans exposer directement les identifiants des utilisateurs finaux.
Cela permet par exemple :
- d’automatiser la récupération ou l’envoi de fichiers Google Drive,
- d’envoyer des emails via Gmail,
- d’accéder à des données utilisateur protégées,
- etc.
Mais sa mise en place peut être délicate voire très difficile si on n’a pas l’habitude de manipuler les paramètres d’API Google Cloud. Nous vous partageons ainsi la procédure complète pour configurer l’authentification OAuth pour se connecter aux outils Google Workspace.
Étapes pour configurer une authentification OAuth dans n8n (avec Google)
Cette procédure détaillée vous guide pas à pas pour réussir cette configuration, que vous soyez développeur web ou utilisateur d’outils no-code.
En suivant ces étapes, vous pourrez connecter vos services Google de manière sécurisée et fiable, tout en respectant les bonnes pratiques imposées par Google Cloud Platform.
1. Se rendre dans Google Cloud Console et créer un nouveau projet
- Rendez-vous dans le tableau de bord Google Cloud : console.cloud.google.com
- Vous allez devoir créer un projet. Dans le sélecteur de projet, cliquez sur « Nouveau projet ».
- Indiquez le nom du projet et rattachez-le éventuellement à une organisation, sinon laissez « No organization ».
- Sélectionnez ensuite votre projet.
2. Créer l’accès OAuth
- Allez dans API et services > Credentials.
- Cliquez sur « Create credentials » > OAuth client ID
- Choisissez le type d’application, généralement : « Web application ».
- Renseigner les URL de redirection autorisées :
- Attention : si vous hébergez n8n en local ou sur un serveur personnel, évitez “localhost” dans les URLs.
- Exemple d’URL correcte :
https://votre-instance-n8n.com/rest/oauth2-credential/callback
A la fin de la procédure, vous obtiendrez le « client ID » et le « client secret », à conserver précieusement. Ce sont ces deux données que vous devrez ensuite renseigner dans l’interface n8n. Il ne s’agit pas des identifiants de l’utilisateur, mais des identifiants du projet que vous avez créé dans la console Google Cloud.
Il est recommandé de donner des noms explicites à vos identifiants OAuth dans Google Cloud, surtout si vous gérez plusieurs projets ou services. Par exemple : “n8n-GoogleDrive-Automation”. Cela facilite la maintenance, évite les erreurs de configuration et améliore la lisibilité globale de votre console Google Cloud.
3. Configurer l’audience
Allez dans API et services > Écran de consentement OAuth > Audience.
- Cliquez sur « Get started »
- Donnez un nom à votre application et indiquez un email de contact
- Définissez l’audience (type d’utilisateur) : interne ou externe selon votre usage.
Si l’automatisation ne concerne que les employés de votre entreprise, qui font partie de la même organisation Google Cloud, alors une connexion interne suffira. Sinon, il faut mettre en place une audience externe.
4. Activer les API nécessaires
- Allez dans API et services > Enabled APIs & services > Library
- Recherchez et activez les APIs que vous souhaitez utiliser : Google Drive API, Gmail API, etc.
- Ensuite, dans API et services > OAuth consent screen > Data Access, cocher les API activées précédemment.
En termes de bonnes pratiques de sécurité, il est essentiel d’activer uniquement les API et les scopes dont vous avez réellement besoin.
Par exemple, si vous n’utilisez Google Drive qu’en lecture seule, privilégiez un scope comme https://www.googleapis.com/auth/drive.readonly plutôt que des autorisations complètes. Cela limite les risques en cas de piratage.
5. Retour sur n8n : configurer les credentials
- Dans l’interface n8n, rendez-vous dans l’onglet « Credentials » et créez un nouveau credential.
- Sélectionnez l’application ou le service Google avec lequel vous souhaitez vous connecter, par exemple « Google Drive OAuth API »
- Renseignez :
- L’ID client et le secret générés par Google
- L’URL de redirection définie dans Google Cloud
- Puis, dans une seconde étape, les scopes souhaités (droits d’accès)
- Exemple : https://www.googleapis.com/auth/drive.labels.readonly pour accéder en lecture seule à Google Drive
- La documentation n8n donne une liste utile ici : n8n OAuth scopes. Vous pouvez également consulter la documentation de Google.
Un mot sur le refresh token
Lorsque l’authentification est réussie, n8n génère également un refresh token. Celui-ci permet de renouveler automatiquement l’accès sans avoir à repasser par le processus de connexion. Cela est très utile pour les automatisations qui doivent se faire sur le long terme, comme les envois quotidiens ou les synchronisations hebdomadaires.
Erreurs fréquemment rencontrées (et comment les éviter)
Voici quelques problèmes que nous avons rencontrés lors de la configuration :
Comment résoudre l’erreur « n8n.cloud n’a pas terminé la procédure de validation de Google »
(Ou en anglais l’erreur « Google hasn’t verified this app ».)
La résolution de cette erreur dépend de la configuration de votre audience (voir étape 3 ci-dessus). Si votre « user type » est externe, vous devez ajouter votre email à la liste des utilisateurs tests (API et services > Écran de consentement OAuth > Audience). Si votre « user type » est interne, vous devez créer votre OAuth credentials depuis le compte que vous voulez authentifier.
Voir les explications détaillées dans la documentation de n8n et sur le forum de n8n
Comment résoudre l’erreur “Make sure that you have enabled the Google Drive API…”
La solution à cette erreur est a priori simple : vous devez vous assurer que l’API est bien activée dans la console Google Cloud > APIs & Services > Enabled APIs & services. Si cela ne fonctionne toujours pas, n’hésitez pas à recréer le credentials depuis n8n après avoir rafraîchi la page.
Comment résoudre les problèmes de scopes mal configurés
Lorsque vous activez les API, assurez-vous de bien choisir les bons scopes selon les services Google utilisés. Par exemple : https://www.googleapis.com/auth/gmail.send pour envoyer des mails.
Conclusion : configurer l’Oauth2 avec Google et n8n une étape technique, mais incontournable
Cette première étape nous a permis de connecter n8n à notre environnement Google. Elle constitue le fondement de toute automatisation future avec n8n dans l’environnement Google Workspace : envoi automatique de mails, gestion de documents, etc.
Dans les prochains articles, nous détaillerons les automatisations concrètes que nous allons mettre en place, notamment autour de la gestion documentaire Qualiopi, du suivi des apprenants ou encore de la génération de documents.
