Coletar registros do VMware Horizon

Compatível com:

Google SecOps SIEM

Observação: esse recurso é coberto pelos Termos de ofertas pré-GA dos Termos específicos do serviço do Google Security Operations. Os recursos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as diretrizes do serviço de suporte técnico do Google SecOps e os Termos específicos do serviço do Google SecOps.

Este documento explica como ingerir registros do Omnissa Horizon (antes conhecido como VMware Horizon) no Google Security Operations usando o Bindplane. Primeiro, o analisador usa expressões regulares (padrões grok) para extrair campos de mensagens syslog brutas. Em seguida, ele mapeia os campos extraídos para os campos correspondentes no esquema UDM do Chronicle, normalizando e estruturando os dados para análise.

Antes de começar

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

• Instância do Google SecOps
• Windows 2016 ou mais recente ou um host Linux com systemd
• Se você estiver executando por trás de um proxy, verifique se as portas do firewall estão abertas.
• Acesso privilegiado ao Omnissa Horizon 8

Receber o arquivo de autenticação de ingestão do Google SecOps

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. Salve o arquivo de forma segura no sistema em que o Bindplane será instalado.

Receber o ID do 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 do 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 root 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, consulte o guia de instalaçã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 fica no diretório /etc/bindplane-agent/ 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:
           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: 'VMWARE_HORIZON'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

   • Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
   • Substitua <customer_id> pelo ID do cliente real.
   • Atualize /path/to/ingestion-authentication-file.json para o caminho em que o arquivo de autenticação foi salvo na seção Receber arquivo de autenticação de ingestão do Google SecOps.

Reinicie o agente do Bindplane para aplicar as mudanças

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

  sudo systemctl restart bindplane-agent
  

• Para reiniciar o agente do Bindplane no Windows, use o console Serviços ou insira o seguinte comando:

  net stop BindPlaneAgent && net start BindPlaneAgent
  

Configurar o Syslog para o Omnissa Horizon (antigo VMware Horizon)

1. Faça login na UI da Web do Onmissa Horizon.
2. Acesse Configurações > Configuração de eventos.
3. Na seção Enviar para servidores syslog, clique em Adicionar.
4. Insira o endereço IP e o número da porta do agente Bindplane. Verifique se você configurou o protocolo Bindplane como UDP.
5. Clique em Salvar.

Tabela de mapeamento da UDM

Campo de registro	Mapeamento da UDM	Lógica
ActionId	metadata.product_log_id	O valor de "ActionId" do registro bruto é mapeado para "metadata.product_log_id".
admin_domain	principal.administrative_domain	O valor de "admin_domain" do registro bruto é mapeado para "principal.administrative_domain".
BrokerName	principal.hostname	O valor de "BrokerName" do registro bruto é mapeado para "principal.hostname".
BrokerSessionId	network.session_id	O valor de "BrokerSessionId" do registro bruto é mapeado para "network.session_id".
ClientIpAddress	principal.ip	O valor de "ClientIpAddress" do registro bruto é mapeado para "principal.ip".
CurrentSessionLength	network.session_duration.seconds	O valor de "CurrentSessionLength" do registro bruto é convertido em número inteiro e mapeado para "network.session_duration.seconds".
description	metadata.description	O valor de "description" do registro bruto é mapeado para "metadata.description".
DesktopDisplayName	principal.hostname	O valor de "DesktopDisplayName" do registro bruto é mapeado para "principal.hostname".
EventType	metadata.product_event_type	O valor de "EventType" do registro bruto é mapeado para "metadata.product_event_type".
ForwardedClientIpAddress	principal.nat_ip	O valor de "ForwardedClientIpAddress" do registro bruto é mapeado para "principal.nat_ip".
GlobalEntitlementName	target.user.group_identifiers	O valor de "GlobalEntitlementName" do registro bruto é mapeado para "target.user.group_identifiers".
host	principal.hostname	O valor de "host" do registro bruto é mapeado para "principal.hostname".
MachineDnsName	principal.url	O valor de "MachineDnsName" do registro bruto é mapeado para "principal.url".
MachineName	intermediary.hostname	O valor de "MachineName" do registro bruto é mapeado para "intermediary.hostname".
Module	additional.fields	A chave "Module" com o valor "Module" do registro bruto é adicionada à matriz "additional.fields".
pid	principal.process.pid	O valor de "pid" do registro bruto é mapeado para "principal.process.pid".
PoolId	additional.fields	A chave "PoolId" com o valor "PoolId" do registro bruto é adicionada à matriz "additional.fields".
program	principal.application	O valor de "program" do registro bruto é mapeado para "principal.application".
SessionType	additional.fields	A chave "SessionType" com o valor "SessionType" do registro bruto é adicionada à matriz "additional.fields".
Severity	security_result.severity	O valor de "Severity" do registro bruto é convertido para maiúsculas, mapeado para gravidades genéricas do Chronicle e, em seguida, para "security_result.severity".
timestamp	metadata.event_timestamp	O valor de "timestamp" do registro bruto é convertido para o formato do Chronicle e mapeado para "metadata.event_timestamp".
UserDisplayName	target.user.user_display_name	O valor de "UserDisplayName" do registro bruto é mapeado para "target.user.user_display_name".
UserName	target.user.userid	O valor de "UserName" do registro bruto é mapeado para "target.user.userid".
UserSID	target.user.windows_sid	O valor de "UserSID" do registro bruto é mapeado para "target.user.windows_sid".
ViewApiMethodName	additional.fields	A chave "ViewApiMethodName" com o valor "ViewApiMethodName" do registro bruto é adicionada à matriz "additional.fields".
ViewApiServiceName	additional.fields	A chave "ViewApiServiceName" com o valor "ViewApiServiceName" do registro bruto é adicionada à matriz "additional.fields".
	extensions.auth.type	O valor é definido como "SSO" se o campo "EventType" for um dos seguintes: "ADMIN_USERLOGGEDOUT", "AGENT_CONNECTED", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING", "AGENT_PENDING_EXPIRED", "AGENT_RECONNECTED", "BROKER_DESKTOP_REQUEST", "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", "BROKER_MACHINE_ALLOCATED", "BROKER_USER_AUTHFAILED_BAD_USER_PASSWORD", "BROKER_USER_LOCK_SSO", "BROKER_USERLOGGEDIN", "BROKER_USERLOGGEDOUT", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION", "VLSI_USERLOGGEDIN_REST", "TIMING_PROFILER_TUNNEL_CONNECTION", "TIMING_PROFILER_GET_LAUNCH_ITEMS", "TIMING_PROFILER_USER_AUTHENTICATION".
	metadata.event_type	O valor é determinado pelo campo "EventType". Se "EventType" for "ADMIN_USERLOGGEDOUT", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING_EXPIRED", "BROKER_USER_LOCK_SSO" ou "BROKER_USERLOGGEDOUT", "metadata.event_type" será "USER_LOGOUT". Se "EventType" for um dos seguintes: "AGENT_CONNECTED", "AGENT_PENDING", "AGENT_RECONNECTED", "BROKER_USERLOGGEDIN", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION", "VLSI_USERLOGGEDIN_REST", então "metadata.event_type" será "USER_LOGIN". Se "EventType" for "TIMING_PROFILER_GET_LAUNCH_ITEMS", "metadata.event_type" será "STATUS_UNCATEGORIZED". Se "EventType" for "AGENT_SHUTDOWN", "metadata.event_type" será "STATUS_SHUTDOWN". Se "EventType" for "AGENT_STARTUP" ou "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", "metadata.event_type" será "STATUS_STARTUP". Caso contrário, "metadata.event_type" será "GENERIC_EVENT".
	metadata.log_type	O valor é definido como "VMWARE_HORIZON".
	metadata.product_name	O valor é definido como "HORIZON".
	metadata.vendor_name	O valor é definido como "VMWARE".

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