Skip to main content

Investigação de vazamento de chave de API

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

Prossiga na seguinte ordem:
Suspected leak
  ├─ Step 1: locate the key and immediately reset or delete it (containment)
  ├─ Step 2: identify anomalous periods from usage and cost curves
  ├─ Step 3: confirm call sources and behavior in audit logs (input and output available if inference logs were enabled)
  ├─ Step 4: review management operations such as key creation and deletion
  └─ Step 5: summarize the damage, rotate credentials, and fix the leak source

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.
Esta página mostra as informações de identidade da chave: ID da chave, chave de API mascarada (por exemplo, sk-ws-H.YHXL****PgonKozeC4RM-Nm), descrição, conta proprietária e data de criação. A descrição e a conta proprietária são as primeiras pistas para identificar a aplicação ou o responsável pela chave; o texto completo normalmente não pode ser visualizado: as novas chaves são exibidas por completo apenas uma vez, no momento da criação, enquanto algumas chaves antigas ainda podem ser copiadas diretamente da lista, conforme os recursos que a lista realmente oferece. Durante a investigação, use o valor mascarado, o ID e a descrição para comparação.
Excluir uma chave não cancela as tarefas assíncronas já associadas: tarefas não concluídas continuam em execução e gerando custos, e devem ser encerradas separadamente; consulte Cobrança de tarefas assíncronas em atraso. Durante a investigação, você também pode habilitar para a chave a opção "parar imediatamente quando o orçamento for atingido" como segunda medida de contenção; consulte Gerenciamento de orçamento.
Atenção a dois erros comuns durante o tratamento:
  1. Apenas criar uma nova chave não invalida automaticamente a chave antiga; a chave antiga deve ser tratada separadamente.
  2. 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.
Para as definições das métricas e os detalhes de operação, consulte Visualizar o uso de modelos. Descarte primeiro as flutuações normais do negócio: compare o horário anômalo, os modelos e o volume de chamadas com lançamentos, processamentos em lote, testes de carga e tarefas agendadas do negócio, e verifique se houve mudanças na região de implantação, nos IPs de saída ou nas ferramentas de terceiros que usam a chave. IPs estrangeiros, IPs novos e picos de uso são sinais que exigem verificação, não provas conclusivas de vazamento. Calibre a intensidade do tratamento ao nível de suspeita: diante de apenas uma notificação de alerta ou de uma anomalia leve, confirme primeiro as origens das chamadas nos logs de auditoria; assim que a curva de uso confirmar chamadas de origens desconhecidas, redefina ou exclua a chave imediatamente antes de continuar a coleta de evidências. Tome o momento da confirmação do vazamento como ponto final e analise os 7 dias anteriores (granularidade horária) e os 31 dias anteriores (granularidade diária) para comparar a linha de base histórica da chave; a janela de tempo anômala identificada define o escopo da investigação posterior nos logs.

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.
Para o método de uso, consulte Logs.

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.
Confirme primeiro o status da chave e o histórico de operações pelo ActionTrail e, depois, investigue o comportamento específico com os logs de chamadas.

Etapa 5: Avaliação de danos, coleta de evidências e recuperação

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
Antes que os custos anômalos sejam totalmente esclarecidos, não simplesmente aumente o orçamento nem retome as chamadas após desligar as configurações de contenção; conclua primeiro a investigação acima para confirmar que a origem do vazamento foi corrigida.

Perguntas frequentes

A detecção e a notificação envolvem intervalos de tempo, e o momento da notificação, sozinho, não indica se a anomalia ainda está em curso; eventos históricos também podem só ser descobertos e notificados em revisões posteriores. Receber uma notificação não significa que a chave antiga ainda consiga chamar com sucesso: se a chave antiga foi tratada e o uso recente está normal, verifique o horário da chamada e o identificador da chave indicados na notificação e ignore-a.
A repetição, sozinha, não confirma um vazamento. Verifique o horário da chamada, o identificador da chave e os detalhes da anomalia de cada alerta para distinguir chamadas novas, notificações repetidas do mesmo evento e registros históricos.
A detecção e os alertas de riscos da plataforma são capacidades oferecidas proativamente pela plataforma; não estão dentro do escopo de serviços acordado no SLA e, devido à complexidade dos cenários de risco, não há compromisso de cobertura absoluta dos alertas; a guarda segura e o uso em conformidade das credenciais são de sua responsabilidade. Não receber um alerta não significa que não há risco de vazamento: conclua primeiro a investigação e o tratamento da chave suspeita de vazamento seguindo as etapas deste documento e, em seguida, verifique a razão da não entrega do alerta combinando o período anômalo com os registros de notificação.
Não. Uma chave nova é exibida por completo apenas uma vez, no momento da criação, e depois não pode mais ser visualizada nem copiada (algumas chaves antigas ainda podem ser copiadas diretamente da lista, conforme os recursos que a lista realmente oferece).
Os logs de inferência valem apenas para dados futuros; dados históricos não podem ser recuperados. As chamadas anteriores só podem ser investigadas pelas informações em nível de campo dos logs de auditoria.
O uso de tokens e os custos têm atraso de cerca de 10 minutos; além disso, a página de uso contabiliza apenas chamadas pay-as-you-go cobradas por token, excluindo treinamento de modelos e throughput pré-provisionado (PTU). O número de falhas e os erros de limitação podem ser vistos na página de monitoramento de modelos.
Ambos retornam 429. A mensagem de erro de orçamento esgotado diz "O orçamento configurado no Gerenciamento de orçamento foi esgotado..."; consulte Códigos de erro. Um 429 de limitação é acionado por limites de taxa ou de cota; distinga-os com a métrica de número de erros de limitação no monitoramento de modelos.
Para análises próprias, entregue os logs ao seu próprio repositório de logs do SLS e faça a pesquisa e a exportação por lá; consulte Entrega de dados.
São credenciais diferentes: uma chave de API do Model Studio acessa apenas os serviços de modelo dentro do seu escopo de autorização; uma AccessKey da Alibaba Cloud autentica chamadas de API de nuvem, com permissões determinadas pela conta e pela configuração de autorização. Confirme primeiro o tipo de credencial vazada e, depois, acesse a entrada de gerenciamento do produto correspondente; não misture os processos.