Coletar registros do ManageEngine Log360

Compatível com:

Neste documento, explicamos como ingerir registros do ManageEngine Log360 no Google Security Operations usando o Bindplane.

O ManageEngine Log360 é uma solução unificada de SIEM e gerenciamento de registros que coleta, monitora e analisa registros de várias fontes no seu ambiente. Ele gera registros agregados de ocorrência de segurança e registros de auditoria de compliance. O Log360 inclui um recurso integrado de encaminhamento de Syslog no componente EventLog Analyzer, que é compatível com vários formatos de saída, incluindo RFC 5424, RFC 3164, JSON e modelos personalizados.

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 host Linux com systemd
  • Conectividade de rede entre o agente do Bindplane e o ManageEngine Log360
  • 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.
  • Acesso privilegiado ao ManageEngine Log360 com permissões de administrador
  • ManageEngine Log360 instalado e configurado para coletar registros do seu ambiente

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 no seu sistema operacional Windows ou Linux de acordo com as instruções a seguir.

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
    
  3. Aguarde a conclusão da instalação.

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

    sudo systemctl status observiq-otel-collector
    

O serviço precisa aparecer como active (running).

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.

Configurar o agente do Bindplane para ingerir o syslog e enviar ao Google SecOps

Localize o arquivo de configuração.

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Editar o arquivo de configuração

  • Substitua todo o conteúdo de config.yaml pela seguinte configuração:

    receivers:
      tcplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/log360:
        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: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: MANAGE_ENGINE_LOG360
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/log360_to_chronicle:
          receivers:
            - tcplog
          exporters:
            - chronicle/log360
    

Parâmetros de configuração

Substitua os seguintes marcadores de posição:

  • Configuração do receptor:

    • tcplog: o tipo de receptor com base no protocolo:
      • udplog para syslog UDP
      • tcplog para syslog TCP
    • 0.0.0.0: endereço IP para detectar:
      • 0.0.0.0 para ouvir em todas as interfaces (recomendado)
      • Endereço IP específico para detectar em uma interface
    • 514: número da porta para detectar (por exemplo, 514, 1514, 6514)
  • Configuração do exportador:

    • log360: nome descritivo do exportador.
    • creds_file_path: caminho completo para o arquivo de chave JSON da conta de serviço (opção 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id>: ID de cliente da etapa anterior.
    • 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.
    • MANAGE_ENGINE_LOG360: tipo de registro exatamente como aparece no Chronicle.
    • ingestion_labels: rótulos opcionais no formato YAML (por exemplo, env: production)
  • Configuração do pipeline:

    • log360_to_chronicle: nome descritivo do pipeline.

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/log360:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: MANAGE_ENGINE_LOG360
        raw_log_field: body
        ingestion_labels:
          env: production
    

Salve o arquivo de configuração.

  • Depois de editar, salve o arquivo:
    • Linux: pressione Ctrl+O, depois Enter e, em seguida, Ctrl+X.
    • Windows: clique em Arquivo > Salvar.

Reinicie o agente do BindPlane para aplicar as mudanças:

Para reiniciar o agente do BindPlane no Linux:

  1. Execute este comando:

    sudo systemctl restart observiq-otel-collector
    
  2. Verifique se o serviço está em execução:

    sudo systemctl status observiq-otel-collector
    
  3. Verifique se há erros nos registros:

    sudo journalctl -u observiq-otel-collector -f
    

Para reiniciar o agente do BindPlane no Windows:

  1. Escolha uma das seguintes opções:

    • Prompt de comando ou PowerShell como administrador:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • Console de serviços:
      1. Pressione Win+R, digite services.msc e pressione Enter.
      2. Localize o coletor do OpenTelemetry da observIQ.
      3. Clique com o botão direito do mouse e selecione Reiniciar.
  2. Verifique se o serviço está em execução:

    sc query observiq-otel-collector
    
  3. Verifique se há erros nos registros:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

Configurar o encaminhamento de syslog do ManageEngine Log360

  1. Faça login no console do ManageEngine Log360 como administrador.
  2. Acesse Configurações > Configurações de administrador > Integrações > Encaminhamento de registros.
  3. Clique em Adicionar novo perfil.
  4. Configure o perfil de encaminhamento com as seguintes configurações:

    Configuração Valor
    Nome do remetente Insira um nome descritivo (por exemplo, Chronicle-Bindplane).
    Servidor de destino Insira o endereço IP do host do agente do BindPlane
    Protocolo Selecione TCP ou UDP para corresponder ao tipo de receptor do BindPlane.
    Porta Insira a porta correspondente à configuração do receptor do agente do Bindplane (por exemplo, 514).
  5. Clique em Personalizar para selecionar o formato do registro. Os formatos disponíveis incluem:

    • Rawlog: encaminha o registro original conforme recebido.
    • JSON: encaminha registros no formato JSON estruturado.
    • RFC 5424: formato padrão de syslog com suporte a dados estruturados
    • RFC 5424 com dados estruturados: formato RFC 5424 estendido
    • RFC 3164: formato de syslog BSD legado
    • Personalizado: defina um modelo de formato de syslog personalizado.
  6. Em Selecionar dispositivos, adicione os dispositivos com os registros que você quer encaminhar.

  7. Selecione os critérios de encaminhamento:

    • Todos os registros: encaminha todos os registros recebidos dos dispositivos selecionados.
    • Excluir: filtra os registros que correspondem às regras especificadas.
    • Somente encaminhamento: encaminha apenas os registros que correspondem às regras especificadas.
  8. Clique em Salvar.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
authentication_package additional.fields Mesclado com o objeto de rótulo criado de authentication_package
Logon_type extensions.auth.mechanism Defina como "NETWORK" se Logon_type == '3'; "BATCH" se '4'; "SERVICE" se '5'; "NETWORK_CLEAR_TEXT" se '8'; "NEW_CREDENTIALS" se '9'; "REMOTE_INTERACTIVE" se '10'; "CACHED_INTERACTIVE" se '11'; "MECHANISM_OTHER" se não estiver vazio
usuário intermediary.hostname Valor copiado diretamente
msg metadata.description Valor copiado diretamente
user_present, principal_present metadata.event_type Defina como "USER_RESOURCE_ACCESS" se user_present == "true"; "STATUS_UPDATE" se principal_present == "true"; caso contrário, "GENERIC_EVENT"
eventid metadata.product_event_type Valor copiado diretamente
principal_domain principal.administrative_domain Valor copiado diretamente
source_ip principal.asset.ip Extraído usando o padrão grok de IP, mesclado se for válido
source_ip principal.ip Extraído usando o padrão grok de IP, mesclado se for válido
source_port principal.port Valor copiado diretamente, convertido em número inteiro
creator_process_name principal.process.file.full_path Valor copiado diretamente
process_id principal.process.pid Valor copiado diretamente se não estiver em [""," -"]
logon_guid principal.resource.product_object_id Valor copiado diretamente
principal_account_name principal.user.userid Valor copiado diretamente
principal_security_id principal.user.windows_sid Valor copiado diretamente se corresponder à regex do SID do Windows
channel, principal_logon_id, impersonation_level, restricted_admin_mode, virtual_account, elevated_token, event_in_sequence, logon_process, transited_services, key_length security_result.detection_fields Mesclado com objetos de rótulo criados de cada campo
resumo security_result.description Valor copiado diretamente
evento src.asset.software.vendor_name Valor copiado diretamente
target_domain target.administrative_domain Valor copiado diretamente se não estiver em [""," -"]
target_account_name target.user.userid Valor copiado diretamente se não estiver em [""," -"]
target_security_id target.user.windows_sid Valor copiado diretamente se corresponder à regex do SID do Windows

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.