Coletar registros do Imperva FlexProtect

Compatível com:

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

O analisador extrai campos de registros formatados do syslog do Imperva FlexProtect em CEF (Common Event Format) com extensões de chave-valor. Ele usa grok e/ou kv para analisar a mensagem CEF e, em seguida, mapeia esses valores para o Modelo de Dados Unificado (UDM). Ele também define valores de metadados padrão para a origem e o tipo do evento. O Imperva FlexProtect oferece implantação flexível de soluções de segurança da Imperva (SecureSphere, Cloud WAF, Bot Protection) em ambientes de nuvem híbrida.

Antes de começar

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

  • Uma instância do Google SecOps
  • Um host do Windows 2016 ou mais recente ou do Linux com systemd
  • 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 console de gerenciamento do Imperva FlexProtect ou a consoles de produtos individuais

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: <CUSTOMER_ID>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'IMPERVA_FLEXPROTECT'
        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 <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: <CUSTOMER_ID>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'IMPERVA_FLEXPROTECT'
        raw_log_field: body
        ingestion_labels:
    

Reinicie o agente do BindPlane para aplicar as mudanças:

  1. Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:

    sudo systemctl restart observiq-otel-collector
    
  2. 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 Imperva FlexProtect

Para o componente SecureSphere (no local/na nuvem)

  1. Faça login no console de gerenciamento do Imperva SecureSphere.
  2. Acesse Configuração > Conjuntos de ações.
  3. Clique em Adicionar para criar um novo conjunto de ações.
  4. Clique em Adicionar ação e informe os seguintes detalhes de configuração:

    • Nome: insira um nome descritivo (por exemplo, Google SecOps Syslog).
    • Tipo de ação: selecione Syslog.
    • Host: insira o endereço IP do agente do BindPlane.
    • Porta: digite o número da porta do agente do BindPlane (o padrão é 514).
    • Protocolo: selecione UDP ou TCP.
    • Nível de registro do Syslog: selecione DEBUG.
    • Recurso do Syslog: selecione LOCAL0.
    • Formato: selecione CEF (Common Event Format).
  5. Salve a configuração da ação e aplique-a às políticas de segurança relevantes.

Para o componente Cloud WAF/Incapsula

  1. Faça login no console do Imperva Cloud.
  2. Acesse Registros > Configuração de registros.
  3. Configure o destino do syslog:
    • Host: insira o endereço IP do agente do BindPlane.
    • Porta: digite o número da porta do agente do BindPlane (o padrão é 514).
    • Protocolo: selecione UDP ou TCP.
    • Formato: selecione CEF.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
agir read_only_udm.security_result.action_details Mapeado diretamente do campo act.
app read_only_udm.network.application_protocol Mapeado diretamente do campo app.
ccode read_only_udm.principal.location.country_or_region Mapeado diretamente do campo ccode.
cicode read_only_udm.principal.location.city Mapeado diretamente do campo cicode.
cn1 read_only_udm.network.http.response_code Mapeado diretamente do campo cn1 após a conversão para número inteiro.
cs1 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs1.
cs2 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs2.
cs3 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs3.
cs4 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs4.
cs5 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs5.
cs6 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs6.
cs7 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs7.
cs8 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs8.
cs9 read_only_udm.additional.fields.value.string_value Mapeado diretamente do campo cs9.
cpt read_only_udm.principal.port Mapeado diretamente do campo cpt após a conversão para número inteiro.
Cliente read_only_udm.principal.user.user_display_name Mapeado diretamente do campo Customer.
deviceExternalId read_only_udm.about.asset.asset_id O valor é derivado da concatenação de "Incapsula.SIEMintegration:" com o campo deviceExternalId.
deviceFacility read_only_udm.principal.location.city Mapeado diretamente do campo deviceFacility.
dproc read_only_udm.target.process.command_line Mapeado diretamente do campo dproc.
end read_only_udm.security_result.detection_fields.value Mapeado diretamente do campo end.
fileId read_only_udm.network.session_id Mapeado diretamente do campo fileId.
filePermission read_only_udm.about.resource.attribute.permissions.name Mapeado diretamente do campo filePermission.
em read_only_udm.network.received_bytes Mapeado diretamente do campo in.
qstr read_only_udm.security_result.detection_fields.value Mapeado diretamente do campo qstr.
solicitação read_only_udm.target.url Mapeado diretamente do campo request.
requestClientApplication read_only_udm.network.http.user_agent Mapeado diretamente do campo requestClientApplication.
requestMethod read_only_udm.network.http.method Mapeado diretamente do campo requestMethod.
siteid read_only_udm.security_result.detection_fields.value Mapeado diretamente do campo siteid.
sip read_only_udm.target.ip Mapeado diretamente do campo sip.
sourceServiceName read_only_udm.principal.application Mapeado diretamente do campo sourceServiceName.
spt read_only_udm.target.port Mapeado diretamente do campo spt após a conversão para número inteiro.
src read_only_udm.principal.ip Mapeado diretamente do campo src.
start read_only_udm.security_result.detection_fields.value Mapeado diretamente do campo start.
suid read_only_udm.principal.user.userid Mapeado diretamente do campo suid.
ver read_only_udm.network.tls.version Mapeado diretamente do campo ver.
read_only_udm.about.asset.asset_id O valor é derivado da concatenação de "Incapsula.SIEMintegration:" com o campo deviceExternalId.
read_only_udm.additional.fields.key O valor é determinado pela lógica do analisador com base no rótulo do campo, por exemplo:
- cs1Label é mapeado para "Cap Support"
- cs2Label é mapeado para "Javascript Support"
- cs3Label é mapeado para "CO Support"
- cs4Label é mapeado para "VID"
- cs5Label é mapeado para "clappsig"
- cs6Label é mapeado para "clapp"
- cs7Label é mapeado para "latitude"
- cs8Label é mapeado para "longitude"
- cs9Label é mapeado para "Rule name"
read_only_udm.metadata.event_timestamp.nanos Mapeado diretamente do campo collection_time.nanos.
read_only_udm.metadata.event_timestamp.seconds Mapeado diretamente do campo collection_time.seconds.
read_only_udm.metadata.event_type O valor é determinado com base na presença dos campos src e sip:
- Se ambos estiverem presentes, o valor será definido como "NETWORK_HTTP".
: se apenas src estiver presente, o valor será definido como "USER_UNCATEGORIZED".
: caso contrário, o valor será definido como "GENERIC_EVENT".
read_only_udm.metadata.product_event_type O valor é derivado da concatenação de "[", o valor numérico do campo de cabeçalho CEF no índice 4, "] - " e a descrição de texto do campo de cabeçalho CEF no índice 4.
read_only_udm.metadata.product_name O valor é definido estaticamente como "SIEMintegration".
read_only_udm.metadata.product_version O valor é definido estaticamente como "1".
read_only_udm.metadata.vendor_name O valor é definido estaticamente como "Incapsula".
read_only_udm.security_result.detection_fields.key O valor é definido estaticamente como "siteid", "event_start_time", "event_end_time" ou "qstr" com base no campo correspondente que está sendo processado.
read_only_udm.security_result.severity O valor é definido estaticamente como "LOW".
read_only_udm.target.port Mapeado diretamente do campo spt após a conversão para número inteiro.
qstr security_results.detection_fields Mapeado do registro de alterações
siteid security_results.detection_fields Mapeado do registro de alterações
device_facility principal.location.city Mapeado do registro de alterações
start security_result.detection_fields.event_start_time Mapeado do registro de alterações
cs8Label additional_cs8.key Mapeado do registro de alterações
cs8 additional_cs8.value.string_value Mapeado do registro de alterações
cs9Label additional_cs9.key Mapeado do registro de alterações
cs9 additional_cs9.value.string_value Mapeado do registro de alterações
end security_result.detection_fields.event_end_time 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.