Raccogli i log HID DigitalPersona

Supportata in:

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

HID DigitalPersona è una soluzione di autenticazione a più fattori e gestione delle identità che fornisce autenticazione senza password, gestione delle credenziali e controllo dell'accesso per gli ambienti Windows. I componenti DigitalPersona scrivono eventi di autenticazione, gestione delle credenziali, gestione degli utenti e policy in canali dedicati del log eventi di Windows quando si verificano attività significative.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows Server 2016 o versioni successive con systemd
  • Connettività di rete tra l'agente Bindplane e internet
  • Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso amministrativo al server Windows su cui è installato DigitalPersona
  • DigitalPersona AD o LDS versione 4.2.0 o successive installate e configurate

Ottieni 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 legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino alla dismissione dell'API Ingestion il 20 luglio 2027.
  1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
  2. Vai a IAM e amministrazione > Service account.
  3. Fai clic su Crea account di servizio.
  4. Fornisci i seguenti dettagli di configurazione:
    • Nome account di servizio: 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 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 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.

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

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > 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.

Ottieni l'ID cliente Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.
  3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul tuo sistema operativo Windows o Linux seguendo queste istruzioni.

Installazione di finestre

  1. Apri il 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.

Configura l'agente Bindplane per importare i log eventi di Windows e inviarli a Google SecOps

Individua il file di configurazione

  1. Apri il prompt dei comandi come amministratore.
  2. Vai alla directory di installazione dell'agente Bindplane e apri il file di configurazione:

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

Modifica il file di configurazione

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

    receivers:
      windowseventlog/digitalpersona_core:
        channel: DigitalPersona-Altus-Core/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_logon:
        channel: DigitalPersona-Altus-Logon/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_policies:
        channel: DigitalPersona-Altus-Policies/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_radius:
        channel: DigitalPersona-Altus-RADIUS/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_passwordmanager:
        channel: DigitalPersona-Altus-PasswordManager/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_identityprovider:
        channel: DigitalPersona-Altus-IdentityProvider/Operational
        raw: true
        start_at: end
      windowseventlog/digitalpersona_adfauthprovider:
        channel: DigitalPersona-Altus-AdfAuthProvider/Operational
        raw: true
        start_at: end
    
    processors:
      batch:
    
    exporters:
      chronicle/digitalpersona:
        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: '{
          "type": "service_account",
          "project_id": "YOUR_PROJECT_ID",
          "private_key_id": "YOUR_PRIVATE_KEY_ID",
          "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n",
          "client_email": "YOUR_CLIENT_EMAIL",
          "client_id": "YOUR_CLIENT_ID",
          "auth_uri": "https://accounts.google.com/o/oauth2/auth",
          "token_uri": "https://oauth2.googleapis.com/token",
          "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
          "client_x509_cert_url": "YOUR_CERT_URL"
        }'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: chronicle.googleapis.com
        log_type: 'HID_DIGITALPERSONA'
        override_log_type: false
        raw_log_field: body
    
    service:
      pipelines:
        logs/digitalpersona:
          receivers:
            - windowseventlog/digitalpersona_core
            - windowseventlog/digitalpersona_logon
            - windowseventlog/digitalpersona_policies
            - windowseventlog/digitalpersona_radius
            - windowseventlog/digitalpersona_passwordmanager
            - windowseventlog/digitalpersona_identityprovider
            - windowseventlog/digitalpersona_adfauthprovider
          processors:
            - batch
          exporters:
            - chronicle/digitalpersona
    
  2. Sostituisci i seguenti segnaposto:

    • Configurazione dell'esportatore:

      • YOUR_PROJECT_ID: l'ID progetto del file di autenticazione dell'acquisizione
      • YOUR_PRIVATE_KEY_ID: l'ID della chiave privata del file di autenticazione dell'acquisizione
      • YOUR_PRIVATE_KEY: la chiave privata del file di autenticazione dell'importazione (assicurati di eseguire l'escaping corretto delle nuove righe)
      • YOUR_CLIENT_EMAIL: l'indirizzo email del client dal file di autenticazione dell'acquisizione
      • YOUR_CLIENT_ID: l'ID client del file di autenticazione dell'acquisizione
      • YOUR_CERT_URL: l'URL del certificato x509 del client dal file di autenticazione dell'acquisizione
      • YOUR_CUSTOMER_ID: l'ID cliente Google SecOps del passaggio precedente
    • 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.

    • Sostituisci <PROJECT_NUMBER> con il numero di progetto indicato in IAM e amministrazione > Impostazioni.

Canali di eventi DigitalPersona

La configurazione precedente raccoglie gli eventi dai seguenti canali del log eventi di Windows di DigitalPersona:

Nome del canale Categorie di eventi Intervallo ID evento
DigitalPersona-Altus-Core/Operational Gestione delle credenziali, Gestione degli utenti, Gestione dei secret, Gestione dei servizi, Autenticazione delle credenziali, Deployment, Gestione delle OTP 256-4352
DigitalPersona-Altus-Logon/Operational Accesso a Windows 4864-4873
DigitalPersona-Altus-Policies/Operational Gestione dei criteri 5376-5383
DigitalPersona-Altus-RADIUS/Operational Autenticazione RADIUS 6400-6402
DigitalPersona-Altus-PasswordManager/Operational Gestore delle password 1536-1557
DigitalPersona-Altus-IdentityProvider/Operational Provider di identità 6656-6765
DigitalPersona-Altus-AdfAuthProvider/Operational Provider di autenticazione ADFS 6401-6405

Esportatore API di importazione precedente

  • Se utilizzi il file di autenticazione dell'acquisizione 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/digitalpersona:
        compression: gzip
        creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: 'HID_DIGITALPERSONA'
        override_log_type: false
        raw_log_field: body
    

Salva il file di configurazione

Dopo la modifica, salva il file:

  1. Fai clic su File > Salva.
  2. Chiudi Blocco note.

Riavvia l'agente Bindplane per applicare le modifiche

  • Per riavviare l'agente Bindplane in Windows, utilizza 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.
    1. Verifica che il servizio sia in esecuzione:

      sc query observiq-otel-collector
      
    2. Controlla i log per verificare la presenza di errori:

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

Verifica la raccolta di eventi DigitalPersona

Verifica che i canali del log eventi di Windows siano attivi

  1. Premi Win+R, digita eventvwr.msc e premi Invio per aprire il Visualizzatore eventi.
  2. Vai a Registri applicazioni e servizi.
  3. Espandi la cartella DigitalPersona-Altus-Core.
  4. Fai clic con il tasto destro del mouse su Operativo e seleziona Proprietà.
  5. Verifica che l'opzione Abilita il logging sia selezionata.
  6. Ripeti i passaggi 3-5 per i seguenti canali:

    • DigitalPersona-Altus-Logon/Operational
    • DigitalPersona-Altus-Policies/Operational
    • DigitalPersona-Altus-RADIUS/Operational
    • DigitalPersona-Altus-PasswordManager/Operational
    • DigitalPersona-Altus-IdentityProvider/Operational
    • DigitalPersona-Altus-AdfAuthProvider/Operational

Verifica che gli eventi vengano raccolti

  1. In Visualizzatore eventi, vai a uno dei canali DigitalPersona (ad esempio, DigitalPersona-Altus-Core > Operativo).
  2. Verifica che gli eventi vengano registrati.
  3. Esegui un'operazione di autenticazione di prova o di gestione delle credenziali in DigitalPersona per generare nuovi eventi.
  4. Aggiorna il Visualizzatore eventi per visualizzare i nuovi eventi.

Verifica che gli eventi vengano inviati a Google SecOps

  1. Attendi 5-10 minuti per l'elaborazione e l'importazione degli eventi.
  2. Accedi alla console Google SecOps.
  3. Vai a Indaga > Enterprise Insights > Importazione dei dati.
  4. Cerca HID_DIGITALPERSONA nel filtro del tipo di log.
  5. Verifica che gli eventi vengano importati con timestamp recenti.

Risoluzione dei problemi

Nessun evento visualizzato in Google SecOps

  • Verifica che il servizio dell'agente Bindplane sia in esecuzione:

    sc query observiq-otel-collector
    
  • Controlla i log dell'agente Bindplane per verificare la presenza di errori:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    
  • Verifica che le credenziali di autenticazione per l'importazione siano corrette nel file config.yaml.

  • Verifica che l'ID cliente sia corretto.

  • Verifica la connettività di rete all'endpoint Google SecOps:

    ping chronicle.googleapis.com
    

Gli eventi non vengono generati nel log eventi di Windows

  • Verifica che i servizi DigitalPersona siano in esecuzione:

    1. Premi Win+R, digita services.msc e premi Invio.
    2. Verifica che i seguenti servizi siano in esecuzione:
      • DigitalPersona Authentication Service
      • DigitalPersona Server
  • Verifica che il logging degli eventi sia abilitato nelle impostazioni dei criteri di gruppo di DigitalPersona:

    1. Apri la Console Gestione Criteri di gruppo.
    2. Vai alla policy DigitalPersona.
    3. Verifica che l'opzione Level of detail in event logs (Livello di dettaglio nei log eventi) sia impostata su Details (Dettagli) o Audit (Controllo).
  • Verifica che i canali del log eventi di Windows siano attivi (vedi "Verifica che i canali del log eventi di Windows siano attivi" sopra).

Impossibile avviare il servizio dell'agente Bindplane

  • Verifica che la sintassi del file config.yaml sia corretta (utilizza la rientranza YAML corretta con spazi, non con tabulazioni).
  • Controlla la presenza di errori di sintassi nella configurazione:

    "C:\Program Files\observIQ OpenTelemetry Collector\observiq-otel-collector.exe" --config "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml" validate
    
  • Esamina il log eventi di Windows per individuare eventuali errori di avvio del servizio:

    1. Apri Visualizzatore eventi.
    2. Vai a Registri di Windows > Applicazione.
    3. Cerca gli errori dall'origine observiq-otel-collector.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
device_application about.application Valore copiato direttamente
AgentLocation about.asset.location.name Valore copiato direttamente
dhostname, device_hostname about.hostname Valore di device_hostname se non è vuoto, altrimenti dhostname
calo about.ip Valore copiato direttamente
System.Version, System.Channel, System.Keywords, System.Opcode, System.ThreadID, EventData.Credential, EventData.DataName, EventData.CredentialMask, content_version_field_value, dhostname, dip, device_application, device_subapplication, device_event_count, bootstraphosts, usessl, acknowledgementmode, contenttype, topic, compression.type, esmversion, schemaregistryhosts, truststoreloc, truststorepass, usesslauth, keystoreloc, keystorepass, keypass, desc, AddrBasedSysZonePopEvents, AddrBasedSysZonePopRows, AddrBasedUsrZonePopEvents, AddrBasedUsrZonePopRows, AddrBasedZonePopEvents, AddrBasedZonePopRows, AddrBasedZonePopRowsIPv6, AgentId, AgentName, CategorizerCount, CategorizerCountConsole, CategorizerCountCustom, Comment, Current Drop Count, DeviceLocation, Estimated Cache Size, First Global event Processed, First Post-Aggregation Event Processed, First Post-Filtering Event Processed, Global events Processed, HostNameResolutionEnabled, Last Global event Processed, Last Post-Aggregation Event Processed, Last Post-Filtering Event Processed, LastModified, M1CacheDropped, M1CacheSize, ModifiedBy, NGCustomAdditionalDataMapper0, NGCustomAdditionalDataMapper1, NameResolverIPv6Control, Post-Aggregation Event rate LTC, Post-Aggregation Events Processed, Post-Aggregation Events Processed(SLC), Post-Aggregation Events/Sec, Post-Aggregation Events/Sec(SLC), Post-Filtering Event rate LTC, Post-Filtering Events Processed, Post-Filtering Events Processed(SLC), Post-Filtering Events/Sec, Post-Filtering Events/Sec(SLC), RawEventCount, RawEventLen, RawEventPreAggregatedCount, Resolver.hAdded, Resolver.hEvicted, Resolver.hQBlocked, Resolver.hQRejected, Resolver.hQSize, Resolver.hSize, Resolver.iAdded, Resolver.iEvicted, Resolver.iQBlocked, Resolver.iQRejected, Resolver.iQSize, Resolver.iSize, StatusCode, TC.dropcount, TC.size, ZFiltered, aup[acp].version, aup[system-zone-mappings].version, aup[user-categorizations].version, aup[user-zone-mappings].version, hbstatus, queuesize, sent, sent(SLC), status, throughput, throughput LTC, throughput(SLC), C, ET, HT, N, S, T additional.fields Uniti con oggetti token in cui ogni token.value.string_value è impostato dal campo di origine corrispondente
extensions.auth.type Imposta su "AUTHTYPE_UNSPECIFIED" se System.EventId == "2054"
System.Task, Comment metadata.description Valore di Comment se non è vuoto, altrimenti System.Task
metadata.event_type Impostato su "GENERIC_EVENT", poi su "USER_UNCATEGORIZED" se System.EventId è ["260","262"] e le condizioni sono soddisfatte, "USER_DELETION" se System.EventId == "533" e le condizioni sono soddisfatte, "STATUS_UPDATE" se System.EventId è ["776","780"], "USER_LOGIN" se System.EventId == "2054"
System.EventId metadata.product_event_type Valore copiato direttamente
System.EventRecordID metadata.product_log_id Valore copiato direttamente
System.ProviderName principal.application Valore copiato direttamente
EventData.InitiatorDomain principal.domain.name Valore copiato direttamente
System.Computer principal.hostname Valore copiato direttamente
System.ProcessID principal.process.pid Valore copiato direttamente
EventData.InitiatorName principal.user.userid Valore copiato direttamente
EventData.Error security_result.description Valore copiato direttamente
security_result.severity Impostato su "INFORMATIONAL" se System.Level == "Information" o level =~ "INFO", "LOW" se System.Level == "Warning", altrimenti "UNKNOWN_SEVERITY"
System.Level, level security_result.severity_details Valore del livello se non vuoto, altrimenti System.Level
EventData.UserDomain target.domain.name Valore copiato direttamente
EventData.UserName target.user.user_display_name Valore copiato direttamente
System.UserId target.user.userid Valore copiato direttamente
metadata.vendor_name Imposta su "HID"
metadata.product_name Imposta su "DigitalPersona"

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.