Raccogli i log di DMP Entre
Parser Version: 1.0
Questo documento spiega come importare i log DMP Entre in Google Security Operations utilizzando l'agente Bindplane.
DMP Entre è un software di monitoraggio degli allarmi di intrusione e controllo dell'accesso di Digital Monitoring Products (DMP). Gestisce i punti di ingresso e di uscita, la gestione dei visitatori e gli eventi di accesso fisico. L'applicazione archivia i dati sugli eventi (scansioni dei badge, concessioni/rifiuti di accesso, modifiche dello stato di attivazione ed eventi di allarme) in un database Microsoft SQL Server.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- Windows Server 2016 o versioni successive
- Connettività di rete tra l'agente Bindplane e il server DMP Entre
- 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 sistema DMP Entre
- Accesso al database Entre SQL Server o possibilità di esportare i report Eventi
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 seguendo le istruzioni riportate di seguito.
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.
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 e inviarli a Google SecOps
Individua il file di configurazione
Individua il file di configurazione nel seguente modo:
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: filelog: include: - 'C:\DMP\Entre\Exports\*.csv' start_at: beginning poll_interval: 5s exporters: chronicle/dmp_entre: 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: DMP_ENTRE raw_log_field: body ingestion_labels: env: production service: pipelines: logs/dmp_entre_to_chronicle: receivers: - filelog exporters: - chronicle/dmp_entre
Parametri di configurazione
Sostituisci i seguenti segnaposto:
Configurazione del ricevitore:
include: percorsi dei file di esportazione di DMP Entre:- Windows:
C:\DMP\Entre\Exports\*.csv - Regola il percorso in base alla posizione in cui esporti i report Eventi Entre
- Windows:
start_at: imposta subeginningper leggere i log esistenti o suendper leggere solo le nuove vocipoll_interval: la frequenza con cui verificare la presenza di nuovi dati di log (valore predefinito:5s)
Configurazione dell'esportatore:
dmp_entre: nome descrittivo dell'esportatorecreds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):- Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Windows:
<customer_id>: l'ID cliente del passaggio precedentelocation: 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.DMP_ENTRE: il tipo di log esattamente come appare in Chronicleingestion_labels: etichette facoltative in formato YAML (ad esempio,env: production)
Configurazione della pipeline:
dmp_entre_to_chronicle: nome descrittivo della pipeline
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/dmp_entre: 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: DMP_ENTRE raw_log_field: body ingestion_labels: env: production
Salva il file di configurazione
- Dopo la modifica, salva il file:
- Windows: fai clic su File > Salva.
Riavvia l'agente Bindplane per applicare le modifiche
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-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
Esporta i dati sugli eventi DMP Entre
DMP Entre archivia i dati sugli eventi in un database Microsoft SQL Server. Devi esportare gli eventi in file CSV che l'agente Bindplane può leggere.
Esporta i report Eventi dalla GUI di DMP Entre
- Accedi all'applicazione DMP Entre sul server Entre.
- Vai a Report nella barra dei menu di Entre.
- Seleziona il tipo di report Eventi appropriato:
- Report sulla cronologia eventi: contiene tutti gli eventi di sistema, inclusi l'accesso alle porte, gli eventi di allarme e le modifiche allo stato di attivazione.
- Report sull'attività di accesso: contiene gli eventi di passaggio del badge con i dettagli dell'utente, della porta e del timestamp.
- Report sull'attività degli allarmi: contiene eventi di allarme, problemi e supervisione.
- Configura i filtri del report:
- Intervallo di date: seleziona l'intervallo di date per gli eventi che vuoi esportare.
- Pannelli/Dispositivi: seleziona i pannelli specifici o tutti i pannelli.
- Tipi di eventi: seleziona le categorie di eventi da includere.
- Fai clic su Genera (o Esegui) per generare il report.
- Esporta il report come file CSV nella directory di esportazione (ad esempio, "C:\DMP\Entre\Exports").
Alternativa: automatizza le esportazioni del database
Per le esportazioni automatiche, puoi eseguire query direttamente sul database Entre SQL Server utilizzando un job SQL Server Agent pianificato o l'Utilità di pianificazione di Windows:
- Connettiti al database Entre SQL Server.
Esporta i dati sugli eventi utilizzando l'utilità
bcp:bcp "SELECT date, time, event_type, p_event_title, p_event_action, user_display_name, userid, device_data, principal_host, data, log_level FROM [EntreDB].[dbo].[EventHistory] WHERE date >= DATEADD(day, -1, GETDATE())" queryout "C:\DMP\Entre\Exports\entre_events.csv" -c -t"," -S localhost -TPianifica l'esecuzione di questo comando a intervalli regolari (ad esempio, ogni ora) utilizzando l'Utilità di pianificazione di Windows in modo che l'agente Bindplane acquisisca continuamente nuovi file di esportazione.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| data, ora | metadata.event_timestamp | Concatenato da data e ora, analizzato utilizzando i formati M/g/aaaa HH:mm:ss, MM/g/aaaa HH:mm:ss e così via. |
| event_type | metadata.event_type | Valore copiato direttamente |
| p_event_type | metadata.description | Impostato su p_event_type se event_type == "GENERIC_EVENT" |
| metadata.product_name | Imposta su "ENTRE" | |
| metadata.vendor_name | Impostato su "DMP" | |
| p_event_title, p_event_action | event_type | Impostato su "GENERIC_EVENT" per impostazione predefinita; "SETTING_MODIFICATION" se p_event_title == "arming status" o p_event_action == "set time"; "STATUS_HEARTBEAT" se p_event_action == "automatic recall test ok" o corrisponde a porta bloccata/sbloccata o zona aperta/chiusa/aperta forzatamente; "USER_BADGE_IN" se p_event_title == "door access" e p_event_action == "door access granted" |
| extensions.auth.mechanism | Imposta su "BADGE_READER" per l'evento USER_BADGE_IN | |
| extensions.auth.type | Impostato su "PHYSICAL" per l'evento USER_BADGE_IN | |
| inter_host | intermediary.hostname | Impostato se inter_host non è convertibile in IP |
| inter_host | intermediary.ip | Imposta se inter_host è convertibile in IP |
| principal_host, inter_host | principal.hostname | Valore di principal_host se device_data è presente e principal_host non è convertibile in IP; altrimenti, se principal è vuoto e inter_host non è convertibile in IP, da inter_host |
| principal_host, inter_host | principal.ip | Valore di principal_host se convertibile in IP; altrimenti, se principal è vuoto, da inter_ip |
| device_data | principal.location.name | Valore copiato direttamente |
| user_display_name | principal.user.user_display_name | Valore copiato direttamente |
| userid | principal.user.userid | Valore copiato direttamente |
| dati | security_result.description | Valore copiato direttamente |
| log_level | security_result.severity | Impostato su "LOW" se "INFO", "MEDIUM" se "WARNING", "HIGH" se "ERROR" |
| log_level | security_result.severity_details | Valore copiato direttamente |
| p_event_type | security_result.summary | Valore copiato direttamente |
| device_data | target.location.name | Impostato per l'evento USER_BADGE_IN |
| target.resource.name | Imposta su "Stato di attivazione" se p_event_title == "stato di attivazione"; "Comando del pannello" se p_event_action == "imposta ora" | |
| target.resource.type | Impostato su "SETTING" per l'evento SETTING_MODIFICATION |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.