Notion · Brancher l’IA sur ses données
Clé d’API
Le mot de passe qui donne accès à un service par programme. Qui la détient peut consommer à vos frais : elle se garde comme une carte bancaire.
Comment ça marche
Pour appeler un service d’IA par programme, il faut s’identifier. La clé d’API est ce moyen : une chaîne secrète, liée à votre compte et à votre facturation, envoyée avec chaque requête. Le fournisseur la reconnaît, exécute, et facture le compte. Tout ce qui est fait avec la clé est fait en votre nom et à vos frais. Elle a la valeur d’une carte bancaire sans code.
Sa gestion suit des règles simples. Une clé par usage, nommée, pour savoir qui consomme et pour pouvoir en révoquer une sans arrêter les autres. Un plafond de dépense par clé, chez le fournisseur. Un stockage dans un coffre ou en variable d’environnement, jamais dans un fichier lu par un agent, un dépôt Git ou une conversation. Un propriétaire par clé, et une date de renouvellement. Et un réflexe : au moindre doute d’exposition, on révoque et on remplace.
Un exemple concret
- Clé « tri-demandes » : automatisation de tri des e-mails entrants. Plafond 50 euros par mois. Propriétaire : l’office manager. Stockée dans le coffre de l’outil d’automatisation.
- Clé « assistant-docs » : l’assistant documentaire interne. Plafond 150 euros. Propriétaire : le responsable informatique. Variable d’environnement sur le serveur.
- Clé « tests » : pour les essais et les développements. Plafond 20 euros. Propriétaire : le référent IA. Renouvelée chaque trimestre.
- Clé « agent-reporting » : l’agent planifié du lundi. Plafond 30 euros. Propriétaire : le contrôleur de gestion.
- L’incident évité : en août, la clé « tests » a été copiée par erreur dans un script partagé. Repérée par un hook qui bloque les commits contenant des clés, révoquée dans la minute. Consommation suspecte : zéro.
Quatre clés, quatre plafonds, quatre noms. Le registre tient sur une page, dans le coffre lui-même.
Ce que ça change pour une équipe
- La consommation est attribuée. Chaque euro de la facture a un usage et un responsable.
- Les fuites ont un coût borné. Le plafond limite les dégâts ; la révocation les arrête.
- Les automatisations se gèrent indépendamment. Arrêter une clé n’arrête que son usage.
- Les agents travaillent sans voir les clés. Par variable d’environnement, ils accèdent au service sans jamais lire la valeur.
Les limites et les erreurs fréquentes
- La clé dans le code. Elle finit dans Git, dans un README, dans une conversation. Le coffre, dès le premier jour.
- Une clé pour toute l’entreprise. Impossible d’attribuer, impossible de révoquer sans tout couper. Une par usage.
- Pas de plafond. La seule protection contre une fuite ou une boucle est la limite de dépense. Elle se règle à la création.
- Jamais renouvelée. Une clé de trois ans a été vue par trop de gens. Un renouvellement périodique, et un à chaque départ de collaborateur qui y avait accès.
Pour aller plus loin
Une clé d’API s’attache à un compte et à un budget. Elle ne doit jamais figurer dans un fichier partagé, un dépôt de code ou une conversation ; on la stocke dans un coffre ou une variable d’environnement, et on la renouvelle en cas de doute.
Où ça se situe chez Opora
Programme 02 · AutomatiserAutomatiser les tâches répétitives
Organiser les clés d’API de l’entreprise, une par usage, avec plafonds et coffre, c’est une des premières mises en place du programme Automatiser.
Questions fréquentes
À quoi ressemble une clé d’API ?
À une longue suite de lettres et de chiffres, générée dans l’espace d’administration du fournisseur. Elle s’envoie avec chaque requête pour prouver qui appelle. Elle n’est affichée qu’une fois à la création : on la copie dans un coffre tout de suite, ou on la régénère.
Combien de clés faut-il ?
Une par usage : une pour l’automatisation de tri, une pour l’assistant interne, une pour les tests. Chacune avec son plafond et son suivi. Une clé unique partagée rend impossible de savoir qui consomme et expose tout en cas de fuite.
Que faire si une clé a fuité ?
La révoquer immédiatement dans l’espace du fournisseur, en créer une nouvelle, la mettre à jour dans le coffre et les outils, et regarder la consommation récente pour évaluer les dégâts. Ne pas attendre d’être sûr : révoquer une clé coûte cinq minutes, une fuite exploitée coûte des centaines d’euros.