--- title: "OAuth et agents IA : quels scopes donner, outil par outil" description: "Quels scopes OAuth donner à un agent IA ? Gmail, Agenda, Drive, Sheets : le minimum à accorder pour chaque tâche, avec les scopes exacts de Google." date: 2026-11-06 head: - - meta - name: keywords content: OAuth agent IA, scopes OAuth, scopes Gmail, sécurité agent IA, permissions agent IA, gmail.readonly, moindre privilège, accès agent IA - - meta - property: og:title content: "OAuth et agents IA : quels scopes donner, outil par outil" - - meta - property: og:description content: Avant de cliquer sur Autoriser, sachez quoi donner à votre agent IA. Les scopes Google à choisir pour Gmail, Agenda, Drive et Sheets, tâche par tâche. - - meta - property: og:image content: https://haloon.ai/doc/blog/oauth-ai-agents-scopes/img-1.jpg - - meta - property: og:type content: article - - meta - property: article:published_time content: 2026-11-06 - - script - type: application/ld+json - | { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Qu'est-ce qu'un scope OAuth ?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Est-ce que l'agent voit mon mot de passe ?", "acceptedAnswer": { "@type": "Answer", "text": "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, ce qui limite encore plus les risques de sécurité." } }, { "@type": "Question", "name": "Comment retirer l'accès d'un agent ?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "La lecture seule suffit-elle pour un agent utile ?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] } --- # OAuth et agents IA : quels scopes donner, outil par outil *Publié le 6 novembre 2026 par [Adrien Crovetto](https://haloon.ai/doc/fr/blog/author/adrien-crovetto)* Un robot assistant qui tient une seule petite clé pendant qu'une personne règle les permissions 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. ::: info 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](https://haloon.ai/doc/fr/blog/ai-agents-complete-guide). ::: ## 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 : 1. L'agent vous redirige vers Google (ou Notion, Slack...) 2. Vous voyez la liste des permissions demandées : ce sont les **scopes** 3. Si vous acceptez, Google donne à l'agent un **jeton** limité à ces scopes. L'agent ne voit jamais votre mot de passe 4. 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. 1. **Lire :** l'agent a-t-il besoin de lire ? Tout, un dossier, ou seulement les en-têtes ? 2. **Écrire :** doit-il créer ou modifier quelque chose ? Des brouillons suffisent-ils ? 3. **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` ::: warning 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](https://developers.google.com/identity/protocols/oauth2/scopes). 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 : - [ ] Lister les applications connectées à mon compte (paramètres de sécurité) - [ ] Retirer celles que je n'utilise plus ou que je ne reconnais pas - [ ] Relire les permissions de celles que je garde - [ ] Vérifier que chaque agent a toujours le minimum pour sa tâche - [ ] Passer en lecture seule ce qui n'a pas besoin d'écrire 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. ::: tip 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](https://haloon.ai/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](https://haloon.ai/doc/fr/blog/ai-agents-complete-guide), et pour apprendre à écrire les procédures que l'agent suivra, lisez [Comment écrire de bons Skills pour vos agents IA](https://haloon.ai/doc/fr/blog/how-to-write-good-skills). Prêt à déléguer votre première tâche ? [Créez votre premier agent sur Haloon](https://haloon.ai/agent) : vous décrivez ce que vous voulez, Haloon s'occupe des outils, des accès et des garde-fous.