Raccogli i log di Pharos
Questo documento spiega come importare i log di Pharos in Google Security Operations utilizzando Bindplane.
Pharos è una piattaforma di gestione della stampa on-premise per il monitoraggio, il controllo e l'audit delle attività di stampa negli ambienti aziendali. Pharos Blueprint Enterprise archivia i dati dei job di stampa, l'attività utente e gli eventi dei dispositivi in un database SQL Server.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- Windows Server 2016 o versioni successive
- Connessione di rete tra l'agente Bindplane e il server Pharos Blueprint
- 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 Pharos Blueprint
- Accesso al database Pharos SQL Server o alla console di reporting di Blueprint Administrator
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-collector
Il 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
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:\Pharos\Exports\*.csv' start_at: beginning poll_interval: 5s exporters: chronicle/pharos: 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: PHAROS raw_log_field: body ingestion_labels: env: production service: pipelines: logs/pharos_to_chronicle: receivers: - filelog exporters: - chronicle/pharos
Parametri di configurazione
Sostituisci i seguenti segnaposto:
Configurazione del ricevitore:
include: percorsi dei file di esportazione di Pharos:- Windows:
C:\Pharos\Exports\*.csv - Modifica il percorso in base alla posizione in cui esporti i report sulle attività di stampa di Pharos
- 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:
pharos: 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.PHAROS: il tipo di log esattamente come appare in Chronicleingestion_labels: etichette facoltative in formato YAML (ad esempio,env: production)
Configurazione della pipeline:
pharos_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/pharos: 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: PHAROS 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-collector- Console dei 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"
Esporta i log delle attività di stampa di Pharos
Pharos Blueprint Enterprise archivia i dati dei job di stampa in un database SQL Server. Devi esportare i dati in file CSV che l'agente Bindplane può leggere.
Esporta i dati dell'attività di stampa dal database SQL di Pharos
- Sul server Pharos Blueprint, connettiti al database SQL Pharos utilizzando SQL Server Management Studio o uno strumento a riga di comando.
Esporta i record delle attività di stampa utilizzando una query SQL:
sqlcmd -S <sql_server> -d Pharos -Q "SELECT * FROM PrintJobLog WHERE JobDate >= DATEADD(day, -1, GETDATE())" -o "C:\Pharos\Exports\pharos_print_jobs.csv" -s "," -WPianifica 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.
Alternativa: esporta i report dalla console di amministrazione di Blueprint
- Apri la console Pharos Blueprint Administrator.
- Vai ad Insight > Report.
- Seleziona il tipo di report che ti interessa (ad esempio, Attività di stampa, Attività utente, Attività del dispositivo).
- Configura l'intervallo di date e i filtri.
Esporta il report come file CSV nella directory di esportazione (ad esempio, `C:\Pharos\Exports`).
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| msg.Building, msg.DataSource, msg.FactSubType, msg.FactType, msg.JobId, msg.JobName, msg.JobTimeutc, msg.PostalCode, msg.VpnConnected, mtd.customer, mtd.slt.node, mtd.slt.pipeline, mtd.source.database, mtd.timestamp.producer_process | additional.fields | Unito a Building_label se msg.Building non è vuoto, datasource_label se msg.DataSource non è vuoto, factsubtype_label se msg.FactSubType non è vuoto, facttype_label se msg.FactType non è vuoto, jobid_label se msg.JobId non è vuoto, jobname_label se msg.JobName non è vuoto, jobtimeutc_label se msg.JobTimeutc non è vuoto, postalcode_label se msg.PostalCode non è ["", "Unknown"], vpnconnected_label se msg.VpnConnected non è vuoto, customer_label se mtd.customer non è vuoto, node_label se mtd.slt.node non è vuoto, pipeline_label se mtd.slt.pipeline non è vuoto, database_label se mtd.source.database non è vuoto, producer_process_label se mtd.timestamp.producer_process non è vuoto |
| metadata.event_type | Impostato su "STATUS_UPDATE" se has_principal è true, altrimenti su "GENERIC_EVENT" | |
| msg.Application | principal.application | Valore copiato direttamente se non vuoto |
| msg.HostName | principal.asset.hostname | Valore copiato direttamente se non vuoto |
| msg.IPAddress | principal.asset.ip | Valore copiato direttamente se non è ["", "Unknown"] |
| msg.City | principal.location.city | Valore copiato direttamente se non è ["", "Unknown"] |
| msg.Country | principal.location.country_or_region | Valore copiato direttamente se non è ["", "Unknown"] |
| msg.State | principal.location.state | Valore copiato direttamente se non è ["", "Unknown"] |
| msg.HostName | principal.hostname | Valore copiato direttamente se non vuoto |
| msg.IPAddress | principal.ip | Valore copiato direttamente se non è ["", "Unknown"] |
| msg.UserDisplayName | principal.user.user_display_name | Valore copiato direttamente se non vuoto |
| mtd.source.host | src.hostname | Valore copiato direttamente se non vuoto |
| mtd.source.port | src.port | Valore copiato direttamente se non è ["", "n/a"] |
| mtd.source.type | src.resource.attribute.labels | Unito a sourcetype_label se non vuoto |
| metadata.product_name | Impostato su "PHAROS" | |
| metadata.vendor_name | Impostato su "PHAROS" |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.