Coletar logs de eventos do Palo Alto Cortex XDR

Compatível com:

Neste documento, explicamos como ingerir logs de eventos do Palo Alto Cortex XDR no Google Security Operations usando o armazenamento do Google Cloud . O analisador extrai dados de ocorrência de segurança dos registros JSON do Cortex XDR da Palo Alto Networks. Ele normaliza os dados no modelo de dados unificado (UDM) mapeando campos, convertendo tipos de dados e enriquecendo eventos com metadados como fornecedor, produto e tipos de evento com base na lógica condicional vinculada aos campos event_type e event_sub_type. Ele também lida com conexões de rede, operações de arquivos e registros, informações de processos e atividade do usuário.

Antes de começar

Verifique se você tem os pré-requisitos a seguir:

  • Instância do Google SecOps
  • Google Cloud O armazenamento está configurado e ativo no seu ambiente do Google Cloud
  • Acesso privilegiado ao Google Cloud e permissões adequadas
  • Acesso privilegiado ao Palo Alto Cortex XDR

Criar um bucket do Google Cloud Cloud Storage

  1. Faça login no console Google Cloud .
  2. Acesse a página Buckets do Cloud Storage.

    Acessar buckets

  3. Clique em Criar.

  4. Na página Criar um bucket, insira as informações do seu bucket. Após cada uma das etapas a seguir, clique em Continuar para prosseguir para a próxima etapa:

  5. Na seção Começar, faça o seguinte:

    1. Insira um nome exclusivo que atenda aos requisitos de nome de bucket (por exemplo, cortex-xdr-events-secops).
    2. Para ativar o namespace hierárquico, clique na seta de expansão para abrir a seção Otimizar para cargas de trabalho orientadas a arquivos e com uso intensivo de dados e selecione Ativar namespace hierárquico neste bucket.

    3. Para adicionar um rótulo de bucket, clique na seta de expansão para abrir a seção Rótulos.

    4. Clique em Adicionar rótulo e especifique uma chave e um valor para o rótulo.

  6. Na seção Escolha onde armazenar seus dados, faça o seguinte:

    1. Selecione um tipo de local.
    2. Use o menu do tipo de local para selecionar um Local em que os dados de objetos no bucket serão armazenados permanentemente.

    3. Para configurar a replicação entre buckets, abra a seção Configurar a replicação entre buckets.

  7. Na seção Escolha uma classe de armazenamento para seus dados, selecione uma classe de armazenamento padrão para o bucket ou selecione Classe automática para gerenciamento automático da classe de armazenamento dos dados do bucket.

  8. Na seção Escolha como controlar o acesso a objetos, selecione não para aplicar a prevenção de acesso público e selecione um modelo de controle de acesso para os objetos do bucket.

  9. Na seção Escolha como proteger os dados do objeto, faça o seguinte:

    1. Selecione qualquer uma das opções em Proteção de dados que você quer definir para o bucket.
    2. Para escolher como os dados dos objetos serão criptografados, clique na seta de expansão Criptografia de dados e selecione um Método de criptografia de dados.
  10. Clique em Criar.

  11. Configure uma regra de Gerenciamento do ciclo de vida de objetos no bucket de destino recém-criado para excluir objetos após sete dias:

    1. Na lista Buckets do Cloud Storage, clique no nome do seu bucket.
    2. Selecione a guia Ciclo de vida e clique em Adicionar uma regra.
    3. Na seção Selecionar uma ação, escolha Excluir objeto.
    4. Na seção Selecionar condições do objeto, selecione Idade e defina o valor como 7 dias.
    5. Clique em Salvar.

Configurar o encaminhamento de eventos do Cortex XDR

  1. Faça login na UI da Web do Cortex XDR.
  2. Acesse Configurações > Configurações > Gerenciamento de dados > Encaminhamento de eventos.
  3. Ative as licenças na seção Ativação.
  4. Ative o encaminhamento de eventos por GB para exportar registros analisados do Cortex XDR Pro por GB para um SIEM externo para armazenamento.
  5. Ative o Encaminhamento de eventos de endpoints para exportar dados brutos de endpoints para o Cortex XDR Pro EP e o Cloud Endpoints.
  6. Salve a seleção.
  7. Copie o caminho de armazenamento exibido.
  8. Gere e faça o download do JSON Web Token da conta de serviço, que contém a chave de acesso.
  9. Salve em um local seguro.

Configurar o Google Cloud Secret Manager

  1. Faça login no GCP.
  2. Acesse a página do Secret Manager.
  3. Se esta for sua primeira vez, será necessário Ativar a API Secret Manager.
  4. Crie um secret chamado EVENT_FRWD_CRTX_KEY e copie o conteúdo do JSON xdr_sa_key.json que você baixou como o valor do secret.

Configurar feeds

Para configurar um feed, siga estas etapas:

  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. No campo Nome do feed, insira um nome para o feed (por exemplo, Logs de eventos do PANW Cortex XDR).
  5. Selecione Google Cloud Storage V2 como o Tipo de origem.
  6. Selecione Eventos do Palo Alto Cortex XDR como o Tipo de registro.
  7. Clique em Get Service Account como a Chronicle Service Account.
  8. Clique em Próxima.
  9. Especifique valores para os seguintes parâmetros de entrada:

    • URI do bucket de armazenamento: Google Cloud URL do bucket de armazenamento (por exemplo, gs://cortex-xdr-events-secops/). Esse URL precisa terminar com uma barra (/).
    • Opções de exclusão da origem: selecione Não excluir os arquivos transferidos.

    • Idade máxima do arquivo: inclui arquivos modificados nos últimos dias. O padrão é 180 dias.

  10. Clique em Próxima.

  11. Revise a configuração do novo feed na tela Finalizar e clique em Enviar.

  12. Depois que o feed for criado, encontre-o na lista Feeds e clique nos três pontos de ação no lado direito da linha.

  13. Selecione Desativar feed.

Configurar o acesso JSON do Secret ao Cloud Storage

  1. Faça login no GCP.
  2. Acesse a página do Secret Manager.
  3. Selecione o secret EVENT_FRWD_CRTX_KEY.
  4. Acesse a guia Permissões.
  5. Conceda os acessos de Administrador de objetos do Storage e Leitor de bucket legado do Storage ao bucket cortex-xdr-events-secops criado anteriormente.

Configurar permissões do Google SecOps para o Cloud Storage

  1. Acesse IAM e administrador > IAM.
  2. Localize a conta de serviço do Chronicle.
  3. Conceda ao Leitor de objetos do Storage (roles/storage.objectViewer) acesso ao bucket cortex-xdr-events-secops criado anteriormente.

Configurar a ingestão de logs de eventos do PANW Cortex XDR para o Cloud Storage do projeto

  1. No Google Cloud, acesse APIs e serviços > Biblioteca.
  2. Ative as APIs Cloud Run e Artifact Registry.
  3. Abra o Cloud Shell clicando no ícone na barra de navegação superior.
  4. Faça o download de um código personalizado usando o seguinte comando:

    git clone https://github.com/PaloAltoNetworks/google-cloud-cortex-chronicle.git
    
  5. Acesse o diretório executando o seguinte comando:

    cd google-cloud-cortex-chronicle/
    
  6. Abra o arquivo env.properties com um editor como o vi.

  7. Informe os seguintes detalhes de configuração:

    REGION=us-central1 # Update according to your project region
    REPO_NAME=panw-chronicle
    IMAGE_NAME=sync_cortex_bucket
    GCP_PROJECT_ID=chrxxxxxxxxx # Update according to your project ID
    JOB_NAME=cloud-run-job-cortex-data-sync # The Cloud Job name 
    ROJECT_NUMBER=80xxxxx9 # Update according to your project number
    # JOB ENV VARIABLES
    SRC_BUCKET=xdr-us-xxxxx-event-forwarding # Update with the Cortex XDR GCS bucket name
    DEST_BUCKET=cortex-xdr-events-secops # Update with the GCS name of the bucket you created
    SECRET_NAME=EVENT_FRWD_CRTX_KEY # Need to match the secret you created
    JOB_SCHEDULE_MINS=30
    
  8. Forneça as permissões necessárias ao script deploy.sh:

    chmod 744 deploy.sh
    
  9. Execute o script deploy.sh:

    ./deploy.sh
    
  10. Identifique a conta de serviço do Cloud Job usada na saída do script.

  11. Conceda à conta de serviço do job do Cloud a permissão Ancestral do secret do Secret Manager para acessar o secret que você criou antes (como no nosso exemplo, EVENT_FRWD_CRTX_KEY).

  12. Acesse Secret Manager > EVENT_FRWD_CRTX_KEY (secret) > Permissões.

  13. Na plataforma do Google SecOps, acesse Configurações > Gerenciamento de dados > Feeds > Nome do feed de eventos do XDR > Ativar feed.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
action_file_path target.file.full_path Mapeado diretamente
action_file_size target.file.size Mapeado e convertido diretamente em um número inteiro sem sinal
action_local_ip principal.ip Mapeado diretamente e mesclado com outros endereços IP
action_local_port principal.port Mapeado diretamente e convertido em número inteiro
action_module_path target.process.file.full_path Mapeado diretamente
action_network_connection_id network.session_id Mapeado diretamente
action_network_protocol network.ip_protocol Renomeado como protocol_number_src, analisado usando parse_ip_protocol.include e mapeado para network.ip_protocol
action_process_image_command_line target.process.command_line Mapeado diretamente
action_process_image_md5 target.process.file.md5 Mapeado diretamente
action_process_image_path target.process.file.full_path Mapeado diretamente
action_process_image_sha256 target.process.file.sha256 Mapeado diretamente
action_process_os_pid target.process.pid Mapeado diretamente e convertido em string
action_process_user_sid target.user.windows_sid Mapeado diretamente
action_process_username target.user.userid, target.administrative_domain Analisados para domínio e usuário, convertidos em letras minúsculas e mapeados de acordo
action_registry_data target.registry.registry_value_data Mapeado diretamente
action_registry_key_name target.registry.registry_key Mapeado diretamente
action_registry_value_name target.registry.registry_value_name Mapeado diretamente
action_remote_ip target.ip Mapeado diretamente e mesclado com outros endereços IP
action_remote_port target.port Mapeado diretamente e convertido em número inteiro
action_total_download network.received_bytes Mapeado e convertido diretamente em um número inteiro sem sinal
action_total_upload network.sent_bytes Mapeado e convertido diretamente em um número inteiro sem sinal
agent_hostname principal.hostname, observer.hostname Em minúsculas e mapeado
agent_ip_addresses observer.ip Analisado como JSON, dividido em IPs individuais e mesclado
agent_os_sub_type target.platform_version Mapeado diretamente
event_id metadata.product_log_id Mapeado diretamente
event_sub_type metadata.product_event_type Convertido em string e usado para mapeamento condicional de metadata.event_type e metadata.product_event_type
event_timestamp metadata.event_timestamp, timestamp Convertido em string, analisado como carimbo de data/hora UNIX_MS e mapeado
event_type metadata.event_type Convertido em string e usado para mapeamento condicional de metadata.event_type e metadata.product_event_type
os_actor_process_command_line principal.process.command_line Mapeado diretamente
os_actor_process_image_md5 principal.process.file.md5 Mapeado diretamente
os_actor_process_image_path principal.process.file.full_path Mapeado diretamente
os_actor_process_image_sha256 principal.process.file.sha256 Mapeado diretamente
os_actor_process_instance_id principal.process.product_specific_process_id Com o prefixo "PAN:" e mapeado
os_actor_process_os_pid principal.process.pid Convertido em string e mapeado
os_actor_primary_user_sid principal.user.windows_sid Mapeado se começar com "S-" ou "s-"
os_actor_primary_username principal.user.userid, principal.administrative_domain Analisados para domínio e usuário, convertidos em letras minúsculas e mapeados de acordo
_action security_result.action Mesclado com _security_result e depois mapeado
metadata.log_type metadata.log_type Fixado no código como "PAN_CORTEX_XDR_EVENTS"
metadata.product_name metadata.product_name Fixado no código como "Cortex XDR"
metadata.vendor_name metadata.vendor_name Fixado no código como "PAN"
target.platform target.platform Defina como "WINDOWS" se agent_os_sub_type contiver "Windows"
action_user_session_id event.idm.read_only_udm.network.session_id Mapeado do registro de alterações
action_username event.idm.read_only_udm.principal.user.user_display_name Mapeado do registro de alterações
agent_ip_addresses event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip Mapeado do registro de alterações
agent_os_sub_type event.idm.read_only_udm.principal.platform_version Mapeado do registro de alterações
agent_id event.idm.read_only_udm.principal.asset.asset_id e event.idm.read_only_udm.principal.asset_id Mapeado do registro de alterações
agent_os_type event.idm.read_only_udm.principal.platform Mapeado do registro de alterações
action_process_token event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_process_fds event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_process_termination_date event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_process_termination_code event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_network_stats_is_last event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_user_is_local_session event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_user_status event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
event_version event.idm.read_only_udm.metadata.product_version Mapeado do registro de alterações
action_file_previous_file_path event.idm.read_only_udm.principal.file.full_path Mapeado do registro de alterações
agent_interface_map.ipv4 event.idm.read_only_udm.observer.ip Mapeado do registro de alterações
agent_interface_map.mac event.idm.read_only_udm.observer.mac Mapeado do registro de alterações
action_file_last_writer_actor event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_file_device_type event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_file_previous_file_name event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_file_name event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
agent_id event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
agent_version event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
agent_os_type event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
os_actor_thread_thread_id event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_file_type event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_file_prev_type event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
os_actor_process_signature_status event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
os_actor_process_logon_id event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
agent_content_version event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
action_module_image_size event.idm.read_only_udm.target.file.size Mapeado do registro de alterações
action_file_md5 event.idm.read_only_udm.target.file.md5 Mapeado do registro de alterações
action_file_sha256 event.idm.read_only_udm.target.file.sha256 Mapeado do registro de alterações
action_module_md5 target.process.file.md5 Mapeado do registro de alterações
action_module_sha256 target.process.file.sha256 Mapeado do registro de alterações
metadata.event_type GENERIC_EVENT. Mapeado do registro de alterações

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.