Raccogli i log HID DigitalPersona
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.
Opzione 1: crea un account di servizio per l'API Chronicle (consigliato)
- Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
- Vai a IAM e amministrazione > Service account.
- Fai clic su Crea account di servizio.
- 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).
- Nome account di servizio: inserisci un nome per l'account (ad esempio
- Fai clic su Crea e continua.
- Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
- Fai clic su Continua e poi su Fine.
- Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
- Fai clic su Aggiungi chiave > Crea nuova chiave.
- Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul computer.
- Salva il file della chiave come
ingestion-auth.jsonnella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonsu Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonsu Windows) o aggiornacreds_file_pathinconfig.yamlin modo che corrisponda al percorso in cui lo salvi. - 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)
- Accedi alla console Google SecOps.
- Vai a Impostazioni > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Agenti di raccolta.
- Scarica il file di autenticazione dell'acquisizione.
- Salva il file in modo sicuro sul sistema in cui verrà installato l'agente Bindplane.
Ottieni l'ID cliente Google SecOps
- Accedi alla console Google SecOps.
- Vai a Impostazioni > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.
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
- Apri il prompt dei comandi o PowerShell come amministratore.
Esegui questo comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sc query observiq-otel-collectorIl servizio dovrebbe essere visualizzato come RUNNING.
Installazione di Linux
- Apri un terminale con privilegi root o sudo.
Esegui questo comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sudo systemctl status observiq-otel-collectorIl 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
- Apri il prompt dei comandi come amministratore.
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
Sostituisci l'intero contenuto di
config.yamlcon 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/digitalpersonaSostituisci i seguenti segnaposto:
Configurazione dell'esportatore:
YOUR_PROJECT_ID: l'ID progetto del file di autenticazione dell'acquisizioneYOUR_PRIVATE_KEY_ID: l'ID della chiave privata del file di autenticazione dell'acquisizioneYOUR_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'acquisizioneYOUR_CLIENT_ID: l'ID client del file di autenticazione dell'acquisizioneYOUR_CERT_URL: l'URL del certificato x509 del client dal file di autenticazione dell'acquisizioneYOUR_CUSTOMER_ID: l'ID cliente Google SecOps del passaggio precedente
Sostituisci
<LOCATION>con la regione della tua istanza Google SecOps (ad esempious,europeoasia-southeast1). L'esportatore anteponechronicle.googleapis.coma 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
exporterscon il seguente. Impostacreds_file_pathsul percorso del file di autenticazione dell'acquisizione e, se l'istanza si trova al di fuori degli Stati Uniti, sostituiscimalachiteingestion-pa.googleapis.comcon 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:
- Fai clic su File > Salva.
- 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-collectorConsole Servizi:
- Premi
Win+R, digitaservices.msce premi Invio. - Individua observIQ OpenTelemetry Collector.
- Fai clic con il tasto destro del mouse e seleziona Riavvia.
- Premi
Verifica che il servizio sia in esecuzione:
sc query observiq-otel-collectorControlla 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
- Premi
Win+R, digitaeventvwr.msce premi Invio per aprire il Visualizzatore eventi. - Vai a Registri applicazioni e servizi.
- Espandi la cartella DigitalPersona-Altus-Core.
- Fai clic con il tasto destro del mouse su Operativo e seleziona Proprietà.
- Verifica che l'opzione Abilita il logging sia selezionata.
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
- In Visualizzatore eventi, vai a uno dei canali DigitalPersona (ad esempio, DigitalPersona-Altus-Core > Operativo).
- Verifica che gli eventi vengano registrati.
- Esegui un'operazione di autenticazione di prova o di gestione delle credenziali in DigitalPersona per generare nuovi eventi.
- Aggiorna il Visualizzatore eventi per visualizzare i nuovi eventi.
Verifica che gli eventi vengano inviati a Google SecOps
- Attendi 5-10 minuti per l'elaborazione e l'importazione degli eventi.
- Accedi alla console Google SecOps.
- Vai a Indaga > Enterprise Insights > Importazione dei dati.
- Cerca HID_DIGITALPERSONA nel filtro del tipo di log.
- 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-collectorControlla 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:
- Premi
Win+R, digitaservices.msce premi Invio. - Verifica che i seguenti servizi siano in esecuzione:
- DigitalPersona Authentication Service
- DigitalPersona Server
- Premi
Verifica che il logging degli eventi sia abilitato nelle impostazioni dei criteri di gruppo di DigitalPersona:
- Apri la Console Gestione Criteri di gruppo.
- Vai alla policy DigitalPersona.
- 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.yamlsia 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" validateEsamina il log eventi di Windows per individuare eventuali errori di avvio del servizio:
- Apri Visualizzatore eventi.
- Vai a Registri di Windows > Applicazione.
- 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.