Recolha registos do ForgeRock OpenAM

Este documento explica como carregar registos do ForgeRock OpenAM para o Google Security Operations através do Bindplane. O analisador extrai campos dos registos nos formatos CSV, Syslog + KV ou JSON, normaliza-os e mapeia-os para o modelo de dados unificado (UDM). Processa vários tipos de eventos do OpenAM, incluindo início/fim de sessão, resultados de acesso e registos gerais, enriquecendo os dados com informações do utilizador, do grupo e da rede, ao mesmo tempo que realiza transformações específicas para diferentes formatos de registo e tipos de eventos. O analisador dá prioridade à análise JSON e, em seguida, recorre ao Syslog+KV e, finalmente, ao CSV, ignorando os registos de formatos não suportados.

Antes de começar

Certifique-se de que tem os seguintes pré-requisitos:

• Instância do Google SecOps
• Windows 2016 ou posterior, ou um anfitrião Linux com systemd
• Se estiver a ser executado através de um proxy, as portas da firewall estão abertas
• Acesso privilegiado ao Forgerock OpenAM (por exemplo, amAdmin)

Obtenha o ficheiro de autenticação de carregamento do Google SecOps

1. Inicie sessão na consola Google SecOps.
2. Aceda a Definições do SIEM > Agentes de recolha.
3. Transfira o ficheiro de autenticação de carregamento. Guarde o ficheiro de forma segura no sistema onde o Bindplane vai ser instalado.

Obtenha o ID de cliente do Google SecOps

1. Inicie sessão na consola Google SecOps.
2. Aceda a Definições do SIEM > Perfil.
3. Copie e guarde o ID do cliente da secção Detalhes da organização.

Instale o agente do Bindplane

Instale o agente do Bindplane no seu sistema operativo Windows ou Linux de acordo com as seguintes instruções.

Instalação do Windows

1. Abra a Linha de comandos ou o PowerShell como administrador.

2. Execute o seguinte comando:

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Instalação do Linux

1. Abra um terminal com privilégios de raiz ou sudo.

2. Execute o seguinte comando:

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

Recursos de instalação adicionais

Para ver opções de instalação adicionais, consulte o guia de instalação.

Configure o agente Bindplane para carregar o Syslog e enviá-lo para o Google SecOps

1. Aceda ao ficheiro de configuração:
   • Localize o ficheiro config.yaml. Normalmente, encontra-se no diretório /etc/bindplane-agent/ no Linux ou no diretório de instalação no Windows.
   • Abra o ficheiro com um editor de texto (por exemplo, nano, vi ou Bloco de notas).

2. Edite o ficheiro config.yaml da seguinte forma:

   receivers:
       udplog:
           # Replace the port and IP address as required
           listen_address: "0.0.0.0:514"
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds_file_path: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           ingestion_labels:
               log_type: 'OPENAM'
               raw_log_field: body
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.

4. Substitua <customer_id> pelo ID de cliente real.

5. Atualize /path/to/ingestion-authentication-file.json para o caminho onde o ficheiro de autenticação foi guardado na secção Obtenha o ficheiro de autenticação de carregamento do Google SecOps.

Reinicie o agente do Bindplane para aplicar as alterações

• Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:

  sudo systemctl restart bindplane-agent
  

• Para reiniciar o agente do Bindplane no Windows, pode usar a consola Services ou introduzir o seguinte comando:

  net stop BindPlaneAgent && net start BindPlaneAgent
  

Configure o registo de auditoria no Forgerock OpenAM

1. Inicie sessão na consola do AM.
2. Aceda a Configurar > Serviços globais > Registo de auditoria.
3. Ative o registo de auditoria para iniciar a funcionalidade de registo de auditoria.
4. Nas listas de filtros de lista de permissões de campos e filtros de lista de bloqueios de campos, introduza valores a incluir (lista de permissões) ou excluir (lista de bloqueios) dos registos de eventos de auditoria.
5. Clique em Guardar.

Configure controladores Syslog para o Forgerock OpenAM

1. Inicie sessão na consola do AM como administrador, por exemplo, amAdmin.
2. Para criar o controlador de eventos na configuração global, aceda a Configurar > Serviços globais > Registo de auditoria.
3. Para criar o controlador de eventos num domínio, aceda a Domínios > Nome do domínio > Serviços > Registo de auditoria.
4. Clique em Adicionar uma configuração secundária > Syslog.
5. Indique os seguintes detalhes de configuração:
   • Nome: introduza um nome para o controlador de eventos (por exemplo, Google SecOps Syslog Event Handler).
   • Nome de anfitrião do servidor: introduza o endereço IP do agente do Bindplane.
   • Porta do servidor: introduza o número da porta do agente do Bindplane (por exemplo, 514 para UDP).
   • Protocolo de transporte: selecione UDP.
   • Tempo limite de ligação: introduza o número de segundos para estabelecer ligação (por exemplo, 120).
   • Opcional: ative a opção Armazenamento em buffer.
6. Clique em Criar.
7. Depois de criar o controlador de eventos de auditoria do syslog, são apresentados vários separadores de configuração.
8. No separador Configuração do controlador geral, selecione Ativado para ativar o controlador de eventos, se estiver desativado.
9. Selecione os tópicos para os registos de auditoria:
   • Acesso
   • Atividade
   • Autenticação
   • Configuração
10. Clique em Guardar.
11. No separador Configuração do Syslog, faculte os seguintes detalhes de configuração:
    • Nome de anfitrião do servidor: introduza o endereço IP do agente do Bindplane.
    • Porta do servidor: introduza o número da porta do agente do Bindplane.
    • Tempo limite de ligação: introduza o número de segundos para estabelecer ligação (por exemplo, 120).
    • Protocolo de transporte: selecione UDP.
    • Instalação: selecione Local0.
    • Todos os tópicos definem a gravidade como INFORMATIONAL.
12. Clique em Guardar.

13. No separador Colocação no buffer, selecione Colocação no buffer ativada para a ativar.

14. Clique em Guardar.

Tabela de mapeamento do UDM

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.