Recolha registos do CyberArk Privilege Cloud
Este documento explica como carregar registos do CyberArk Privilege Cloud para o Google Security Operations através do Bindplane. O código do analisador transforma os registos do formato SYSLOG + KV não processado no formato do modelo de dados unificado (UDM) do Google SecOps. Primeiro, extrai campos de mensagens formatadas em CEF através de padrões grok e da análise de chave/valor. Em seguida, mapeia esses campos e outros para os respetivos campos UDM, enriquecendo os dados com valores padronizados para fornecedor, produto e gravidade.
Antes de começar
Certifique-se de que tem os seguintes pré-requisitos:
- Instância do Google SecOps
- Windows 2016 ou posterior, ou um anfitrião Linux com
systemd
- Se estiver a ser executado através de um proxy, as portas da firewall estão abertas
- Acesso privilegiado ao CyberArk Privilege Cloud
Obtenha o ficheiro de autenticação de carregamento do Google SecOps
- Inicie sessão na consola Google SecOps.
- Aceda a Definições do SIEM > Agentes de recolha.
- Transfira o ficheiro de autenticação de carregamento. Guarde o ficheiro de forma segura no sistema onde o Bindplane vai ser instalado.
Obtenha o ID de cliente do Google SecOps
- Inicie sessão na consola Google SecOps.
- Aceda a Definições do SIEM > Perfil.
- Copie e guarde o ID do cliente da secção Detalhes da organização.
Instale o agente do Bindplane
Instale o agente do Bindplane no seu sistema operativo Windows ou Linux de acordo com as seguintes instruções.
Instalação do Windows
- Abra a Linha de comandos ou o PowerShell como administrador.
Execute o seguinte 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 o seguinte comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Recursos de instalação adicionais
Para ver opções de instalação adicionais, consulte o guia de instalação.
Configure o agente Bindplane para carregar o Syslog e enviá-lo para o Google SecOps
- Aceda ao ficheiro de configuração:
- Localize o ficheiro
config.yaml
. Normalmente, encontra-se no diretório/etc/bindplane-agent/
no Linux ou no diretório de instalação no Windows. - Abra o ficheiro com um editor de texto (por exemplo,
nano
,vi
ou Bloco de notas).
- Localize o ficheiro
Edite o ficheiro
config.yaml
da seguinte forma:receivers: tcplog: # Replace the port and IP address as required listen_address: "0.0.0.0:6514" 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: 'CYBERARK_PRIVILEGE_CLOUD' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog exporters: - chronicle/chronicle_w_labels
- Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
- Substitua
<customer_id>
pelo ID de cliente real. - Atualize
/path/to/ingestion-authentication-file.json
para o caminho onde o ficheiro de autenticação foi guardado na secção Obtenha o ficheiro de autenticação de carregamento do Google SecOps.
Reinicie o agente do Bindplane para aplicar as alterações
Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:
sudo systemctl restart bindplane-agent
Para reiniciar o agente Bindplane no Windows, pode usar a consola Serviços ou introduzir o seguinte comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Instale o túnel seguro
- Certifique-se de que o ID da máquina é exclusivo, mesmo quando as máquinas são implementadas em vários domínios.
- Transfira o pacote de software Privilege Cloud a partir de Implemente o Privilege Cloud Connector (Standard), copie o ficheiro ZIP Secure Tunnel e descompacte-o.
- Execute a instalação a partir da pasta descomprimida.
- Na página Selecionar pasta de instalação, introduza a localização da pasta de instalação e clique em Seguinte.
- Na página Pronto para instalar, clique em Instalar.
- Quando a instalação estiver concluída, clique em Terminar. A ferramenta de configuração é iniciada.
Configure o túnel seguro
- Na página Autenticar no Privilege Cloud, introduza os seguintes detalhes
e, de seguida, clique em Seguinte:
- Subdomínio ou ID de cliente: o subdomínio é o identificador do sistema no endereço do sistema, conforme apresentado no FQDN do Privilege Cloud Portal:
https://<subdomain>.Privilegecloud.cyberark.com
. Introduza apenas o identificador de<subdomain>
e não o URL completo. Em alternativa, use o ID de cliente que lhe foi fornecido pela CyberArk. - Nome de utilizador e palavra-passe: introduza as credenciais fornecidas pelo apoio técnico da CyberArk.
- Subdomínio ou ID de cliente: o subdomínio é o identificador do sistema no endereço do sistema, conforme apresentado no FQDN do Privilege Cloud Portal:
- Na página Configure componentes no local, adicione os componentes que quer ligar através do túnel seguro e clique em Configurar componentes.
- Indique os seguintes detalhes de configuração:
- Tipo de componente: selecione SIEM.
- Endereço do anfitrião: introduza o endereço do anfitrião do agente do Bindplane (o componente SIEM tem de incluir um nome de anfitrião).
- Porta de destino: introduza o número da porta do agente do Bindplane.
- Porta remota: a porta usada pelo CyberArk para interagir com o seu túnel seguro (a porta remota é fornecida pelo apoio técnico do CyberArk. Normalmente, a porta é
1468
). - Clique em Avançadas para apresentar esta coluna.
- Acesso através de túneis seguros: pode configurar os túneis seguros aos quais os seus servidores vão aceder, mesmo que estes túneis seguros estejam a ser executados numa máquina diferente.
- Clique em Configurar componentes > Fechar.
Tabela de mapeamento do UDM
Campo de registo | Mapeamento de UDM | Lógica |
---|---|---|
agir | security_result.action_details | Mapeado diretamente a partir do campo act no registo não processado. |
app | network.application_protocol | Mapeado a partir do campo app no registo não processado e transformado através da lógica em parse_app_protocol.include . |
cn1 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cn1 no registo não processado. |
cn1Label | additional.fields.key | Mapeado diretamente a partir do campo cn1Label no registo não processado. |
cn2 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cn2 no registo não processado. |
cn2Label | additional.fields.key | Mapeado diretamente a partir do campo cn2Label no registo não processado. |
cs1 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cs1 no registo não processado. |
cs1Label | additional.fields.key | Mapeado diretamente a partir do campo cs1Label no registo não processado. |
cs2 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cs2 no registo não processado. |
cs2Label | additional.fields.key | Mapeado diretamente a partir do campo cs2Label no registo não processado. |
cs3 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cs3 no registo não processado. |
cs3Label | additional.fields.key | Mapeado diretamente a partir do campo cs3Label no registo não processado. |
cs4 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cs4 no registo não processado. |
cs4Label | additional.fields.key | Mapeado diretamente a partir do campo cs4Label no registo não processado. |
cs5 | additional.fields.value.string_value | Mapeado diretamente a partir do campo cs5 no registo não processado. |
cs5Label | additional.fields.key | Mapeado diretamente a partir do campo cs5Label no registo não processado. |
device_event_class_id | metadata.product_event_type | Mapeado diretamente a partir do campo device_event_class_id no registo não processado. |
device_version | metadata.product_version | Mapeado diretamente a partir do campo device_version no registo não processado. |
dhost | target.hostname | Mapeado diretamente a partir do campo dhost no registo não processado. |
duser | target.user.user_display_name | Mapeado diretamente a partir do campo duser no registo não processado. |
dvc | about.ip | Mapeado diretamente a partir do campo dvc no registo não processado. |
event_name | metadata.product_event_type | Mapeado diretamente a partir do campo event_name no registo não processado. |
externalId | metadata.product_log_id | Mapeado diretamente a partir do campo externalId no registo não processado. |
fname | additional.fields.value.string_value | Mapeado diretamente a partir do campo fname no registo não processado. |
msg | metadata.description | Mapeado diretamente a partir do campo msg no registo não processado. |
motivo | security_result.summary | Mapeado diretamente a partir do campo reason no registo não processado. |
gravidade | security_result.severity | Mapeado a partir do campo severity no registo não processado e transformado em "BAIXO", "MÉDIO", "ALTO" ou "CRÍTICO" com base no respetivo valor. |
shost | principal.ip | Mapeado diretamente a partir do campo shost no registo não processado. |
suser | principal.user.user_display_name | Mapeado diretamente a partir do campo suser no registo não processado. |
tempo | metadata.event_timestamp.seconds | Mapeado diretamente a partir do campo time no registo não processado após a análise e a conversão numa data/hora. |
metadata.event_type | Defina como "USER_UNCATEGORIZED" se suser estiver presente e duser não estiver. Caso contrário, defina como "GENERIC_EVENT". |
|
metadata.log_type | Definido como "CYBERARK_PRIVILEGE_CLOUD". | |
metadata.product_name | Definido como "CYBERARK_PRIVILEGE_CLOUD". | |
principal.asset.hostname | Valor retirado dos campos shost ou dvc , se contiverem um nome do anfitrião. |
|
principal.asset.ip | Valor retirado dos campos shost ou dvc , se contiverem um endereço IP. |
|
principal.hostname | Valor retirado dos campos shost ou dvc , se contiverem um nome do anfitrião. |
|
target.asset.hostname | Valor retirado do campo dhost , se contiver um nome de anfitrião. |
|
additional.fields.key | A chave dos campos adicionais é determinada pelo campo de etiqueta correspondente (por exemplo, cn1Label por cn1 ). |
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.