https://api.phaseo.app/v1) :
Clés de gestion, clés d’API et jetons OAuth
Les routes de gestion acceptent uniquement les clés de gestion (ou les jetons OAuth) ; une clé d’API Gateway ne peut pas les appeler.
Les garde-fous sont un contrôle distinct : ils s’appliquent aux clés d’API Gateway et encadrent le trafic d’inférence, par exemple les restrictions de routage, les budgets, la gestion des injections de prompt et les règles relatives aux informations sensibles. Les capacités d’une clé de gestion déterminent quelles API d’administration elle peut appeler.
Choisir un niveau d’accès
Chaque modèle se développe en une liste explicite de capacités lors de la création de la clé. Phaseo ne stocke jamais de joker tel queall : une clé ne reçoit donc jamais une autorisation ajoutée ultérieurement.
Aucun modèle n’inclut
billing:write, qui lance les rechargements de crédits ; demandez-la explicitement avec --scopes. Réservez All aux automatisations d’administration de confiance.
Pour une autorisation plus restreinte, passez les capacités nécessaires avec --scopes scope_a,scope_b :
Les capacités ne remplacent pas les rôles de l’espace de travail
Phaseo vérifie deux choses à chaque appel : que la clé possède la capacité, et que la clé ou l’utilisateur OAuth appartient à l’espace de travail avec le rôle requis par l’action. Par exemple,keys:write autorise la gestion des clés, mais c’est la vérification du rôle qui décide si l’appelant peut gérer les clés dans cet espace de travail. Une clé ne peut pas utiliser une capacité pour accéder à un autre espace de travail ni contourner les vérifications de propriétaire et d’administrateur.
Protéger vos clés
- Gardez les clés de gestion hors des navigateurs, des journaux de poste de travail, du contrôle de version et des discussions.
- Utilisez une clé par intégration, avec le modèle le plus restrictif qui fonctionne.
- Définissez une date d’expiration si l’intégration n’a pas besoin d’un accès permanent.
- Suspendez ou supprimez immédiatement les clés inutilisées.
- Renouvelez une clé divulguée avant de poursuivre l’analyse.