Coletar registros do Imperva CEF
Neste documento, explicamos como ingerir registros CEF da Imperva no Google Security Operations usando o agente do Bindplane.
O analisador extrai campos de registros formatados do syslog da Imperva em CEF (formato de evento comum). 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.
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 ou dispositivo de gerenciamento da Imperva
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.
Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)
- Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
- Acesse IAM e administrador > Contas de serviço.
- Clique em Criar conta de serviço.
- 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).
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
- Clique em Criar e continuar.
- Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
- Clique em Continuar e depois em Concluído.
- Clique na conta de serviço que você criou e acesse a guia Chaves.
- Clique em Adicionar chave > Criar nova chave.
- Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
- Salve o arquivo de chave como
ingestion-auth.jsonno diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.jsonno Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonno Windows) ou atualizecreds_file_pathemconfig.yamlpara corresponder ao caminho em que você o salvou. - 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)
- Faça login no console do Google SecOps.
- Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
- Faça o download do arquivo de autenticação de ingestão.
- Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.
Receber o ID de cliente do Google SecOps
- Faça login no console do Google SecOps.
- Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
- 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
- Abra o Prompt de comando ou o PowerShell como administrador.
Execute este comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Instalação do Linux
- Abra um terminal com privilégios de raiz ou sudo.
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
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,viou Bloco de Notas).
- Localize o arquivo
Edite o arquivo
config.yamlda 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_CEF' 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,europeouasia-southeast1). O exportador prefixachronicle.googleapis.comcom 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.jsonpara 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
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo 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_CEF' 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-collectorPara 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 gateway do Imperva WAF (SecureSphere) para enviar CEF por syslog
No console do MX, crie um conjunto de ações:
- Acesse Políticas > Conjuntos de ações.
- Clique em Novo e dê um nome a ele (por exemplo,
Google SecOps CEF).
Adicione a interface de ação do syslog do CEF:
- Em Interfaces de ação disponíveis, abra Registro do sistema e adicione uma ou mais das seguintes opções (conforme necessário):
- Registrar ocorrência de segurança no registro do sistema (syslog) usando o padrão CEF
- Registrar ocorrência de segurança de rede no registro do sistema (syslog) usando o padrão CEF
- Registrar eventos do sistema no registro do sistema (syslog) usando o padrão CEF
- Registrar evento de segurança personalizado no registro do sistema (syslog) usando o padrão CEF
- Em Interfaces de ação disponíveis, abra Registro do sistema e adicione uma ou mais das seguintes opções (conforme necessário):
Configure os parâmetros da interface de ação:
- Host do Syslog: insira o endereço IP do agente do Bindplane. Para usar uma porta que não é a padrão, anexe
:PORT(o padrão é 514 se você não especificar uma). Exemplo:10.0.0.10:514. - Recurso / Nível de registro: defina de acordo com os requisitos da sua política.
- Mensagem: deixe os padrões do fornecedor para o CEF, a menos que você tenha um mapeamento personalizado.
- Host do Syslog: insira o endereço IP do agente do Bindplane. Para usar uma porta que não é a padrão, anexe
Anexe o conjunto de ações às políticas:
- Para eventos de Segurança / Segurança de rede: abra as políticas relevantes e defina Ação seguida como seu conjunto de ações.
- Para Eventos do sistema: crie ou verifique uma política de Eventos do sistema e defina a Ação seguida como seu conjunto de ações para que esses eventos também sejam enviados pelo CEF.
(Opcional) Configure destinos específicos do gateway:
- Se diferentes grupos de gateway precisarem enviar para diferentes servidores syslog, configure cada Grupo de gateway > Registrador externo e ative "Usar configuração de gateway, se houver" na política.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
act |
security_result.action |
Derivado. Se act for "allowed", "alert", começar com "REQ_PASSED" ou começar com "REQ_CACHED", action será "ALLOW". Se act for "deny", "blocked", começar com "REQ_BLOCKED" ou começar com "REQ_CHALLENGE", action será "BLOCK". Se act corresponder ao regex (?i)REQ_BAD, action será "FAIL". Caso contrário, action será "UNKNOWN_ACTION". security_result.action é definido como o valor de action. |
act |
security_result.action_details |
Derivado. Com base no valor de act, uma descrição detalhada é gerada. Exemplos: "REQ_CACHED_FRESH: a resposta foi retornada do cache do data center", "REQ_BLOCKED: a solicitação foi bloqueada". |
app |
network.application_protocol |
Mapeado diretamente após ser convertido em letras maiúsculas. |
cs1 |
security_result.detection_fields.value |
Mapeado condicionalmente se cs1 não estiver vazio ou for "NA". security_result.detection_fields.key é definido como o valor de cs1Label. |
cs1Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs1 não estiver vazio ou for "NA". security_result.detection_fields.value é definido como o valor de cs1. |
cs2 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key é definido como o valor de cs2Label. |
cs2Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs2 não estiver vazio. security_result.detection_fields.value é definido como o valor de cs2. |
cs3 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio ou "-". security_result.detection_fields.key é definido como o valor de cs3Label. |
cs3Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs3 não estiver vazio ou for "-". security_result.detection_fields.value é definido como o valor de cs3. |
cs4 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key é definido como o valor de cs4Label. |
cs4Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs4 não estiver vazio. security_result.detection_fields.value é definido como o valor de cs4. |
cs5 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key é definido como o valor de cs5Label. |
cs5Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs5 não estiver vazio. security_result.detection_fields.value é definido como o valor de cs5. |
cs6 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key é definido como o valor de cs6Label. |
cs6Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cs6 não estiver vazio. security_result.detection_fields.value é definido como o valor de cs6. |
cs7 |
principal.location.region_latitude |
Mapeado condicionalmente se cs7Label for "latitude". |
cs8 |
principal.location.region_longitude |
Mapeado condicionalmente se cs8Label for "longitude". |
cn1 |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio e cn1Label não estiver vazio. security_result.detection_fields.key é definido como o valor de cn1Label. |
cn1Label |
security_result.detection_fields.key |
Mapeado condicionalmente se cn1 e cn1Label não estiverem vazios. security_result.detection_fields.value é definido como o valor de cn1. |
fileType |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key está definido como "fileType". |
filePermission |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key está definido como "filePermission". |
request |
target.url |
Mapeado diretamente. |
requestClientApplication |
network.http.user_agent |
Mapeado condicionalmente se não estiver vazio. Substitui o valor mapeado do campo user_agent extraído dos pares de chave-valor requestContext ou requestClientApplication no payload do CEF. |
requestMethod |
network.http.method |
Mapeado diretamente. |
siteid |
security_result.detection_fields.value |
Mapeado condicionalmente se não estiver vazio. security_result.detection_fields.key está definido como "siteid". |
sourceServiceName |
target.hostname |
Mapeado diretamente. Substitui o valor de dhost, se houver. |
src |
principal.ip |
Mapeado diretamente. |
start |
metadata.event_timestamp.seconds |
Extraído usando um padrão grok e convertido em um carimbo de data/hora. Usado como substituto para deviceReceiptTime se ele não estiver presente. Se deviceReceiptTime e start estiverem vazios, o carimbo de data/hora do registro será usado. |
suid |
principal.user.userid |
Mapeado condicionalmente se não estiver vazio. |
| N/A | metadata.event_type |
Fixado no código como "NETWORK_HTTP". |
| N/A | metadata.log_type |
Mapeado diretamente do campo log_type de nível superior. |
| N/A | metadata.product_event_type |
Mapeado de csv.event_id se não estiver vazio. |
| N/A | metadata.product_name |
Codificado como "Firewall de aplicativos da Web". |
| N/A | metadata.vendor_name |
Fixado no código como "Imperva". |
kv.act |
event.idm.read_only_udm.security_result.action_details |
Mapeado do registro de alterações |
kv.sourceServiceName |
event.idm.read_only_udm.target.resource.name |
Mapeado do registro de alterações |
cicode |
event.idm.read_only_udm.principal.location.city |
Mapeado do registro de alterações |
ccode |
event.idm.read_only_udm.principal.location.country_or_region |
Mapeado do registro de alterações |
Customer |
event.idm.read_only_udm.network.organization_name |
Mapeado do registro de alterações |
tls_cipher |
event.idm.read_only_udm.network.tls.cipher |
Mapeado do registro de alterações |
cpt |
event.idm.read_only_udm.target.port |
Mapeado do registro de alterações |
fileId |
event.idm.read_only_udm.target.resource.product_object_id |
Mapeado do registro de alterações |
dproc |
event.idm.read_only_udm.security_result.category_details |
Mapeado do registro de alterações |
deviceFacility |
event.idm.read_only_udm.security_result.detection_fields |
Mapeado do registro de alterações |
deviceExternalId |
event.idm.read_only_udm.security_result.detection_fields |
Mapeado do registro de alterações |
end |
event.idm.read_only_udm.metadata.collected_timestamp |
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.