Todos os produtos
Search
Central de documentação

Key Management Service:Consultar registros de uso de chaves e segredos

Última atualização: Sep 09, 2026

O Key Management Service (KMS) integra-se ao ActionTrail e ao Simple Log Service para registrar eventos gerados durante o uso das suas chaves e segredos. Esses registros são úteis para solução de problemas, monitoramento de segurança e auditoria. Este tópico descreve como consultar os registros de uso das suas chaves e segredos.

Informações básicas

Os eventos de chaves e segredos dividem-se em dois tipos: operação de gerenciamento e operação criptográfica. Uma operação de gerenciamento inclui criar ou excluir uma chave, criar ou excluir um segredo e modificar um alias de chave. Já uma operação criptográfica abrange o uso de uma chave para criptografia ou descriptografia e a recuperação do valor de um segredo. O método de consulta varia conforme o tipo de evento e o seu caso de uso.

Chaves e segredos em uma instância do KMS

Tipo de recurso

Tipo de evento

Método de consulta

Chave

Operação de gerenciamento

ActionTrail

Operação criptográfica

  • Criptografia no lado do servidor com serviços cloud: ActionTrail

  • Criptografia em aplicações personalizadas: Simple Log Service

Segredo

Operação de gerenciamento

ActionTrail

Operação criptográfica (recuperação do valor de um segredo)

  • Recuperação do valor de um segredo via endpoint de service do KMS: ActionTrail ou Simple Log Service

  • Recuperação do valor de um segredo via endpoint de instância do KMS: Simple Log Service

Chaves e segredos fora de instância

As chaves que não estão em uma instância do KMS são chamadas de chaves padrão. Versões mais antigas do KMS permitiam criar segredos sem a compra de uma instância. Esse recurso não é mais suportado.

Tipo de recurso

Tipo de evento

Método de consulta

Chave

Operação de gerenciamento

ActionTrail

Operação criptográfica

ActionTrail

Segredo

Operação de gerenciamento

ActionTrail

Operação criptográfica (recuperação do valor de um segredo)

ActionTrail ou Simple Log Service

Nota

A recuperação do valor do segredo só é possível por meio de um endpoint de service do KMS.

Observações de uso

Ao consultar eventos relacionados a chaves, utilize o ActionTrail para obter registros de chaves em qualquer status. O Simple Log Service, por sua vez, consulta apenas registros de chaves com status habilitado.

Consultar eventos com o ActionTrail

É possível consultar eventos nas páginas Event Query e Advanced Query do console do ActionTrail. Para visualizar a lista de eventos auditáveis no Key Management Service, consulte Auditable events for Key Management Service.

  • Event Query: Permite consultar eventos dos últimos 90 dias. O ActionTrail oferece esse recurso sem custo adicional.

  • Advanced Event Query: Requer a criação prévia de uma trilha e a entrega de eventos ao Simple Log Service (SLS). A consulta abrange apenas eventos ocorridos após a criação da trilha. Para mais detalhes, veja Overview of single-account trails e Overview of multi-account trails. Caso precise consultar eventos dos 90 dias anteriores à criação da trilha, crie uma Create a historical event delivery task.

    Nota

    Há cobrança pelo armazenamento de eventos no SLS quando você cria uma trilha para entregar eventos nesse serviço.

Método 1: Usar a página Event Query

  1. Faça login no console do ActionTrail.

  2. No painel de navegação à esquerda, clique em Events > Event Query.

  3. Selecione Resource Name, insira o ID da chave ou do segredo, escolha um intervalo de tempo e clique no ícone image.png.

  4. Localize o evento desejado e clique em View Event Details na coluna Actions.

Método 2: Usar a página Advanced Event Query

  1. Faça login no console do ActionTrail.

  2. No painel de navegação à esquerda, clique em Events > Advanced Event Query.

  3. Selecione o nome de uma trilha, desative o Simple Mode no canto superior direito e insira uma instrução de consulta.

    Use os exemplos de instruções de consulta abaixo:

    • Consultar eventos de uma chave específica: * AND (event.serviceName: "Kms") AND (event.eventRW: "Read") AND "key-szz63dc8c429ermur****". Substitua key-szz63dc8c429ermur**** pelo ID real da chave.

    • Consultar eventos de uma chave desabilitada: * AND (event.serviceName: "Kms") AND (event.errorCode:"Rejected.Disabled").

    • Consultar eventos de uma chave com status Pending Deletion: * AND (event.serviceName: "Kms") AND (event.errorCode:"Rejected.PendingDeletion").

    • Consultar eventos de chaves em uma instância expirada: * AND (event.serviceName: "Kms") AND (event.errorCode:"Rejected.Unavailable").

      Nota

      Para mais códigos de erro relacionados ao status de chaves, consulte Common error codes.

    • Consultar eventos de um segredo específico: * AND (event.serviceName: "Kms") AND (event.eventName: "GetSecretValue") AND "SecretName". Substitua SecretName pelo nome real do segredo.

  4. Localize o evento desejado e clique em View Event Details na coluna Actions.

Consultar eventos com o Simple Log Service

  1. Faça login no console do KMS. Na barra de navegação superior, selecione uma região. No painel de navegação à esquerda, clique em Security Operations > Simple Log Service for KMS.

  2. Na página Simple Log Service for KMS, selecione um ID de instância e insira o ID da chave ou do segredo no campo Key/Secret ID.

  3. Defina um intervalo de tempo e clique em Search & Analyze.

    Nota
    • Os logs ficam retidos por 180 dias. Registros mais antigos são excluídos automaticamente. Portanto, as consultas abrangem apenas os últimos 180 dias.

    • Os resultados da consulta podem apresentar uma variação de até 1 minuto em relação ao intervalo de tempo especificado.

    • Essas operações de consulta e análise são gratuitas.

Documentos relacionados