Raccogli i log di Fortinet FortiAnalyzer
Versione parser: 35.0
Questa guida spiega come importare i log di Fortinet FortiAnalyzer in Google Security Operations utilizzando Bindplane.
Fortinet FortiAnalyzer è una piattaforma di logging centralizzato, analisi e generazione di report per i dispositivi Fortinet Security Fabric. Aggrega i log dei firewall FortiGate, FortiMail, FortiWeb, FortiSandbox e di altri prodotti Fortinet per fornire visibilità unificata, correlazione degli eventi e report sulla conformità. FortiAnalyzer può inoltrare i log aggregati tramite syslog a piattaforme SIEM esterne per ulteriori analisi.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps.
- Windows Server 2016 o versioni successive oppure host Linux con
systemd. - Connettività di rete tra l'agente Bindplane e l'appliance FortiAnalyzer.
- Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
- Accesso con privilegi alla console di gestione di Fortinet FortiAnalyzer (Super_User o ruolo di amministratore equivalente).
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 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](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](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-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 il syslog e inviarlo a Google SecOps
Individua il file di configurazione
- Linux:
bash sudo nano /opt/observiq-otel-collector/config.yaml - Windows:
cmd 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: tcplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/fortianalyzer: 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 # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' # Replace with your actual customer ID from Step 2 customer_id: 'your-customer-id-here' endpoint: chronicle.googleapis.com log_type: FORTINET_FORTIANALYZER raw_log_field: body ingestion_labels: env: production service: pipelines: logs/fortianalyzer_to_chronicle: receivers: - tcplog exporters: - chronicle/fortianalyzer
Parametri di configurazione
- Configurazione del ricevitore:
listen_address: l'indirizzo IP e la porta su cui ascoltare. Utilizza0.0.0.0per ascoltare su tutte le interfacce. Se necessario, modifica la porta (ad esempio1514).
- Configurazione dell'esportatore:
creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: il tuo ID cliente Google SecOps.location: 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.ingestion_labels: etichette facoltative in formato YAML (ad esempio,env: production).
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/fortianalyzer: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' # Replace with your actual customer ID from Step 2 customer_id: 'your-customer-id-here' endpoint: malachiteingestion-pa.googleapis.com log_type: FORTINET_FORTIANALYZER raw_log_field: body ingestion_labels: env: production
Salva il file di configurazione
Dopo la modifica, salva il file:
- Linux: premi
Ctrl+O, poiEntere infineCtrl+X. - Windows: fai clic su File > Salva.
Riavvia l'agente Bindplane per applicare le modifiche
Per riavviare l'agente Bindplane in Linux:
Esegui questo comando:
sudo systemctl restart observiq-otel-collectorVerifica che il servizio sia in esecuzione:
sudo systemctl status observiq-otel-collectorControlla i log per verificare la presenza di errori:
sudo journalctl -u observiq-otel-collector -f
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"
Configura l'inoltro del syslog di FortiAnalyzer
Configura FortiAnalyzer per inoltrare i log all'agente Bindplane utilizzando l'output syslog.
Configura il server syslog in FortiAnalyzer
- Accedi all'interfaccia web di FortiAnalyzer.
- Vai a Impostazioni di sistema > Inoltro dei log.
- Fai clic su Crea nuova per aggiungere una nuova regola di forwarding dei log.
- Fornisci i seguenti dettagli di configurazione:
- Nome: inserisci un nome descrittivo (ad esempio
Chronicle-Bindplane). - Stato: seleziona Attiva.
- Remote Server Type (Tipo di server remoto): seleziona Syslog.
- IP/FQDN del server: inserisci l'indirizzo IP dell'host dell'agente Bindplane.
- Porta server: inserisci
514(o la porta configurata nell'agente Bindplane). - Syslog affidabile (RFC 6587): seleziona Abilita per utilizzare il trasporto TCP.
- Formato di forwarding dei log: seleziona Predefinito o CEF in base ai tuoi requisiti.
- Nome: inserisci un nome descrittivo (ad esempio
- Nella sezione Filtri log, configura i tipi di log da inoltrare:
- Seleziona l'ADOM (dominio amministrativo) da cui inoltrare i log.
- Seleziona i tipi di dispositivi e le categorie di log da includere (log di traffico, eventi, sicurezza, DNS, SSH, SSL).
- Fai clic su Ok per salvare la configurazione.
Verifica l'inoltro dei log
- Vai a Impostazioni di sistema > Inoltro dei log.
- Verifica che lo stato della regola di forwarding sia Abilitato.
- Monitora la colonna Statistiche per verificare che i log vengano inoltrati.
- Verifica che i log vengano ricevuti controllando i log dell'agente Bindplane.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
devname |
principal.hostname |
Tratto da devname. |
srcip |
principal.ip |
Tratto da srcip. |
srcport |
principal.port |
Convertito in numero intero. |
srcintf |
additional.fields |
Chiave: srcintf. |
dstip |
target.ip |
Tratto da dstip. |
dstport |
target.port |
Convertito in numero intero. |
dstintf |
additional.fields |
Chiave: dstintf. |
proto |
network.ip_protocol |
Mappato (6=TCP, 17=UDP, 1=ICMP). |
action |
security_result.action |
accept/pass → CONSENTI; deny/drop/block → BLOCCA. |
policyid |
security_result.rule_id |
Tratto da policyid. |
policyname |
security_result.rule_name |
Tratto da policyname. |
user |
principal.user.userid |
Tratto da user. |
app |
target.application |
Tratto da app. |
sentbyte |
network.sent_bytes |
Convertito in numero intero senza segno. |
rcvdbyte |
network.received_bytes |
Convertito in numero intero senza segno. |
severity |
security_result.severity |
information → INFORMATIVO, warning → MEDIO, error → ERRORE, critical/alert/emergency → ALTO. |
logid |
metadata.product_log_id |
Tratto da logid. |
type |
metadata.product_event_type |
Tratto da type. |
subtype |
metadata.product_event_type |
Aggiunto al tipo. |
level |
security_result.severity_details |
Tratto da level. |
| N/D | metadata.vendor_name |
Impostalo su Fortinet. |
| N/D | metadata.product_name |
Impostalo su FortiAnalyzer. |
attack |
event.idm.read_only_udm.security_result.description |
Mappato dal log delle modifiche |
msg |
event.idm.read_only_udm.security_result.category_details |
Mappato dal log delle modifiche |
alert_sub_type |
event.idm.read_only_udm.security_result.category_details |
Mappato dal log delle modifiche |
Details.SourcePort |
event.idm.read_only_udm.principal.port |
Mappato dal log delle modifiche |
Details.DestinationPort |
event.idm.read_only_udm.target.port |
Mappato dal log delle modifiche |
inter_host |
event.idm.read_only_udm.intermediary.hostname |
Mappato dal log delle modifiche |
observer_application |
event.idm.read_only_udm.observer.application |
Mappato dal log delle modifiche |
event_time |
event.idm.read_only_udm.metadata.event_timestamp |
Mappato dal log delle modifiche |
alert_time |
event.idm.read_only_udm.metadata.collected_timestamp |
Mappato dal log delle modifiche |
details.Bios |
event.idm.read_only_udm.principal.asset.product_object_id |
Mappato dal log delle modifiche |
details.HostName |
event.idm.read_only_udm.principal.hostname e event.idm.read_only_udm.principal.asset.hostname |
Mappato dal log delle modifiche |
details.IP |
event.idm.read_only_udm.principal.nat_ip |
Mappato dal log delle modifiche |
agent_uuid |
event.idm.read_only_udm.principal.asset.asset_id |
Mappato dal log delle modifiche |
alert_name |
event.idm.read_only_udm.security_result.rule_name |
Mappato dal log delle modifiche |
Details.SourceAddress |
event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip |
Mappato dal log delle modifiche |
Details.DestinationAddress |
event.idm.read_only_udm.target.ip e event.idm.read_only_udm.target.asset.ip |
Mappato dal log delle modifiche |
Details.Protocol |
event.idm.read_only_udm.network.ip_protocol |
Mappato dal log delle modifiche |
ref |
event.idm.read_only_udm.security_result.about.url |
Mappato dal log delle modifiche |
Details.status |
event.idm.read_only_udm.security_result.summary |
Mappato dal log delle modifiche |
log_verbosity |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
root_scope_id |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
timestamp_details |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
observer_application_pid |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
Details.ConsumerScopes |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
Details.ProviderScopes |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
user_dst_location |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
user_dst_network_zone |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
user_dst_ownership |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
host_name |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
forwardedfor |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
tenant_id |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
details.AgentType |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
details.CurrentVersion |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
details.Platform |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
scope_name |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
scope_id |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
vrf_id |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
Details.user_src_app_name |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
Details.user_src_environment |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
Details.user_src_location |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
Details.user_src_network_zone |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
Details.user_src_ownership |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
severity |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
alert_text |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
attackid |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
key_id |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
individual_alert |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
summary_alert_freq |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
alert_grain |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
IsConsumerMalicious |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
IsProviderMalicious |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
from |
event.idm.read_only_udm.network.email.from |
Mappato dal log delle modifiche |
to |
event.idm.read_only_udm.network.email.to |
Mappato dal log delle modifiche |
subject |
event.idm.read_only_udm.network.email.subject |
Mappato dal log delle modifiche |
size |
event.idm.read_only_udm.network.sent_bytes |
Mappato dal log delle modifiche |
attachment |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
qtype |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
xid |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
action |
event.idm.read_only_udm.security_result.action a ALLOW quando action è uguale a ip-conn |
Mappato dal log delle modifiche |
unauthuser |
event.idm.read_only_udm.principal.user.userid |
Mappato dal log delle modifiche |
user_name |
event.idm.read_only_udm.principal.user.userid |
Mappato dal log delle modifiche |
app_protocol_src |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
cloudaction |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
itime |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
shapingpolicyname |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
mastersrcmac |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
dstdevtype |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
eventsubtype |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
pdstport |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
psrcport |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
clouduser |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
unauthusersource |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
devid |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
incidentserialno |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
poluuid |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
http_retcode |
event.idm.read_only_udm.network.http.response_code |
Mappato dal log delle modifiche |
http_method |
event.idm.read_only_udm.network.http.method |
Mappato dal log delle modifiche |
http_url |
event.idm.read_only_udm.target.url |
Mappato dal log delle modifiche |
http_agent |
event.idm.read_only_udm.network.http.user_agent |
Mappato dal log delle modifiche |
srcfamily |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mappato dal log delle modifiche |
cipher_suite |
event.idm.read_only_udm.network.tls.cipher |
Mappato dal log delle modifiche |
policy |
event.idm.read_only_udm.security_result.rule_name |
Mappato dal log delle modifiche |
http_response_bytes |
event.idm.read_only_udm.network.received_bytes |
Mappato dal log delle modifiche |
http_request_bytes |
event.idm.read_only_udm.network.sent_bytes |
Mappato dal log delle modifiche |
osname |
event.idm.read_only_udm.principal.platform |
Mappato dal log delle modifiche |
dstosname |
event.idm.read_only_udm.target.platform |
Mappato dal log delle modifiche |
scertcname |
event.idm.read_only_udm.network.tls.client.certificate.subject |
Mappato dal log delle modifiche |
dstswversion |
event.idm.read_only_udm.target.platform_version |
Mappato dal log delle modifiche |
dsthwvendor |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
filesize |
event.idm.read_only_udm.target.file.size |
Mappato dal log delle modifiche |
http_version |
event.idm.read_only_udm.network.application_protocol_version |
Mappato dal log delle modifiche |
x509_cert_subject |
event.idm.read_only_udm.network.tls.server.certificate.subject |
Mappato dal log delle modifiche |
srcswversion |
event.idm.read_only_udm.principal.platform_version |
Mappato dal log delle modifiche |
tlsver |
event.idm.read_only_udm.network.tls.version |
Mappato dal log delle modifiche |
original_src |
event.idm.read_only_udm.principal.ip |
Mappato dal log delle modifiche |
http_host |
event.idm.read_only_udm.target.hostname |
Mappato dal log delle modifiche |
http_refer |
event.idm.read_only_udm.network.http.referral_url |
Mappato dal log delle modifiche |
agent |
event.idm.read_only_udm.network.http.user_agent e event.idm.read_only_udm.network.http.parsed_user_agent |
Mappato dal log delle modifiche |
dstname |
target.hostname |
Mappato dal log delle modifiche |
catdesc |
security_result.rule_name |
Mappato dal log delle modifiche |
crscore |
security_result.detection_fields |
Mappato dal log delle modifiche |
method |
network.http.method |
Mappato dal log delle modifiche |
filename |
target.file.full_path |
Mappato dal log delle modifiche |
dstuser |
target.user.userid |
Mappato dal log delle modifiche |
fsaverdict |
additional.fields |
Mappato dal log delle modifiche |
type", "subtype", and "level |
metadata.ingestion_labels |
Mappato dal log delle modifiche |
logdesc |
metadata.description |
Mappato dal log delle modifiche |
srcname |
principal.hostname |
Mappato dal log delle modifiche |
httpmethod |
network.http.method |
Mappato dal log delle modifiche |
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.