https://api.phaseo.app/v1):
Claves de administración, claves de API y tokens OAuth
Las rutas de administración solo aceptan claves de administración (o tokens OAuth); una clave de API de Gateway no puede llamarlas.
Los guardrails son un control distinto: se aplican a las claves de API de Gateway y gobiernan el tráfico de inferencia, como las restricciones de enrutamiento, los presupuestos, la gestión de la inyección de instrucciones y las reglas sobre información sensible. Las capacidades de una clave de administración determinan a qué API de administración puede llamar.
Elige un nivel de acceso
Cada plantilla se expande a una lista explícita de capacidades al crear la clave. Phaseo nunca almacena un comodín comoall, así que una clave nunca obtiene un permiso que se añada más adelante.
Ninguna plantilla incluye
billing:write, que inicia recargas de créditos; solicítala explícitamente con --scopes. Usa All solo para automatizaciones administrativas de confianza.
Para conceder menos, pasa las capacidades que necesites con --scopes scope_a,scope_b:
Las capacidades no sustituyen a los roles del espacio de trabajo
Phaseo comprueba dos cosas en cada llamada: que la clave tenga la capacidad y que la clave o el usuario OAuth pertenezca al espacio de trabajo con el rol que exige la acción. Por ejemplo,keys:write permite gestionar claves, pero la comprobación del rol sigue decidiendo si quien llama puede gestionar claves en ese espacio de trabajo. Una clave no puede usar una capacidad para acceder a otro espacio de trabajo ni para saltarse las comprobaciones de propietario y administrador.
Mantén las claves seguras
- Mantén las claves de administración fuera de los navegadores, los registros de escritorio, el control de versiones y los chats.
- Usa una clave por integración, con la plantilla más restrictiva que funcione.
- Define una caducidad cuando la integración no necesite acceso indefinido.
- Pausa o elimina de inmediato las claves que no uses.
- Rota una clave filtrada antes de seguir investigando.