Lição 2 de 7 · 8 minutos

Chaves de API para uma equipe

Dê a cada app e ambiente a própria chave com limites, use chaves de gerenciamento para automação e rotacione chaves sem interrupção.

Proprietários e administradores criam chaves de API em Configurações → Chaves de API. Use uma chave por app e por ambiente, não uma chave compartilhada por todos. Assim você vê o uso de cada chave, define limites para ela e a substitui sem mexer em mais nada. O segredo é exibido uma única vez, então ele vai direto para o seu gerenciador de segredos.

Toda chave pode ter limites diários, semanais ou mensais de solicitações e de gastos. Eles são verificados a cada solicitação e reiniciam à meia-noite UTC, na segunda-feira ou no dia 1º do mês. Quando um limite é atingido, as solicitações com essa chave são recusadas até o período reiniciar. Segurança das chaves lista as chaves que poderiam causar danos se vazassem: sem limite de gastos, sem validade, sem uso há 90 dias ou mais, ou utilizáveis de qualquer endereço IP.

Para automação, como um script que cria chaves ou lê o uso, use uma chave de gerenciamento de Configurações → Chaves de gerenciamento. Chaves de gerenciamento não podem enviar solicitações a modelos. Escolha um modelo: Leitura, Escrita (sem exclusão) ou Todos, ou escolha só os recursos de que você precisa. Uma chave de gerenciamento nunca pode fazer mais do que a função da pessoa por trás dela permite.

Para substituir uma chave, selecione Rotacionar. O Phaseo cria uma substituta com os mesmos limites e deixa você escolher quando a chave atual expira: imediatamente, em 1 hora, 24 horas ou 7 dias, em um horário que você escolher, ou nunca. Passe os seus apps para a chave nova antes que a antiga expire. Você também pode pausar uma chave e retomá-la depois, ou excluí-la de vez. Uma chave revogada não pode ser reativada.

Confira o que você aprendeu

A sua equipe quer um script noturno que cria e exclui chaves de API. Qual credencial ele deve usar?

Aplique

Um desenvolvedor conta que a chave de API de produção foi enviada para um repositório público há uma hora. O que você faz?

Mostrar a resposta

Rotacione a chave na hora e escolha expirar a chave atual imediatamente. Coloque o novo segredo no seu gerenciador de segredos e atualize o app. Depois confira as solicitações da chave em Configurações → Registros em busca de algo que você não reconheça. Primeiro rotacione, depois investigue.

Resumo

Uma chave por app e por ambiente, cada uma com limite de gastos, deixa os vazamentos pequenos e a rotação tranquila.

Links relacionados

O progresso fica salvo neste navegador.

Verificado em 17 de novembro de 2026