OAuth et agents IA : quels scopes donner, outil par outil
Publié le 6 novembre 2026 par Adrien Crovetto
Un agent IA vous demande de connecter votre Gmail. Une fenêtre Google s'ouvre, avec une liste de permissions et un bouton "Autoriser". Vous cliquez, comme tout le monde.
Ce que vous venez peut-être d'accorder : lire, rédiger, envoyer et supprimer définitivement tous vos mails. Pour un agent qui doit juste résumer votre boîte mail le lundi, c'est beaucoup trop.
Le problème n'est pas OAuth, qui est un bon mécanisme. Le problème, c'est le scope qu'on accepte sans le lire. Cet article vous dit lesquels choisir, outil par outil.
En une phrase : un scope OAuth est une permission précise que vous accordez à une application, et donner le scope minimum limite ce qu'un agent peut faire, même s'il se trompe ou se fait manipuler.
Un article de notre série sur les agents IA
Les accès sont le premier risque d'un agent. Pour le tableau complet des risques, lisez Agents IA : définition, fonctionnement et risques à maîtriser.
En un coup d'œil
| # | Section | Ce que ça change |
|---|---|---|
| 1 | OAuth et scopes en 2 minutes | Vous comprenez ce que vous autorisez vraiment |
| 2 | Le test lire, écrire, envoyer | Une règle simple pour choisir un scope |
| 3 | Gmail | Vous évitez le scope qui donne tout |
| 4 | Agenda, Drive et Sheets | Vous limitez l'accès à ce dont la tâche a besoin |
| 5 | Les recettes par tâche | Vous copiez le minimum pour 7 tâches courantes |
| 6 | Vérifier et révoquer | Vous gardez la main dans le temps |
OAuth et scopes en 2 minutes
Pourquoi c'est important
Donner votre mot de passe à un agent, c'est lui donner toutes les clés, pour toujours. Vous ne devriez jamais faire ça.
OAuth fonctionne autrement, comme une clé de voiturier : elle ouvre la portière et démarre la voiture, mais le coffre reste fermé. Vous l'avez surement utilisé en cliquant sur un bouton Se connecter avec Google.
Voici ce qui se passe quand vous connectez un outil :
- L'agent vous redirige vers Google (ou Notion, Slack...)
- Vous voyez la liste des permissions demandées : ce sont les scopes
- Si vous acceptez, Google donne à l'agent un jeton limité à ces scopes. L'agent ne voit jamais votre mot de passe
- Vous pouvez retirer l'accès à tout moment, sans changer de mot de passe
Les scopes classiques: lire, écrire, envoyer
Avant d'accepter un scope, posez trois questions.
- Lire : l'agent a-t-il besoin de lire ? Tout, un dossier, ou seulement les en-têtes ?
- Écrire : doit-il créer ou modifier quelque chose ? Des brouillons suffisent-ils ?
- Envoyer, partager, supprimer : en a-t-il vraiment besoin ? Si oui, c'est vous qui validez chaque action.
| Verbe | Si l'agent se trompe | Exemple |
|---|---|---|
| Lire | Des données sont lues pour rien | Résumer vos mails |
| Écrire | Des données sont modifiées | Corriger un tableur |
| Envoyer, partager, supprimer | C'est irréversible | Envoyer un mail, supprimer un fichier |
La règle : commencez par lire seulement. Vous ajoutez l'écriture plus tard, si les résultats le méritent.
Gmail : le plus sensible
Votre boîte mail contient des contrats, des factures, des mots de passe oubliés. C'est le premier endroit où réduire les droits.
| Scope | Ce que Google en dit | Verdict |
|---|---|---|
gmail.metadata | Voir les libellés et les en-têtes, mais pas le corps du mail | ✅ Suffisant pour trier par expéditeur |
gmail.readonly | Voir vos mails et vos réglages | ✅ Résumés, recherche |
gmail.labels | Voir et modifier vos libellés | ⚠️ Pour organiser |
gmail.compose | Gérer les brouillons et envoyer des mails | ⚠️ Peut envoyer |
gmail.send | Envoyer des mails en votre nom | ⚠️ Seulement avec validation |
gmail.modify | Lire, rédiger et envoyer des mails | ⚠️ Peut envoyer |
https://mail.google.com/ | Lire, rédiger, envoyer et supprimer définitivement tous vos mails | ❌ Presque jamais justifié |
Deux lignes sont à lire deux fois : d'après les descriptions de Google, gmail.compose et gmail.modify permettent aussi d'envoyer. Il n'y a donc pas de scope "brouillons seulement" dans cette liste.
Conséquence : la règle "je valide avant l'envoi" ne peut pas reposer sur le scope. Elle doit être dans l'agent, qui doit vous demander votre accord avant tout envoi.
Pour un résumé hebdomadaire de boîte mail, un seul scope suffit : https://www.googleapis.com/auth/gmail.readonly
Attention
Un agent qui lit vos mails ET peut envoyer des mails librement est la combinaison la plus risquée. Si vous devez lui donner gmail.compose ou gmail.modify, gardez la validation humaine sur l'envoi.
Agenda
| Scope | Ce que Google en dit | Verdict |
|---|---|---|
calendar.freebusy | Voir vos disponibilités | ✅ Proposer des créneaux sans voir vos rendez-vous |
calendar.events.readonly | Voir les événements de vos agendas | ✅ Préparer votre semaine |
calendar.events.owned | Voir, créer, modifier et supprimer les événements des agendas que vous possédez | ⚠️ Créer des rendez-vous |
calendar | Voir, modifier, partager et supprimer définitivement tous vos agendas | ❌ Trop large |
Drive et Sheets
| Scope | Ce que Google en dit | Verdict |
|---|---|---|
drive.file | Voir, modifier, créer et supprimer seulement les fichiers précis que vous utilisez avec l'application | ✅ Le meilleur choix pour déposer un rapport |
drive.readonly | Voir et télécharger tous vos fichiers | ⚠️ Lecture seule, mais tout le Drive |
drive | Voir, modifier, créer et supprimer tous vos fichiers | ❌ Trop large |
spreadsheets.readonly | Voir tous vos tableurs | ✅ Lire un tableur de suivi |
spreadsheets | Voir, modifier, créer et supprimer tous vos tableurs | ⚠️ Seulement si l'agent doit écrire |
Le scope drive.file est celui à retenir : l'agent ne voit que les fichiers que vous lui montrez, pas votre Drive entier.
Exemple 7 tâches classiques
| Tâche | Scopes minimum | À éviter |
|---|---|---|
| Résumer les mails du lundi | gmail.readonly (ou gmail.metadata si l'expéditeur et l'objet suffisent) | gmail.modify, https://mail.google.com/ |
| Préparer des brouillons de réponse | gmail.readonly et gmail.compose, avec validation avant tout envoi | gmail.modify |
| Proposer des créneaux de rendez-vous | calendar.freebusy | calendar |
| Préparer votre semaine | calendar.events.readonly | calendar |
| Créer un rendez-vous | calendar.events.owned | calendar |
| Lire un tableur de suivi | spreadsheets.readonly | spreadsheets |
| Déposer un rapport dans un dossier | drive.file | drive |
Liste vérifiée le 3 novembre 2026 sur la documentation officielle de Google. Les scopes évoluent : vérifiez avant de vous y fier.
Quand l'outil n'a pas de scope fin
Tous les outils ne proposent pas des permissions aussi précises. Certains CRM ou outils plus petits fonctionnent en "tout ou rien". Dans ce cas, limitez autrement :
- Un compte dédié à l'agent, avec un rôle lecteur quand c'est possible
- Un espace limité : un dossier ou un projet partagé seulement avec l'agent
- Un test à vide : connectez d'abord un compte qui ne contient aucune donnée sensible
Dans Google Workspace, l'administrateur peut aussi contrôler quelles applications tierces ont le droit de se connecter. Pour une TPE ou une startup, c'est un bon réflexe avant d'ouvrir l'accès à toute l'équipe.
Vérifier et révoquer
Un accès accordé il y a six mois pour un test est encore ouvert aujourd'hui, sauf si vous le retirez. Une fois par mois, prenez 10 minutes :
Retirer l'accès d'une application ne demande pas de changer votre mot de passe. C'est tout l'intérêt d'OAuth.
Avec Haloon Agent
Dans Haloon, l'accès est limité outil par outil, et l'agent ne voit jamais vos clés OAuth. Vous choisissez quels outils vous connectez et lesquels l'agent peut utiliser. Les actions sensibles attendent votre validation. Découvrez Haloon Agent.
Erreurs à éviter
Cliquer sur "Autoriser" sans lire
La liste des permissions est là pour être lue. Si vous ne comprenez pas une ligne, ne l'accordez pas.
Utiliser votre compte principal pour un essai
Testez d'abord avec un compte ou un dossier de test. Vous élargirez ensuite.
Oublier les anciennes connexions
Chaque intégration oubliée reste une porte ouverte. Le nettoyage mensuel suffit.
Croire que le scope remplace la validation humaine
Un scope limite ce que l'agent peut faire. Il ne décide pas de ce qu'il doit faire. Gardez votre validation sur ce qui est irréversible.
Questions fréquentes
Qu'est-ce qu'un scope OAuth ?
Un scope est une permission précise que vous accordez à une application, par exemple "lire vos mails" ou "voir vos disponibilités". Il limite ce que l'application peut faire avec votre compte.
Est-ce que l'agent voit mon mot de passe ?
Non. Avec OAuth, vous vous authentifiez chez le fournisseur (Google par exemple). L'agent reçoit un jeton limité aux scopes que vous avez acceptés. Avec un bon harness, comme celui d'Haloon, l'agent ne voit même pas vos tokens OAuth; ca limite encore plus les risques de sécurité.
Comment retirer l'accès d'un agent ?
Dans les paramètres de sécurité de votre compte, section des applications connectées, vous pouvez supprimer l'accès d'une application entière ou l'accès d'un agent spécifiquement. Vous n'avez pas besoin de changer votre mot de passe.
La lecture seule suffit-elle pour un agent utile ?
Oui, pour beaucoup de tâches : résumés, veille, rapports, préparation de brouillons. L'écriture et l'envoi ne sont à ajouter que si la tâche l'exige.
Résumé
| # | À retenir | Pourquoi |
|---|---|---|
| 1 | OAuth donne un accès limité, révocable | L'agent ne voit jamais votre mot de passe |
| 2 | Le scope décide de ce que l'agent peut faire | Choisissez le plus étroit |
| 3 | Lire, écrire, envoyer | Commencez par lire seulement |
| 4 | gmail.compose et gmail.modify peuvent envoyer | La validation avant envoi doit être dans l'agent |
| 5 | drive.file plutôt que drive | L'agent ne voit que les fichiers que vous lui montrez |
| 6 | Un compte ou un dossier dédié si l'outil est "tout ou rien" | Vous limitez les dégâts possibles |
| 7 | Un contrôle mensuel de 10 minutes | Les anciens accès ne restent pas ouverts |
Le bon réflexe tient en une phrase : donnez à l'agent la clé de voiturier, pas la clé du coffre. Le contexte complet est dans le guide sur les agents IA, et pour apprendre à écrire les procédures que l'agent suivra, lisez Comment écrire de bons Skills pour vos agents IA.
Prêt à déléguer votre première tâche ? Créez votre premier agent sur Haloon : vous décrivez ce que vous voulez, Haloon s'occupe des outils, des accès et des garde-fous.