Raccogli i log di Delinea Distributed Engine

Parser Version: 1.0

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log di Delinea Distributed Engine in Google Security Operations utilizzando l'agente Bindplane.

Delinea Distributed Engine fornisce connettività sicura tra la piattaforma cloud Delinea e le risorse on-premise. Il motore genera messaggi syslog in formato CEF per gli eventi di rilevamento, sincronizzazione e operativi. Il parser estrae i campi e li mappa al modello UDM (Unified Data Model).

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps
• Windows Server 2016 o versioni successive oppure host Linux con systemd
• Connettività di rete tra l'agente Bindplane e il motore distribuito Delinea
• Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso privilegiato alla UI web del portale Delinea

Recupera le credenziali Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: utilizza l'API Chronicle (opzione 1).
• Deployment legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino al ritiro dell'API Ingestion il 20 luglio 2027.

Opzione 1: crea un account di servizio per l'API Chronicle (consigliata)

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome service account: inserisci un nome per l'account (ad esempio bindplane-ingest).
   • Descrizione del service account: inserisci una descrizione (ad esempio, Bindplane agent log ingestion).
5. Fai clic su Crea e continua.
6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
7. Fai clic su Continua e poi su Fine.
8. Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
9. Fai clic su Aggiungi chiave > Crea nuova chiave.
10. Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul tuo computer.
11. Salva il file della chiave come ingestion-auth.json nella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.json su Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json su Windows) o aggiorna creds_file_path in config.yaml in modo che corrisponda al percorso in cui lo salvi.
12. Vai a IAM e amministrazione > Impostazioni e copia il Numero progetto. Ti servirà per la configurazione dell'esportatore.

Nota: la chiave JSON è una credenziale. Limita l'accesso al file sull'host Bindplane e ruota la chiave in base alle policy della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > Agenti di raccolta.
3. Scarica il file di autenticazione dell'acquisizione.
4. Salva il file in modo sicuro sul sistema in cui verrà installato l'agente Bindplane.

Nota: questo file autentica l'agente nell'API Ingestion precedente (malachiteingestion-pa.googleapis.com), che Google ha programmato per la fine del ciclo di vita il 20 luglio 2027. Pianifica il passaggio all'Opzione 1 prima di questa data.

Ottieni l'ID cliente Google SecOps

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > Profilo.

3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

   Nota: l'ID cliente è necessario per configurare l'esportatore dell'agente Bindplane.

Installa l'agente Bindplane

Installa l'agente Bindplane sul sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.

Installazione di finestre

1. Apri Prompt dei comandi o PowerShell come amministratore.

2. Esegui questo comando:

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

3. Attendi il completamento dell'installazione.

4. Verifica l'installazione eseguendo:

   sc query observiq-otel-collector
   

   Il servizio dovrebbe essere visualizzato come RUNNING.

Installazione di Linux

1. Apri un terminale con privilegi root o sudo.

2. Esegui questo comando:

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

3. Attendi il completamento dell'installazione.

4. Verifica l'installazione eseguendo:

   sudo systemctl status observiq-otel-collector
   

   Il servizio dovrebbe essere visualizzato come attivo (in esecuzione).

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.

Nota: la configurazione dell'esportatore dell'API Chronicle richiede Bindplane Collector v1.106.0 o versioni successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade dell'agente di raccolta prima di modificare la configurazione.

Configura l'agente Bindplane per importare il syslog e inviarlo a Google SecOps

Individua il file di configurazione

• Linux:

  sudo nano /opt/observiq-otel-collector/config.yaml
  

• Windows:

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

Modifica il file di configurazione

• Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

  receivers:
    tcplog:
      listen_address: "0.0.0.0:5145"
  
  exporters:
    chronicle/delinea_distributed_engine:
      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: DELINEA_DISTRIBUTED_ENGINE
      raw_log_field: body
  
  service:
    pipelines:
      logs/delinea_distributed_engine_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/delinea_distributed_engine
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • listen_address: Indirizzo IP e porta da ascoltare:
    • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
    • La porta 5145 è la porta syslog configurata (regola in base alle esigenze)

• Configurazione dell'esportatore:

  • creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: ID cliente copiato dalla console Google SecOps
  • location: sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio us, europe o asia-southeast1). L'esportatore antepone chronicle.googleapis.com a questo valore. Per l'elenco completo, consulta Endpoint regionali.
  • project: sostituisci <PROJECT_NUMBER> con il numero di progetto da IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione chronicle.googleapis.com.

Esportatore API di importazione legacy

• Se utilizzi il file di autenticazione dell'importazione dell'opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'acquisizione e, se l'istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con il tuo endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/delinea_distributed_engine:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: DELINEA_DISTRIBUTED_ENGINE
      raw_log_field: body
  

Nota: questo esportatore smetterà di funzionare quando l'API Ingestion verrà ritirata il 20 luglio 2027.

Salva il file di configurazione

• Dopo la modifica, salva il file:
  • Linux: premi Ctrl+O, poi Enter e infine Ctrl+X
  • Windows: fai clic su File > Salva.

Riavvia l'agente Bindplane per applicare le modifiche

• Per riavviare l'agente Bindplane in Linux, esegui questo comando:

  sudo systemctl restart observiq-otel-collector
  

  1. Verifica che il servizio sia in esecuzione:

     sudo systemctl status observiq-otel-collector
     

  2. Controlla i log per verificare la presenza di errori:

     sudo journalctl -u observiq-otel-collector -f
     

• Per riavviare l'agente Bindplane in Windows, scegli una delle seguenti opzioni:

  • Prompt dei comandi o PowerShell come amministratore:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

  • Console dei servizi:

    1. Premi Win+R, digita services.msc e premi Invio.
    2. Individua observIQ OpenTelemetry Collector.
    3. Fai clic con il tasto destro del mouse e seleziona Riavvia.

    4. Verifica che il servizio sia in esecuzione:

       sc query observiq-otel-collector
       

    5. Controlla i log per verificare la presenza di errori:

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

Configura il syslog di Delinea

1. Accedi all'interfaccia utente web del portale Delinea.
2. Vai ad Admin (Amministratore) > Application (Applicazione).
3. Fai clic sul pulsante Edit (Modifica).
4. Fai clic sulla casella di controllo Enable Syslog/CEF Log Output (Attiva output log Syslog/CEF). Viene visualizzata una sezione Syslog.
5. Inserisci l'indirizzo IP dell'agente Bindplane.
6. Inserisci il numero di porta dell'agente Bindplane.
7. Fai clic sul menu Protocollo e seleziona TCP.
8. Fai clic per selezionare Elenco fusi orari in base all'ora UTC o Ora del server, a seconda delle tue preferenze.
9. Fai clic sul menu Sito per selezionare il Sito correlato su cui verrà eseguito Syslog/CEF.
10. (Facoltativo) Seleziona Write Syslogs As Windows Events (Scrivi i syslog come eventi di Windows) per scrivere i controlli e le sottoscrizioni agli eventi nel log eventi di Windows.
11. Fai clic su Salva.

Configura il livello di log per i motori distribuiti

1. Accedi alla UI web del portale Delinea.
2. Vai ad Amministrazione > Distributed Engine.
3. Fai clic sull'icona con i tre puntini sopra il motore pertinente e seleziona Mostra impostazioni.
4. Seleziona il menu Livello log e poi Informazioni.
5. Fai clic su OK.

Log di esempio di Delinea Distributed Engine supportati

• SYSLOG (formato proprietario Delinea)

  2024-09-26 21:14:27,369 [CID:] [C:] [TID:PriorityScheduler Elastic Thread @ Normal] INFO Thycotic.DE.Feature.SS.LocalAccountDiscovery.Areas.Discovery.LocalAccountConsumer - server-dummy-01: Send Local Account Results Count: 0 - (null)
  

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
ACTION	security_result.action	Se ACTION_CODE è "1", imposta "ALLOW". In caso contrario, se ACTION_CODE non è vuoto, imposta su "BLOCK". In caso contrario, il valore predefinito è "UNKNOWN_ACTION" della fase precedente del parser.
ACTION_CODE	security_result.action	Utilizzato nella logica per determinare security_result.action.
APP_NAME	network.http.user_agent	Mappato direttamente.
BYTES_RECVD	network.received_bytes	Mappato direttamente, convertito in numero intero senza segno.
BYTES_SENT	network.sent_bytes	Mappato direttamente, convertito in numero intero senza segno.
CLOUDGENIX_HOST	principal.hostname	Mappato direttamente se il campo NAME è vuoto. Utilizzato come nome host intermedio se NAME è presente.
CODE	metadata.product_event_type	Concatenato con FACILITY per formare metadata.product_event_type. Utilizzato anche per determinare metadata.event_type (ad es. se CODE contiene "DOWN", metadata.event_type è impostato su "STATUS_SHUTDOWN").
DESTINATION_ZONE_NAME	about.labels	Mappato direttamente come etichetta con chiave "DESTINATION_ZONE_NAME".
DEVICE_TIME	metadata.event_timestamp	Mappato direttamente dopo essere stato analizzato come data.
DST_INTERFACE	target.hostname	Mappato direttamente.
DST_IP	target.ip	Mappato direttamente.
DST_PORT	target.port	Mappato direttamente, convertito in numero intero.
ELEMENT_ID	about.labels	Mappato direttamente come etichetta con chiave "ELEMENT_ID".
EVENT_TIME	metadata.event_timestamp	Mappato direttamente dopo l'analisi come data.
FACILITY	metadata.product_event_type	Concatenato con CODE per formare metadata.product_event_type.
FLOW_EVENT	security_result.summary	Utilizzato come parte della stringa security_result.summary.
IDENTIFIER	about.labels	Mappato direttamente come etichetta con chiave "IDENTIFIER".
ION_HOST	principal.hostname	Mappato direttamente se i campi CLOUDGENIX_HOST e NAME sono vuoti.
MSG	metadata.description	Mappato direttamente. Utilizzato anche per la corrispondenza delle espressioni regolari per determinare metadata.event_type ed estrarre target.ip.
NAME	principal.hostname	Mappato direttamente. Se presente, CLOUDGENIX_HOST diventa intermediary.hostname.
PROCESS_NAME	principal.process.file.full_path	Mappato direttamente.
PROTOCOL_NAME	network.ip_protocol	Mappato direttamente, convertito in maiuscolo.
REMOTE_HOSTNAME	target.hostname	Mappato direttamente.
REMOTE_IP	target.ip	Mappato direttamente.
RULE_NAME	security_result.rule_name	Mappato direttamente.
SEVERITY	security_result.severity, security_result.severity_details	Mappatura a security_result.severity_details. Utilizzato anche per determinare security_result.severity (ad es. se SEVERITY è "minor", security_result.severity è impostato su "LOW").
SOURCE_ZONE_NAME	about.labels	Mappato direttamente come etichetta con la chiave "SOURCE_ZONE_NAME".
SRC_INTERFACE	principal.hostname	Mappato direttamente.
SRC_IP	principal.ip	Mappato direttamente.
SRC_PORT	principal.port	Mappato direttamente, convertito in numero intero.
VPN_LINK_ID	target.resource.id	Mappato direttamente.
(Logica del parser)	is_alert	Imposta su true se log_type è "alert" o "alarm".
(Logica del parser)	is_significant	Imposta su true se log_type è "alert" o "alarm".
(Logica del parser)	metadata.event_type	Determinato da una serie di istruzioni condizionali basate sui valori di CODE, MSG, src_ip e dest_ip. Il valore predefinito è "GENERIC_EVENT".
(Logica del parser)	metadata.log_type	Impostalo su "CLOUDGENIX_SDWAN".
(Logica del parser)	metadata.product_event_type	Il valore predefinito è la concatenazione di CODE e FACILITY. Imposta su "cgxFlowLogV1" per i log di flusso.
(Logica del parser)	metadata.product_name	Imposta "CloudGenix SD-WAN".
(Logica del parser)	metadata.vendor_name	Impostalo su "Palo Alto Networks".
(Logica del parser)	principal.process.pid	Imposta il valore di pid dal log non elaborato per i log di flusso.
(Logica del parser)	security_result.action	Il valore predefinito è "UNKNOWN_ACTION".
(Logica del parser)	security_result.severity	Il valore predefinito è "UNKNOWN_SEVERITY". Impostato in base al valore di SEVERITY. Impostato su "INFORMATIONAL" per i log di flusso.
(Logica del parser)	security_result.summary	Imposta in base al valore di CODE per i messaggi syslog. Imposta una stringa descrittiva che includa FLOW_EVENT, SRC_IP e DST_IP per i log di flusso.

Log delle modifiche

Visualizza il log delle modifiche per questo parser

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.