Como investigar um vazamento suspeito de chave de API: localize e trate a chave vazada para conter as perdas, identifique períodos anômalos pelo uso e pelos custos, confirme o comportamento das chamadas com logs de auditoria e de inferência, verifique as operações de gerenciamento no ActionTrail e conclua a avaliação de danos, a coleta de evidências e a recuperação por rotação.
Abordagem da investigação
Se o vazamento estiver confirmado, acesse primeiro a página de gerenciamento de chaves de API para redefinir ou excluir a chave vazada e conter as perdas imediatamente; em seguida, siga as etapas desta página para avaliar o impacto. Se o vazamento ainda for incerto, comece pela verificação de uso da etapa 2.
Uma investigação de vazamento precisa responder a cinco perguntas, cada uma mapeada a uma fonte de informação do console:
Pergunta a responder | Onde consultar | O que você obtém |
|---|---|---|
Qual chave vazou? Quem a criou? Qual é o status atual? | Página de gerenciamento de chaves de API | ID da chave, chave mascarada, descrição, conta proprietária, data de criação; ações de redefinir, editar, excluir e visualizar custos |
Quanto essa chave foi chamada e quanto custou? | Uso de modelos, visão geral de custos e faturas | Número de chamadas, uso de tokens, curvas de uso com granularidade diária e valores agrupados por chave de API |
De onde vieram as chamadas, quais modelos foram chamados e se tiveram sucesso? | Logs de auditoria | Request ID, data e hora, modelo, uso de tokens, latência, código de status e código de erro; filtrável por chave de API |
Qual foi a entrada e a saída das chamadas? | Logs de inferência (devem ser habilitados previamente) | Prompts e respostas completos (até 128K) |
Quais operações de gerenciamento essa chave já passou? | ActionTrail | Registros de eventos de operação nos níveis do console e da OpenAPI |
Etapa 1: Localize e trate a chave vazada
Acesse a página de API Key do Alibaba Cloud Model Studio e selecione a região no canto superior direito: as chaves são independentes por região e não podem ser usadas entre regiões.
Com o vazamento confirmado, priorize redefinir ou excluir a chave para conter as perdas imediatamente; editar para restringir permissões só se encaixa em cenários em que o vazamento não pode ser confirmado e é necessária uma janela de observação. Localize a chave na lista de chaves de API e use as ações na coluna de operações:
- Redefinir: emite um novo valor para a chave, e o valor antigo deixa de funcionar imediatamente.
- Editar: restringe permissões (lista de permissões de IP, escopo de modelos); consulte Melhores práticas de prevenção de vazamento de chave de API.
- Excluir: entra em vigor imediatamente e é irreversível.
- Visualizar custos: leva à visão de custos e uso da chave.
- Apenas criar uma nova chave não invalida automaticamente a chave antiga; a chave antiga deve ser tratada separadamente.
- Não coloque a nova chave de volta em um ambiente que ainda não terminou de ser investigado; caso contrário, você estará entregando a nova credencial outra vez.
Etapa 2: Verifique o uso e os custos para identificar o período anômalo
O sinal mais direto de um vazamento é volume de chamadas ou custos que não deveriam existir. No console do Model Studio, escolha Custo e Uso > Uso de Modelos, defina a dimensão de agrupamento como API Key e compare o uso de cada chave para identificar de relance a anômala:
- Granularidade temporal: minuto (até 1 dia), hora (até 7 dias), dia (até 31 dias) e mês (até 12 meses); use a granularidade horária para localizar chamadas repentinas de alto custo.
- Atraso dos dados: o número de chamadas tem atraso inferior a 1 minuto, e o uso de tokens e os custos, de cerca de 10 minutos; abusos recentes podem aparecer mais tarde, portanto não descarte a suspeita apenas porque ainda não há dados.
- As linhas de detalhe oferecem Visualizar custos para os valores associados; para a visão geral de custos e a conferência das faturas, consulte Visualizar visão geral de custos e Consultar faturas.
Etapa 3: Verifique os logs de chamadas para confirmar o comportamento
Os logs de chamadas do Model Studio se dividem em duas categorias, logs de auditoria e logs de inferência, com limites de capacidade diferentes; distinga-as durante a investigação.
Logs de auditoria
Os logs de auditoria são habilitados por padrão e armazenados no lado da plataforma, sem necessidade de configuração, sendo a principal ferramenta da investigação; visualize-os na página de monitoramento de modelos:
- Campos registrados: Request ID, data e hora, modelo, uso de tokens, latência, status e código de erro, mas não o conteúdo de entrada e saída.
- Filtragem e pesquisa: filtre por período (até 30 dias), modelo, ID de chave de API, status e tipo de inferência, ou pesquise por Request ID.
- Finalidade: confirmar se as chamadas da chave dentro da janela do vazamento correspondem ao comportamento esperado, como grandes volumes de 4xx/5xx, ritmos de chamada anômalos ou registros de chamadas a modelos desconhecidos.
Logs de inferência
Os logs de inferência contêm prompts e respostas completos, além das etapas intermediárias (até 128K). Eles devem ser habilitados previamente em entrega de dados e entregues ao seu próprio serviço de logs (SLS; a habilitação envolve autorização de produto em nuvem e custos do serviço de logs), e valem apenas para dados futuros: chamadas históricas anteriores à habilitação não podem ser recuperadas, e logs gerados com a entrega desligada não são reprocessados. Para o método de habilitação e a disponibilidade por região, consulte Habilitar logs de inferência. Sem logs de inferência habilitados, as chamadas anteriores só podem ser investigadas pelas informações em nível de campo dos logs de auditoria.
Limites do rastreamento
A plataforma pode ajudar a verificar comportamentos anômalos com base nos logs de chamadas, mas o IP, o modelo e as informações de horário das chamadas geralmente não bastam para confirmar diretamente o usuário real ou o canal original do vazamento; o rastreamento adicional exige evidências dos seus repositórios de código, servidores, terminais e serviços de terceiros. A entrega de uma investigação é uma cadeia de evidências e uma avaliação de impacto, não uma conclusão de responsabilidade; em caso de atividades ilegais, preserve as evidências conforme a lei e trate delas pelos canais adequados.
Etapa 4: Verifique o histórico de operações de gerenciamento
As operações de ciclo de vida das chaves de API, como criação e exclusão, são agregadas no ActionTrail da Alibaba Cloud. Acesse a página de consulta de eventos do console do ActionTrail e filtre por serviço (Model Studio) e intervalo de tempo:
- Localize os eventos de criação da chave para confirmar quem a criou e quando, e verificar a responsabilidade.
- Localize os eventos de exclusão da chave para confirmar se alguém excluiu chaves ao redor da janela do vazamento, por exemplo um invasor ou alguém interno tentando apagar rastros.
Etapa 5: Avaliação de danos, coleta de evidências e recuperação
- Calcule os danos: combine a janela anômala (curvas de uso), as origens e os status das chamadas (logs de auditoria) e os valores (faturas) em uma conclusão de impacto.
- Defina o escopo do impacto: avalie pelo escopo de autorização da chave. Ter uma chave de API do Model Studio não equivale a ter a senha da conta ou permissões sobre todos os recursos de nuvem; o impacto real limita-se ao escopo de chamadas autorizado da chave. Observe que uma chave de API do Model Studio e uma AccessKey (AK) da Alibaba Cloud são credenciais diferentes: se o que vazou foi uma AK, siga o processo de tratamento de AK do RAM.
- Preserve evidências mascaradas: ao salvar capturas de tela e listas de Request IDs, mascare os valores das chaves e os IDs de conta e pare de divulgar a chave completa em qualquer canal.
- Verifique as tarefas assíncronas: excluir uma chave não cancela as tarefas assíncronas já enviadas; encerre as tarefas canceláveis e acompanhe os custos das não canceláveis.
- Determine o escopo da rotação: invalid e substitua o quanto antes as chaves com vazamento confirmado; para as demais, julgue pelo escopo de exposição e faça em conjunto a rotação das chaves armazenadas no mesmo ambiente exposto.
- Ordem de recuperação: depois de corrigir a origem do vazamento com a lista de locais de alto risco, crie uma nova chave em um ambiente confiável com permissões e orçamento reconfigurados, atualize as referências de credenciais nos serviços, tarefas e integrações de terceiros, confirme que a nova chave funciona e, por fim, verifique que a chave antiga está inválida.
Perguntas frequentes
A chave vazada já foi excluída. Por que continuo recebendo alertas?
A chave vazada já foi excluída. Por que continuo recebendo alertas?
A mesma chave dispara alertas repetidamente. Isso confirma um vazamento?
A mesma chave dispara alertas repetidamente. Isso confirma um vazamento?
Ocorreu um vazamento, mas não recebi o alerta da plataforma. Por que?
Ocorreu um vazamento, mas não recebi o alerta da plataforma. Por que?
Por que não consigo ver a chave completa no console? O suporte pode recuperar o texto claro?
Por que não consigo ver a chave completa no console? O suporte pode recuperar o texto claro?
Acabei de habilitar os logs de inferência. Por que não encontro as entradas e saídas de ontem?
Acabei de habilitar os logs de inferência. Por que não encontro as entradas e saídas de ontem?
Os dados da página de uso não correspondem às chamadas reais?
Os dados da página de uso não correspondem às chamadas reais?
As chamadas retornam 429. É limitação de taxa ou parada por orçamento?
As chamadas retornam 429. É limitação de taxa ou parada por orçamento?
Posso exportar os logs em lote para minha própria análise?
Posso exportar os logs em lote para minha própria análise?
Como saber se a credencial vazada é uma chave de API do Model Studio ou uma AccessKey da Alibaba Cloud?
Como saber se a credencial vazada é uma chave de API do Model Studio ou uma AccessKey da Alibaba Cloud?