Coletar registros do AWS Inspector
Versão do analisador: 1.0
Neste documento, explicamos como ingerir registros do AWS Inspector no Google Security Operations usando o Amazon S3.
O Amazon Inspector é um serviço gerenciado de gestão de vulnerabilidades que descobre automaticamente as cargas de trabalho e as verifica continuamente em busca de vulnerabilidades de software e exposição não intencional à rede. Ele verifica instâncias do Amazon EC2, imagens de contêiner no Amazon ECR e funções do AWS Lambda, produzindo descobertas detalhadas com pontuações de gravidade e recomendações de correção. Essa integração usa o recurso de exportação de descobertas integrado do Amazon Inspector para enviar relatórios de descobertas em formato JSON para um bucket do S3, que o Google SecOps ingere usando um feed do Amazon S3 V2.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps
- Acesso privilegiado ao Console de Gerenciamento da AWS com permissões para gerenciar:
- Amazon Inspector (descobertas, relatórios)
- Amazon S3 (buckets, políticas de bucket)
- AWS KMS (políticas de chave)
- IAM da AWS (papéis, políticas, usuários)
Configurar um bucket do S3 para exportações de descobertas do Amazon Inspector
O Amazon Inspector criptografa os relatórios de descobertas com uma chave do AWS KMS antes de armazená-los em um bucket do S3. É necessário configurar a política do bucket do S3 e a política de chave do KMS para permitir o acesso do Amazon Inspector.
Criar e configurar o bucket do S3
- Crie um bucket do Amazon S3 seguindo este guia do usuário: Como criar um bucket.
Salve o Nome e a Região do bucket para referência futura (por exemplo,
inspector-findings-to-secops).Selecione o bucket criado no console do Amazon S3 em https://console.aws.amazon.com/s3.
Selecione a guia Permissões.
Na seção Política do bucket, clique em Editar.
Adicione a seguinte instrução à política do bucket (substitua
inspector-findings-to-secopspelo nome do bucket,111122223333pelo ID da conta da AWS eus-east-1pela região da AWS):{ "Version": "2012-10-17", "Statement": [ { "Sid": "allow-inspector", "Effect": "Allow", "Principal": { "Service": "inspector2.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:AbortMultipartUpload" ], "Resource": "arn:aws:s3:::inspector-findings-to-secops/*", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:inspector2:us-east-1:111122223333:report/*" } } } ] }Clique em Salvar alterações.
Configurar uma chave KMS da AWS
O Amazon Inspector requer uma chave de criptografia simétrica do AWS KMS gerenciada pelo cliente na mesma região do bucket do S3 para criptografar relatórios de descobertas.
- Abra o console do AWS KMS em https://console.aws.amazon.com/kms.
- No painel de navegação, selecione Chaves gerenciadas pelo cliente.
- Selecione a chave do KMS que você quer usar (ou crie uma nova chave de criptografia simétrica).
- Selecione a guia Política de chaves e clique em Editar.
Adicione a seguinte instrução à política de chaves (substitua
111122223333pelo ID da sua conta da AWS eus-east-1pela sua região da AWS):{ "Sid": "Allow Amazon Inspector to use the key", "Effect": "Allow", "Principal": { "Service": "inspector2.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey*" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:inspector2:us-east-1:111122223333:report/*" } } }Clique em Salvar alterações.
Exportar descobertas do Amazon Inspector para o S3
- Faça login no console do Amazon Inspector em https://console.aws.amazon.com/inspector/v2/home.
- No painel de navegação, acesse Descobertas > Todas as descobertas.
Opcional: use a barra de filtro acima da tabela Descobertas para especificar quais descobertas incluir no relatório.
Clique em Exportar descobertas.
Na seção Configurações de exportação, em Tipo de arquivo de exportação, selecione JSON.
Em Local de exportação, para URI do S3, clique em Procurar S3 e selecione o bucket do S3
inspector-findings-to-secops.Em Chave do KMS, selecione a chave do AWS KMS que você configurou.
Clique em Exportar.
Automatizar a exportação de descobertas usando a CLI da AWS
Para exportar relatórios de descobertas de forma recorrente, use o comando create-findings-report da CLI da AWS. É possível programar esse comando usando o Amazon EventBridge Scheduler ou um cron job.
Exemplo de comando:
aws inspector2 create-findings-report \ --report-format JSON \ --s3-destination bucketName=inspector-findings-to-secops,keyPrefix=findings/,kmsKeyArn=arn:aws:kms:us-east-1:111122223333:key/your-kms-key-id
Para mais informações, consulte a referência da CLI da AWS create-findings-report.
Configurar um usuário do IAM para o Google SecOps
O Google SecOps precisa de um usuário do IAM com acesso de leitura ao bucket do S3 para ingerir as descobertas exportadas.
- Crie um usuário seguindo este guia do usuário: Como criar um usuário do IAM.
- Selecione o Usuário criado.
- Selecione a guia Credenciais de segurança.
- Clique em Criar chave de acesso na seção Chaves de acesso.
- Selecione Serviço de terceiros como Caso de uso.
- Clique em Próxima.
- Opcional: adicione uma tag de descrição.
- Clique em Criar chave de acesso.
- Clique em Fazer o download do arquivo .csv para salvar a chave de acesso e a chave de acesso secreta para referência futura.
- Clique em Concluído.
- Selecione a guia Permissões.
- Clique em Adicionar permissões na seção Políticas de permissões.
- Selecione Adicionar permissões.
- Selecione Anexar políticas diretamente.
- Pesquise a política AmazonS3FullAccess.
- Selecione a política.
- Clique em Próxima.
- Clique em Adicionar permissões
Configurar um feed no Google SecOps para ingerir registros do AWS Inspector
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Na página seguinte, clique em Configurar um único feed.
- Insira um Nome do feed exclusivo.
- Selecione Amazon S3 V2 como o Tipo de origem.
- Selecione AWS Inspector como o Tipo de registro.
- Clique em Próximo e em Enviar.
Especifique valores para os seguintes campos:
- URI do S3:
s3://inspector-findings-to-secops/findings/ - Opção de exclusão da fonte: selecione a opção de exclusão de acordo com sua preferência.
- Idade máxima do arquivo: inclua arquivos modificados nos últimos dias (o padrão é 180 dias).
- ID da chave de acesso: chave de acesso do usuário com acesso ao bucket do S3.
- Chave de acesso secreta: chave secreta do usuário com acesso ao bucket do S3.
- Namespace do recurso: o namespace do recurso
- Rótulos de ingestão: o rótulo que será aplicado aos eventos desse feed.
- URI do S3:
Clique em Próximo e em Enviar.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
duration_ms_label |
additional.fields |
Mesclado |
evnt_app_class_label |
additional.fields |
Mesclado |
evnt_cloud_application_class_label |
additional.fields |
Mesclado |
evnt_cloud_sandbox_md5_label |
additional.fields |
Mesclado |
evnt_cloudapp_rule_label |
additional.fields |
Mesclado |
evnt_content_type_label |
additional.fields |
Mesclado |
evnt_customer_label |
additional.fields |
Mesclado |
evnt_department_label |
additional.fields |
Mesclado |
evnt_location_label |
additional.fields |
Mesclado |
evnt_lpclagg_label |
additional.fields |
Mesclado |
evnt_lpcltype_label |
additional.fields |
Mesclado |
evnt_network_service_label |
additional.fields |
Mesclado |
evnt_tenant_label |
additional.fields |
Mesclado |
evnt_url_category_label |
additional.fields |
Mesclado |
exception_label |
additional.fields |
Mesclado |
function_label |
additional.fields |
Mesclado |
id_label |
additional.fields |
Mesclado |
level_no_label |
additional.fields |
Mesclado |
line_label |
additional.fields |
Mesclado |
location_label |
additional.fields |
Mesclado |
logger_field |
additional.fields |
Mesclado |
msg_location_label |
additional.fields |
Mesclado |
msg_record_functionName_label |
additional.fields |
Mesclado |
msg_record_functionVersion_label |
additional.fields |
Mesclado |
msg_record_initializationType_label |
additional.fields |
Mesclado |
msg_record_instancId_label |
additional.fields |
Mesclado |
msg_record_instanceMaxMemory_label |
additional.fields |
Mesclado |
msg_record_phase_label |
additional.fields |
Mesclado |
msg_service_label |
additional.fields |
Mesclado |
msg_type_label |
additional.fields |
Mesclado |
msg_xray_trace_id_label |
additional.fields |
Mesclado |
protocol_label |
additional.fields |
Mesclado |
record_version_label |
additional.fields |
Mesclado |
repr_label |
additional.fields |
Mesclado |
service_label |
additional.fields |
Mesclado |
sourcetype_label |
additional.fields |
Mesclado |
thread_name_label |
additional.fields |
Mesclado |
type_label |
additional.fields |
Mesclado |
xray_trace_id_label |
additional.fields |
Mesclado |
evnt_device_hostname |
intermediary.hostname |
Mapeado diretamente |
evnt_fwd_method_label |
intermediary.resource.attribute.labels |
Mesclado |
desc_msg |
metadata.description |
Mapeado diretamente |
message |
metadata.description |
Mapeado diretamente |
msg |
metadata.description |
Mapeado diretamente |
msg_desc_msg |
metadata.description |
Mapeado diretamente |
msg_record_desc_msg |
metadata.description |
Mapeado diretamente |
msg_text |
metadata.description |
Mapeado diretamente |
msg.time |
metadata.event_timestamp |
Analisado como ISO8601 |
repr_time |
metadata.event_timestamp |
Analisado como ISO8601 |
timestamp |
metadata.event_timestamp |
Analisado como ISO8601 |
has_host |
metadata.event_type |
Mapeado: true → STATUS_UPDATE |
has_user |
metadata.event_type |
Mapeado: true → USER_COMMUNICATION, true → USER_UNCATEGORIZED |
msg_record_module |
metadata.product_event_type |
Mapeado diretamente |
id_1 |
metadata.product_log_id |
Mapeado diretamente |
evnt_bytes_in |
network.received_bytes |
Mapeado diretamente |
evnt_bytes_out |
network.sent_bytes |
Mapeado diretamente |
evnt_app_name |
principal.application |
Mapeado diretamente |
msg_record_process_name |
principal.application |
Mapeado diretamente |
evnt_device_app_version_label |
principal.asset.attribute.labels |
Mesclado |
evnt_ssl_policy_label |
principal.asset.attribute.labels |
Mesclado |
evnt_server_ip |
principal.asset.ip |
Mesclado |
evnt_src_ip |
principal.asset.ip |
Mesclado |
evnt_src_translated_ip |
principal.asset.ip |
Mesclado |
msg_record_file_path |
principal.file.full_path |
Mapeado diretamente |
msg_record_file_name |
principal.file.names |
Mesclado |
evnt_hostname |
principal.hostname |
Mapeado diretamente |
host |
principal.hostname |
Mapeado diretamente |
evnt_server_ip |
principal.ip |
Mesclado |
evnt_src_ip |
principal.ip |
Mesclado |
evnt_src_translated_ip |
principal.ip |
Mesclado |
evnt_os |
principal.platform |
Mapeado: Windows → WINDOWS, Linux → LINUX |
evnt_src_port |
principal.port |
Mapeado diretamente |
port_number |
principal.port |
Mapeado diretamente |
msg_record_process_id |
principal.process.pid |
Mapeado diretamente |
cmd_status_label |
principal.resource.attribute.labels |
Mesclado |
evnt_format_label |
principal.resource.attribute.labels |
Mesclado |
evnt_os_label |
principal.resource.attribute.labels |
Mesclado |
msg_record_runtimeVersionArn_label |
principal.resource.attribute.labels |
Mesclado |
msg_record_runtimeVersion_label |
principal.resource.attribute.labels |
Mesclado |
record_requestId_labels |
principal.resource.attribute.labels |
Mesclado |
requestId_labels |
principal.resource.attribute.labels |
Mesclado |
msg_record_name |
principal.resource.name |
Mapeado diretamente |
id |
principal.resource.product_object_id |
Mapeado diretamente |
evnt_url |
principal.url |
Mapeado diretamente |
evnt_device_owner |
principal.user.user_display_name |
Mapeado diretamente |
evnt_user |
principal.user.userid |
Mapeado diretamente |
msg_extra_desc_msg_body_account_id |
principal.user.userid |
Mapeado diretamente |
evnt_action |
security_result.action |
Mapeado: allow → security_result_action |
security_result_action |
security_result.action |
Mesclado |
security_result_category_details |
security_result.category_details |
Mesclado |
security_result_url_super_category |
security_result.category_details |
Mesclado |
elapsed_time_label |
security_result.detection_fields |
Mesclado |
evnt_session_count_label |
security_result.detection_fields |
Mesclado |
evnt_ssl_decrypted_label |
security_result.detection_fields |
Mesclado |
evnt_url_class_label |
security_result.detection_fields |
Mesclado |
level_icon_label |
security_result.detection_fields |
Mesclado |
level |
security_result.severity |
Mapeado: INFO → INFORMATIONAL, WARNING → MEDIUM |
msg_level |
security_result.severity |
Mapeado: INFO → INFORMATIONAL, WARNING → MEDIUM |
evnt_dest_ip |
target.ip |
Mesclado |
evnt_dest_country |
target.location.country_or_region |
Mapeado diretamente |
evnt_dest_port |
target.port |
Mapeado diretamente |
dst_url |
target.url |
Mapeado diretamente |
| N/A | metadata.event_type |
Constante: USER_COMMUNICATION |
| N/A | metadata.product_name |
Constante: AWS Inspector |
| N/A | metadata.vendor_name |
Constante: AWS Inspector |
| N/A | network.ip_protocol |
Constante: UDP |
| N/A | principal.platform |
Constante: WINDOWS |
| N/A | security_result.detection_fields |
Constante: client_tunnel_ip_label |
| N/A | security_result.severity |
Constante: INFORMATIONAL |
Registro de alterações
Confira o registro de alterações deste analisador
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.