Coletar registros do CipherTrust Manager

Versão do analisador:18.0

Compatível com:

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

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 CipherTrust Manager
  • Se você 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 console da Web do CipherTrust Manager.

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.
  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 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 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 vai aparecer como EM EXECUÇÃO.

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
    
  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 vai aparecer como ativo (em execução).

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 syslog e enviar ao Google SecOps

Localizar o arquivo de configuração

  • Linux:

    sudo nano /etc/bindplane-agent/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/ciphertrust_manager:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: CIPHERTRUST_MANAGER
            raw_log_field: body
    
    service:
        pipelines:
            logs/ciphertrust_manager_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/ciphertrust_manager
    

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 autenticação de ingestão:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID do cliente copiado do console do Google SecOps
    • endpoint: URL do endpoint regional:
      • EUA: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Ásia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Consulte a lista completa em Endpoints regionais.

Salvar o arquivo de configuração

  • Depois de editar, salve o arquivo:
    • Linux: pressione Ctrl+O, Enter e 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 em 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 para o CipherTrust Manager

  1. Faça login no console da Web do CipherTrust Manager.
  2. Acesse Configurações de administrador > Notificações > Syslog.
  3. Clique em Novo servidor Syslog.
  4. Informe os seguintes detalhes de configuração:
    • Host: insira o endereço IP do agente do Bindplane.
    • Porta: digite o número da porta do agente do Bindplane (padrão 514).
    • Formato do registro: selecione RFC 5424.
    • Transporte: selecione UDP.
  5. Clique em Salvar.

Tabela de mapeamento de UDM

Campo de registro Mapeamento do UDM Lógica
message about Mapeado: CEF → about
deviceNtDomain about.administrative_domain Renomeado/mapeado
deviceExternalId about.asset.asset_id Mapeado diretamente
device_product about.asset.asset_id Mapeado diretamente
device_vendor about.asset.asset_id Mapeado diretamente
fileHash about.file.full_path Mapeado diretamente
filePath about.file.full_path Renomeado/mapeado
_hash about.file.sha256 Renomeado/mapeado
fileHash about.file.sha256 Renomeado/mapeado
fsize about.file.size Renomeado/mapeado
dvchost about.hostname Renomeado/mapeado
ips about.ip Mesclado
message about.ip Mapeado: CEF → ips
dvc_mac about.mac Mapeado: slot → mac_address
dvcmac about.mac Mesclado
mac_address about.mac Mesclado
message about.mac Mapeado: CEF → mac_address, CEF → dvcmac
deviceTranslatedAddress about.nat_ip Mesclado
message about.nat_ip Mapeado: CEF → deviceTranslatedAddress
Emne about.process.command_line Mapeado diretamente
Path about.process.command_line Mapeado diretamente
Subject about.process.command_line Mapeado diretamente
deviceProcessName about.process.command_line Renomeado/mapeado
dvcpid about.process.pid Renomeado/mapeado
message about.resource.attribute.permissions Mapeado: CEF → permissions
permissions about.resource.attribute.permissions Mesclado
Internal_label additional.fields Mesclado
additional_alias_alias_field additional.fields Mesclado
additional_alias_index_field additional.fields Mesclado
additional_alias_type_field additional.fields Mesclado
additional_cfp1 additional.fields Mesclado
additional_cfp2 additional.fields Mesclado
additional_cfp3 additional.fields Mesclado
additional_cfp4 additional.fields Mesclado
additional_cn1 additional.fields Mesclado
additional_cn2 additional.fields Mesclado
additional_cn3 additional.fields Mesclado
additional_cs1 additional.fields Mesclado
additional_cs2 additional.fields Mesclado
additional_cs3 additional.fields Mesclado
additional_cs4 additional.fields Mesclado
additional_cs5 additional.fields Mesclado
additional_cs6 additional.fields Mesclado
additional_cs7 additional.fields Mesclado
additional_devicePayloadId additional.fields Mesclado
additional_eventId additional.fields Mesclado
additional_flexString1 additional.fields Mesclado
additional_fname additional.fields Mesclado
algorithm_label additional.fields Mesclado
app_connector_type_label additional.fields Mesclado
assignSelfAsOwner_label additional.fields Mesclado
auth_domain_label additional.fields Mesclado
client_name_label additional.fields Mesclado
client_type_label additional.fields Mesclado
codeDesc_label additional.fields Mesclado
code_label additional.fields Mesclado
createdAt_label additional.fields Mesclado
cs2 additional.fields Mapeado: arc_test → additional_cs2
cs5_label additional.fields Mesclado
customAttributes_label additional.fields Mesclado
deatils_domain_id_label additional.fields Mesclado
details_user_metadata_current_domain_id_label additional.fields Mesclado
details_user_metadata_current_persistedData_label additional.fields Mesclado
details_user_metadata_current_persistedData_paging_label additional.fields Mesclado
domain_id_label additional.fields Mesclado
domain_label additional.fields Mesclado
emptyMaterial_label additional.fields Mesclado
feature_label additional.fields Mesclado
format_label additional.fields Mesclado
generateKeyId_label additional.fields Mesclado
idType_label additional.fields Mesclado
id_label additional.fields Mesclado
identifier_label additional.fields Mesclado
interfaceName_label additional.fields Mesclado
interfaceType_label additional.fields Mesclado
label_label additional.fields Mesclado
message additional.fields Valores mapeados (71 no total, por exemplo, CEF → additional_eventId, CEF → `additional_devicePayloa...
messageFormat_label additional.fields Mesclado
meta_label additional.fields Mesclado
objectType_label additional.fields Mesclado
ownerId_label additional.fields Mesclado
padded_label additional.fields Mesclado
permissions_label additional.fields Mesclado
record_type_id_label additional.fields Mesclado
refresh_token_counts_label additional.fields Mesclado
refresh_token_counts_no_label additional.fields Mesclado
refresh_token_counts_total_label additional.fields Mesclado
refresh_token_id_label additional.fields Mesclado
renew_refresh_token_label additional.fields Mesclado
requestId_label additional.fields Mesclado
requestIdentifierType_label additional.fields Mesclado
requestIdentifier_label additional.fields Mesclado
scope_label additional.fields Mesclado
service_label additional.fields Mesclado
switch_domain_id_label additional.fields Mesclado
undeletable_label additional.fields Mesclado
unexportable_label additional.fields Mesclado
version_label additional.fields Mesclado
xts_label additional.fields Mesclado
zone_id_label additional.fields Mesclado
details_grant_type extensions.auth.auth_details Mapeado diretamente
logon_type_temp extensions.auth.mechanism Mesclado
message extensions.auth.mechanism Mapeado: CEF → logon_type_temp, Get User → logon_type_temp
message intermediary Mapeado: CEF → intermediary
proxy_ip intermediary.ip Mesclado
msg metadata.description Renomeado/mapeado
Generated metadata.event_timestamp Analisado como yyyy-MM-ddTHH:mm:ss
Received metadata.event_timestamp Analisado como yyyy-MM-ddTHH:mm:ss
event_time metadata.event_timestamp Analisado como ISO8601
rt metadata.event_timestamp Analisado como yyyy-MM-ddTHH:mm:ssZ
syslog_timestamp metadata.event_timestamp Analisado como MMM dd HH:mm:ss
syslog_timestamp_with_year metadata.event_timestamp Analisado como MMM dd HH:mm:ss yyyy
cef_message metadata.event_type Mapeado: (Use Key/Update Key/Export Key) → USER_RESOURCE_UPDATE_CONTENT
event_name metadata.event_type Mapeado: "LogSpyware","LogPredictiveMachineLearning" → SCAN_UNCATEGORIZED
has_principal metadata.event_type Mapeado: true → NETWORK_CONNECTION
has_user metadata.event_type Mapeado: true → USER_UNCATEGORIZED
message metadata.event_type Valores mapeados (12 no total, por exemplo, CEF → PROCESS_UNCATEGORIZED, CEF → SCAN_UNCATEGORIZED,...
device_event_class_id metadata.product_event_type Mapeado diretamente
event_name metadata.product_event_type Mapeado diretamente
externalId metadata.product_log_id Mapeado diretamente
id metadata.product_log_id Mapeado diretamente
uid metadata.product_log_id Mapeado diretamente
device_product metadata.product_name Mapeado diretamente
product metadata.product_name Mapeado diretamente
product_name metadata.product_name Mapeado diretamente
device_version metadata.product_version Mapeado diretamente
device_vendor metadata.vendor_name Renomeado/mapeado
app_protocol_output network.application_protocol Mapeado diretamente
deviceDirection network.direction Mapeado: 0 → INBOUND, 1 → OUTBOUND
message network.direction Mapeado: CEF → INBOUND, CEF → OUTBOUND
requestMethod network.http.method Renomeado/mapeado
requestClientApplication network.http.user_agent Renomeado/mapeado
ip_protocol_out network.ip_protocol Mapeado diretamente
in network.received_bytes Renomeado/mapeado
out network.sent_bytes Renomeado/mapeado
sntdom principal.administrative_domain Renomeado/mapeado
sourceServiceName principal.application Renomeado/mapeado
syslog_host principal.asset.hostname Mapeado diretamente
details_user_metadata_current_domain_name principal.domain.name Mapeado diretamente
Group_name principal.group.group_display_name Mapeado diretamente
Gruppenavn principal.group.group_display_name Mapeado diretamente
Device_name principal.hostname Mapeado diretamente
Enhetsnavn principal.hostname Mapeado diretamente
shost principal.hostname Renomeado/mapeado
syslog_host principal.hostname Mapeado diretamente
client_ip principal.ip Mesclado
message principal.ip Mapeado: CEF → principal_ip, CEF → shost, CEF → client_ip, (Falha no handshake SSL...
principal_ip principal.ip Mesclado
shost principal.ip Mesclado
mac principal.mac Mesclado
message principal.mac Mapeado: CEF → mac
message principal.nat_ip Mapeado: CEF → sourceTranslatedAddress
sourceTranslatedAddress principal.nat_ip Mesclado
sourceTranslatedPort principal.nat_port Renomeado/mapeado
spt principal.port Renomeado/mapeado
sproc principal.process.command_line Renomeado/mapeado
spid principal.process.pid Renomeado/mapeado
acc_label principal.resource.attribute.labels Mesclado
acct_label principal.resource.attribute.labels Mesclado
iss_label principal.resource.attribute.labels Mesclado
jti_label principal.resource.attribute.labels Mesclado
message principal.resource.attribute.labels Valores mapeados (5 no total, por exemplo, CEF → acct_label, CEF → acc_label, CEF → iss_label)
sub_label principal.resource.attribute.labels Mesclado
message principal.user.attribute.roles Mapeado: CEF → principal_role
principal_role principal.user.attribute.roles Mesclado
details_username principal.user.user_display_name Mapeado diretamente
suser principal.user.user_display_name Mapeado diretamente
username principal.user.user_display_name Mapeado diretamente
details_user_id principal.user.userid Mapeado diretamente
details_userid principal.user.userid Mapeado diretamente
suid principal.user.userid Renomeado/mapeado
user_id principal.user.userid Mapeado diretamente
username principal.user.userid Mapeado diretamente
_security_result security_result Mesclado
message security_result Mapeado: CEF → security_result
_action security_result.action Mesclado
act security_result.action Mapeado: accept → _action, deny → _action
message security_result.action Mapeado: CEF → _action
Action_Taken security_result.action_details Mapeado diretamente
act security_result.action_details Mapeado diretamente
details_errorMessage security_result.action_details Mapeado diretamente
cat security_result.category_details Mesclado
message security_result.category_details Mapeado: CEF → cat
Scan_Type security_result.description Mapeado diretamente
Type security_result.description Mapeado diretamente
message security_result.description Mapeado diretamente
msg_data_2 security_result.description Mapeado diretamente
infection_channel_label security_result.detection_fields Mesclado
message security_result.detection_fields Valores mapeados (7 no total, por exemplo, CEF → operation_label, CEF → operasjon_label, CEF → `...
operasjon_label security_result.detection_fields Mesclado
operation_label security_result.detection_fields Mesclado
permission_label security_result.detection_fields Mesclado
spyware_Grayware_Type_label security_result.detection_fields Mesclado
threat_probability_label security_result.detection_fields Mesclado
tillatelse_label security_result.detection_fields Mesclado
mwProfile security_result.rule_name Mapeado diretamente
message security_result.severity Mapeado: CEF → LOW, CEF → MEDIUM, CEF → HIGH, CEF → CRITICAL
severity security_result.severity Mapeado: "0", "1", "2", "3", "LOW" → LOW, "4", "5", "6", "MEDIUM", "SUBSTANTIAL", "INFO"...
Result security_result.summary Mapeado diretamente
appcategory security_result.summary Mapeado diretamente
reason security_result.summary Renomeado/mapeado
success security_result.summary Mapeado diretamente
Spyware security_result.threat_name Mapeado diretamente
Unknown_Threat security_result.threat_name Mapeado diretamente
Virus_Malware_Name security_result.threat_name Mapeado diretamente
oldFilePath src.file.full_path Renomeado/mapeado
oldFileSize src.file.size Renomeado/mapeado
client_ip src.ip Mesclado
message src.ip Mapeado: CEF → client_ip
message src.resource.attribute.permissions Mapeado: CEF → old_permissions
old_permissions src.resource.attribute.permissions Mesclado
cust_client_id src.user.product_object_id Mapeado diretamente
details_client_id src.user.product_object_id Mapeado diretamente
dntdom target.administrative_domain Renomeado/mapeado
destinationServiceName target.application Renomeado/mapeado
service target.application Mapeado diretamente
service_name target.application Mapeado diretamente
application target.domain.name Mapeado diretamente
details.size target.file.size Renomeado/mapeado
details.host target.hostname Mapeado diretamente
target_hostname target.hostname Mapeado diretamente
temp_dhost target.hostname Mapeado diretamente
IPv6_Address target.ip Mesclado
dst_ip target.ip Mesclado
ipv6 target.ip Mapeado: - → IPv6_Address
message target.ip Mapeado: CEF → dst_ip, CEF → IPv6_Address
mac_address target.mac Mesclado
message target.mac Mapeado: CEF → mac_address
destination_translated_address target.nat_ip Mesclado
message target.nat_ip Mapeado: CEF → destination_translated_address
destinationTranslatedPort target.nat_port Renomeado/mapeado
details.port target.port Renomeado/mapeado
dpt target.port Renomeado/mapeado
dproc target.process.command_line Renomeado/mapeado
File_name target.process.file.full_path Mapeado diretamente
Infected_Resource target.process.file.full_path Mapeado diretamente
Object target.process.file.full_path Mapeado diretamente
Objekt target.process.file.full_path Mapeado diretamente
dpid target.process.pid Renomeado/mapeado
account_label target.resource.attribute.labels Mesclado
connection_label target.resource.attribute.labels Mesclado
message target.resource.attribute.labels Valores mapeados (6 no total, por exemplo, CEF → resource_Type_label, CEF → name_label, CEF → `u...
name_label target.resource.attribute.labels Mesclado
resource_Type_label target.resource.attribute.labels Mesclado
uri_label target.resource.attribute.labels Mesclado
usageMask_label target.resource.attribute.labels Mesclado
source target.resource.name Mapeado diretamente
request target.url Mapeado diretamente
message target.user.attribute.roles Mapeado: CEF → target_role
target_role target.user.attribute.roles Mesclado
CustomerName target.user.user_display_name Mapeado diretamente
temp_duser target.user.user_display_name Mapeado diretamente
Bruker target.user.userid Mapeado diretamente
User_value target.user.userid Mapeado diretamente
temp_duid target.user.userid Mapeado diretamente
N/A metadata.event_type Constante: GENERIC_EVENT
N/A network.direction Constante: INBOUND
N/A network.ip_protocol Constante: UDP
N/A security_result.severity Constante: LOW
details.host event.idm.read_only_udm.target.hostname Mapeado do registro de mudanças
details.messageFormat event.idm.read_only_udm.additional.fields Mapeado do registro de mudanças
details.transport event.idm.read_only_udm.network.ip_protocol Mapeado do registro de mudanças
syslog_timestamp event.idm.read_only_udm.metadata.collected_timestamp Mapeado do registro de mudanças
syslog_host event.idm.read_only_udm.principal.hostname e event.idm.read_only_udm.principal.asset.hostname Mapeado do registro de mudanças
product event.idm.read_only_udm.metadata.product_name Mapeado do registro de mudanças
details.errorMessage event.idm.read_only_udm.security_result.action_details Mapeado do registro de mudanças
sev event.idm.read_only_udm.security_result.detection_fields Mapeado do registro de mudanças

Registro de alterações

Ver o registro de alterações deste analisador

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