As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Registro em log AWS KMS Chamadas de API com AWS CloudTrail
AWS KMS está integrado com AWS CloudTrail, um serviço que grava todas as chamadas para AWS KMS por usuários, funções e outros AWS serviços. CloudTrail captura todas as chamadas de API para AWS KMS como eventos, incluindo chamadas do AWS KMS console, AWS KMS APIs, CloudFormation modelos, o AWS Command Line Interface (AWS CLI) e Ferramentas da AWS para PowerShell.
CloudTrail registra tudo AWS KMS operações, incluindo operações somente para leitura, como ListAliases e GetKeyRotationStatus, operações que gerenciam chaves KMS, como CreateKey e PutKeyPolicy, e operações criptográficas, como GenerateDataKey e Descriptografar. Ele também registra operações internas que AWS KMS chamadas para você, como DeleteExpiredKeyMaterial, DeleteKey, SynchronizeMultiRegionKey, e RotateKey.
CloudTrail registra todas as operações bem-sucedidas e, em alguns cenários, tentativas de chamadas que falharam, como quando o chamador não tem acesso a um recurso. Cross-account operações em chaves KMS estão logados na conta do chamador e na conta do proprietário da chave KMS. No entanto, contas cruzadas AWS KMS solicitações rejeitadas porque o acesso foi negado são registradas somente na conta do chamador.
Por motivos de segurança, alguns campos são omitidos do AWS KMS entradas de registro, como a Plaintext parâmetro de um Criptografar solicitação e a resposta para GetKeyPolicy ou qualquer operação criptográfica. Para facilitar a busca por CloudTrail entradas de registro para chaves KMS específicas, AWS KMS adiciona o chave ARN da chave KMS afetada para o responseElements campo nas entradas de registro para alguns AWS KMS operações de gerenciamento de chaves, mesmo quando a operação da API não retorna o ARN da chave.
Embora, por padrão, todos AWS KMS as ações são registradas como CloudTrail eventos, você pode excluir AWS KMS ações de um CloudTrail trilha. Para obter detalhes, consulte Excluindo AWS KMS eventos de uma trilha.
Saiba mais:
-
Para CloudTrail exemplos de registros de AWS KMS operações para plataformas atestadas, consulte Monitorar solicitações atestadas.
Tópicos
Descoberta AWS KMS entradas de registro em CloudTrail
Para pesquisar CloudTrail entradas de registro, use o CloudTrail console ou o CloudTrail LookupEvents operação. CloudTrail suporta vários valores de atributos para filtrar sua pesquisa, incluindo nome do evento, nome de usuário e fonte do evento.
Para ajudar você a pesquisar AWS KMS entradas de registro em CloudTrail, AWS KMS preenche o seguinte CloudTrail campos de entrada de registro.
A partir de dezembro de 2022, AWS KMS preenche o Tipo de recurso e Nome do recurso atributos em todas as operações de gerenciamento que alteram uma chave KMS específica. Esses valores de atributos podem ser nulos em versões mais antigas CloudTrail entradas para as seguintes operações: CreateAlias, CreateGrant, DeleteAlias, DeleteImportedKeyMaterial, ImportKeyMaterial, ReplicateKey, RetireGrant, RevokeGrant, UpdateAlias, e UpdatePrimaryRegion.
| Atributo | Valor | Entradas de log |
|---|---|---|
Origem do evento (EventSource) |
kms.amazonaws.com |
Todas as operações. |
Tipo de recurso (ResourceType) |
AWS::KMS::Key |
Operações de gerenciamento que alteram uma chave do KMS específica, como CreateKey e EnableKey, mas não ListKeys. |
Nome do recurso (ResourceName) |
ARN da chave (ou ID da chave e ARN da chave) | Operações de gerenciamento que alteram uma chave do KMS específica, como CreateKey e EnableKey, mas não ListKeys. |
Para ajudá-lo a encontrar entradas de registro para operações de gerenciamento em chaves KMS específicas, AWS KMS
registra a chave ARN da chave KMS afetada no responseElements.keyId elemento da entrada de registro, mesmo quando o AWS KMS A operação da API não retorna o ARN da chave.
Por exemplo, uma chamada bem-sucedida para o DisableKey a operação não retorna nenhum valor na resposta, mas em vez de um valor nulo, o responseElements.keyId valor no DisableKey entrada de registro inclui a chave ARN da chave KMS desativada.
Esse recurso foi adicionado em dezembro de 2022 e afeta o seguinte CloudTrail entradas de registro: CreateAlias, CreateGrant, DeleteAlias, DeleteKey, DisableKey, EnableKey, EnableKeyRotation, ImportKeyMaterial, RotateKey, SynchronizeMultiRegionKey, TagResource, UntagResource, UpdateAlias, e UpdatePrimaryRegion.
Excluindo AWS KMS eventos de uma trilha
Para fornecer um registro do uso e gerenciamento de seus AWS KMS recursos, a maioria AWS KMS os usuários confiam nos eventos em um CloudTrail trilha. A trilha pode ser uma fonte valiosa de dados para auditar eventos críticos, como criar, desativar e excluir AWS KMS keys, alterando a política de chaves e o uso de suas chaves KMS por AWS serviços em seu nome. Em alguns casos, os metadados em um CloudTrail entrada de registro, como a contexto de criptografia em uma operação de criptografia, pode ajudá-lo a evitar ou resolver erros.
No entanto, porque AWS KMS pode gerar um grande número de eventos, AWS CloudTrail permite que você exclua AWS KMS eventos de uma trilha. Essa configuração por trilha exclui todas AWS KMS eventos; você não pode excluir eventos específicos AWS KMS eventos.
Excluindo AWS KMS eventos de um CloudTrail O registro pode obscurecer ações que usam suas chaves KMS. Tenha cuidado ao conceder aos principais a permissão cloudtrail:PutEventSelectors que é necessária para executar essa operação.
Para excluir AWS KMS eventos de uma trilha:
-
Na CloudTrail console, use o Registrar eventos do Serviço de Gerenciamento de Chaves configurando quando você criar uma trilha ou atualizar uma trilha. Para obter instruções, consulte Registrando eventos de gerenciamento com o Console de gerenciamento da AWS na AWS CloudTrail Guia do usuário.
-
Na CloudTrail API, use o PutEventSelectors operação. Adicione o atributo
ExcludeManagementEventSourcesaos seletores de eventos com um valor dekms.amazonaws.com. Para obter um exemplo, consulte Exemplo: Uma trilha que não registra AWS Key Management Service eventos na AWS CloudTrail Guia do usuário.
É possível desativar essa exclusão a qualquer momento alterando a configuração do console ou os seletores de eventos de uma trilha. A trilha então começará a ser gravada AWS KMS eventos. No entanto, ele não pode se recuperar AWS KMS eventos que ocorreram enquanto a exclusão era efetiva.
Quando você exclui AWS KMS eventos usando o console ou a API, o resultado CloudTrail PutEventSelectors A operação da API também está registrada em seu CloudTrail Registros. Se AWS KMS
eventos não aparecem em seu CloudTrail Registros, procure um PutEventSelectors evento com o ExcludeManagementEventSources atributo definido como kms.amazonaws.com.