Coletar registros do VMware vCenter

Compatível com:

Este documento explica como ingerir registros do VMware vCenter no Google Security Operations usando o agente do Bindplane.

O VMware vCenter é uma plataforma de gerenciamento de servidores que gera mensagens JSON e syslog para operações de máquina virtual, gerenciamento de host, autenticação e mudanças de configuração.

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 servidor VMware vCenter
  • 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 à UI da Web de gerenciamento do VMware vCenter Server

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:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/vmware_vcenter:
        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: VMWARE_VCENTER
        raw_log_field: body
    
    service:
      pipelines:
        logs/vmware_vcenter_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/vmware_vcenter
    

Parâmetros de configuração

Substitua os seguintes marcadores de posição:

  • Configuração do receptor:

    • listen_address: endereço IP e porta a serem detectados:
      • 0.0.0.0 para ouvir em todas as interfaces (recomendado)
      • A porta 514 é a porta padrão do syslog (requer raiz no Linux; use 1514 para não raiz)
  • Configuração 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 copiado do console 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.

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

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, execute o seguinte comando:

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

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

      sudo journalctl -u observiq-otel-collector -f
      
  • Para reiniciar o agente do Bindplane no Windows, 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.
      4. Verifique se o serviço está em execução:

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

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

Configurar o syslog no VMware vCenter

  1. Faça login na UI da Web do vCenter Server Management.
  2. Acesse Syslog > Configuração de encaminhamento.
  3. Clique em Configurar para criar uma nova configuração de encaminhamento.
  4. Informe os seguintes detalhes de configuração:
    • Endereço do servidor: insira o endereço IP do agente do BindPlane.
    • Protocolo: selecione UDP.
    • Porta: insira o número da porta do agente do Bindplane (por exemplo, 514).
  5. Clique em Salvar.
  6. Clique em Enviar mensagem de teste para verificar a configuração.

Tabela de mapeamento de UDM

A tabela a seguir lista os mapeamentos de campos de registro para UDM para registros do VMware vCenter:

Campo de registro mapeamento de UDM
Access Mask principal.process.access_mask
Account Domain principal.administrative_domain
Account Name target.user.userid
AccessControlRuleAction security_result.action
AccessControlRuleName security_result.rule_name
ACPolicy security_result.rule_labels
admin principal.resource.attribute.labels
agent.hostname principal.hostname,
principal.asset.hostname
agent.type observer.application
agent.version intermediary.platform_version
alarm_target about.resource.name
api_call_method metadata.product_event_type
app principal.application
ApplicationProtocol network.application_protocol
appname principal.application
auth_date_time metadata.collected_timestamp
auth_user target.user.userid
Authentication Package security_result.about.resource.name
basedn_group_iden target.user.group_identifiers
bytes_received network.received_bytes
bytes_sent network.sent_bytes
Client target.user.attribute.labels
Client Address principal.ip
Client Port principal.port
client_ip principal.ip,
principal.asset.ip
client_port principal.port
ClientVersion target.platform_version
cmd target.process.command_line
ConnectionID security_result.about.labels
cor_id metadata.product_log_id
data_center target.location.name
datacenter target.location.name
desc metadata.description
description_data metadata.description
dest_ip target.ip,
target.asset.ip
dest_port target.port
DeviceUUID metadata.product_log_id
domain principal.administrative_domain
dstip target.ip,
target.asset.ip
EgressZone target.location.name
error_code security_result.detection_fields
error_message security_result.summary
event_name metadata.product_event_type
eventid metadata.product_event_type
EventPriority security_result.severity,
security_result.severity_details
@fields.company_name principal.user.company_name
@fields.facility principal.resource.resource_subtype
@fields.host principal.hostname,
principal.asset.hostname
@fields.privatecloud_id principal.resource_ancestors.product_object_id
@fields.privatecloud_name principal.resource_ancestors.name
@fields.procid principal.process.pid
@fields.region_id principal.location.country_or_region
file_path target.process.file.full_path
file_type network.http.response_headers
FirstPacketSecond security_result.about.labels
f_path target.file.full_path
function security_result.detection_fields
hmethod network.http.method
host.architecture principal.asset.hardware
host.id observer.asset_id
host.ip principal.ip,
principal.asset.ip
host.mac principal.mac
host.os.kernel principal.platform_patch_level
host.os.platform target.platform
host.os.version principal.platform_version
host_ip principal.ip,
principal.asset.ip
http_method network.http.method
HTTPResponse network.http.response_code
http_version network.tls.version_protocol
i_ip intermediary.ip,
intermediary.asset.ip
i_port intermediary.port
IngressZone principal.location.name
InitiatorBytes network.sent_bytes
InitiatorPackets network.sent_packets
insertId metadata.product_log_id
InstanceId target.asset_id
inter_host_name intermediary.hostname
inter_ip intermediary.ip
inter_port target.port
intermediary_ip intermediary.ip
intermediary_port intermediary.port
ip target.ip,
target.asset.ip
ips principal.ip,
principal.asset.ip
jsonPayload.appname security_result.detection_fields
jsonPayload.facility security_result.detection_fields
jsonPayload.hostname principal.hostname,
principal.asset.hostname
jsonPayload.message security_result.detection_fields
jsonPayload.priority security_result.detection_fields
jsonPayload.version security_result.detection_fields
kv_msg1.cipher network.tls.cipher
kv_msg1.ctladdr intermediary.user.attribute.labels
kv_msg1.daemon security_result.about.labels
kv_msg1.from network.email.from
kv_msg1.get_error intermediary.user.attribute.labels
kv_msg1.msgid network.email.mail_id
kv_msg1.proto security_result.about.labels
kv_msg1.size network.sent_bytes
kv_msg1.stat security_result.summary
kv_msg1.to network.email.to
kv_msg1.verify security_result.description,
security_result.action
kv_msg1.version network.tls.version
labels.log_type metadata.product_event_type
labels.net.host.ip principal.ip,
principal.asset.ip
labels.net.host.port principal.port
labels.net.peer.ip intermediary.ip,
intermediary.asset.ip,
target.ip,
target.asset.ip
labels.net.peer.port intermediary.port,
target.port
labels.net.transport network.ip_protocol
level security_result.severity,
security_result.severity_details
level_name security_result.severity,
security_result.severity_details
local_address_1 observer.ip
local_address_2 observer.ip
local_port_1 observer.port
log.file.path target.process.file.full_path
log.source.address intermediary.ip,
intermediary.port
log.syslog.severity.name security_result.severity_details
log_id metadata.product_log_id
log_level security_result.severity,
security_result.severity_details
logName security_result.category_details
Logon Account principal.user.userid
logstash.irm_site target.location.name
logstash.process.host additional.fields
mail_from network.email.from
mail_to network.email.to
msg metadata.description
name about.group.group_display_name
namespace principal.namespace
NAPPolicy security_result.rule_labels
o_ip observer.ip,
observer.asset.ip
o_port observer.port
obj_h additional.fields
obj_p additional.fields
p_ip principal.ip,
principal.asset.ip
p_log_id metadata.product_log_id
p_port principal.port
p_user_id principal.user.userid
p_vm_name target.resource.name
parsable_message metadata.description
pid target.process.pid
port intermediary.port
ppid principal.process.pid
prin_app principal.application
prin_domain principal.administrative_domain
prin_name principal.resource.attribute.labels
prin_pid principal.process.pid
principal_email principal.user.email_addresses
principal_ip1 principal.ip,
principal.asset.ip
principal_ip2 principal.ip,
principal.asset.ip
principal_port principal.port
priority security_result.severity,
security_result.severity_details
process principal.application
process_id principal.process.pid
product_event_type metadata.product_event_type
program principal.application
Protocol network.ip_protocol
providername principal.application
r_bytes network.received_bytes
r_name principal.resource.name
ReferencedHost target.hostname,
target.asset.hostname
Relative Target Name target.file.full_path
relay intermediary.hostname,
intermediary.ip
request_path target.url
resource.labels.project_id src.resource_ancestors.product_object_id
resource.type src.user.attribute.labels
resource_name target.resource.name
ResponderBytes network.received_bytes
ResponderPackets network.received_packets
response_code network.http.response_code
response_details target.resource.attribute.labels
role target.user.attribute.roles
s_bytes network.sent_bytes
sec_desc security_result.description
Security ID target.user.windows_sid
security_result_action_detail security_result.action_details
server_name target.hostname,
target.asset.hostname
session_id network.session_id
severity security_result.severity,
security_result.severity_details
severity_data security_result.severity,
security_result.severity_details
Share Name target.resource.name
sid about.group.windows_sid
Source Network Address principal.ip
Source Port principal.port
source_port principal.port
src_ip principal.ip
srcip principal.ip,
principal.asset.ip
ssh_proto network.application_protocol
summary security_result.summary
syslog_host target.hostname,
target.asset.hostname
t_ip target.ip,
target.asset.ip
t_port target.port
t_url target.url
tags additional.fields
principal_app principal.application
target_domain target.administrative_domain
target_host target.hostname,
target.asset.hostname
target_ip1 target.ip,
target.asset.ip
target_ip2 target.ip,
target.asset.ip
target_port target.port
target_userid target.user.userid
temp_host intermediary.hostname
tgt_domain target.administrative_domain
tgt_user target.user.userid
thread_id principal.resource.attribute.labels
tls_cipher network.tls.cipher
type metadata.product_event_type
upn_name intermediary.url
upstream_ip target.ip,
target.asset.ip
upstream_port target.port
URL target.url
User security_result.summary
user target.user.userid,
principal.user.userid
User ID target.user.userid
user_id principal.user.userid
UserAgent network.http.user_agent,
network.http.parsed_user_agent
username principal.user.userid
usrName target.user.userid
vc_event_obj_id target.asset.asset_id
vc_event_severity security_result.severity,
security_result.severity_details
vc_username target.user.userid
ver_proto network.tls.version
version metadata.product_version
@version principal.platform_version
vpxd_some_id additional.fields
LEEF_version additional.fields
ICMPType additional.fields
ICMPCode additional.fields
IngressInterface additional.fields
EgressInterface additional.fields
WebApplication additional.fields
DNSQuery additional.fields
DNSRecordType additional.fields
DNSResponseType additional.fields
DNS_TTL additional.fields
ApplicationProtocol additional.fields
service.type additional.fields
log.syslog.facility.code additional.fields
log.syslog.facility.name additional.fields
log.syslog.severity.code additional.fields
log.syslog.priority additional.fields
host.os.name additional.fields
host.os.build additional.fields
labels.plugin_id additional.fields
opID additional.fields
sub additional.fields
api_invocations additional.fields
vc_event_cat_0 additional.fields
vc_event_cat_1 additional.fields
vc_event_chain_id additional.fields
vc_event_obj_name additional.fields
vc_event_obj_type additional.fields
p_log_id_repeat additional.fields
sys_priority additional.fields
facility additional.fields
originator additional.fields
originator_id additional.fields
subsystem additional.fields
request_timestamp additional.fields
response_flags additional.fields
duration_total_ms additional.fields
duration_upstream_connect_ms additional.fields
duration_response_tx_ms additional.fields
local_port_2 additional.fields
proc_id additional.fields
eventid_label additional.fields
Logger_Name additional.fields
subcomponent additional.fields
op_id additional.fields
vcenter_uuid_1 additional.fields
vcenter_uuid_2 additional.fields
object_lookup_method additional.fields
conn_id additional.fields
performed_action additional.fields
login_time additional.fields
open_connections additional.fields
total_connections additional.fields
channel_id additional.fields
line_number additional.fields
vc_event_desc additional.fields
uid additional.fields
euid additional.fields
ruser additional.fields
tty additional.fields
tenant additional.fields
duration_ms additional.fields
provider additional.fields
provider_type additional.fields
response_flag additional.fields
http_path additional.fields
unknown_metric_1 additional.fields
unknown_metric_2 additional.fields
sequence_id additional.fields
syslog_facility_code additional.fields
syslog_severity_code additional.fields
syslog_severity additional.fields
syslog_pri additional.fields
syslog_facility additional.fields
logstash.collect.timestamp additional.fields
logstash.ingest.timestamp additional.fields
logstash.process.timestamp additional.fields
logstash.irm_site additional.fields
logstash.irm_environment additional.fields
logstash.irm_region additional.fields
agent.id additional.fields
agent.ephemeral_id additional.fields
ecs.version additional.fields
input.type additional.fields

Referência de delta de mapeamento de UDM

Em 15 de setembro de 2026, o Google SecOps lançou uma nova versão do analisador do VMware vCenter, que inclui mudanças no mapeamento dos campos de registro do VMware vCenter para os campos do UDM.

Delta de mapeamento de campo de registro

A tabela a seguir lista o delta de mapeamento para os campos de registro para UDM do VMware vCenter expostos antes de 15 de setembro de 2026 e posteriormente (listados nas colunas Mapeamento antigo e Mapeamento atual, respectivamente):

Campo de registro Mapeamento antigo Mapeamento atual Motivo para a alteração
appname target.application principal.application Essa é considerada a ferramenta que inicia a ação pelo usuário, tornando-a o aplicativo principal que origina o evento, em vez do destino em que a ação é realizada.
auth_user principal.user.userid target.user.userid Este é um evento de login do usuário em que o usuário está sendo afetado.
logstash.process.host target.hostname additional.fields Esse campo é adicionado pelo pipeline do Logstash. Ele indica o nome do host do servidor em que o processo do Logstash está em execução, que faz parte da infraestrutura de coleta de registros. Esse host não é a origem do evento em si, mas um intermediário que processa o registro.
username target.user.userid principal.user.userid Esse ID do usuário pertence à origem do evento, não ao destino.
domain target.administrative_domain principal.administrative_domain Esse domínio pertence à origem do evento, não ao destino.
resource.labels.project_id src.cloud.project.id src.resource_ancestors.product_object_id O campo anterior foi descontinuado.
target_app target.application principal.application O registro descreve especificamente um Logon Único interno.
process additional.fields principal.application Mais adequado.
app target.application principal.application O registro descreve especificamente um Logon Único interno.
@fields.privatecloud_id principal.cloud.project.id principal.resource_ancestors.product_object_id O campo anterior foi descontinuado.
@fields.privatecloud_name principal.cloud.project.name principal.resource_ancestors.name O campo anterior foi descontinuado.
@fields.facility principal.resource.type principal.resource.resource_subtype O campo anterior foi descontinuado.
Client target.labels target.user.attribute.labels O campo anterior foi descontinuado.
kv_msg1.ctladdr intermediary.labels intermediary.user.attribute.labels O campo anterior foi descontinuado.
kv_msg1.get_error intermediary.labels intermediary.user.attribute.labels O campo anterior foi descontinuado.
resource.type src.labels src.user.attribute.labels O campo anterior foi descontinuado.
admin principal.user.attribute.labels principal.resource.attribute.labels O campo anterior foi descontinuado.
role target.user.role_name target.user.attribute.roles O campo anterior foi descontinuado.
syslog_host Não mapeada target.hostname Mapeamento de campo recém-adicionado.
log.source.address Não mapeada intermediary.ip,
intermediary.port
Mapeamento de campo recém-adicionado.
agent.type Não mapeada observer.application Mapeamento de campo recém-adicionado.
agent.version Não mapeada intermediary.platform_version Mapeamento de campo recém-adicionado.
pid Não mapeada target.process.pid Mapeamento de campo recém-adicionado.
temp_host Não mapeada intermediary.hostname Mapeamento de campo recém-adicionado.
port Não mapeada intermediary.port Mapeamento de campo recém-adicionado.
inter_hostname Não mapeada intermediary.hostname Mapeamento de campo recém-adicionado.
tgt_user Não mapeada target.user.userid Mapeamento de campo recém-adicionado.
tgt_domain Não mapeada target.administrative_domain Mapeamento de campo recém-adicionado.
alarm_target Não mapeada about.resource.name Mapeamento de campo recém-adicionado.
prin_app Não mapeada principal.application Mapeamento de campo recém-adicionado.
dest_ip Não mapeada target.ip Mapeamento de campo recém-adicionado.
dest_port Não mapeada target.port Mapeamento de campo recém-adicionado.
error_message Não mapeada security_result.summary Mapeamento de campo recém-adicionado.
error_code Não mapeada security_result.detection_fields Mapeamento de campo recém-adicionado.
function Não mapeada security_result.detection_fields Mapeamento de campo recém-adicionado.
thread_id Não mapeada principal.resource.attribute.labels Mapeamento de campo recém-adicionado.
obj_p Não mapeada additional.fields Mapeamento de campo recém-adicionado.
obj_h Não mapeada additional.fields Mapeamento de campo recém-adicionado.

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.