Coletar registros do AppLocker do Windows

Compatível com:

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 analisador WINDOWS_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.
  1. Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
  2. Acesse IAM e administrador > Contas de serviço.
  3. Clique em Criar conta de serviço.
  4. 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).
  5. Clique em Criar e continuar.
  6. Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
  7. Clique em Continuar e depois em Concluído.
  8. Clique na conta de serviço que você criou e acesse a guia Chaves.
  9. Clique em Adicionar chave > Criar nova chave.
  10. Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
  11. Salve o arquivo de chave como ingestion-auth.json no diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.json no Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json no Windows) ou atualize creds_file_path em config.yaml para corresponder ao caminho em que você o salvou.
  12. 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)

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
  3. Faça o download do arquivo de autenticação de ingestão.
  4. Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.

Receber o ID de cliente do Google SecOps

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
  3. 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

  1. Abra o Prompt de comando ou o PowerShell como administrador.
  2. Execute este comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Aguarde a conclusão da instalação.

  4. Execute o seguinte comando para confirmar a instalação:

    sc query observiq-otel-collector
    

    O serviço precisa aparecer como RUNNING.

Instalação do Linux

  1. Abra um terminal com privilégios de raiz ou sudo.
  2. 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

  1. 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.yaml
    
  2. Substitua todo o conteúdo de config.yaml pela 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_applocker
    
  3. Substitua os seguintes marcadores de posição:

    • listen_address: o endereço IP e a porta que o agente detecta. O 0.0.0.0:514 aceita 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
    • <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, europe ou asia-southeast1). O exportador prefixa chronicle.googleapis.com com 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 como chronicle.googleapis.com.
    • ingestion_labels: rótulos opcionais no formato YAML (por exemplo, env: production)
  4. Salve o arquivo.

  5. Reinicie o agente do BindPlane:

    Windows:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

    Linux:

    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 exporters pelo seguinte. Defina creds_file_path como o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substitua malachiteingestion-pa.googleapis.com pelo 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

  1. Faça o download do NXLog Agent (antigo NXLog Enterprise Edition) para Windows no site do NXLog.
  2. 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

  1. Abra o Explorador de Arquivos e acesse C:\Program Files\nxlog\conf.
  2. Abra o arquivo nxlog.conf no Bloco de Notas ou em um editor de texto com privilégios de administrador.
  3. 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>
    
  4. Substitua <BINDPLANE_AGENT_IP> pelo endereço IP do host do agente do BindPlane e 514 pela porta de listen_address, se você a tiver alterado.

  5. Salve o arquivo nxlog.conf.

Reinicie o serviço NXLog.

  1. Abra Serviços pressionando Win+R, digitando services.msc e pressionando Enter.
  2. Localize nxlog na lista de serviços.
  3. Clique com o botão direito do mouse em nxlog e selecione Reiniciar.
  4. 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

  1. Abra o Visualizador de Eventos no endpoint do Windows.
  2. Acesse Registros de aplicativos e serviços > Microsoft > Windows > AppLocker > EXE e DLL.
  3. 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.
  4. Verifique se há erros ou avisos no arquivo de registro do NXLog em C:\Program Files\nxlog\data\nxlog.log.
  5. 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

  1. No endpoint do Windows, abra o arquivo de configuração:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    
  2. Substitua todo o conteúdo de config.yaml pela 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/winevtlog
    
  3. Substitua 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 como end para coletar apenas novos eventos ou beginning para coletar também os eventos que já estão nos canais.
  4. Salve o arquivo.

  5. Reinicie o agente do BindPlane:

    net stop observiq-otel-collector && net start observiq-otel-collector
    
  6. Verifique 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 exporters pelo seguinte. Defina creds_file_path como o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substitua malachiteingestion-pa.googleapis.com pelo 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.