Coletar registros do Tableau

Compatível com:

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

O Tableau é uma plataforma de Business Intelligence e visualização de dados que gera registros de atividade, autenticação e auditoria do usuário. O Tableau Server armazena arquivos de registro no sistema de arquivos do servidor, o que torna a coleta baseada em arquivos ideal para ingestã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 host do Tableau Server
  • 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 Tableau Server com permissões de administrador
  • Acesso aos arquivos de registro do Tableau Server no sistema de arquivos do servidor

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:
      filelog:
        include:
          - /var/opt/tableau/tableau_server/data/tabsvc/logs/httpd/access.*.log
          - /var/opt/tableau/tableau_server/data/tabsvc/logs/vizqlserver/*.log
          - /var/opt/tableau/tableau_server/data/tabsvc/logs/backgrounder/*.log
        start_at: beginning
    
    exporters:
      chronicle/tableau:
        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: TABLEAU
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/tableau_to_chronicle:
          receivers:
            - filelog
          exporters:
            - chronicle/tableau
    

Parâmetros de configuração

Substitua os seguintes marcadores de posição:

  • Configuração do receptor:

    • filelog: o tipo de receptor para coletar arquivos de registro do disco.
    • include: lista de caminhos de arquivo ou padrões glob a serem monitorados:
      • Linux: /var/opt/tableau/tableau_server/data/tabsvc/logs/
      • Windows: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\
      • Os principais arquivos de registro incluem httpd/access.*.log (registros de acesso do Apache), vizqlserver/*.log (registros do servidor VizQL) e backgrounder/*.log (registros de tarefas em segundo plano)
      • Ajuste os caminhos para que correspondam à instalação do Tableau Server.
    • start_at: defina como beginning para ler os arquivos de registro atuais desde o início ou como end para ler apenas as novas entradas.
  • Configuração do exportador:

    • tableau: 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.
    • TABLEAU: tipo de registro exatamente como aparece no Chronicle.
    • ingestion_labels: rótulos opcionais no formato YAML (por exemplo, env: production)

Configuração do pipeline: * tableau_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/tableau:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: TABLEAU
        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"
    

Verificar os locais dos arquivos de registro do Tableau Server

  1. Faça login no host do Tableau Server com privilégios de administrador.
  2. Verifique os diretórios de arquivos de registro:
    • Linux: /var/opt/tableau/tableau_server/data/tabsvc/logs/
    • Windows: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\
  3. Subdiretórios e arquivos de registro de chaves:
    • httpd/access.*.log: registros de acesso do Apache com detalhes da solicitação HTTP
    • vizqlserver/*.log: registros do servidor VizQL com atividade de consulta de visualização
    • backgrounder/*.log: registros de tarefas em segundo plano com atividade de job programada.
  4. (Opcional) Gere um arquivo de registro usando a ferramenta de linha de comando do TSM para verificação:

    tsm maintenance ziplogs -a -t -o -f tableau-logs.zip
    
  5. Atualize os caminhos include no agente do Bindplane config.yaml se o diretório de registros for diferente dos padrões.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
dataserver_permissions, local_dataserver, saved_credentials_viewerid, locale, server_oauth, :id, server_viewerid, dataserver_version, tablename, ElapsedTime, LastStatus, Timeszone additional.fields Pares de chave-valor mesclados de campos especificados
Conteúdo metadata.description Valor copiado diretamente após a remoção de "_"
ID, RemoteHost metadata.event_type Defina como USER_UNCATEGORIZED se o ID não estiver vazio, STATUS_UPDATE se RemoteHost estiver presente, caso contrário, GENERIC_EVENT
protocolo network.application_protocol Valor copiado diretamente
http_version network.application_protocol_version Valor copiado diretamente
método network.http.method Valor copiado diretamente após a remoção de ""
SizeBytes network.received_bytes Convertido em uinteger
session_id network.session_id Valor copiado diretamente
Workername principal.asset.hostname Valor copiado diretamente
RemoteHost principal.asset.ip Valor copiado diretamente
Workername principal.hostname Valor copiado diretamente
RemoteHost principal.ip Valor copiado diretamente
Porta principal.nat_port Convertido para número inteiro
ID principal.user.product_object_id Valor copiado diretamente
RemoteUser principal.user.userid Valor copiado diretamente se não estiver vazio ou "_"
logging_ctx security_result.detection_fields Par de chave-valor mesclado de logging_ctx
path target.file.full_path Valor copiado diretamente
dbname target.resource.name Valor copiado diretamente
metadata.product_name Defina como "Tableau".
metadata.vendor_name Defina como "TABLEAU"
temp_user event.idm.read_only_udm.principal.user.userid Mapeado do registro de alterações
user_name event.idm.read_only_udm.principal.user.userid Mapeado do registro de alterações
temp_domain event.idm.read_only_udm.principal.administrative_domain Mapeado do registro de alterações
temp_role event.idm.read_only_udm.principal.user.attribute.roles Mapeado do registro de alterações
source_info event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
user_application event.idm.read_only_udm.principal.application Mapeado do registro de alterações
temp_http_uri event.idm.read_only_udm.target.url Mapeado do registro de alterações
temp_api_call event.idm.read_only_udm.target.url Mapeado do registro de alterações
temp_site_id event.idm.read_only_udm.target.resource.name Mapeado do registro de alterações
java_method event.idm.read_only_udm.target.resource.name Mapeado do registro de alterações
java_class event.idm.read_only_udm.target.resource.type Mapeado do registro de alterações
temp_http_method event.idm.read_only_udm.network.http.method Mapeado do registro de alterações
temp_http_status event.idm.read_only_udm.network.http.response_code Mapeado do registro de alterações
"Computer" event.idm.read_only_udm.principal.hostname Mapeado do registro de alterações
"TimeGenerated" event.idm.read_only_udm.security_result.first_discovered_time Mapeado do registro de alterações
"_TimeReceived" event.idm.read_only_udm.security_result.last_discovered_time Mapeado do registro de alterações
"_IsBillable" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"_BilledSize" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"_Internal_WorkspaceResourceId" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"_ItemId" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"TenantId" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"_SubscriptionId" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"_ResourceId" event.idm.read_only_udm.principal.resource.id Mapeado do registro de alterações
"FilePath" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"Type" event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
"temp_message" event.idm.read_only_udm.metadata.description Mapeado do registro de alterações
"temp_logger_name" event.idm.read_only_udm.principal.application Mapeado do registro de alterações
"temp_pid" event.idm.read_only_udm.principal.process.pid Mapeado do registro de alterações
"temp_thread_name" event.idm.read_only_udm.principal.process.file.full_path Mapeado do registro de alterações
"temp_log_level" event.idm.read_only_udm.security_result.severity Mapeado do registro de alterações
appname event.idm.read_only_udm.metadata.product_event_type Mapeado do registro de alterações
id2 event.idm.read_only_udm.metadata.product_log_id Mapeado do registro de alterações
pid event.idm.read_only_udm.observer.process.pid Mapeado do registro de alterações
timestamp event.idm.read_only_udm.metadata.event_timestamp Mapeado do registro de alterações
user event.idm.read_only_udm.principal.user.userid Mapeado do registro de alterações
id1 event.idm.read_only_udm.network.session_id Mapeado do registro de alterações
logger event.idm.read_only_udm.observer.process.command_line Mapeado do registro de alterações
loglevel event.idm.read_only_udm.security_result.severity Mapeado do registro de alterações
user_id event.idm.read_only_udm.target.user.userid Mapeado do registro de alterações
site_id event.idm.read_only_udm.target.resource.id Mapeado do registro de alterações
message event.idm.read_only_udm.metadata.description Mapeado do registro de alterações
script_type event.idm.read_only_udm.target.resource.name Mapeado do registro de alterações
id3 event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
thread event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
function_name event.idm.read_only_udm.security_result.summary Mapeado do registro de alterações

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.