Coletar logs de eventos do Palo Alto Cortex XDR
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
- Faça login no console Google Cloud .
Acesse a página Buckets do Cloud Storage.
Clique em Criar.
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:
Na seção Começar, faça o seguinte:
- Insira um nome exclusivo que atenda aos requisitos de nome de bucket (por exemplo, cortex-xdr-events-secops).
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.
Para adicionar um rótulo de bucket, clique na seta de expansão para abrir a seção Rótulos.
Clique em Adicionar rótulo e especifique uma chave e um valor para o rótulo.
Na seção Escolha onde armazenar seus dados, faça o seguinte:
- Selecione um tipo de local.
Use o menu do tipo de local para selecionar um Local em que os dados de objetos no bucket serão armazenados permanentemente.
Para configurar a replicação entre buckets, abra a seção Configurar a replicação entre buckets.
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.
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.
Na seção Escolha como proteger os dados do objeto, faça o seguinte:
- Selecione qualquer uma das opções em Proteção de dados que você quer definir para o bucket.
- 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.
Clique em Criar.
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:
- Na lista Buckets do Cloud Storage, clique no nome do seu bucket.
- Selecione a guia Ciclo de vida e clique em Adicionar uma regra.
- Na seção Selecionar uma ação, escolha Excluir objeto.
- Na seção Selecionar condições do objeto, selecione Idade e defina o
valor como
7dias. - Clique em Salvar.
Configurar o encaminhamento de eventos do Cortex XDR
- Faça login na UI da Web do Cortex XDR.
- Acesse Configurações > Configurações > Gerenciamento de dados > Encaminhamento de eventos.
- Ative as licenças na seção Ativação.
- Ative o encaminhamento de eventos por GB para exportar registros analisados do Cortex XDR Pro por GB para um SIEM externo para armazenamento.
- Ative o Encaminhamento de eventos de endpoints para exportar dados brutos de endpoints para o Cortex XDR Pro EP e o Cloud Endpoints.
- Salve a seleção.
- Copie o caminho de armazenamento exibido.
- Gere e faça o download do JSON Web Token da conta de serviço, que contém a chave de acesso.
- Salve em um local seguro.
Configurar o Google Cloud Secret Manager
- Faça login no GCP.
- Acesse a página do Secret Manager.
- Se esta for sua primeira vez, será necessário Ativar a API Secret Manager.
- 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:
- 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.
- No campo Nome do feed, insira um nome para o feed (por exemplo, Logs de eventos do PANW Cortex XDR).
- Selecione Google Cloud Storage V2 como o Tipo de origem.
- Selecione Eventos do Palo Alto Cortex XDR como o Tipo de registro.
- Clique em Get Service Account como a Chronicle Service Account.
- Clique em Próxima.
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.
- URI do bucket de armazenamento: Google Cloud URL do bucket de armazenamento (por exemplo,
Clique em Próxima.
Revise a configuração do novo feed na tela Finalizar e clique em Enviar.
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.
Selecione Desativar feed.
Configurar o acesso JSON do Secret ao Cloud Storage
- Faça login no GCP.
- Acesse a página do Secret Manager.
- Selecione o secret EVENT_FRWD_CRTX_KEY.
- Acesse a guia Permissões.
- 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
- Acesse IAM e administrador > IAM.
- Localize a conta de serviço do Chronicle.
- 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
- No Google Cloud, acesse APIs e serviços > Biblioteca.
- Ative as APIs Cloud Run e Artifact Registry.
- Abra o Cloud Shell clicando no ícone na barra de navegação superior.
Faça o download de um código personalizado usando o seguinte comando:
git clone https://github.com/PaloAltoNetworks/google-cloud-cortex-chronicle.gitAcesse o diretório executando o seguinte comando:
cd google-cloud-cortex-chronicle/Abra o arquivo
env.propertiescom um editor como ovi.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=30Forneça as permissões necessárias ao script
deploy.sh:chmod 744 deploy.shExecute o script
deploy.sh:./deploy.shIdentifique a conta de serviço do Cloud Job usada na saída do script.
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).
Acesse Secret Manager > EVENT_FRWD_CRTX_KEY (secret) > Permissões.
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.