Segurança com agentes

Um agente de IA é um software que decide sozinho o que chamar. Dê a ele o menor acesso possível, em um ambiente onde você consiga cortá-lo.

Regras

Chave somente leitura. A chave de API da owiew só pode ter o papel viewer ou analyst. Esses dois papéis não executam nada nas plataformas de anúncio nem reescrevem a classificação do relatório. A API de leitura não escreve em lugar nenhum, e a chave só serve para pedir um token em POST /v1/token.
Prazo curto. Toda chave expira. O padrão é 90 dias e o teto é 365. Para um agente, escolha o prazo mais curto que sirva ao seu uso e crie uma chave por agente, para cortar um sem afetar os outros.
Nunca no prompt. A chave não entra na conversa, no prompt de sistema, em exemplos nem em arquivos que o agente lê. Se ela aparecer no texto, trate como vazada. A chave fica numa variável de ambiente do código que chama a API (OWIEW_API_KEY) ou num cofre de segredos, e o modelo só vê o resultado das chamadas.
Nunca em código versionado. Nem em repositório, nem em log, nem em captura de tela. Peça ao agente que leia a chave do ambiente e nunca a escreva em arquivo.
Token de dois minutos. A troca da chave devolve um token que expira em dois minutos e vale para um cliente e um conjunto de contas. Não guarde o token; peça outro quando precisar.
Lista de rotas permitidas. Quando você expõe a API como ferramenta, valide o recurso pedido contra uma lista fixa e use o tenant_id da troca. Nunca aceite do modelo o cliente ou o caminho completo.
Uma pessoa decide o que gasta dinheiro. O agente lê e propõe. Quem aprova uma publicação é uma pessoa.

Isolamento por cliente

O cliente vem sempre do caminho da requisição e é conferido contra o token. Um token usado no caminho de outro cliente recebe 403, nunca uma resposta vazia. Se o agente receber 403, ele deve parar e relatar, não tentar outro identificador.

Revogação

Chave que venceu responde 401 na troca. A integração para, de forma visível.
Chave comprometida: peça a quem administra o cliente na owiew que a revogue e crie outra. Tokens já emitidos expiram em no máximo dois minutos.
Depois de revogar, procure onde a chave pode ter ficado: histórico de conversas, logs, variáveis de ambiente de outras máquinas.

Resultado esperado

O agente lê os dados do cliente certo, por poucos minutos de cada vez, sem nenhum segredo no texto da conversa e sem poder alterar nada.

Se algo der errado

A chave apareceu em uma conversa ou em um log. Revogue e crie uma nova agora; não espere o prazo vencer.
O agente tenta acessar outro cliente. Ele recebe 403. Revise a lista de rotas permitidas e o prompt.
A integração parou de repente. Confira a validade da chave antes de procurar outro defeito.