FortiAnalyzer

Questo documento descrive come integrare FortiAnalyzer con Google Security Operations.

Prima di iniziare

Per garantire una comunicazione corretta tra Google SecOps e FortiAnalyzer, devi configurare un account amministratore dedicato con autorizzazioni specifiche per API e risorse.

Categoria Livello di autorizzazione
Impostazioni di sistema Nessuno
Dominio amministrativo Nessuno
Gestione dispositivi Sola lettura
    Aggiungi/Elimina/Modifica dispositivi/gruppi Sola lettura
Log View/FortiView Sola lettura
Incidenti ed eventi Lettura/scrittura
    Crea e aggiorna gli incidenti Lettura/scrittura
Triage Event Nessuno
Esegui playbook Nessuno
Report Nessuno
    Esegui report Nessuno
Visualizzazione Fabric Nessuno

Per consentire all'integrazione di comunicare con l'API FortiAnalyzer, devi concedere all'account amministratore le autorizzazioni API necessarie:

  1. In FortiAnalyzer, vai all'elenco degli amministratori e seleziona l'account utente creato per questa integrazione.

  2. Nella barra laterale Modifica amministratore, individua il campo Accesso API JSON e impostalo su Read-Write.

  3. Fai clic su Ok per salvare le modifiche.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Root API Stringa https://{ip address} Sì Radice API dell'istanza FortiAnalyzer.
Nome utente Stringa N/D Sì

Nome utente dell'account FortiAnalyzer.

Assicurati che le credenziali fornite appartengano a un account utente assegnato al profilo definito in Prima di iniziare.

Password Password N/D Sì

Password dell'account FortiAnalyzer.

Assicurati che le credenziali fornite appartengano a un account utente assegnato al profilo definito in Prima di iniziare.

Verifica SSL Casella di controllo Selezionata Sì Se abilitata, verifica che il certificato SSL per la connessione a FortiAnalyzer sia valido.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Aggiungi commento all'avviso

Descrizione

Aggiungi un commento all'avviso in FortiAnalyzer.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID avviso Stringa N/D Sì Specifica l'ID dell'avviso da aggiornare.
Commento Stringa N/D Sì Specifica il commento per l'avviso.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
    "jsonrpc": "2.0",
    "id": "string",
    "result": {
        "status": "done"
    }
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se le informazioni restituite (is_success=true): "Commento aggiunto correttamente all'avviso con ID {id} in FortiAnalyzer."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Aggiungi commento all'avviso". Reason: {0}''.format(error.Stacktrace)"

Se l'avviso non viene trovato: "Errore durante l'esecuzione dell'azione "Aggiungi commento all'avviso". Motivo: l'avviso con ID {alert id} non è stato trovato in FortiAnalyzer. Controlla l'ortografia."

Generale

Arricchisci le entità

Descrizione

Arricchisci le entità utilizzando le informazioni di FortiAnalyzer. Entità supportate: nome host, indirizzo IP.

Parametri

N/D

Pubblica su

Questa azione viene eseguita sulle seguenti entità:

  • Nome host
  • Indirizzo IP

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
    "adm_pass": [
        "ENC",
        "FLP+Dq8f3t2/S+GQ6DfPL2iRhtmk1CEZzEeH8+nVkRkFd72IUbBZM6uDyw0fQ1j1i28H1wtfqf6HlGEK2ubxs0rXE4L+Uqj433si+AmEF9gEB5gLw/4P5YYRkw/aOYF74k8/8bincoa31jBe0u0HWRNdWYQSyG7IWgvZGsPK4at0gwZI"
    ],
    "adm_usr": "admin",
    "app_ver": "",
    "av_ver": "",
    "beta": -1,
    "branch_pt": 1255,
    "build": 1255,
    "checksum": "",
    "conf_status": 0,
    "conn_mode": 0,
    "conn_status": 0,
    "db_status": 0,
    "desc": "",
    "dev_status": 0,
    "eip": "",
    "fap_cnt": 0,
    "faz.full_act": 0,
    "faz.perm": 15,
    "faz.quota": 0,
    "faz.used": 0,
    "fex_cnt": 0,
    "first_tunnel_up": 0,
    "flags": 2097152,
    "foslic_cpu": 0,
    "foslic_dr_site": 0,
    "foslic_inst_time": 0,
    "foslic_last_sync": 0,
    "foslic_ram": 0,
    "foslic_type": 0,
    "foslic_utm": 0,
    "fsw_cnt": 0,
    "ha_group_id": 0,
    "ha_group_name": "",
    "ha_mode": 0,
    "ha_slave": null,
    "hdisk_size": 0,
    "hostname": "",
    "hw_rev_major": 0,
    "hw_rev_minor": 0,
    "hyperscale": 0,
    "ip": "172.30.203.248",
    "ips_ext": 0,
    "ips_ver": "",
    "last_checked": 1665664693,
    "last_resync": 0,
    "latitude": "0.0",
    "lic_flags": 0,
    "lic_region": "",
    "location_from": "",
    "logdisk_size": 0,
    "longitude": "0.0",
    "maxvdom": 10,
    "mgmt.__data[0]": 0,
    "mgmt.__data[1]": 0,
    "mgmt.__data[2]": 0,
    "mgmt.__data[3]": 0,
    "mgmt.__data[4]": 0,
    "mgmt.__data[5]": 0,
    "mgmt.__data[6]": 0,
    "mgmt.__data[7]": 0,
    "mgmt_if": "",
    "mgmt_mode": 2,
    "mgmt_uuid": "1841991674",
    "mgt_vdom": "",
    "module_sn": "",
    "mr": 2,
    "name": "FGVMEV2YKQ61YQD5",
    "node_flags": 0,
    "nsxt_service_name": "",
    "oid": 181,
    "onboard_rule": null,
    "opts": 0,
    "os_type": 0,
    "os_ver": 7,
    "patch": 2,
    "platform_str": "FortiGate-VM64",
    "prefer_img_ver": "",
    "prio": 0,
    "private_key": "",
    "private_key_status": 0,
    "psk": "",
    "role": 0,
    "sn": "FGVMEV2YKQ61YQD5",
    "source": 2,
    "tab_status": "",
    "tunnel_cookie": "",
    "tunnel_ip": "",
    "vdom": [
        {
            "comments": null,
            "devid": "FGVMEV2YKQ61YQD5",
            "ext_flags": 0,
            "flags": 0,
            "name": "root",
            "node_flags": 0,
            "oid": 3,
            "opmode": 1,
            "rtm_prof_id": 0,
            "status": null,
            "tab_status": null,
            "vdom_type": 1,
            "vpn_id": 0
        }
    ],
    "version": 700,
    "vm_cpu": 0,
    "vm_cpu_limit": 0,
    "vm_lic_expire": 0,
    "vm_mem": 0,
    "vm_mem_limit": 0,
    "vm_status": 0
}
Arricchimento delle entità - Prefisso FortiAn_
Nome del campo di arricchimento Origine (chiave JSON) Logica - Quando applicarle
adm_usr adm_usr Se disponibile in JSON
build build Se disponibile in JSON
ip ip Se disponibile in JSON
last_checked last_checked Se disponibile in JSON
last_resync last_resync Se disponibile in JSON
nome nome Se disponibile in JSON
sn sn Se disponibile in JSON
os_type os_type Se disponibile in JSON
os_ver os_ver Se disponibile in JSON
patch patch Se disponibile in JSON
platform\_str platform\_str Se disponibile in JSON
versione versione Se disponibile in JSON
decr decr Se disponibile in JSON
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili per un'entità (is_success=true): "Le seguenti entità sono state arricchite correttamente utilizzando le informazioni di FortiAnalyzer: {entity.identifier}".

Se i dati non sono disponibili per un'entità (is_success=true): "L'azione non è riuscita ad arricchire le seguenti entità utilizzando le informazioni di FortiAnalyzer: {entity.identifier}"

Se i dati non sono disponibili per tutte le entità (is_success=false): "Nessuna delle entità fornite è stata arricchita."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Arricchisci entità". Reason: {0}''.format(error.Stacktrace)

Generale
Tabella della bacheca casi

Titolo: {entity.identifier}

Colonne:Coppia chiave-valore

Entità

Dindin

Descrizione

Testa la connettività a FortiAnalyzer con i parametri forniti nella pagina di configurazione dell'integrazione nella pagina Google SecOps Content Hub.

Parametri

N/D

Pubblica su

Questa azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
N/A
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine: "Connessione al server BitSight eseguita con i parametri di connessione forniti".

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Impossibile connettersi al server BitSight. Error is {0}".format(exception.stacktrace)

Generale

Cerca nei log

Descrizione

Cerca i log in FortiAnalyzer.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Tipo di log DDL

Traffico

Valori possibili:

  • Traffico
  • Controllo tramite app
  • Attacco
  • Contenuti, DLP
  • Filtro email
  • Evento, cronologia
  • Virus
  • VOIP
  • Filtro web
  • Netscan
  • Evento FCT
  • Traffico FCT
  • WAF
  • GTP
No Specifica il tipo di log in cui eseguire la ricerca.
Filtro sensibile alle maiuscole Casella di controllo Deselezionata No Se abilitato, il filtro è sensibile alle maiuscole.
Filtro query Stringa N/D No Specifica il filtro di query per la ricerca.
ID dispositivo Stringa All\_Fortigate No

Specifica l'ID del dispositivo da cercare.

Se non viene fornito alcun valore, l'azione esegue la ricerca in All_Fortigate.

Esempi di valori: All_FortiGate, All_FortiMail, All_FortiWeb, All_FortiManager, All_Syslog, All_FortiClient, All_FortiCache, All_FortiProxy, All_FortiAnalyzer, All_FortiSandbox, All_FortiAuthenticator, All_FortiDDoS

Intervallo di tempo DDL

Mese scorso

Valori possibili:

  • Ultima ora
  • Ultime 6 ore
  • Ultime 24 ore
  • Settimana scorsa
  • Mese scorso
  • Personalizzato
No

Specifica un intervallo di tempo per i risultati.

Se selezioni "Personalizzato", devi anche fornire il parametro "Ora di inizio".

Ora di inizio Stringa N/D No

Specifica l'ora di inizio dei risultati.

Questo parametro è obbligatorio se per il parametro "Periodo di tempo" è selezionato "Personalizzato".

Formato: ISO 8601

Ora di fine Stringa N/D No

Specifica l'ora di fine per i risultati.

Formato: ISO 8601.

Se non viene fornito alcun valore e per il parametro "Periodo di tempo" è selezionato "Personalizzato", questo parametro utilizza l'ora corrente.

Ordine cronologico DDL

DECR

Valori possibili:

  • DECR
  • CRESC
No Specifica l'ordine temporale nella ricerca.
Numero massimo di log da restituire Numero intero 20 No Specifica il numero di log che vuoi restituire. Valore predefinito: 20. Massimo: 1000.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
    "sessionid": "29658",
    "srcip": "172.30.201.188",
    "dstip": "173.243.138.210",
    "srcport": "17453",
    "dstport": "443",
    "trandisp": "noop",
    "duration": "1",
    "proto": "6",
    "sentbyte": "216",
    "rcvdbyte": "112",
    "sentpkt": "4",
    "rcvdpkt": "2",
    "logid": "0001000014",
    "service": "HTTPS",
    "app": "HTTPS",
    "appcat": "unscanned",
    "srcintfrole": "undefined",
    "dstintfrole": "undefined",
    "eventtime": "1665752066921638736",
    "srccountry": "Reserved",
    "dstcountry": "Canada",
    "srcintf": "root",
    "dstintf": "port1",
    "dstowner": "540",
    "tz": "-0700",
    "devid": "FGVMEV2YKQ61YQD5",
    "vd": "root",
    "csf": "FortiNetFabric",
    "dtime": "2022-10-14 05:54:27",
    "itime_t": "1665752069",
    "devname": "FGVMEV2YKQ61YQD5"
}{
    "date": "2022-10-14",
    "time": "05:54:27",
    "id": "7154350659607724033",
    "itime": "2022-10-14 05:54:29",
    "euid": "102",
    "epid": "102",
    "dsteuid": "102",
    "dstepid": "102",
    "logver": "702021255",
    "type": "traffic",
    "subtype": "local",
    "level": "notice",
    "action": "close",
    "policyid": "0"
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se vengono restituite informazioni (is_success=true): "Recupero dei log per i criteri forniti in FortiAnalyzer riuscito."

Se non vengono restituite informazioni (is_success=true): "No logs were found for the provided criteria in FortiAnalyzer." (Non sono stati trovati log per i criteri forniti in FortiAnalyzer).

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Cerca nei log". Reason: {0}''.format(error.Stacktrace)"

Se nella risposta viene segnalato un errore: "Errore durante l'esecuzione dell'azione "Cerca nei log". Reason: {0}''.format(error/message)"

Generale

Aggiorna avviso

Descrizione

Aggiorna un avviso in FortiAnalyzer.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID avviso Stringa N/D Sì Specifica l'ID dell'avviso da aggiornare.
Stato di conferma DDL

Selezionane uno

Valori possibili:

  • Selezionane uno
  • Conferma
  • Annulla conferma
No Specifica lo stato di conferma dell'avviso.
Segna come letto Casella di controllo Deselezionata No Se abilitata, l'azione contrassegna l'avviso come letto.
Assegna a Stringa N/D No Specifica a chi deve essere assegnato l'avviso.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
    "alerttime": "1665653864",
    "logcount": "17",
    "alertid": "202210131000040003",
    "adom": "root",
    "epid": "1",
    "epname": "not implemented dev type",
    "subject": "desc:Trim local db",
    "euid": "1",
    "euname": "N/A",
    "devname": "fortianalyzer",
    "logtype": "event",
    "devtype": "FortiAnalyzer",
    "devid": "FAZ-VMTM22013516",
    "vdom": "_self_locallog_",
    "groupby1": "desc:Trim local db",
    "triggername": "Local Device Event",
    "tag": "Default,System,Local",
    "eventtype": "event",
    "severity": "medium",
    "extrainfo": "{ \"msg\": \"Requested to trim database tables older than 60 days to enforce the retention policy of Adom FortiAuthenticator.\" }",
    "ackflag": "no",
    "readflag": "yes",
    "filterkey": "3377053565526629289",
    "firstlogtime": "1665653864",
    "multiflag": "",
    "lastlogtime": "1665653887",
    "updatetime": "1665747977",
    "filtercksum": "2072153473",
    "filterid": "1",
    "assignto": "api_user",
    "ackby": "admin",
    "acktime": "1665747892"
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se vengono restituite informazioni (is_success=true): "Successfully updated alert with ID {alert id} in FortiAnalyzer."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Aggiorna avviso". Reason: {0}''.format(error.Stacktrace)

Se l'avviso non viene trovato: "Errore durante l'esecuzione dell'azione "Aggiorna avviso". Motivo: l'avviso con ID {alert id} non è stato trovato in FortiAnalyzer. Controlla l'ortografia."

Se il parametro "Stato di conferma" è impostato su "Seleziona uno", il parametro "Segna come letto" è impostato su Falso e non viene fornito alcun valore nel parametro "Assegna a": "Errore durante l'esecuzione dell'azione "Aggiorna avviso". Motivo: almeno uno dei parametri "Acknowledge Status", "Mark As Read" o "Assign To" deve avere un valore ."

Generale

Connettori

FortiAnalyzer - Connettore degli avvisi

Descrizione

Recupera informazioni sugli avvisi da FortiAnalyzer.

Configura FortiAnalyzer - Connettore degli avvisi in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, consulta Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Nome campo prodotto Stringa siemplify_type Sì Inserisci il nome del campo di origine per recuperare il nome del campo del prodotto.
Nome campo evento Stringa event_type Sì Inserisci il nome del campo di origine per recuperare il nome del campo evento.
Nome campo ambiente Stringa "" No

Descrive il nome del campo in cui è memorizzato il nome dell'ambiente.

Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.

Pattern regex dell'ambiente Stringa .* No

Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente".

Il valore predefinito è .* per rilevare tutto e restituire il valore invariato.

Utilizzato per consentire all'utente di manipolare il campo dell'ambiente tramite la logica delle espressioni regolari.

Se il pattern regex è nullo o vuoto o se il valore dell'ambiente è nullo, il risultato finale dell'ambiente è l'ambiente predefinito.

Timeout dello script (secondi) Numero intero 180 Sì Limite di timeout per il processo Python che esegue lo script corrente.
Root API Stringa https://{ip address} Sì Radice API dell'istanza FortiAnalyzer.
Nome utente Stringa N/D Sì Nome utente dell'account FortiAnalyzer.
Password Password N/D Sì Password dell'account FortiAnalyzer.
Gravità minima da recuperare Stringa Media No

La gravità minima da utilizzare per recuperare gli avvisi.

Valori possibili: low, medium, high, critical. Se non viene specificato nulla, il connettore importa gli avvisi con tutte le gravità.

Numero massimo di ore indietro Numero intero 1 No Numero di ore da cui recuperare gli avvisi.
Numero massimo di avvisi da recuperare Numero intero 20 No Numero di avvisi per tipo da elaborare per un'iterazione del connettore.
Utilizza l'elenco dinamico come lista bloccata Casella di controllo Deselezionata Sì Se l'opzione è attiva, l'elenco dinamico viene utilizzato come lista bloccata.
Verifica SSL Casella di controllo Selezionata Sì Se questa opzione è abilitata, il connettore verifica che il certificato SSL per la connessione al server FortiAnalyzer sia valido.
Indirizzo del server proxy Stringa N/D No L'indirizzo del server proxy da utilizzare.
Nome utente proxy Stringa N/D No Il nome utente del proxy con cui eseguire l'autenticazione.
Password proxy Password N/D No La password del proxy con cui eseguire l'autenticazione.

Regole del connettore

Supporto dei proxy

Il connettore supporta il proxy.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.