Pular para o conteúdo principal
Crie uma chave de gerenciamento para chamar as APIs de administração do Phaseo a partir dos seus próprios servidores: créditos, atividade, espaços de trabalho, chaves, predefinições, configurações e guardrails. Chaves de gerenciamento não enviam solicitações de inferência. Crie uma no painel em Configurações → Chaves de gerenciamento. O segredo é exibido uma única vez, então guarde-o no seu gerenciador de segredos. Envie-o apenas a partir de código do lado do servidor, para a mesma URL base do Gateway (https://api.phaseo.app/v1):

Chaves de gerenciamento, chaves de API e tokens OAuth

As rotas de gerenciamento aceitam apenas chaves de gerenciamento (ou tokens OAuth); uma chave de API do Gateway não consegue chamá-las. Os guardrails são um controle separado: eles se aplicam às chaves de API do Gateway e regem o tráfego de inferência, como restrições de roteamento, orçamentos, tratamento de injeção de prompt e regras para informações confidenciais. Os recursos de uma chave de gerenciamento definem quais APIs de administração ela pode chamar.

Escolha um nível de acesso

Cada modelo se expande em uma lista explícita de recursos quando a chave é criada. O Phaseo nunca armazena um curinga como all, então uma chave nunca ganha uma permissão adicionada depois. Nenhum modelo inclui billing:write, que inicia recargas de créditos; peça-o explicitamente com --scopes. Use All somente para automações administrativas confiáveis. Para uma concessão menor, passe os recursos de que você precisa com --scopes scope_a,scope_b:

Recursos não substituem as funções no espaço de trabalho

O Phaseo verifica duas coisas em cada chamada: se a chave tem o recurso e se a chave ou o usuário OAuth pertence ao espaço de trabalho com a função que a ação exige. Por exemplo, keys:write permite o gerenciamento de chaves, mas a verificação de função ainda decide se quem chama pode gerenciar chaves naquele espaço de trabalho. Uma chave não pode usar um recurso para acessar outro espaço de trabalho nem ignorar as verificações de proprietário e administrador.

Mantenha as chaves seguras

  • Mantenha as chaves de gerenciamento fora de navegadores, logs do computador, controle de versão e chats.
  • Use uma chave por integração, com o modelo mais restrito que funcione.
  • Defina uma expiração quando a integração não precisar de acesso indefinido.
  • Pause ou exclua imediatamente as chaves sem uso.
  • Faça a rotação de uma chave vazada antes de continuar investigando.
Última modificação em 7 de novembro de 2026