Raccogli i log di Preempt Auth

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di Preempt Auth in Google Security Operations utilizzando l'agente Bindplane.

Preempt Auth è una soluzione di monitoraggio degli eventi di autenticazione che genera log di autenticazione dettagliati per gli ambienti Active Directory. Acquisisce gli eventi di accesso riusciti e non riusciti, le ricerche LDAP, l'accesso ai servizi e i tipi di autenticazione tra gli endpoint.

Nota: Preempt Security è stata acquisita da CrowdStrike nel settembre 2020 ed è stata completamente integrata in CrowdStrike Falcon Identity Protection. Il prodotto Preempt autonomo non è più disponibile. Se hai eseguito la migrazione a CrowdStrike Falcon Identity Protection, consulta invece la guida Raccogli i log di CrowdStrike Falcon.

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 server Preempt
• Se esegui l'agente dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso privilegiato a Preempt Auth (CrowdStrike Identity Protection) con autorizzazioni di amministratore

Recupera le credenziali di 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 precedenti: continua a utilizzare il file di autenticazione dell'importazione (opzione 2) fino alla dismissione dell'API Ingestion il 20 luglio 2027.

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

1. Accedi alla Google Cloud console e seleziona il Google Cloud progetto 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 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 Editor Chronicle.
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 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) oppure 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 di 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 norme della tua organizzazione.

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

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > Agenti di raccolta.
3. Scarica il file di autenticazione dell'importazione.
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 legacy (malachiteingestion-pa.googleapis.com), la cui fine del ciclo di vita è prevista da Google per il 20 luglio 2027. Pianifica di passare all'opzione 1 prima di questa data.

Recupera 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 dell'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 Windows

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 IN ESECUZIONE.

Installazione di Linux

1. Apri un terminale con privilegi di 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 di installazione aggiuntive

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 il raccoglitore Bindplane versione 1.106.0 o successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade del raccoglitore prima di modificare la configurazione.

Configura l'agente Bindplane per importare i syslog e inviarli 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:514"
  
  exporters:
    chronicle/preempt_auth:
      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: '<CREDS_FILE_PATH>'
      customer_id: '<CUSTOMER_ID>'
      endpoint: chronicle.googleapis.com
      log_type: PREEMPT_AUTH
      raw_log_field: body
      ingestion_labels:
        env: production
  
  service:
    pipelines:
      logs/preempt_auth_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/preempt_auth
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • tcplog: riceve i syslog tramite TCP. Utilizza udplog se il deployment di Preempt inoltra i log tramite UDP.
  • 0.0.0.0:514: ascolta tutte le interfacce sulla porta 514. Se necessario, modifica la porta (ad esempio, 1514 per Linux non root).

• 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 dal passaggio Recupera l'ID cliente 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 dell'API Ingestion 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'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con l'endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/preempt_auth:
      compression: gzip
      creds_file_path: '<CREDS_FILE_PATH>'
      customer_id: '<CUSTOMER_ID>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: PREEMPT_AUTH
      raw_log_field: body
      ingestion_labels:
        env: production
  

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

Salva il file di configurazione

• Dopo la modifica, salva il file:
  • Linux: premi Ctrl+O, poi Enter, poi 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 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 l'inoltro dei syslog di Preempt Auth

Nota: Preempt Auth è un prodotto obsoleto. Queste istruzioni si applicano solo ai deployment Preempt legacy. Se hai eseguito la migrazione a CrowdStrike Falcon Identity Protection, utilizza invece la guida all'integrazione di CrowdStrike.

1. Accedi alla console di gestione di Preempt.
2. Vai a Impostazioni > Integrazione SIEM.
3. Attiva l'inoltro dei syslog per gli eventi di autenticazione.
4. Fornisci i seguenti dettagli di configurazione:
   • Protocollo: seleziona TCP (deve corrispondere alla configurazione del ricevitore dell'agente Bindplane).
   • Indirizzo del server syslog: inserisci l'indirizzo IP dell'host dell'agente Bindplane (ad esempio, 192.168.1.100).
   • Porta: inserisci 514 (deve corrispondere alla porta del ricevitore dell'agente Bindplane).
5. Seleziona i tipi di eventi di autenticazione da inoltrare:
   • Eventi di autenticazione riusciti
   • Eventi di autenticazione non riusciti
   • Ricerche LDAP
   • Eventi di accesso ai servizi
6. Fai clic su Salva o Applica.
7. Verifica che i log vengano inviati controllando i log dell'agente Bindplane.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
authenticationType	extensions.auth.type	Imposta su "SSO" se authenticationType corrisponde a SSO_LOGIN o LDAP_AUTHENTICATION; "MACHINE" se DOMAIN_LOGIN; "AUTHTYPE_UNSPECIFIED" se NTLM_AUTHENTICATION
	extensions.auth.mechanism	Imposta su "MECHANISM_UNSPECIFIED"
inter_ip	intermediary.hostname	Imposta se inter_ip non è un indirizzo IP valido
inter_ip	intermediary.ip	Imposta se inter_ip è un indirizzo IP valido
eventLabel	metadata.description	Valore copiato direttamente
eventType	metadata.event_type	Imposta su "USER_LOGIN" se eventType è SUCCESSFUL_AUTHENTICATION o FAILED_AUTHENTICATION; "SERVICE_UNSPECIFIED" se SERVICE_ACCESS o LDAP_SEARCH e principal_host_set è true
eventType	metadata.product_event_type	Valore copiato direttamente
endpointDisplayName, ipAddress	principal.hostname	Imposta se endpointDisplayName != ipAddress e endpointDisplayName != ""
ipAddress, inter_ip	principal.ip	Valore da ipAddress se ipAddress != inter_ip, altrimenti da inter_ip
networkType	principal.resource.name	Valore copiato direttamente
	principal.resource.type	Imposta su "Network type"
userDisplayName	principal.user.email_addresses	Imposta se userDisplayName corrisponde all'espressione regolare dell'indirizzo email
userDisplayName	principal.user.user_display_name	Valore copiato direttamente
userEntity.secondaryDisplayName, userDisplayName	principal.user.userid	Valore da userEntity.secondaryDisplayName se non è vuoto, altrimenti da userDisplayName se userEntity.secondaryDisplayName è vuoto
eventType	security_result.action	Imposta su "ALLOW" se SUCCESSFUL_AUTHENTICATION, "BLOCK" se FAILED_AUTHENTICATION
eventSeverity	security_result.severity_details	Valore copiato direttamente
authenticationType	security_result.summary	Valore copiato direttamente
targetEntity.primaryDisplayName, targetServiceIdentifier, eventType, targetEntity.type	target.application	Valore da targetEntity.primaryDisplayName se targetEntity.type == "CLOUD_SERVICE"; altrimenti da targetServiceIdentifier se targetServiceIdentifier != "" e non è stato impostato in precedenza; altrimenti "LDAP" se eventType == "LDAP_SEARCH" e non è stato impostato in precedenza
targetEntity.primaryDisplayName, targetEntity.type	target.hostname	Imposta se targetEntity.type == "ENDPOINT"
targetServiceType	target.resource.name	Imposta se targetServiceType != "" e != "UNKNOWN"
targetServiceType	target.resource.type	Imposta su "Service Type" se targetServiceType != "" e != "UNKNOWN"
targetEntity.primaryDisplayName, targetEntity.type	target.user.user_display_name	Imposta se targetEntity.type == "USER"
targetEntity.secondaryDisplayName, targetEntity.type	target.user.userid	Imposta se targetEntity.type == "USER"
	metadata.product_name	Imposta su "PREEMPT_AUTH"
	metadata.vendor_name	Imposta su "Preempt"

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