Recopila registros de CyberArk

Versión del analizador: 8.0

Compatible con:

En este documento, se explica cómo transferir registros de CyberArk a Google Security Operations con el agente de Bindplane.

CyberArk Privileged Access Manager (PAM) es una solución de seguridad de acceso con privilegios de nivel empresarial que protege, administra y supervisa las cuentas y credenciales con privilegios en entornos locales y de nube. Proporciona almacenamiento de credenciales, aislamiento y supervisión de sesiones, detección de amenazas a través de Privileged Threat Analytics (PTA) y registro de auditoría integral de todas las actividades con privilegios.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Windows Server 2016 o posterior, o host de Linux con systemd
  • Conectividad de red entre el agente de Bindplane y el servidor de CyberArk Vault
  • Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
  • Acceso de administrador al servidor de CyberArk Vault (acceso a la carpeta de instalación de Server\Conf)
  • CyberArk Vault versión 10.0 o posterior

Obtén credenciales de Google SecOps para el agente de Bindplane

Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:

  • Implementaciones nuevas: Usa la API de Chronicle (opción 1).
  • Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
  1. Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
  2. Ve a IAM y administración > Cuentas de servicio.
  3. Haga clic en Crear cuenta de servicio.
  4. Proporciona los siguientes detalles de configuración:
    • Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo, bindplane-ingest).
    • Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo, Bindplane agent log ingestion).
  5. Haz clic en Crear y continuar.
  6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
  7. Haz clic en Continuar y, luego, en Listo.
  8. Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
  9. Haz clic en Agregar clave > Crear clave nueva.
  10. Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
  11. Guarda el archivo de claves como ingestion-auth.json en el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.json en Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json en Windows) o actualiza creds_file_path en config.yaml para que coincida con la ruta de acceso en la que lo guardas.
  12. Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.

Opción 2: Descarga el archivo de autenticación de transferencia (heredado)

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
  3. Descarga el archivo de autenticación de transferencia.
  4. Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.

Obtén el ID de cliente de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de Bindplane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.

Instalación en Windows

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el comando siguiente:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Espera a que se complete la instalación.

  4. Ejecuta el siguiente comando para verificar la instalación:

    sc query observiq-otel-collector
    

    El estado del servicio debe ser RUNNING.

Instalación en Linux

  1. Abre una terminal con privilegios de raíz o sudo.
  2. Ejecuta el comando siguiente:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Espera a que se complete la instalación.

  4. Ejecuta el siguiente comando para verificar la instalación:

    sudo systemctl status observiq-otel-collector
    

    El estado del servicio debería ser active (running).

Recursos de instalación adicionales

Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.

Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps

Ubica el archivo de configuración

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Edita el archivo de configuración

  1. Reemplaza todo el contenido de config.yaml por la siguiente configuración:

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/cyberark:
        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: 'your-customer-id'
        endpoint: chronicle.googleapis.com
        log_type: CYBERARK
        raw_log_field: body
    
    service:
      pipelines:
        logs/cyberark_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/cyberark
    
  2. Reemplaza los marcadores de posición que se indican más abajo:

    • Configuración del receptor:

      • listen_address: Dirección IP y puerto que se escucharán:

        • 0.0.0.0:514 para escuchar en todas las interfaces en el puerto 514 (requiere raíz en Linux)
        • 0.0.0.0:1514 para escuchar en un puerto sin privilegios (recomendado para Linux sin raíz)
      • Opciones de tipo de receptor:

        • udplog para syslog de UDP (predeterminado para CyberArk Vault)
        • tcplog para el registro del sistema de TCP
        • Usa tcplog si CyberArk Vault está configurado con SyslogServerProtocol=TCP
    • Configuración del exportador:

      • creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):

        • Linux: /opt/observiq-otel-collector/ingestion-auth.json
        • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
      • customer_id: ID de cliente de Google SecOps

      • location: Reemplaza <LOCATION> por la región de tu instancia de Google SecOps (por ejemplo, us, europe o asia-southeast1). El exportador agrega el prefijo chronicle.googleapis.com con este valor. Consulta Extremos regionales para obtener la lista completa.

      • project: Reemplaza <PROJECT_NUMBER> por el número de proyecto de IAM y administración > Configuración.

      • endpoint: Mantén la configuración como chronicle.googleapis.com.

Exportador de la API de transferencia heredada

  • Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque exporters por lo siguiente. Establece creds_file_path en la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplaza malachiteingestion-pa.googleapis.com por tu extremo regional (por ejemplo, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/cyberark:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'your-customer-id'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CYBERARK
        raw_log_field: body
    

Guarda el archivo de configuración

Después de editarlo, guarda el archivo:

  • Linux: Presiona Ctrl+O, luego Enter y, por último, Ctrl+X
  • Windows: Haz clic en Archivo > Guardar.

Reinicia el agente de Bindplane para aplicar los cambios.

  • Para reiniciar el agente de Bindplane en Linux, haz lo siguiente:

    1. Ejecuta el comando siguiente:

      sudo systemctl restart observiq-otel-collector
      
    2. Verifica que el servicio esté en ejecución:

      sudo systemctl status observiq-otel-collector
      
    3. Revisa los registros en busca de errores:

      sudo journalctl -u observiq-otel-collector -f
      
  • Para reiniciar el agente de Bindplane en Windows, haz lo siguiente:

    1. Elige una de las siguientes opciones:

      • Símbolo del sistema o PowerShell como administrador:

        net stop observiq-otel-collector && net start observiq-otel-collector
        
      • Consola de servicios:

        1. Presiona Win+R, escribe services.msc y presiona Intro.
        2. Busca observIQ OpenTelemetry Collector.
        3. Haz clic con el botón derecho y selecciona Reiniciar.
    2. Verifica que el servicio esté en ejecución:

      sc query observiq-otel-collector
      
    3. Revisa los registros en busca de errores:

      type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
      

Configura el reenvío de syslog de CyberArk

CyberArk Vault envía eventos de auditoría en CEF (formato de evento común) a través de syslog. El servidor de Vault convierte los registros de auditoría XML en mensajes CEF con un archivo de traductor XSL y, luego, los reenvía al agente de Bindplane.

Configura el servidor de Vault para enviar syslog

  1. Accede a la máquina anfitrión del servidor de CyberArk Vault con privilegios de administrador.
  2. Navega a la carpeta de instalación del servidor de CyberArk Vault (por ejemplo, `C:\Program Files (x86)\PrivateArk\Server\Conf`).
  3. Abre el archivo DBParm.ini en un editor de texto.
  4. Copia la sección [SYSLOG] del archivo DBParm.sample.ini (ubicado en la misma carpeta) y pégala en la parte inferior de DBParm.ini.
  5. Configura los siguientes parámetros de syslog en la sección [SYSLOG]:

    [SYSLOG]
    SyslogServerIP=<BINDPLANE_AGENT_IP>
    SyslogServerPort=514
    SyslogServerProtocol=UDP
    UseLegacySyslogFormat=No
    SyslogTranslatorFile=Syslog\Arcsight.sample.xsl
    SyslogMessageCodeFilter=0-999
    
  6. Reemplaza los siguientes valores:

    • SyslogServerIP: Ingresa la dirección IP del host del agente de Bindplane (por ejemplo, 192.168.1.100).
    • SyslogServerPort: Ingresa el puerto que coincida con el agente de Bindplane listen_address (por ejemplo, 514).
    • SyslogServerProtocol: Selecciona el protocolo:

      • UDP para el registro del sistema de UDP (predeterminado)
      • TCP para el registro del sistema de TCP
    • SyslogTranslatorFile: Ingresa el archivo de traductor XSL para el formato CEF:

      • Syslog\Arcsight.sample.xsl para el resultado de CEF estándar (recomendado)
    • SyslogMessageCodeFilter: Ingresa los códigos de mensaje que se reenviarán:

      • 0-999 para reenviar todos los eventos
      • Especifica códigos o rangos individuales (por ejemplo, 1,2,3,5-10,30) para filtrar eventos específicos.
    • UseLegacySyslogFormat: Se establece en No para el formato RFC 5424.

  7. Guarda el archivo DBParm.ini.

  8. Reinicia el servicio PrivateArk Server:

    1. Abre Servicios de Windows (services.msc).
    2. Ubica el servicio CyberArk Vault Disaster Recovery y detenlo (si se está ejecutando).
    3. Ubica el servicio PrivateArk Server.
    4. Haz clic con el botón derecho y selecciona Reiniciar.
    5. Vuelve a iniciar el servicio CyberArk Vault Disaster Recovery (si corresponde).

Reenvía syslog a varios destinos

  • Para reenviar eventos de syslog de Vault al agente de Bindplane y a otros destinos (por ejemplo, PTA), especifica varias direcciones IP y archivos de traductor separados por comas:

    SyslogServerIP=<BINDPLANE_AGENT_IP>,<PTA_SERVER_IP>
    SyslogTranslatorFile=Syslog\Arcsight.sample.xsl,Syslog\PTA.xsl
    

Configura el reenvío de syslog de Privileged Threat Analytics (PTA) (opcional)

Si también quieres reenviar las alertas de seguridad de PTA a Google SecOps, configura la integración de PTA con SIEM:

  1. Accede a la consola de PVWA (acceso web a la bóveda de contraseñas).
  2. Ve a Administration > Configuration Options > Privileged Threat Analytics.
  3. En la sección SIEM, configura lo siguiente:
    • Servidor Syslog IP: Ingresa la dirección IP del host del agente de Bindplane.
    • Puerto del servidor Syslog: Ingresa el puerto que coincida con la configuración del agente de Bindplane (por ejemplo, 514).
    • Protocolo: Selecciona UDP o TCP para que coincida con el receptor del agente de Bindplane.
    • Formato: Selecciona CEF.
  4. Haz clic en Guardar.

Archivos de traductor de XSL disponibles

  • La subcarpeta Syslog de la carpeta de instalación de CyberArk Server contiene archivos de traducción XSL de ejemplo:

    Archivo del traductor Formato Descripción
    Arcsight.sample.xsl CEF Formato CEF estándar (recomendado para Google SecOps)
    SplunkCIM.xsl CIM Formato del modelo de información común de Splunk
    PTA.xsl Personalizado Formato para el reenvío a CyberArk PTA
    XSIAM.xsl CEF Formato de Palo Alto Cortex XSIAM

Verifica el reenvío de syslog

  1. Después de reiniciar el servicio de PrivateArk Server, realiza una acción de prueba en Vault (por ejemplo, recupera una contraseña o accede a PVWA).
  2. Verifica los registros del agente de Bindplane para ver los mensajes de syslog entrantes:
    • Linux: sudo journalctl -u observiq-otel-collector -f
    • Windows: type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
  3. Verifica que los mensajes con formato CEF aparezcan en los registros, por ejemplo:

    CEF:0|Cyber-Ark|Vault|10.0|22|CPM password retrieved|5|suser=Administrator src=10.0.0.1 fname=Root\operating system-server1-admin
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
RequestId_label additional.fields Asignado como par clave-valor
Category_label additional.fields Asignado como par clave-valor
ExtraDetails_label additional.fields Asignado como par clave-valor
CAPolicy_label additional.fields Asignado como par clave-valor
line_number_label additional.fields Asignado como par clave-valor
pasvc_action_label additional.fields Asignado como par clave-valor
control_socket_label additional.fields Asignado como par clave-valor
data_socket_label additional.fields Asignado como par clave-valor
timeout_label additional.fields Asignado como par clave-valor
vault_name_label additional.fields Asignado como par clave-valor
class_name_label additional.fields Asignado como par clave-valor
status_label additional.fields Asignado como par clave-valor
Publisher_Event additional.fields Asignado como par clave-valor
Last_Event additional.fields Asignado como par clave-valor
Total_Events additional.fields Asignado como par clave-valor
cs1_var additional.fields Asignado como par clave-valor
cs3_var additional.fields Asignado como par clave-valor
app_var additional.fields Asignado como par clave-valor
reason_var additional.fields Asignado como par clave-valor
cs5_var additional.fields Asignado como par clave-valor
cs4_var additional.fields Asignado como par clave-valor
_auth_mechanism extensions.auth.mechanism Combinados directamente
dvc intermediary.ip Si el valor coincide con el patrón de dirección IP
EventName metadata.description Si el proceso no coincide con el patrón de exe
act metadata.description Si fname está vacío
EventMessage metadata.description Si act está vacío
LastEventDate metadata.event_timestamp Se convirtió con el formato ISO8601 o aaaa-MM-ddTHH:mm:ss
_temp_datetime metadata.event_timestamp Se convirtió con el formato dd/MM/aaaa HH:mm:ss
fecha y hora metadata.event_timestamp Se convirtió con el formato ISO8601 o MMM d HH:mm:ss
_event_type metadata.event_type Se cambió el nombre directamente
nombre metadata.event_type Se establece según las condiciones: FILE_CREATION para "Store File", USER_LOGIN para "Logon", NETWORK_CONNECTION si has_principal y has_target, FILE_UNCATEGORIZED si has_target_file_details, PROCESS_UNCATEGORIZED si has_target_process_details, STATUS_UPDATE si solo has_principal, NETWORK_UNCATEGORIZED si app_error y has_principal y has_target, de lo contrario, GENERIC_EVENT
EventType metadata.product_event_type Asignada directamente
signature_id, name metadata.product_event_type Concatenado a partir de signature_id y name
LastEventID metadata.product_log_id Se convirtió en cadena
tid metadata.product_log_id Asignada directamente
producto metadata.product_name Se cambió el nombre directamente
versión metadata.product_version Se cambió el nombre directamente
vendor metadata.vendor_name Se cambió el nombre directamente
host observer.hostname Asignada directamente
LastEventUserName principal.administrative_domain Se extrae con el patrón de grok domain\user
ApplicationType principal.application Asignada directamente
shost principal.asset.hostname Si el valor no coincide con el patrón de dirección IP
shost principal.asset.hostname Resguardo si dhost está vacío
shost principal.asset.ip Si el valor coincide con el patrón de dirección IP
src principal.asset.ip Asignada directamente
ip_address principal.asset.ip Asignada directamente
shost principal.asset.ip Resguardo si dhost está vacío
shost principal.ip Si el valor coincide con el patrón de dirección IP, se combina.
src principal.ip Combinados directamente
ip_address principal.ip Combinados directamente
Ubicación principal.location.name Asignada directamente
LastEventSourceName principal.platform Se establece en WINDOWS si el valor coincide con el patrón de Windows
EventName principal.process.command_line Si el proceso coincide con el patrón exe
LastEventPackageName principal.resource.name Si el valor no es EventName
ApplicationType principal.user.attribute.roles Establece el valor en ADMINISTRATOR si es igual a AdminTask
LastEventUserName principal.user.user_display_name La parte del usuario se extrae con el patrón de grok domain\user
user_name principal.user.user_display_name Asignada directamente
SourceUser principal.user.userid Asignada directamente
suser principal.user.userid Si el evento no es del tipo USER_
usrName principal.user.userid Asignada directamente
_action security_result.action Combinados directamente
nombre security_result.action Se establece en BLOCK si el valor comienza con "Failure" o "Failed"; de lo contrario, se establece en ALLOW
msg security_result.description Asignada directamente
msg, reason security_result.description Se concatena a partir de msg y reason si se cumple la condición de falla
_sec_result_description security_result.description Asignada directamente
PolicyName security_result.rule_name Asignada directamente
cs2 security_result.rule_name Asignada directamente
gravedad, security_result.severity Se establece en LOW si el valor es <= 5, MEDIUM si el valor es <= 8, HIGH de lo contrario
sev security_result.severity Asignada directamente
sev security_result.severity_details Asignada directamente
Motivo security_result.summary Asignada directamente
nombre security_result.summary Asignada directamente
dhost target.asset.hostname Si el valor no coincide con el patrón de dirección IP
shost target.asset.hostname Resguardo si dhost está vacío
dhost target.asset.ip Si el valor coincide con el patrón de dirección IP
GatewayStation target.asset.ip Asignada directamente
shost target.asset.ip Resguardo si dhost está vacío
FileQualifier target.asset_id Con el prefijo "ID del activo:" y convertido en cadena
Archivo target.file.full_path Asignada directamente
file_path target.file.full_path Asignada directamente
LastEventSourceName target.file.full_path Si el valor comienza con "C:"
fname target.file.full_path Asignada directamente
Hash target.file.sha1 Se quitó el prefijo "SHA1##" y el valor se convirtió a minúsculas, si es de tipo SHA1
GatewayStation target.ip Combinados directamente
pid target.process.pid Se convirtió en cadena
Seguro target.resource.name Asignada directamente
user_name target.user.user_display_name Asignada directamente
TargetUser target.user.userid Asignada directamente
duser target.user.userid Asignada directamente
suser target.user.userid Si el evento es del tipo USER_
event_msg.created event.idm.read_only_udm.metadata.collected_timestamp Asignado desde el registro de cambios
datetime event.idm.read_only_udm.metadata.event_timestamp Asignado desde el registro de cambios
Issuer event.idm.read_only_udm.principal.application Asignado desde el registro de cambios
Message event.idm.read_only_udm.security_result.description Asignado desde el registro de cambios
Station event.idm.read_only_udm.principal.ip, event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
MessageID event.idm.read_only_udm.metadata.product_log_id Asignado desde el registro de cambios
Safe event.idm.read_only_udm.target.resource.name Asignado desde el registro de cambios
Version event.idm.read_only_udm.metadata.product_version Asignado desde el registro de cambios
usrName event.idm.read_only_udm.principal.user.userid Asignado desde el registro de cambios
src event.idm.read_only_udm.principal.ip y event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
GatewayStation event.idm.read_only_udm.target.ip y event.idm.read_only_udm.target.asset.ip Asignado desde el registro de cambios
Reason event.idm.read_only_udm.security_result.summary Asignado desde el registro de cambios
Location event.idm.read_only_udm.principal.location.name Asignado desde el registro de cambios
File event.idm.read_only_udm.target.file.full_path Asignado desde el registro de cambios
RequestId security_result.detection_fields Asignado desde el registro de cambios
sev event.idm.read_only_udm.security_result Asignado desde el registro de cambios
Category event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
ExtraDetails event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
CAPolicy event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
status event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
class_name event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
vault_name event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
timeout event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
data_socket event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
control_socket event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
pasvc_action event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
line_number event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
ip_address event.idm.read_only_udm.principal.ip y event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
file_path event.idm.read_only_udm.target.file.full_path Asignado desde el registro de cambios
tid event.idm.read_only_udm.metadata.product_log_id Asignado desde el registro de cambios
pid event.idm.read_only_udm.target.process.pid Asignado desde el registro de cambios
EventMessage event.idm.read_only_udm.metadata.description Asignado desde el registro de cambios
SourceUser event.idm.read_only_udm.principal.user.userid Asignado desde el registro de cambios
TargetUser event.idm.read_only_udm.target.user.userid Asignado desde el registro de cambios
user_name event.idm.read_only_udm.target.user.user_display_name Asignado desde el registro de cambios
host event.idm.read_only_udm.observer.hostname Asignado desde el registro de cambios

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.