Coletar registros do Symantec CloudSOC CASB

Compatível com:

Neste documento, explicamos como ingerir registros do Symantec CloudSOC CASB no Google Security Operations usando o agente do Bindplane.

O Symantec CloudSOC é um agente de segurança de acesso à nuvem (CASB, na sigla em inglês) que gera mensagens de syslog para atividades de aplicativos em nuvem, violações de políticas de DLP, detecções de ameaças, resultados de inspeção de conteúdo e eventos de acesso de usuários. O analisador extrai campos de registros formatados em JSON e syslog e os mapeia para o modelo de dados unificado (UDM).

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 Symantec CloudSOC
  • 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 administrativo ao host do Symantec CloudSOC

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/symantec_casb:
        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: SYMANTEC_CASB
        raw_log_field: body
    
    service:
      pipelines:
        logs/symantec_casb_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/symantec_casb
    

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/symantec_casb:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: SYMANTEC_CASB
        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 Symantec CloudSOC CASB

  1. Faça login no host do Symantec CloudSOC.
  2. Execute o seguinte comando para identificar qual logger o sistema usa:

    ls -d /etc/*syslog*
    
  3. Acesse a seção correspondente, de acordo com a resposta:

    • syslog.conf: Syslog legado.
    • syslog-ng.conf: Syslog-ng.

Configuração legada do syslog

  1. Abra o arquivo syslogd, normalmente localizado no diretório /etc/default:

    vi /etc/default/syslogd
    
  2. Verifique se o valor de SYSLOGD contém a flag -r:

    SYSLOGD="-r"
    
  3. Salve o arquivo e saia do editor.

  4. Abra o arquivo services, normalmente localizado no diretório /etc:

    vi /etc/services
    
  5. Edite o valor da porta do serviço syslog:

    syslog          514/udp
    
  6. Salve o arquivo e saia do editor.

  7. Abra o arquivo syslog.conf, normalmente localizado no diretório /etc:

    vi /etc/syslog.conf
    
  8. Atualize a configuração para encaminhar todos os registros ao agente do Bindplane:

    *.* @<BINDPLANE_IP>
    
    • Substitua <BINDPLANE_IP> pelo endereço IP do agente do BindPlane.
  9. Abra o arquivo hosts, normalmente localizado no diretório /etc:

    vi /etc/hosts
    
  10. Crie uma entrada de DNS local para o agente do Bindplane:

    <BINDPLANE_IP>    bindplane_agent_host
    
  11. Salve o arquivo e saia do editor.

  12. Reinicie o serviço do daemon syslog.

Configuração do Syslog-ng

  1. Abra o arquivo syslog-ng.conf, normalmente localizado no diretório /etc:

    vi /etc/syslog-ng.conf
    
  2. Adicione o seguinte código ao final do arquivo:

    destination d_bindplane { udp("<BINDPLANE_IP>" port(514)); };
    log { source(s_src); destination(d_bindplane); };
    
    • Substitua <BINDPLANE_IP> pelo endereço IP do agente do BindPlane.
  3. Abra o arquivo hosts, normalmente localizado no diretório /etc:

    vi /etc/hosts
    
  4. Crie uma entrada de DNS local para o agente do Bindplane:

    <BINDPLANE_IP>    bindplane_agent_host
    
  5. Salve o arquivo e saia do editor.

  6. Reinicie o serviço daemon syslog-ng.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
_domain target.hostname O valor do campo _domain
_domain target.asset.hostname O valor do campo _domain
_id metadata.product_log_id O valor do campo _id
actions_taken security_result.detection_fields[].value O valor do campo actions_taken. A chave é gerada dinamicamente como Action_ + índice.
activity_type metadata.product_event_type O valor do campo activity_type se product_data.activity_type estiver vazio ou o valor de product_data.activity_type se não estiver vazio.
collector_device_ip principal.ip O valor do campo collector_device_ip, se não for Unknown IP.
collector_device_ip principal.asset.ip O valor do campo collector_device_ip, se não for Unknown IP.
collector_device_name principal.hostname O valor do campo collector_device_name.
collector_device_name principal.asset.hostname O valor do campo collector_device_name.
content_checks.dlp.raw_response.contentdetails[].contentBlockId security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.contentdetails[].contentBlockId. A chave é gerada dinamicamente como contentBlockId_ + índice.
content_checks.dlp.raw_response.contentdetails[].topLevelFileType security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.contentdetails[].topLevelFileType. A chave é gerada dinamicamente como topLevelFileType_ + índice.
content_checks.dlp.raw_response.requestid security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.requestid. A tecla é Request ID.
content_checks.dlp.raw_response.responseaction security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.responseaction. A tecla é Response Action.
content_checks.dlp.raw_response.violation[].name security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.violation[].name. A chave é gerada dinamicamente como Violation_Policy_Name_ + índice.
content_checks.dlp.raw_response.violation[].policyId security_result.detection_fields[].value O valor de content_checks.dlp.raw_response.violation[].policyId. A chave é gerada dinamicamente como Violation_Policy_ID_ + índice.
content_checks.dlp.updated_timestamp additional.fields[].value.string_value O valor de content_checks.dlp.updated_timestamp. A tecla é Updated TimeStamp.
content_checks.filename target.file.full_path O valor de content_checks.filename.
content_checks.mimetype target.file.mime_type O valor de content_checks.mimetype.
content_checks.risktype_list[] security_result.detection_fields[].value O valor de content_checks.risktype_list[]. A chave é gerada dinamicamente como RiskType_ + índice.
content_checks.vba_macros.expressions[].values[].key security_result.detection_fields[].key O valor de content_checks.vba_macros.expressions[].values[].key concatenado com índices.
content_checks.vba_macros.expressions[].values[].value security_result.detection_fields[].value O valor de content_checks.vba_macros.expressions[].values[].value.
content_checks.vk_content_iq_violations[] security_result.detection_fields[].value O valor de content_checks.vk_content_iq_violations[]. A chave é gerada dinamicamente como content_violation_ + índice.
content_checks.vk_dlp_policy_violations[] security_result.detection_fields[].value O valor de content_checks.vk_dlp_policy_violations[]. A chave é gerada dinamicamente como dlp_policy_violation_ + índice.
content_checks.vk_encryption security_result.detection_fields[].value O valor de content_checks.vk_encryption. A tecla é vk_encryption.
content_checks.vk_glba security_result.detection_fields[].value O valor de content_checks.vk_glba. A tecla é vk_glba.
content_checks.vk_hipaa security_result.detection_fields[].value O valor de content_checks.vk_hipaa. A tecla é vk_hipaa.
content_checks.vk_pci security_result.detection_fields[].value O valor de content_checks.vk_pci. A tecla é vk_pci.
content_checks.vk_pii security_result.detection_fields[].value O valor de content_checks.vk_pii. A tecla é vk_pii.
content_checks.vk_source_code security_result.detection_fields[].value O valor de content_checks.vk_source_code. A tecla é vk_source_code.
content_checks.vk_vba_macros security_result.detection_fields[].value O valor de content_checks.vk_vba_macros. A tecla é vk_vba_macros.
content_checks.vk_virus security_result.detection_fields[].value O valor de content_checks.vk_virus. A tecla é vk_virus.
content_checks.violations security_result.detection_fields[].value O valor de content_checks.violations. A tecla é violations.
created_timestamp additional.fields[].value.string_value O valor de created_timestamp. A tecla é Created TimeStamp.
date metadata.event_timestamp.seconds Segundos da época extraídos do campo date.
device_ip target.ip O valor do campo device_ip, se não for Unknown IP.
device_ip target.asset.ip O valor do campo device_ip, se não for Unknown IP.
file_size target.file.size O valor de file_size ou product_data.file_size se o primeiro estiver vazio. Convertido em número inteiro sem sinal.
file_url target.file.full_path O valor de product_data.file_url.
group_name target.group.group_display_name O nome de exibição extraído do campo group_name.
hosts[] principal.ip Os valores do campo hosts, separados por vírgula.
inserted_timestamp additional.fields[].value.string_value O valor de inserted_timestamp. A tecla é Inserted TimeStamp.
instance principal.hostname O primeiro valor do campo instance se for uma matriz ou o valor do campo instance se for uma string.
instance principal.asset.hostname O primeiro valor do campo instance se for uma matriz ou o valor do campo instance se for uma string.
ioi_code security_result.summary O valor do campo ioi_code.
_latency security_result.detection_fields[].value O valor do campo _latency. A tecla é Latency.
locations security_result.detection_fields[].value O valor do campo locations. A tecla é Locations.
log_name intermediary.asset.asset_id O ID do registro extraído do campo log_name, com o prefixo logid:.
mailbox_owner target.user.userid O valor de product_data.mailbox owner.
metadata.log_type metadata.log_type Fixado no código como SYMANTEC_CASB.
metadata.product_name metadata.product_name Fixado no código como SYMANTEC_CASB.
metadata.vendor_name metadata.vendor_name Fixado no código como SYMANTEC.
msg metadata.description O valor do campo msg ou do campo message se msg não estiver presente.
name security_result.detection_fields[].value O valor do campo name. A tecla é Name.
object_name security_result.detection_fields[].value O valor do campo object_name. A tecla é Object Name.
object_type target.resource.name O valor do campo object_type.
org_unit security_result.detection_fields[].value O valor do campo org_unit. A tecla é org_unit ID.
policy_action security_result.action_details O valor do campo policy_action.
policy_type security_result.detection_fields[].value O valor do campo policy_type. A tecla é policy_type.
policy_violated security_result.detection_fields[].value O valor do campo policy_violated. A tecla é policy_violated.
product_data._domain target.hostname O valor de product_data._domain.
product_data._domain target.asset.hostname O valor de product_data._domain.
product_data.activity_type metadata.product_event_type O valor de product_data.activity_type.
product_data.file url target.file.full_path O valor de product_data.file url.
product_data.file_size target.file.size O valor de product_data.file_size.
product_data.group target.group.group_display_name O valor de product_data.group.
product_data.location principal.location.country_or_region O valor de product_data.location.
product_data.logon error security_result.summary O valor de product_data.logon error.
product_data.mailbox owner target.user.userid O valor de product_data.mailbox owner.
product_data.name target.file.full_path O valor de product_data.name.
product_data.object_name target.file.full_path O valor de product_data.object_name.
product_data.originatingserver product_data.service target.application O valor de product_data.service.
product_data.site url target.url O valor de product_data.site url.
product_data.target target.user.userid O valor de product_data.target.
product_data.useragent network.http.user_agent O valor de product_data.useragent.
product_name intermediary.application O valor do campo product_name.
product_uid metadata.product_name O valor do campo product_uid.
responsible_logs additional.fields[].value.string_value O valor do campo responsible_logs. A tecla é responsible_logs.
resource_id target.resource.product_object_id O valor do campo resource_id.
risks security_result.detection_fields[].value O valor do campo risks. A tecla é Risks.
security_result.action security_result.action Derivado de product_data.logon error. Defina como BLOCK se product_data.logon error for BlockedByConditionalAccess.
security_result.severity security_result.severity O valor em maiúsculas do campo severity, se for um dos níveis de gravidade aceitos.
security_result.severity_details security_result.severity_details O valor do campo severity, se não for um dos níveis de gravidade compatíveis.
security_result.summary security_result.summary O valor do campo ioi_code ou product_data.logon error se ioi_code não estiver presente.
service target.application O valor do campo service se product_data.service estiver vazio.
site_url target.url O valor de product_data.site url.
source principal.resource.attribute.labels[].value O valor do campo source. A tecla é Source.
sub_feature additional.fields[].value.string_value O valor do campo sub_feature. A tecla é Sub Feature.
target.application target.application Derivado com base em product_data.activity_type e na presença de principal e destino.
target.resource.name target.resource.name Derivado com base em product_data.activity_type e na presença de principal e destino.
threat_score security_result.detection_fields[].value O valor do campo threat_score. A tecla é Threat Score.
transaction_id security_result.detection_fields[].value O valor do campo transaction_id. A tecla é Transaction ID.
updated_timestamp additional.fields[].value.string_value O valor de updated_timestamp ou content_checks.dlp.updated_timestamp se o primeiro estiver vazio. A tecla é Updated TimeStamp.
user principal.user.userid O valor do campo user.
user_email target.user.userid O valor do campo user_email.
user_mail target.user.userid O valor do campo user_mail extraído do campo msg.
user_name principal.user.user_display_name O valor do campo user_name.
user_uid principal.user.userid ou target.user.userid O valor do campo user_uid. Mapeado para principal.user.userid se product_data.activity_type não for InvalidLogin ou Login. Caso contrário, mapeado para target.user.userid.
uuid intermediary.asset.product_object_id O valor do campo uuid.
version metadata.product_version O valor do campo version.
user", "user_mail", and "user_uid principal.user.email_addresses Mapeado do registro de alterações
user_email", "mailbox_owner", "product_data.target", and "user_uid target.user.email_addresses Mapeado do registro de alterações
__event_timestamp metadata.event_timestamp Mapeado do registro de alterações
_elastic_timestamp", "created_timestamp", "inserted_timestamp", "updated_timestamp", "responsible_logs" and "sub_feature additional.fields Mapeado do registro de alterações
threat_score", "locations", "transaction_id", "content_checks.dlp.raw_response.requestid", "content_checks.dlp.raw_response.responseaction", "org_unit", "policy_type", "content_checks.vk_pci", "content_checks.vk_vba_macros", "content_checks.vk_glba", "content_checks.vk_source_code", "content_checks.vk_pii", "content_checks.vk_virus", "content_checks.vk_hipaa", "content_checks.violations", "object_name", "multi_user", "risks", "name", "_latency", "content_checks.dlp.raw_response.warning", "content_checks.dlp.raw_response.violation", "content_checks.dlp.raw_response.contentdetails", "content_checks.vk_dlp_policy_violations", "content_checks.risktype_list", "content_checks.vk_content_iq_violations", "actions_taken", "__detect_source", "multi_facility", "content_checks.vba_macros.expressions" and "policy_violated security_result.detection_fields Mapeado do registro de alterações
resource_id target.resource.id 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.