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 |
| |
Segredo | Operação de gerenciamento | ActionTrail |
Operação criptográfica (recuperação do valor de um segredo) |
|
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.
NotaHá 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
Faça login no console do ActionTrail.
No painel de navegação à esquerda, clique em .
Selecione Resource Name, insira o ID da chave ou do segredo, escolha um intervalo de tempo e clique no ícone
.Localize o evento desejado e clique em View Event Details na coluna Actions.
Método 2: Usar a página Advanced Event Query
Faça login no console do ActionTrail.
No painel de navegação à esquerda, clique em Events > Advanced Event Query.
-
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****". Substituakey-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").NotaPara 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". SubstituaSecretNamepelo nome real do segredo.
Localize o evento desejado e clique em View Event Details na coluna Actions.
Consultar eventos com o Simple Log Service
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 .
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.
-
Defina um intervalo de tempo e clique em Search & Analyze.
NotaOs 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.