Coletar registros do Forcepoint Email Security

Versão do analisador:2.0

Disponível em:

Google SecOps SIEM

Este documento explica como ingerir registros do Forcepoint Email Security no Google Security Operations usando o BindPlane. O analisador primeiro extrai campos dos registros formatados em JSON e inicializa alguns campos do UDM com valores vazios. Em seguida, ele mapeia os campos extraídos para os campos correspondentes na estrutura do UDM do Chronicle com base em condições específicas e manipulações de dados, criando uma representação unificada da ocorrência de segurança de e-mail.

Antes de começar

Verifique se você tem os pré-requisitos a seguir:

• Uma instância do Google SecOps
• Um host do Windows 2016 ou mais recente ou do Linux com systemd
• Se você estiver executando em um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente do BindPlane
• Acesso privilegiado ao appliance ou ao console de gerenciamento do Forcepoint Email Security

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 descontinuada em 20 de julho de 2027.

Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)

1. Faça login no Google Cloud console e selecione o Google Cloud projeto 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 criada e acesse a guia Chaves.
9. Selecione Adicionar chave > Criar nova chave.
10. Selecione JSON e clique em Criar. O arquivo de chave é baixado para o 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 salva.
12. Acesse IAM e administrador > Configurações e copie o Número do projeto. Você vai precisar dele para a configuração do exportador.

Observação: a chave JSON é uma credencial. Restrinja o acesso ao arquivo no host do BindPlane e gire a chave de acordo com a política da sua organização.

Opção 2: baixar o arquivo de autenticação de ingestão (legado)

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > Agentes de coleta.
3. Baixe o arquivo de autenticação de ingestão.
4. Salve o arquivo com segurança no sistema em que o agente do BindPlane será instalado.

Observação: esse arquivo autentica o agente na API Ingestion legada (malachiteingestion-pa.googleapis.com), que o Google programou para o fim da vida útil em 20 de julho de 2027. Planeje mudar para a opção 1 antes dessa data.

Receber o ID de cliente do Google SecOps

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > 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 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
   

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 outras opções de instalação, consulte este guia de instalação.
• Alternativa: também é possível usar o fluxo de trabalho de instalação gerenciada do BindPlane OP para gerenciamento centralizado de agentes.

Observação: a configuração do exportador da API Chronicle requer o coletor do BindPlane v1.106.0 ou mais recente. Os comandos anteriores instalam a versão mais recente. Se você estiver atualizando uma instalação atual, faça upgrade do coletor antes de mudar a configuração.

Configurar o agente do BindPlane para ingerir o Syslog e enviar ao Google SecOps

1. Acesse o arquivo de configuração:

   • Localize o arquivo config.yaml. Normalmente, ele está no diretório /opt/observiq-otel-collector/ no Linux ou no diretório de instalação no Windows.
   • Abra o arquivo usando um editor de texto (por exemplo, nano, vi ou Bloco de Notas).

2. Edite o arquivo 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:
       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
       # 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: chronicle.googleapis.com
       # Add optional ingestion labels for better organization
       log_type: 'FORCEPOINT_EMAILSECURITY'
       raw_log_field: body
       ingestion_labels:
   
   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 <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.

5. Substitua <PROJECT_NUMBER> pelo número do projeto em IAM e administrador > Configurações.

6. Substitua <CUSTOMER_ID> pelo ID de cliente real.

7. Atualize /path/to/ingestion-authentication-file.json para o caminho do arquivo em que o arquivo de chave da conta de serviço (opção 1) foi salvo na etapa 1.

Exportador da API Ingestion 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/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
      log_type: 'FORCEPOINT_EMAILSECURITY'
      raw_log_field: body
      ingestion_labels:
  

Observação: esse exportador vai parar de funcionar quando a API Ingestion for descontinuada em 20 de julho de 2027.

Reiniciar o agente do BindPlane para aplicar as mudanças

1. Para reiniciar o agente do BindPlane no Linux, execute o seguinte comando:

   sudo systemctl restart observiq-otel-collector
   

2. Para reiniciar o agente do BindPlane no Windows, use o console Serviços ou insira o seguinte comando:

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

Configurar o encaminhamento do Syslog no Forcepoint Email Security

1. Faça login no Console de gerenciamento do Forcepoint Email Security.
2. Acesse Configurações > Integrações > Integração do SIEM.
3. Clique em Ativar integração do SIEM.

4. Informe os seguintes detalhes de configuração:

   • Formato: selecione LEEF (Log Event Extended Format).
   • Servidor Syslog: insira o endereço IP do agente do BindPlane.
   • Porta Syslog: insira o número da porta do agente do BindPlane (por exemplo, 514).
   • Protocolo: selecione UDP ou TCP, dependendo da configuração real do agente do BindPlane.
   • Instalação: selecione o código de instalação do Syslog (por exemplo, Local0).
   • Gravidade: selecione o nível de gravidade dos eventos de registro.

5. Clique em Salvar.

Tabela de mapeamento de UDM

Campo de registro	Mapeamento de UDM	Lógica
Ação	security_result.action_details	Mapeado diretamente do campo "Action" no registro bruto.
AttachmentFilename	additional.fields.value.list_value.values.string_value (key: Attachments_FileNames)	O campo "AttachmentFilename" é dividido por vírgula e, em seguida, cada valor é adicionado como string_value à matriz "additional.fields" com a chave "Attachments_FileNames".
AttachmentFileType	additional.fields.value.list_value.values.string_value (key: AttachmentsFileType)	O campo "AttachmentFileType" é dividido por vírgula e, em seguida, cada valor é adicionado como string_value à matriz "additional.fields" com a chave "AttachmentsFileType".
AttachmentSize	additional.fields.value.list_value.values.string_value (key: AttachmentsSize)	O campo "AttachmentSize" é dividido por vírgula e, em seguida, cada valor é adicionado como string_value à matriz "additional.fields" com a chave "AttachmentsSize".
DateTime		Não mapeado no UDM fornecido.
EnvelopeSender	network.email.from	Mapeado diretamente do campo "EnvelopeSender" no registro bruto.
EventReceivedTime	metadata.event_timestamp	Analisado em um formato de carimbo de data/hora e mapeado para "metadata.event_timestamp".
FilteringReason	security_result.category_details	Mapeado diretamente do campo "FilteringReason" no registro bruto.
MessageSandboxing	security_result.detection_fields.value (key: MessageSandboxing)	Mapeado diretamente do campo "MessageSandboxing" no registro bruto e adicionado como um par de chave-valor à matriz "security_result.detection_fields".
MessageSize	security_result.detection_fields.value (key: MessageSize)	Mapeado diretamente do campo "MessageSize" no registro bruto e adicionado como um par de chave-valor à matriz "security_result.detection_fields".
nxlog_filename	additional.fields.value.string_value (key: nxlog_filename)	Mapeado diretamente do campo "nxlog_filename" no registro bruto e adicionado como um par de chave-valor à matriz "additional.fields".
RecipientAddress	network.email.to	Mapeado diretamente do campo "RecipientAddress" no registro bruto.
SenderIP	principal.asset.ip, principal.ip	Mapeado diretamente do campo "SenderIP" no registro bruto.
SenderIPCountry	principal.location.country_or_region	Mapeado diretamente do campo "SenderIPCountry" no registro bruto.
SourceModuleName	principal.resource.attribute.labels.value (key: SourceModuleName)	Mapeado diretamente do campo "SourceModuleName" no registro bruto e adicionado como um par de chave-valor à matriz "principal.resource.attribute.labels".
SourceModuleType	principal.resource.attribute.labels.value (key: SourceModuleType)	Mapeado diretamente do campo "SourceModuleType" no registro bruto e adicionado como um par de chave-valor à matriz "principal.resource.attribute.labels".
SpamScore	security_result.detection_fields.value (key: SpamScore)	Mapeado diretamente do campo "SpamScore" no registro bruto e adicionado como um par de chave-valor à matriz "security_result.detection_fields".
Assunto	network.email.subject	Mapeado diretamente do campo "Subject" no registro bruto.
VirusName	security_result.detection_fields.value (key: VirusName)	Mapeado diretamente do campo "VirusName" no registro bruto e adicionado como um par de chave-valor à matriz "security_result.detection_fields".
	metadata.event_type	O valor é determinado com base na presença de outros campos. Se "has_network_email_data" for verdadeiro, o valor será definido como "EMAIL_TRANSACTION". Se "has_principal" for verdadeiro, o valor será definido como "STATUS_UPDATE". Caso contrário, o padrão será "GENERIC_EVENT".
	metadata.product_name	O valor é definido como "FORCEPOINT EMAILSECURITY".
	metadata.vendor_name	O valor é definido como "FORCEPOINT EMAILSECURITY".

Registro de alterações

Consulte o registro de alterações deste analisador

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