Raccogli i log di Microsoft LAPS
Questo documento spiega come importare i log di Microsoft Windows LAPS (Local Administrator Password Solution) in Google Security Operations utilizzando l'agente Bindplane.
Windows LAPS gestisce le password degli account amministratore locale sui dispositivi aggiunti al dominio e genera voci del log eventi per la rotazione delle password, l'elaborazione delle policy e le operazioni di gestione. Il parser estrae i campi dal formato XML del log eventi di Windows 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 con l'agente Bindplane installato
- Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
- Windows LAPS configurato e distribuito nel tuo ambiente
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
- 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.
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 il log eventi di Windows e inviarlo a Google SecOps
Individua il file di configurazione
Utilizza la seguente sintassi per individuare 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/laps_operational: channel: Microsoft-Windows-LAPS/Operational max_reads: 100 poll_interval: 5s raw: true start_at: end processors: batch: exporters: chronicle/laps: 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: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINDOWS_LAPS override_log_type: false raw_log_field: body service: pipelines: logs/laps: receivers: - windowseventlog/laps_operational processors: [batch] exporters: [chronicle/laps]
Parametri di configurazione
Sostituisci i seguenti segnaposto:
Configurazione del ricevitore:
channel: canale del log eventi di Windows da cui leggere (Microsoft-Windows-LAPS/Operational)max_reads: numero massimo di voci di log da leggere per ciclo di pollingpoll_interval: la frequenza con cui eseguire il polling per i nuovi eventistart_at: da dove iniziare la lettura (endsolo per i nuovi eventi)
Configurazione dell'esportatore:
creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1) (C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)customer_id: ID cliente copiato dalla console Google SecOpslocation: sostituisci<LOCATION>con la regione della tua istanza Google SecOps (ad esempious,europeoasia-southeast1). L'esportatore aggiungechronicle.googleapis.comcome prefisso 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'impostazionechronicle.googleapis.com.
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/laps: compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINDOWS_LAPS override_log_type: false raw_log_field: body
Salva il file di configurazione
Fai clic su File > Salva.
Riavvia l'agente Bindplane per applicare le modifiche
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.
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"
- Premi
Configura Microsoft Windows LAPS
- Digita
eventvwr.mscin un prompt dei comandi con privilegi elevati e premi Invio per aprire il Visualizzatore eventi. - Vai a Registri applicazioni e servizi > Microsoft > Windows > LAPS.
- Espandi LAPS.
- Fai clic con il tasto destro del mouse su LAPS, quindi su Proprietà.
- Seleziona la casella di controllo Abilita il logging.
- Fai clic su OK quando ti viene chiesto se il log è abilitato.
- Fai clic su OK.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| Canale | read_only_udm.additional.fields.key | Il valore viene preso dal campo Channel nel log non elaborato e assegnato al campo key. |
| Canale | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo Channel nel log non elaborato e assegnato al campo string_value. |
| Computer | read_only_udm.principal.hostname | Il valore viene preso dal campo Computer nel log non elaborato. |
| Computer | read_only_udm.principal.asset.hostname | Il valore viene preso dal campo Computer nel log non elaborato. |
| EventData.%1 | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo EventData.%1 nel log non elaborato e assegnato al campo string_value. |
| EventId | read_only_udm.metadata.product_event_type | Il valore viene preso dal campo EventId nel log non elaborato. |
| EventId | read_only_udm.security_result.rule_name | Il valore viene preso dal campo EventId nel log non elaborato e aggiunto a EventID:. |
| EventRecordID | read_only_udm.metadata.product_log_id | Il valore viene preso dal campo EventRecordID nel log non elaborato. |
| Parole chiave | read_only_udm.additional.fields.key | Il valore viene preso dal campo Keywords nel log non elaborato e assegnato al campo key. |
| Parole chiave | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo Keywords nel log non elaborato e assegnato al campo string_value. |
| Livello | read_only_udm.security_result.severity | Il valore viene preso dal campo Level nel log non elaborato e mappato a: INFORMATIONAL per INFO, Informational, Information, Normal, NOTICE; ERROR per ERROR, Error; CRITICAL per Critical. |
| Opcode | read_only_udm.additional.fields.key | Il valore viene preso dal campo Opcode nel log non elaborato e assegnato al campo key. |
| Opcode | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo Opcode nel log non elaborato e assegnato al campo string_value. |
| ProcessID | read_only_udm.principal.process.pid | Il valore viene preso dal campo ProcessID nel log non elaborato. |
| ProviderName | read_only_udm.metadata.product_name | Il valore viene preso dal campo ProviderName nel log non elaborato. |
| Attività | read_only_udm.additional.fields.key | Il valore viene preso dal campo Task nel log non elaborato e assegnato al campo key. |
| Attività | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo Task nel log non elaborato e assegnato al campo string_value. |
| ThreadID | read_only_udm.additional.fields.key | Il valore viene preso dal campo ThreadID nel log non elaborato e assegnato al campo key. |
| ThreadID | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo ThreadID nel log non elaborato e assegnato al campo string_value. |
| TimeCreated | read_only_udm.metadata.event_timestamp | Il valore viene preso dal campo TimeCreated nel log non elaborato, analizzato come timestamp UNIX_MS. |
| TimeCreated | events.timestamp | Il valore viene preso dal campo TimeCreated nel log non elaborato, analizzato come timestamp UNIX_MS. |
| Versione | read_only_udm.additional.fields.key | Il valore viene preso dal campo Version nel log non elaborato e assegnato al campo key. |
| Versione | read_only_udm.additional.fields.value.string_value | Il valore viene preso dal campo Version nel log non elaborato e assegnato al campo string_value. |
| read_only_udm.additional.fields.key | Assegnato il valore EventData_P1. |
|
| read_only_udm.metadata.event_type | Assegnato in modo condizionale STATUS_UNCATEGORIZED se EventId è 7 o 2, altrimenti GENERIC_EVENT. |
|
| read_only_udm.metadata.vendor_name | Assegnato il valore Microsoft. |
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.