Passer au contenu principal
Créez une clé de gestion pour appeler les API d’administration de Phaseo depuis vos propres serveurs : crédits, activité, espaces de travail, clés, préréglages, paramètres et garde-fous. Les clés de gestion ne peuvent pas envoyer de requêtes d’inférence. Créez-en une dans le tableau de bord, sous Paramètres → Clés de gestion. Le secret ne s’affiche qu’une seule fois : enregistrez-le dans votre gestionnaire de secrets. Envoyez-le uniquement depuis du code côté serveur, vers la même URL de base que le Gateway (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 que all : 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.
Dernière modification le 7 novembre 2026