Coletar registros do AWS Inspector

Versão do analisador: 1.0

Compatível com:

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

  1. Crie um bucket do Amazon S3 seguindo este guia do usuário: Como criar um bucket.
  2. Salve o Nome e a Região do bucket para referência futura (por exemplo, inspector-findings-to-secops).

  3. Selecione o bucket criado no console do Amazon S3 em https://console.aws.amazon.com/s3.

  4. Selecione a guia Permissões.

  5. Na seção Política do bucket, clique em Editar.

  6. Adicione a seguinte instrução à política do bucket (substitua inspector-findings-to-secops pelo nome do bucket, 111122223333 pelo ID da conta da AWS e us-east-1 pela 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/*"
                    }
                }
            }
        ]
    }
    
  7. 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.

  1. Abra o console do AWS KMS em https://console.aws.amazon.com/kms.
  2. No painel de navegação, selecione Chaves gerenciadas pelo cliente.
  3. Selecione a chave do KMS que você quer usar (ou crie uma nova chave de criptografia simétrica).
  4. Selecione a guia Política de chaves e clique em Editar.
  5. Adicione a seguinte instrução à política de chaves (substitua 111122223333 pelo ID da sua conta da AWS e us-east-1 pela 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/*"
            }
        }
    }
    
  6. Clique em Salvar alterações.

Exportar descobertas do Amazon Inspector para o S3

  1. Faça login no console do Amazon Inspector em https://console.aws.amazon.com/inspector/v2/home.
  2. No painel de navegação, acesse Descobertas > Todas as descobertas.
  3. Opcional: use a barra de filtro acima da tabela Descobertas para especificar quais descobertas incluir no relatório.

  4. Clique em Exportar descobertas.

  5. Na seção Configurações de exportação, em Tipo de arquivo de exportação, selecione JSON.

  6. Em Local de exportação, para URI do S3, clique em Procurar S3 e selecione o bucket do S3 inspector-findings-to-secops.

  7. Em Chave do KMS, selecione a chave do AWS KMS que você configurou.

  8. 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.

  1. Crie um usuário seguindo este guia do usuário: Como criar um usuário do IAM.
  2. Selecione o Usuário criado.
  3. Selecione a guia Credenciais de segurança.
  4. Clique em Criar chave de acesso na seção Chaves de acesso.
  5. Selecione Serviço de terceiros como Caso de uso.
  6. Clique em Próxima.
    • Opcional: adicione uma tag de descrição.
  7. Clique em Criar chave de acesso.
  8. Clique em Fazer o download do arquivo .csv para salvar a chave de acesso e a chave de acesso secreta para referência futura.
  9. Clique em Concluído.
  10. Selecione a guia Permissões.
  11. Clique em Adicionar permissões na seção Políticas de permissões.
  12. Selecione Adicionar permissões.
  13. Selecione Anexar políticas diretamente.
  14. Pesquise a política AmazonS3FullAccess.
  15. Selecione a política.
  16. Clique em Próxima.
  17. Clique em Adicionar permissões

Configurar um feed no Google SecOps para ingerir registros do AWS Inspector

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em Adicionar novo feed.
  3. Na página seguinte, clique em Configurar um único feed.
  4. Insira um Nome do feed exclusivo.
  5. Selecione Amazon S3 V2 como o Tipo de origem.
  6. Selecione AWS Inspector como o Tipo de registro.
  7. Clique em Próximo e em Enviar.
  8. 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.
  9. 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.