Authentification et clésAPI
La plateforme accepteAPI Gateway les clésCHAMPREPAPI à portée limitée pour les intégrations de serveurs et l’automatisation. Les sessions de compte via navigateur sont utilisées pour gérer les clés, mais une intégration personnalisée doit authentifier ses requêtes de service à l’aide d’une APIclé.
Créer une clé
Section intitulée « Créer une clé »- Ouvrir API Clés.
- Choisissez un nom qui identifie la charge de travail et l’environnement.
- Pour chaque service, choisissez un niveau d’accès, puis affinez-le pour ne retenir que les périmètres dont la charge de travail a besoin.
- Ajoutez une liste blanche d’adresses IP lorsque la charge de travail dispose d’adresses sortantes stables.
- Copiez la clé une seule fois et stockez-la dans un gestionnaire de secrets ou un trousseau.
Ne créez pas une seule clé à portée étendue pour chaque application. Des clés distinctes rendent la rotation, l’audit et la réponse aux incidents plus sûrs.
Envoyer les identifiants
Section intitulée « Envoyer les identifiants »Authorization: Bearer YOUR_API_KEYPour les exemples de shell, conservez la valeur dans une variable d’environnement :
curl --fail-with-body \ --header "Authorization: Bearer $CHAMPREP_TOKEN" \ https://api.champrep.com/v1/auth/whoamiN’insérez pas de clé dans une URL, un paramètre de requête, un bundle JavaScript front-end, une application mobile, une ligne de journal ou un événement d’analyse.
Catalogue des portées
Section intitulée « Catalogue des portées »L’écran « ClésAPI » regroupe les services en quatre domaines : Espace de travail, Communication, Développeur et Administration. Pour chaque service, choisissez un niveau d’accès, puis ajoutez ou supprimez des portées individuelles si la charge de travail nécessite une autorisation plus restreinte :
- Aucune: la clé ne permet pas d’utiliser le service.
- Lecture: les champs d’application indiqués dans la colonne « Lecture ».
- Lecture et écriture: Lecture plus les périmètres indiqués dans la colonne « Écriture ».
- Administrateur: tout ce qui précède, plus les champs d’application de la colonne « Admin », pour les services qui en disposent.
Portées marquées sur inscription ne sont jamais sélectionnées par niveau. Cochez-les par leur nom. Un service non inclus dans votre forfait apparaît verrouillé, avec un lien vers la mise à niveau. L’écran affiche toujours le catalogue actuellement en ligne.
Espace de travail
Section intitulée « Espace de travail »| Service | Lecture | Écriture | Administrateur |
|---|---|---|---|
| Drive | drive:read | drive:write, drive:delete | — |
| Docs | docs:read, docs:export | docs:write, docs:share, docs:delete | — |
| Feuilles de calcul | sheets:read, sheets:export | sheets:write, sheets:share, sheets:delete | — |
| Notes | notes:read | notes:write | — |
| Calendar | calendar:read | calendar:write | — |
| Contacts | contacts:read | contacts:write | — |
| Work | work:read | work:write, work:delete | — |
| Forms | forms:read | forms:write | — |
| Invoice | invoice:read | invoice:write, invoice:send, invoice:delete | — |
| Organigrammes | charts:read | charts:write, charts:delete | — |
| Learn | courses:read | courses:write | — |
| École LMS | Pas encore disponible via une cléAPI |
Communication
Section intitulée « Communication »| Service | Lecture | Écriture | Administrateur |
|---|---|---|---|
mail:read | mail:write, mail:send | — | |
| Chat | chat:read | chat:write | — |
| Meet | meet:read | meet:write | — |
| RTC | À venir. RTC utilise ses propres clésAPI de projet |
Développeur
Section intitulée « Développeur »| Service | Lecture | Écriture | Administrateur |
|---|---|---|---|
| CHAMPREP Code | code:read_api, code:read_repository, code:read_registry, code:read_package_registry | code:write_repository, code:write_registry, code:write_package_registry | code:api; activation requise code:admin_mode |
| CHAMPREP QA | qa:read | qa:write | — |
| Ferme de runners | runner_farm:read | runner_farm:write | — |
| CLI | — | cli:use | — |
| CHAMPREP AI | — | ai:chat; activation requise ai:actions, ai:agent | — |
Administrateur
Section intitulée « Administrateur »| Service | Lecture | Écriture | Administrateur |
|---|---|---|---|
| Entreprise | business:read | — | business:manage |
| Facturation | billing:read | — | billing:manage |
| Développeur API | api:read | — | api:manage, webhooks:manage |
| Profil | users:read | — | — |
L’administration de la plateforme n’est jamais accessible à une cléAPI ; elle nécessite un administrateur connecté.
Notes sur des périmètres spécifiques
Section intitulée « Notes sur des périmètres spécifiques »- CHAMPREP Code. Chaque
code:correspond à celui du jeton d’accès personnel du même nom dans CHAMPREPCode, et Code le vérifie sur chaque point de terminaison.code:apicorrespond à un accès complet en lecture et en écriture à tout ce que votre compte peut atteindre dans Code ; il se situe donc au niveau « Admin » ; privilégiez les autorisations plus restreintesread_etwrite_. Les points de terminaison d’administration du code nécessitent une clé contenantcode:admin_modepar nom, ainsi qu’un compte disposant des droits d’administrateur Code. - Ferme de Runner.
runner_farm:writeenregistre et gère les runners, les pools et les connexions. Il n’achète jamais de crédits ni ne modifie les paramètres de paiement, et il ne génère, ne remplace ni ne teste jamais de secret de connecteur ou de jeton de runner. Ces actions nécessitent une personne connectée. - Docs et Sheets. Le partage (collaborateurs, partage de liens, publication), la suppression définitive ou la purge, ainsi que l’exportation nécessitent chacun leur propre champ d’application. Une clé ne comportant que
docs:writeousheets:writepeuvent modifier le contenu, mais ne peuvent ni le partager, ni le purger, ni l’exporter. - CHAMPREP AI.
ai:agentpermettent de CLI Agent IA utilisent des outils locaux et incluentai:chat.ai:actionsapprouve ou rejette les actions que l’IA propose dans vos CHAMPREPservices, et rien d’autre.
La portée « * »
Section intitulée « La portée « * » »La portée « * » * (accès complet) couvrent tous les services inclus dans votre forfait, y compris CHAMPREPCode, Runner Farm et Docs. CHAMPREPCode les traite comme
code:api, ce qui correspond à un accès complet en lecture et en écriture. Cela n’inclut pas
ai:agent ou code:admin_mode; celles-ci doivent toujours être sélectionnées par leur nom.
Réservez le caractère générique aux intégrations administratives strictement contrôlées, et limitez les clés d’accès complet existantes si elles n’ont pas besoin des nouveaux services. Une portée autorise une catégorie d’actions ; elle ne remplace pas les autorisations liées au forfait, au rôle, à l’organisation ou à la ressource.
Cycle de vie des clés
Section intitulée « Cycle de vie des clés »
Rotation
Section intitulée « Rotation »Créez ou régénérez une clé de remplacement, déployez-la, vérifiez que la charge de travail l’utilise, puis révoquez la clé précédente. Évitez toute rotation qui laisserait une charge de travail sans surveillance et dépourvue d’identifiants valides.
Révoquer
Section intitulée « Révoquer »Révoquez immédiatement une clé si elle a été exposée, copiée sur un système non fiable ou si elle n’appartient plus à une charge de travail active. Une clé révoquée doit renvoyer 401 et ne doit pas faire l’objet de tentatives indéfinies.
Révision
Section intitulée « Révision »Vérifiez régulièrement les noms de clés, les portées, les restrictions d’adresse IP, les informations relatives à la dernière utilisation et l’activité d’audit. Supprimez les clés inutilisées au lieu de les conserver en vue d’un éventuel script futur.
Connexion via le navigateur et CLIconnexion
Section intitulée « Connexion via le navigateur et CLIconnexion »champrep auth login utilise un processus d’approbation via navigateur pour une personne utilisant un terminal.
champrep auth token stocke une APIclé à portée limitée pour l’automatisation. La CLI protègeCLI les identifiants stockés à l’aide du trousseau du système d’exploitation et envoie toutes les commandes réseau via la passerelle.
Voir CLI Authentification et API Clés pour l’automatisationCLI pour ces flux de travail.