Coletar registros do Tanium Asset

Compatível com:

Neste documento, explicamos como ingerir registros do Tanium Asset no Google Security Operations usando dois métodos diferentes.

Você pode escolher entre a exportação nativa do Amazon S3 do Tanium Connect ou o encaminhamento de syslog em tempo real usando o Bindplane. Os dois métodos usam o módulo Tanium Connect para extrair dados de recursos do Tanium e encaminhá-los ao Chronicle para análise e monitoramento.

Antes de começar

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

  • Uma instância do Google SecOps
  • Acesso privilegiado ao console do Tanium (módulo Connect) para configurar destinos de exportação
  • Escolha seu método de integração preferido:
    • Opção 1 (recomendada): acesso privilegiado à AWS (S3, IAM) para exportação nativa do S3
    • Opção 2: um host do Windows 2016 ou posterior ou do Linux com systemd para instalação do agente do BindPlane

Opção 1: configurar a exportação de registros do Tanium Asset usando o AWS S3

Criar um bucket do Amazon S3

  1. Crie um bucket do Amazon S3 seguindo este guia do usuário: Como criar um bucket.
  2. Salve o Nome e a Região do bucket para referência futura (por exemplo, tanium-asset-logs).
  3. Crie um usuário seguindo este guia do usuário: Como criar um usuário do IAM.
  4. Selecione o Usuário criado.
  5. Selecione a guia Credenciais de segurança.
  6. Clique em Criar chave de acesso na seção Chaves de acesso.
  7. Selecione Serviço de terceiros como Caso de uso.
  8. Clique em Próxima.
    • Opcional: adicione uma tag de descrição.
  9. Clique em Criar chave de acesso.
  10. Clique em Fazer o download do arquivo .csv para salvar a chave de acesso e a chave de acesso secreta para referência futura.
  11. Clique em Concluído.
  12. Selecione a guia Permissões.
  13. Clique em Adicionar permissões na seção Políticas de permissões.
  14. Selecione Adicionar permissões.
  15. Selecione Anexar políticas diretamente.
  16. Pesquise a política AmazonS3FullAccess.
  17. Selecione a política.
  18. Clique em Próxima.
  19. Clique em Adicionar permissões

Configurar o Tanium Connect para exportação do S3

  1. Faça login no Console do Tanium com privilégios de administrador.
  2. Acesse Módulos > Conectar > Visão geral e clique em Criar conexão.
  3. Clique em Criar.
  4. Informe os seguintes detalhes de configuração:
    • Nome: insira um nome descritivo (por exemplo, Google SecOps Asset S3 Export).
    • Descrição: descrição opcional para essa conexão.
    • Ativar: selecione Ativar para executar em uma programação.
  5. Clique em Próxima.
  6. Na configuração de Origem:
    • Origem: selecione Pergunta salva.
    • Pergunta: escolha uma pergunta salva que retorne dados de recursos ou crie uma nova com sensores relacionados a recursos (por exemplo, nome do computador, endereço IP, plataforma do SO, domínio).
    • Grupo de computadores: selecione o grupo de computadores que será usado para a coleta de dados de recursos.
  7. Clique em Próxima.
  8. Na configuração de Destino:
    • Destino: escolha AWS S3.
    • Nome: insira um nome de destino (por exemplo, Chronicle Asset S3).
    • ID da chave de acesso da AWS: insira o ID da chave de acesso do usuário do IAM.
    • Chave de acesso secreta da AWS: insira a chave de acesso secreta do usuário do IAM.
    • Nome do bucket do S3: tanium-asset-logs.
    • Prefixo de chave do S3: tanium/assets/ (prefixo opcional para a organização).
    • Região: selecione a região da AWS em que o bucket do S3 está localizado.
  9. Clique em Próxima.
  10. Na configuração de Formatação:
    • Formato: selecione JSON para exportar dados estruturados.
    • Colunas: selecione os campos de recursos que você quer exportar e formate-os adequadamente.
  11. Clique em Próxima.
  12. Na configuração Programação:
    • Programação: configure a programação de entrega (por exemplo, a cada hora ou diariamente).
    • Data/hora de início: defina quando a conexão deve começar a ser executada.
  13. Clique em Salvar para criar a conexão e iniciar a exportação automatizada do S3.

(Opcional) Criar usuário e chaves do IAM somente leitura para o Google SecOps

  1. Acesse Console da AWS > IAM > Usuários > Adicionar usuários.
  2. Clique em Add users.
  3. Informe os seguintes detalhes de configuração:
    • Usuário: insira secops-reader.
    • Tipo de acesso: selecione Chave de acesso — Acesso programático.
  4. Clique em Create user.
  5. Anexe a política de leitura mínima (personalizada): Usuários > secops-reader > Permissões > Adicionar permissões > Anexar políticas diretamente > Criar política.
  6. JSON:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject"],
          "Resource": "arn:aws:s3:::tanium-asset-logs/*"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::tanium-asset-logs"
        }
      ]
    }
    
  7. Nome = secops-reader-policy.

  8. Clique em Criar política > pesquisar/selecionar > Próxima > Adicionar permissões.

  9. Crie uma chave de acesso para secops-reader: Credenciais de segurança > Chaves de acesso > Criar chave de acesso > faça o download do .csv (você vai colar esses valores no feed).

Configurar um feed no Google SecOps para ingerir registros do Tanium Asset

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em + Adicionar novo feed de notícias.
  3. No campo Nome do feed, insira um nome para o feed (por exemplo, Tanium Asset logs).
  4. Selecione Amazon S3 V2 como o Tipo de origem.
  5. Selecione Tanium Asset como o Tipo de registro.
  6. Clique em Próxima.
  7. Especifique valores para os seguintes parâmetros de entrada:
    • URI do S3: s3://tanium-asset-logs/tanium/assets/
    • Opções de exclusão da origem: selecione a opção de exclusão de acordo com sua preferência.
    • Idade máxima do arquivo: inclua arquivos modificados nos últimos dias. O padrão é 180 dias.
    • ID da chave de acesso: chave de acesso do usuário com acesso ao bucket do S3.
    • Chave de acesso secreta: chave secreta do usuário com acesso ao bucket do S3.
    • Namespace do recurso: o namespace do recurso.
    • Rótulos de ingestão: o rótulo aplicado aos eventos desse feed.
  8. Clique em Próxima.
  9. Revise a configuração do novo feed de notícias na tela Finalizar e clique em Enviar.

Opção 2: configurar a exportação de registros do Tanium Asset usando o syslog e o Bindlane

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
    

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 mais opções de instalação, consulte o guia de instalação do agente do BindPlane.

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 /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: <PLACEHOLDER_CUSTOMER_ID>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'TANIUM_ASSET'
        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 <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.
    • Substitua <PROJECT_NUMBER> pelo número do projeto em IAM e administrador > Configurações.
    • Substitua <PLACEHOLDER_CUSTOMER_ID> pelo ID de cliente real.
    • 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 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/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: <PLACEHOLDER_CUSTOMER_ID>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'TANIUM_ASSET'
        raw_log_field: body
        ingestion_labels:
    

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
    
  • Para reiniciar o agente do Bindplane no Windows, use o console Serviços ou digite o seguinte comando:

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

Configurar o encaminhamento do Syslog no Tanium Asset

  1. Faça login no Console do Tanium com privilégios de administrador.
  2. Acesse Módulos > Conectar > Visão geral e clique em Criar conexão.
  3. Clique em Criar.
  4. Informe os seguintes detalhes de configuração:
    • Nome: insira um nome descritivo (por exemplo, Google SecOps Asset Integration).
    • Descrição: descrição opcional para essa conexão.
    • Ativar: selecione Ativar para executar em uma programação.
  5. Clique em Próxima.
  6. Na configuração de Origem:
    • Origem: selecione Pergunta salva.
    • Pergunta: escolha uma pergunta salva que retorne dados de recursos ou crie uma nova com sensores relacionados a recursos.
    • Grupo de computadores: selecione o grupo de computadores que será usado para a coleta de dados de recursos.
  7. Clique em Próxima.
  8. Na configuração de Destino:
    • Destino: escolha SIEM/Syslog.
    • Nome: insira um nome de destino (por exemplo, Chronicle Asset Syslog).
    • Host: insira o IP do Bindplane.
    • Porta: insira o número da porta do Bindplane (por exemplo, 514).
    • Protocolo: selecione UDP.
    • Formato: selecione SYSLOG RFC 5424.
    • Fuso horário: selecione o fuso horário UTC para garantir a consistência universal entre os sistemas.
  9. Clique em Próxima.
  10. Na configuração de Formatação:
    • Formato: selecione JSON.
    • Colunas: selecione os campos de recursos que você quer encaminhar (por exemplo, nome do computador, endereço IP, plataforma do SO, domínio).
  11. Clique em Próxima.
  12. Na configuração Programação:
    • Programação: configure a programação de entrega (por exemplo, a cada hora).
    • Data/hora de início: defina quando a conexão deve começar a ser executada.
  13. Clique em Salvar para criar a conexão e iniciar o encaminhamento.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
application_name entity.metadata.source_labels.value O valor é extraído do campo "application_name", se ele existir no registro bruto.
application_vendor entity.metadata.source_labels.value O valor é extraído do campo "application_vendor", se ele existir no registro bruto.
application_version entity.metadata.product_version O valor é extraído do campo "application_version", se ele existir no registro bruto.
BIOS_Current_Language entity.metadata.source_labels.value O valor é extraído do campo "BIOS_Current_Language", se ele existir no registro bruto.
BIOS_Release_Date entity.metadata.source_labels.value O valor é extraído do campo "BIOS_Release_Date", se ele existir no registro bruto.
BIOS_Vendor entity.metadata.source_labels.value O valor é extraído do campo "BIOS_Vendor", se ele existir no registro bruto.
BIOS_Version entity.metadata.product_version O valor é extraído do campo "BIOS_Version", se ele existir no registro bruto.
Chassis Type entity.entity.asset.category O valor é extraído do campo "Chassis Type", se ele existir no registro bruto.
Computer ID entity.entity.asset.product_object_id O valor é extraído do campo "ID do computador", se ele existir no registro bruto. Também é usado para preencher entity.relations.entity.asset.asset_id com o prefixo "id: ".
Computer Name entity.entity.asset.hostname O valor é retirado do campo "Nome do computador", se ele existir no registro bruto.
Count entity.metadata.source_labels.value O valor é extraído do campo "Count", se ele existir no registro bruto.
Endpoint Fingerprint entity.entity.asset.hardware.serial_number O valor é extraído do campo "Impressão digital do endpoint", se houver, no registro bruto.
IP Address entity.entity.asset.ip Os valores são retirados do campo "Endereço IP" e adicionados como endereços IP separados à matriz.
Last Logged In User entity.relations.entity.user.userid O valor é extraído do campo "Último usuário conectado", com qualquer prefixo de domínio removido, se houver no registro bruto.
Last Reboot entity.entity.asset.last_boot_time O valor é analisado no campo "Última reinicialização" e formatado como um carimbo de data/hora, se existir no registro bruto.
MAC Address entity.entity.asset.mac Os valores são retirados do campo "Endereço MAC" e adicionados como endereços MAC separados à matriz.
Manufacturer entity.entity.asset.hardware.manufacturer O valor é extraído do campo "Fabricante", se ele existir no registro bruto.
Operating System entity.entity.asset.platform_software.platform_version O valor é extraído do campo "Sistema operacional", se ele existir no registro bruto. Usado para determinar o valor de entity.entity.asset.platform_software.platform (WINDOWS, LINUX ou MAC).
platform entity.entity.asset.platform_software.platform_version O valor é extraído do campo "platform", se ele existir no registro bruto. Usado para determinar o valor de entity.entity.asset.platform_software.platform (WINDOWS, LINUX ou MAC).
serial_number entity.entity.asset.hardware.serial_number O valor é extraído do campo "serial_number", se ele existir no registro bruto.
version entity.entity.asset.platform_software.platform_version O valor é extraído do campo "version", se ele existir no registro bruto. Usado para determinar o valor de entity.entity.asset.platform_software.platform (WINDOWS, LINUX ou MAC).
N/A entity.metadata.collected_timestamp Defina como o create_time do lote.
N/A entity.metadata.vendor_name Sempre definido como "TANIUM_ASSET".
N/A entity.metadata.product_name Sempre definido como "TANIUM_ASSET".
N/A entity.metadata.entity_type Sempre definido como "ASSET".
N/A entity.relations.entity_type Sempre definido como "USER".
N/A entity.relations.relationship Sempre definido como "OWNS".
comp_serial_num _asset_entity.asset.product_object_id Mapeado do registro de alterações
application_name", "count", "application_vendor", "BIOS_Release_Date", "BIOS_Vendor", and "BIOS_Current_Language metadata.source_labels Mapeado do registro de alterações
application_version" and "BIOS_Version metadata.product_version Mapeado do registro de alterações
computer_id entity.asset.asset_id Mapeado do registro de alterações
comp_serial_num hardware.serial_number 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.