Limitações Pré-requisitos Para criar um armazenamento de dados de eventos para itens de configuração Esquema de item de configuração

Criar um armazenamento de dados de eventos para itens de configuração com o console

É possível criar um armazenamento de dados de eventos para incluir itens de configuração do AWS Config e usar o armazenamento de dados de eventos para investigar alterações não compatíveis em seus ambientes de produção. Com um armazenamento de dados de eventos, é possível relacionar regras fora de conformidade a usuários e recursos associados às mudanças. Um item de configuração representa uma visão pontual dos atributos de um recurso compatível da AWS que existe em sua conta. O AWS Config cria um item de configuração sempre que detecta uma alteração em um tipo de recurso que está gravando. O AWS Config também cria itens de configuração quando um snapshot de configuração é capturado.

Você pode usar o AWS Config e o CloudTrail Lake para executar consultas em seus itens de configuração. É possível usar o AWS Config para consultar o estado atual de configuração dos recursos da AWS com base em propriedades de configuração de uma Conta da AWS e Região da AWS ou entre várias contas e regiões. Por outro lado, você pode usar o CloudTrail Lake para consultar diversas fontes de dados, como eventos do CloudTrail, itens de configuração e avaliações de regras. As consultas do CloudTrail Lake abrangem todos os itens de configuração do AWS Config, incluindo configuração de recursos e histórico de conformidade.

A criação de um armazenamento de dados de eventos para itens de configuração não afeta as consultas avançadas existentes do AWS Config e nenhum agregador configurado do AWS Config. Você pode continuar executando consultas avançadas usando o AWS Config, enquanto o AWS Config continua entregando arquivos de histórico para seus buckets do S3.

Armazenamentos de dados de eventos do CloudTrail Lake incorrem em cobranças. Ao criar um armazenamento de dados de eventos, você escolhe a opção de preço que deseja usar para ele. A opção de preço determina o custo para a ingestão e para o armazenamento de eventos, e o período de retenção padrão e máximo para o armazenamento de dados de eventos. Para obter informações sobre preços do CloudTrail e gerenciamento de custos do Lake consulte Preços do AWS CloudTrail e Gerenciar custos do CloudTrail Lake.

Limitações

As limitações a seguir são aplicáveis aos armazenamentos de dados de eventos para itens de configuração.

Não há compatibilidade com itens de configuração personalizados
Não há compatibilidade com filtragem de eventos usando seletores de eventos avançados

Pré-requisitos

Antes de criar seu armazenamento de dados de eventos, configure a gravação do AWS Config para todas as suas contas e regiões. É possível usar o Quick Setup, uma capacidade do AWS Systems Manager, para criar rapidamente um gravador de configuração habilitado pelo AWS Config.

nota

Você será cobrado por uso do serviço quando o AWS Config começar a registrar as configurações. Para obter mais informações sobre precificação, consulte Precificação do AWS Config. Para obter mais informações sobre como gerenciar o gravador de configuração, consulte Managing the Configuration Recorder (Gerenciar o gravador de configurações) no Guia do desenvolvedor do AWS Config.

Além disso, as seguintes ações são recomendadas, mas não são necessárias para criar um armazenamento de dados de eventos.

Configure um bucket do Amazon S3 para receber um snapshot de configuração mediante solicitação e o histórico de configuração. Para obter mais informações sobre snapshots, consulte Managing the Delivery Channel (Gerenciar o canal de entrega) e Delivering Configuration Snapshot to an Amazon S3 Bucket (Entrega de snapshot de configuração para um bucket do Amazon S3) no Guia do desenvolvedor do AWS Config.
Especifique as regras que você deseja que o AWS Config use para avaliar as informações de compatibilidade para os tipos de recursos registrados. Vários dos exemplos de consulta do CloudTrail Lake para AWS Config exigem que o Regras do AWS Config avalie o estado de conformidade de seus recursos da AWS. Para obter mais informações sobre o Regras do AWS Config, consulte Avaliar recursos com o Regras do AWS Config no Guia do desenvolvedor do AWS Config.

Para criar um armazenamento de dados de eventos para itens de configuração

Faça login no Console de gerenciamento da AWS e abra o console do CloudTrail em https://console.aws.amazon.com/cloudtrail/.
No painel de navegação, em Lake, escolha Armazenamentos de dados de eventos.
Selecione Create event data store (Criar armazenamento de dados de eventos).
Na página Configure event data store (Configurar armazenamento de dados de eventos), em General details (Detalhes gerais), insira um nome para o armazenamento de dados de eventos. Um nome é obrigatório.
Escolha a opção de preço que você deseja usar para o armazenamento de dados de eventos. A opção de preço determina o custo para a ingestão e para o armazenamento de eventos, e os períodos de retenção padrão e máximo para o armazenamento de dados de eventos. Para obter mais informações, consulte Preços do AWS CloudTrail e Gerenciar custos do CloudTrail Lake.

As seguintes opções estão disponíveis:
- Preço de retenção extensível de um ano: geralmente recomendado se você espera ingerir menos de 25 TB de dados de eventos por mês e deseja um período de retenção flexível de até 10 anos. Nos primeiros 366 dias (o período de retenção padrão), o armazenamento é incluído sem custo adicional no preço de ingestão. Após 366 dias, a retenção estendida está disponível com preço conforme o uso. Essa é a opção padrão.
  - Período de retenção padrão: 366 dias
  - Período máximo de retenção: 3.653 dias
- Preço de retenção de sete anos: recomendado se você espera ingerir mais de 25 TB de dados de eventos por mês e precisa de um período de retenção de até 7 anos. A retenção está incluída no preço de ingestão sem custo adicional.
  - Período de retenção padrão: 2.557 dias
  - Período máximo de retenção: 2.557 dias
Especifique um período de retenção para o armazenamento de dados de eventos. Os períodos de retenção podem ser entre 7 dias e 3.653 dias (cerca de 10 anos) para a opção de preço de retenção extensível de um ano ou entre 7 dias e 2.557 dias (cerca de sete anos) para a opção de preço de retenção de sete anos.

O CloudTrail Lake determina se um evento deve ser mantido ao verificar se o eventTime do evento está dentro do período de retenção especificado. Por exemplo, se você especificar um período de retenção de 90 dias, o CloudTrail removerá eventos quando o eventTime for superior a 90 dias.
(Opcional) Para ativar a criptografia com o AWS Key Management Service, escolha Usar minha própria AWS KMS key. Escolha New (Novo) para que o sistema crie uma AWS KMS key para você ou escolha Existing (Existente) para usar uma chave existente do KMS. Em Enter KMS alias (Inserir alias do KMS), especifique um alias no formato alias/MyAliasName. O uso da sua própria chave do KMS exige que você edite sua política de chaves do KMS para permitir que os logs do CloudTrail sejam criptografados e descriptografados. Para obter mais informações, consulte Configure as políticas de chaves do AWS KMS para o CloudTrail. O CloudTrail também é compatível com chaves multirregionais do AWS KMS. Para obter mais informações sobre chaves de várias regiões, consulte Usar chaves de várias regiões no Manual do desenvolvedor do AWS Key Management Service.

O uso da sua própria chave do KMS gera custos de criptografia e decodificação do AWS KMS. Após associar um armazenamento de dados de eventos a uma chave do KMS, não será possível remover ou alterar a chave do KMS.

nota
Para habilitar a criptografia do AWS Key Management Service para o armazenamento de dados de eventos de uma organização, é necessário usar uma chave existente do KMS para a conta de gerenciamento.
(Opcional) Se você quiser consultar os dados do seu evento usando o Amazon Athena, escolha Habilitar na federação de consultas do Lake. A federação permite que você visualize os metadados associados ao armazenamento de dados de eventos no Catálogo de Dados do AWS Glue e execute consultas SQL nos dados do evento no Athena. Os metadados da tabela que estão armazenados no Catálogo de Dados do AWS Glue permitem que o mecanismo de consulta do Athena saiba como encontrar, ler e processar os dados que você deseja consultar. Para obter mais informações, consulte Federar um armazenamento de dados de eventos.

Para habilitar a federação de consultas do Lake, escolha Habilitar e faça o seguinte:
1. Escolha se deseja criar um perfil ou usar um perfil do IAM existente. O AWS Lake Formation usa esse perfil para gerenciar permissões para o armazenamento de dados de eventos federados. Quando você cria um novo perfil usando o console do CloudTrail, o CloudTrail cria automaticamente um perfil com as permissões necessárias. Se você escolher um perfil existente, a política do perfil deve fornecer as permissões mínimas necessárias.
2. Se você estiver criando um perfil, insira um nome para identificá-lo.
3. Se você estiver usando um perfil existente, escolha o perfilo que deseja usar. O perfil deve existir em sua conta.
(Opcional) Escolha Habilitar política de recursos para adicionar uma política baseada em recurso ao seu datastore de eventos. As políticas baseadas em recursos permitem que você controle quais entidades principais podem realizar ações no datastore de eventos. Por exemplo, você pode adicionar uma política baseada em recurso que permita que os usuários-raiz de outras contas consultem esse datastore de eventos e visualizem os resultados da consulta. Para obter exemplos de políticas, consulte Exemplos de políticas baseadas em recursos para armazenamentos e dados de eventos.

Uma política baseada em recurso inclui uma ou mais instruções. Cada instrução da política define as entidades principais que têm acesso permitido ou negado ao datastore de eventos, e as ações que as entidades principais podem realizar no recurso de datastore de eventos.

As seguintes ações são compatíveis com políticas baseadas em recursos para datastores de eventos:
- cloudtrail:StartQuery
- cloudtrail:CancelQuery
- cloudtrail:ListQueries
- cloudtrail:DescribeQuery
- cloudtrail:GetQueryResults
- cloudtrail:GenerateQuery
- cloudtrail:GenerateQueryResultsSummary
- cloudtrail:GetEventDataStore
Para datastores de eventos da organização, o CloudTrail cria uma política baseada em recurso padrão que lista as ações que as contas de administrador delegado podem realizar nos datastores de eventos da organização. As permissões dessa política são derivadas das permissões de administrador delegado no AWS Organizations. Essa política é atualizada automaticamente após alterações no datastore de eventos da organização ou na organização (por exemplo, uma conta de administrador delegado do CloudTrail é registrada ou removida).
(Opcional) Na seção Tags, é possível adicionar até 50 pares de chave de tag para ajudar a identificar, classificar e controlar o acesso ao seu armazenamento de dados de eventos. Para obter mais informações sobre como usar políticas do IAM para autorizar o acesso a um armazenamento de dados de eventos com base em tags, consulte Exemplos: negação de acesso para criar ou excluir armazenamentos de dados de eventos com base em tags. Para obter mais informações sobre como usar tags na AWS, consulte Marcação de recursos da AWS no Guia do usuário de marcação de recursos da AWS.
Escolha Próximo.
Na página Escolher eventos, escolha Eventos da AWS e, em seguida, Itens de configuração.
O CloudTrail armazena o recurso de armazenamento de dados de eventos na na qual você o cria. Porém, por padrão os itens de configuração coletados no armazenamento de dados são de todas as regiões da sua conta que têm a gravação habilitada. Opcionalmente, selecione Include only the current region in my event data store (Incluir somente a região atual no armazenamento de dados do meu evento) para incluir somente itens de configuração que sejam capturados na região atual. Se você não escolher essa opção, o armazenamento de dados de eventos incluirá itens de configuração de todas as regiões que estejam com a gravação habilitada.
Para que seu armazenamento de dados de eventos colete itens de configuração de todas as contas em uma organização do AWS Organizations, selecione Enable for all accounts in my organization (Habilitar para todas as contas na minha organização). É necessário estar conectado à conta de gerenciamento da organização ou à conta de administrador delegado para criar um armazenamento de dados de eventos que colete itens de configuração de uma organização.
Selecione Next (Próximo) para revisar suas escolhas.
Na página Review and create (Revisar e criar), revise as suas escolhas. Escolha Edit (Editar) para fazer alterações a uma seção. Quando estiver pronto para criar o armazenamento de dados de eventos, escolha Create event data store (Criar armazenamento de dados de eventos).
O novo armazenamento de dados de eventos está visível na tabela Armazenamentos de dados de eventos na página Armazenamento de dados de eventos.

Deste ponto em diante, o armazenamento de dados de eventos capturará itens de configuração. Os itens de configuração que tenham ocorrido antes de você criar o armazenamento de dados de eventos não estarão no armazenamento de dados de eventos.

Esquema de item de configuração

A tabela a seguir descreve os elementos obrigatórios e opcionais de esquema que correspondem aos elementos dos registros de itens de configuração. O conteúdo de eventData é fornecido por seus itens de configuração; outros campos são fornecidos pelo CloudTrail após a ingestão.

O conteúdo do registro de eventos do CloudTrail é descrito com mais detalhes em O CloudTrail grava conteúdo para eventos de gerenciamento, dados e atividade de rede.

Campos que são fornecidos pelo CloudTrail após a ingestão
Campos que são fornecidos por seus eventos

Campos que são fornecidos pelo CloudTrail após a ingestão
Nome do campo	Tipo de entrada	Requisito	Descrição
eventVersion	string	Obrigatório	A versão do formato de evento da AWS.
eventCategory	string	Obrigatório	A categoria do evento. Para itens de configuração, o valor válido é `ConfigurationItem`.
eventType	string	Obrigatório	O tipo de evento. Para itens de configuração, o valor válido é `AwsConfigurationItem`.
eventID	string	Obrigatório	Um ID exclusivo para um evento.
eventTime	string	Obrigatório	O carimbo de data e hora do evento, em formato `yyyy-MM-DDTHH:mm:ss`, em Universal Coordinated Time (UTC – Tempo universal coordenado).
awsRegion	string	Obrigatório	A Região da AWS para a atribuição de um evento.
recipientAccountId	string	Obrigatório	Representa o ID da Conta da AWS que recebeu esse evento.
addendum	addendum	Opcional	Mostra informações sobre o motivo de adiamento de um evento. Se as informações estiverem ausentes de um evento existente, o bloco de adendo incluirá as informações ausentes e um motivo pelo qual elas estavam ausentes.

Os campos em `eventData` são fornecidos por seus itens de configuração
Nome do campo	Tipo de entrada	Requisito	Descrição
eventData	-	Obrigatório	Os campos em eventData são fornecidos por seus itens de configuração.
configurationItemVersion	string	Opcional	A versão do item de configuração com base em sua origem.
configurationItemCaptureTime	string	Opcional	A hora em que a gravação da configuração foi iniciada.
configurationItemStatus	string	Opcional	O status do item de configuração. Os valores válidos são `OK`, `ResourceDiscovered`, `ResourceNotRecorded`, `ResourceDeleted` e `ResourceDeletedNotRecorded`.
accountId	string	Opcional	O ID de 12 dígitos da Conta da AWS associada ao recurso.
resourceType	string	Opcional	O tipo de recurso do AWS. Para obter mais informações sobre tipos de recursos válidos, consulte ConfigurationItem na Referência da API do AWS Config.
resourceId	string	Opcional	O ID do recurso (p. ex., sg-`xxxxxx`).
resourceName	string	Opcional	O nome personalizado do recurso, se disponível.
arn	string	Opcional	O nome do recurso da Amazon (ARN) associado ao recurso.
awsRegion	string	Opcional	A Região da AWS onde o recurso reside.
availabilityZone	string	Opcional	A zona de disponibilidade associada ao recurso.
resourceCreationTime	string	Opcional	O carimbo de data e hora de criação do recurso.
configuration	JSON	Opcional	A descrição da configuração do recurso.
supplementaryConfiguration	JSON	Opcional	Atributos de configuração que o AWS Config retorna para determinados tipos de recursos visando complementar as informações retornadas para o parâmetro de configuração.
relatedEvents	string	Opcional	Uma lista de IDs de eventos do CloudTrail.
relationships	-	Opcional	A lista de recursos relacionados da AWS.
nome	string	Opcional	O tipo de relacionamento com o recurso relacionado.
resourceType	string	Opcional	O tipo de recurso do recurso relacionado.
resourceId	string	Opcional	O ID do recurso relacionado (p. ex., sg-`xxxxxx`).
resourceName	string	Opcional	O nome personalizado do recurso relacionado, se disponível.
tags	JSON	Opcional	Um mapeamento das tags de valor de chave associadas ao recurso.

O exemplo a seguir mostra a hierarquia dos elementos de esquema que correspondem aos dos registros de itens de configuração.


{
  "eventVersion": String,
  "eventCategory: String,
  "eventType": String,
  "eventID": String,
  "eventTime": String,
  "awsRegion": String,
  "recipientAccountId": String,
  "addendum": Addendum,
  "eventData": {
      "configurationItemVersion": String,
      "configurationItemCaptureTime": String,
      "configurationItemStatus": String,
      "configurationStateId": String,
      "accountId": String,
      "resourceType": String,
      "resourceId": String,
      "resourceName": String,
      "arn": String,
      "awsRegion": String, 
      "availabilityZone": String,
      "resourceCreationTime": String,
      "configuration": {
        JSON,
      },
      "supplementaryConfiguration": {
        JSON,
      },
      "relatedEvents": [
        String
      ],
      "relationships": [
        struct{
          "name" : String,
          "resourceType": String,
          "resourceId": String,
          "resourceName": String
        }
      ],
     "tags": {
       JSON
     }
    }
  }
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar um armazenamento de dados de eventos para eventos do Insights

Criação de um armazenamento de dados de eventos para eventos de fora da AWS