Coletar registros do AppLocker do Windows
Este documento explica como ingerir registros do Windows AppLocker no Google Security Operations usando o agente do Bindplane.
O Windows AppLocker é um recurso de controle de aplicativos integrado ao Windows que gera eventos de aplicação de políticas, auditoria e execução de aplicativos. O AppLocker grava esses eventos em quatro canais do log de eventos do Windows em Applications and Services Logs > Microsoft > Windows > AppLocker: EXE and DLL, MSI and Script, Packaged app-Deployment e Packaged app-Execution.
É possível configurar a ingestão usando um dos dois métodos compatíveis:
- Método 1: encaminhamento do NXLog para o agente do BindPlane (recomendado). O NXLog lê os canais do AppLocker em cada endpoint e encaminha os eventos como syslog com um payload JSON para um agente do Bindplane, que os envia ao Google SecOps no tipo de registro
WINDOWS_APPLOCKER. Esse é o formato esperado pelo analisadorWINDOWS_APPLOCKER, que preserva os campos de arquivo e regra do AppLocker. Método 2: leitura do canal direto do agente do BindPlane. O agente do Bindplane em cada endpoint lê os canais do AppLocker de forma nativa e envia o XML bruto do evento do Windows para o Google SecOps no tipo de registro
WINEVTLOG. Não é necessária nenhuma exportação de arquivo ou agente adicional, mas os eventos são analisados pelo analisador genérico de log de eventos do Windows.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps
- Windows Server 2016 ou mais recente, ou Windows 10 ou mais recente, com políticas do AppLocker configuradas
- Acesso de administrador aos endpoints do Windows
- Se estiver executando por trás de um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente do Bindplane.
- Para o Método 1: um host Windows ou Linux para o agente do Bindplane que os endpoints podem acessar na porta TCP 514.
Receber credenciais do Google SecOps para o agente do Bindplane
Para autenticar o agente do Bindplane no Google SecOps, escolha um dos seguintes métodos:
- Novas implantações: use a API Chronicle (opção 1).
- Implantações legadas: continue usando o arquivo de autenticação de ingestão (opção 2) até que a API Ingestion seja desativada em 20 de julho de 2027.
Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)
- Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
- Acesse IAM e administrador > Contas de serviço.
- Clique em Criar conta de serviço.
- Informe os seguintes detalhes de configuração:
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
bindplane-ingest). - Descrição da conta de serviço: insira uma descrição (por exemplo,
Bindplane agent log ingestion).
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
- Clique em Criar e continuar.
- Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
- Clique em Continuar e depois em Concluído.
- Clique na conta de serviço que você criou e acesse a guia Chaves.
- Clique em Adicionar chave > Criar nova chave.
- Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
- Salve o arquivo de chave como
ingestion-auth.jsonno diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.jsonno Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonno Windows) ou atualizecreds_file_pathemconfig.yamlpara corresponder ao caminho em que você o salvou. - Acesse IAM e administrador > Configurações e copie o Número do projeto. Você vai precisar dele para configurar o exportador.
Opção 2: fazer o download do arquivo de autenticação de ingestão (legado)
- Faça login no console do Google SecOps.
- Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
- Faça o download do arquivo de autenticação de ingestão.
- Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.
Receber o ID de cliente do Google SecOps
- Faça login no console do Google SecOps.
- Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
Copie e salve o ID de cliente na seção Detalhes da organização.
Instalar o agente do BindPlane
Instale o agente do Bindplane de acordo com as instruções a seguir. Para o Método 1, instale-o no host que recebe o syslog do NXLog. Para o Método 2, instale-o em todos os endpoints em que você quer coletar eventos do AppLocker.
Instalação do Windows
- Abra o Prompt de comando ou o PowerShell como administrador.
Execute este comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietAguarde a conclusão da instalação.
Execute o seguinte comando para confirmar a instalação:
sc query observiq-otel-collectorO serviço precisa aparecer como RUNNING.
Instalação do Linux
- Abra um terminal com privilégios de raiz ou sudo.
Execute este comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Outros recursos de instalação
Para mais opções de instalação e solução de problemas, consulte o guia de instalação do agente do Bindplane.
Método 1: encaminhamento do NXLog para o agente do BindPlane
Configurar o agente do Bindplane para receber o syslog e enviar ao Google SecOps
Abra o arquivo de configuração no host do agente do BindPlane:
Windows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"Linux:
sudo nano /opt/observiq-otel-collector/config.yamlSubstitua todo o conteúdo de
config.yamlpela seguinte configuração:receivers: tcplog/applocker: listen_address: "0.0.0.0:514" exporters: chronicle/windows_applocker: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/path/to/ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINDOWS_APPLOCKER raw_log_field: body ingestion_labels: env: production service: pipelines: logs/applocker_to_chronicle: receivers: - tcplog/applocker exporters: - chronicle/windows_applockerSubstitua os seguintes marcadores de posição:
listen_address: o endereço IP e a porta que o agente detecta. O0.0.0.0:514aceita syslog em todas as interfaces na porta TCP 514. Use uma porta maior que 1024 no Linux se o agente não for executado como raiz e abra a porta no firewall do host.creds_file_path: caminho completo para o arquivo de chave JSON da conta de serviço (opção 1):- Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json - Linux:
/opt/observiq-otel-collector/ingestion-auth.json
- Windows:
<customer_id>: ID de cliente da seção "Receber o ID de cliente do Google SecOps"location: substitua<LOCATION>pela região da sua instância do Google SecOps (por exemplo,us,europeouasia-southeast1). O exportador prefixachronicle.googleapis.comcom esse valor. Consulte Endpoints regionais para ver a lista completa.project: substitua<PROJECT_NUMBER>pelo número do projeto em IAM e administrador > Configurações.endpoint: mantenha definido comochronicle.googleapis.com.ingestion_labels: rótulos opcionais no formato YAML (por exemplo,env: production)
Salve o arquivo.
Reinicie o agente do BindPlane:
Windows:
net stop observiq-otel-collector && net start observiq-otel-collectorLinux:
sudo systemctl restart observiq-otel-collector
Exportador da API de ingestão legada
Se você usar o arquivo de autenticação de ingestão da Opção 2, substitua o bloco
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo endpoint regional (por exemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/windows_applocker: compression: gzip creds_file_path: '/path/to/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINDOWS_APPLOCKER raw_log_field: body ingestion_labels: env: production
Instalar o NXLog nos endpoints do Windows
- Faça o download do NXLog Agent (antigo NXLog Enterprise Edition) para Windows no site do NXLog.
Execute o instalador em cada endpoint em que você quer coletar eventos do AppLocker e aceite o diretório de instalação padrão (
C:\Program Files\nxlog).
Configurar o NXLog para encaminhar eventos do AppLocker
- Abra o Explorador de Arquivos e acesse
C:\Program Files\nxlog\conf. - Abra o arquivo
nxlog.confno Bloco de Notas ou em um editor de texto com privilégios de administrador. Substitua todo o conteúdo pela seguinte configuração:
define ROOT C:\Program Files\nxlog define LOGDIR %ROOT%\data define LOGFILE %LOGDIR%\nxlog.log Moduledir %ROOT%\modules CacheDir %ROOT%\data Pidfile %ROOT%\data\nxlog.pid SpoolDir %ROOT%\data LogFile %LOGFILE% <Extension json> Module xm_json </Extension> <Extension xml> Module xm_xml </Extension> <Extension syslog> Module xm_syslog </Extension> <Input applocker_events> Module im_msvistalog <QueryXML> <QueryList> <Query Id="0"> <Select Path="Microsoft-Windows-AppLocker/EXE and DLL">*</Select> <Select Path="Microsoft-Windows-AppLocker/MSI and Script">*</Select> <Select Path="Microsoft-Windows-AppLocker/Packaged app-Deployment">*</Select> <Select Path="Microsoft-Windows-AppLocker/Packaged app-Execution">*</Select> </Query> </QueryList> </QueryXML> <Exec> # AppLocker keeps the rule and file details in the UserData part of the # event. parse_xml() turns them into RuleAndFileData.* fields, which # the parser expects. if $UserData parse_xml($UserData); $Message = to_json(); to_syslog_bsd(); </Exec> </Input> <Output bindplane_syslog> Module om_tcp Host <BINDPLANE_AGENT_IP> Port 514 </Output> <Route applocker_to_bindplane> Path applocker_events => bindplane_syslog </Route>Substitua
<BINDPLANE_AGENT_IP>pelo endereço IP do host do agente do BindPlane e514pela porta delisten_address, se você a tiver alterado.Salve o arquivo
nxlog.conf.
Reinicie o serviço NXLog.
- Abra Serviços pressionando
Win+R, digitandoservices.msce pressionando Enter. - Localize nxlog na lista de serviços.
- Clique com o botão direito do mouse em nxlog e selecione Reiniciar.
- Verifique se o status do serviço mostra Em execução.
Como alternativa, você pode reiniciar o NXLog no prompt de comando como administrador:
net stop nxlog && net start nxlog
Verificar se os eventos do AppLocker estão sendo encaminhados
- Abra o Visualizador de Eventos no endpoint do Windows.
- Acesse Registros de aplicativos e serviços > Microsoft > Windows > AppLocker > EXE e DLL.
- Verifique se os eventos do AppLocker (por exemplo, IDs de evento 8002, 8003 ou 8004) estão presentes. Se o registro estiver vazio, confirme se uma política do AppLocker foi aplicada e se o serviço Identidade do Aplicativo está em execução.
- Verifique se há erros ou avisos no arquivo de registro do NXLog em
C:\Program Files\nxlog\data\nxlog.log. No host do agente do Bindplane, verifique se há erros no registro do agente:
Windows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"Linux:
sudo tail -f /opt/observiq-otel-collector/log/collector.log
Método 2: leitura do canal direto do agente do BindPlane
Use esse método quando não quiser implantar o NXLog. O agente do Bindplane instalado em cada endpoint lê os canais do AppLocker diretamente do log de eventos do Windows e envia o XML do evento bruto para o Google SecOps no tipo de registro WINEVTLOG.
Configurar o agente do Bindplane para ler os canais do AppLocker
No endpoint do Windows, abra o arquivo de configuração:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"Substitua todo o conteúdo de
config.yamlpela seguinte configuração:receivers: windowseventlog/applocker_exe_dll: channel: Microsoft-Windows-AppLocker/EXE and DLL raw: true max_reads: 100 poll_interval: 5s start_at: end windowseventlog/applocker_msi_script: channel: Microsoft-Windows-AppLocker/MSI and Script raw: true max_reads: 100 poll_interval: 5s start_at: end windowseventlog/applocker_packaged_deployment: channel: Microsoft-Windows-AppLocker/Packaged app-Deployment raw: true max_reads: 100 poll_interval: 5s start_at: end windowseventlog/applocker_packaged_execution: channel: Microsoft-Windows-AppLocker/Packaged app-Execution raw: true max_reads: 100 poll_interval: 5s start_at: end exporters: chronicle/winevtlog: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINEVTLOG raw_log_field: body ingestion_labels: env: production service: pipelines: logs/applocker_to_chronicle: receivers: - windowseventlog/applocker_exe_dll - windowseventlog/applocker_msi_script - windowseventlog/applocker_packaged_deployment - windowseventlog/applocker_packaged_execution exporters: - chronicle/winevtlogSubstitua os seguintes marcadores de posição:
<customer_id>: ID de cliente da seção "Receber o ID de cliente do Google SecOps"endpoint: URL do endpoint regional, conforme listado no Método 1.ingestion_labels: rótulos opcionais no formato YAML (por exemplo,env: production)start_at: defina comoendpara coletar apenas novos eventos oubeginningpara coletar também os eventos que já estão nos canais.
Salve o arquivo.
Reinicie o agente do BindPlane:
net stop observiq-otel-collector && net start observiq-otel-collectorVerifique se o serviço está em execução e se há erros no registro agêntico:
sc query observiq-otel-collector type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Exportador da API de ingestão legada
Se você usar o arquivo de autenticação de ingestão da Opção 2, substitua o bloco
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo endpoint regional (por exemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/winevtlog: compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINEVTLOG raw_log_field: body ingestion_labels: env: production
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
syslog_ts |
metadata.event_timestamp |
Analisado como yyyy-MM-ddTHH:mm:ss Z |
event_type |
metadata.event_type |
Mapeado diretamente |
EventID |
metadata.product_event_type |
Mapeado diretamente |
sourceName |
metadata.product_name |
Mapeado diretamente |
SourceModuleType |
observer.application |
Renomeado/mapeado |
Domain |
principal.administrative_domain |
Renomeado/mapeado |
Hostname |
principal.hostname |
Renomeado/mapeado |
principal_ip1 |
principal.ip |
Mesclado |
roles |
principal.user.attribute.roles |
Mesclado |
AccountName |
principal.user.userid |
Renomeado/mapeado |
EventID |
security_result.about.labels |
Mapeado: 8002,8005, 8006, 8020 → ssdl |
ssdl |
security_result.about.labels |
Mesclado |
message1 |
security_result.action |
Mapeado: allowed to run → security_action |
security_action |
security_result.action |
Mesclado |
message1 |
security_result.description |
Mapeado diretamente |
RuleAndFileData.RuleId |
security_result.rule_id |
Renomeado/mapeado |
EventID |
security_result.rule_name |
Mapeado diretamente |
RuleAndFileData.RuleName |
security_result.rule_name |
Renomeado/mapeado |
EventType |
security_result.severity |
Mapeado: INFO → INFORMATIONAL, WARNING → LOW |
RuleAndFileData.PolicyName |
security_result.summary |
Renomeado/mapeado |
ThreadID |
security_result.threat_id |
Renomeado/mapeado |
RuleAndFileData.FullFilePath |
target.process.file.full_path |
Renomeado/mapeado |
filePath |
target.process.file.full_path |
Renomeado/mapeado |
ProcessID |
target.process.pid |
Mapeado diretamente |
RuleAndFileData.TargetProcessId |
target.process.pid |
Renomeado/mapeado |
ProviderGuid |
target.resource.product_object_id |
Renomeado/mapeado |
UserID |
target.user.userid |
Renomeado/mapeado |
| N/A | metadata.vendor_name |
Constante: Microsoft |
| 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.