Punto di log

Versione integrazione: 16.0

Casi d'uso

Esegui azioni attive: esegui query per ottenere maggiori informazioni sulle entità.

Configura l'integrazione di Logpoint in Google Security Operations

Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Indirizzo IP Stringa https://x.x.x.x Indirizzo IP dell'istanza Logpoint.
Nome utente Stringa N/D Nome utente dell'account Logpoint.
Secret Password N/D Chiave API segreta dell'account Logpoint
File del certificato CA Stringa N/D No File del certificato CA con codifica Base64.
Verifica SSL Casella di controllo Selezionata Se abilitato, verifica che il certificato SSL per la connessione al server Logpoint sia valido.

Azioni

Dindin

Descrizione

Verifica la connettività a Logpoint con i parametri forniti nella pagina di configurazione dell'integrazione nella scheda Google Security Operations Marketplace.

Parametri

N/D

Run On

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

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
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 Logpoint riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se non va a buon fine: "Failed to connect to the Logpoint server! Error is {0}".format(exception.stacktrace)

Generale

Esegui query

Descrizione

Esegui la query di ricerca in Logpoint.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Query Stringa N/D Specifica la query da eseguire in Logpoint.
Intervallo di tempo DDL

Ultime 24 ore

Valori possibili:
Ultima ora

Ultime 12 ore

Ultime 24 ore

Ultimi 30 giorni

Ultimi 365 giorni

Personalizzato

Specifica l'intervallo di tempo per la query. Se è selezionata l'opzione "Personalizzato", devi fornire anche l'ora di inizio e l'ora di fine.
Ora di inizio Stringa N/D No

Specifica l'ora di inizio della query. Formato:

AAAA-MM-GGThh:mm:ssZ o timestamp.

Ora di fine Stringa N/D No

Specifica l'ora di fine della query.Formato:

AAAA-MM-GGThh:mm:ssZ o timestamp. Se non viene specificato nulla, l'azione utilizzerà l'ora corrente come ora di fine.

Repos CSV N/D No Specifica un elenco separato da virgole dei nomi dei repository. Se non viene fornito alcun valore, l'azione eseguirà la ricerca in tutti i repository.
Numero massimo di risultati da restituire Numero intero 100 No Specifica il numero di risultati da restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "query_type": "simple",
    "rows": [
        {
            "msg": "2021-01-10 10:27:50 Benchmarker; reporting speed; service=norm_front; actual_mps=1; doable_mps=19096;",
            "log_ts": 1610274470,
            "actual_mps": "1",
            "doable_mps": "19096",
            "_type_str": "_tz device_name msg source_name col_type object norm_id service collected_at label device_ip
    _enrich_policy action _fromV550 repo_name logpoint_name",
    "device_name": "localhost",
            "_offset": 48317,
            "logpoint_name": "Logpoint",
            "action": "reporting speed",
            "repo_name": "_logpoint",
            "source_name": "/opt/immune/var/log/benchmarker/norm_front.log",
            "col_ts": 1610274470,
            "_tz": "UTC",
            "norm_id": "Logpoint",
            "_identifier": "0",
            "collected_at": "Logpoint",
            "device_ip": "127.0.0.1",
            "service": "norm_front",
            "_fromV550": "t",
            "_enrich_policy": "None",
            "_type_num": "actual_mps doable_mps col_ts sig_id log_ts _offset _identifier",
            "_type_ip": "device_ip",
            "sig_id": "10505",
            "col_type": "filesystem",
            "object": "Benchmarker",
            "_labels": [
                "Logpoint",
                "Benchmarker"
            ]
        }
    ],
    "version": 6,
    "extracted_terms": [],
    "time_range": [
        1609496280,
        1610274480
    ],
    "orig_search_id": "9acac4a0-e530-4a19-a446-e17d4d9f8aae",
    "success": true,
    "final": true,
    "totalPages": 1,
    "estim_count": 185003,
    "complete": true,
    "status": {
        "Logpoint": {
            "default": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 3,
                "final": true
            },
            "_logpoint": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 185000,
                "final": true
            },
            "LogSource1": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            },
            "_LogpointAlerts": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            }
        }
    }
}
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 success == true per tutte le richieste (is_success = true): "Successfully executed query and retrieved results from Logpoint".

Se success == true per tutte le richieste, ma nessun risultato (is_success=false): "Non sono stati trovati dati per la query fornita."

Se success == false per almeno una richiesta (is_success = false): "L'azione non è riuscita a eseguire correttamente la query e a recuperare i risultati da Logpoint. Motivo: {0}".format(message)

Messaggio asincrono

"In attesa del completamento dell'elaborazione della query in Logpoint."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Esegui query". Motivo: {0}''.format(error.Stacktrace)

Se si verifica un timeout:

Errore durante l'esecuzione dell'azione "Esegui query". Motivo: l'azione ha raggiunto il timeout. Restringi l'intervallo di tempo o riduci la quantità di risultati da restituire.

Se non viene trovato almeno un repository:

"Errore durante l'esecuzione dell'azione "Esegui query". Motivo: i seguenti repository non sono stati trovati in Logpoint: {0}. Assicurati che tutti i repository siano disponibili.".format(comma-separated list of repos that were not found)

Se è selezionata l'opzione"Personalizzato ", ma non è stata fornita l'ora di inizio:

"Errore durante l'esecuzione dell'azione "Esegui query". Motivo: devi fornire l'"Ora di inizio" se è selezionato "Personalizzato" per l'intervallo di tempo.

Generale
Tabella Bacheca casi

Nome tabella: "Risultati"

Tutte le colonne della risposta verranno utilizzate come colonne della tabella.

Generale

Esegui query entità

Descrizione

Esegui la query in Logpoint in base alle entità. Tipi di entità attualmente supportati: utente, IP, indirizzo email, URL, hash del file, nome host. Nota: l'indirizzo email è un'entità Utente che corrisponde al formato dell'indirizzo email.

Come utilizzare i parametri di azione

Questa azione consente di recuperare facilmente le informazioni relative alle entità. Ad esempio, è possibile risolvere il caso d'uso in cui vuoi visualizzare la quantità di log degli endpoint interessati dall'hash fornito senza creare query complicate.

Per risolvere questo problema in Logpoint, devi preparare la seguente query: ("device_ip"="10.0.0.1" or "device_ip"="10.0.0.2") and ("hash"="7694f4a66316e53c8cdd9d9954bd611d" or "hash"="8264ee52f589f4c0191aa94f87aa1aeb") | chart count() by device_ip

Per creare la stessa query utilizzando l'azione "Esegui query entità", devi compilare i parametri dell'azione nel seguente modo:

Query | chart count() by device_ip
Chiave entità IP device_ip
Chiave entità hash file hash
Operatore cross-entity E

Tutti gli altri campi possono essere lasciati vuoti.

Se il caso d'uso è vedere quanti endpoint sono stati interessati dagli hash forniti, la configurazione di "Esegui query entità" avrà il seguente aspetto.

Query | chart count() by device_ip
Chiave entità hash file hash

In questa situazione, "Operatore cross-entità" non ha alcun impatto, perché influisce solo sulla query quando vengono fornite più "Chiavi entità".

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Query Stringa Specifica la query da eseguire. Per informazioni dettagliate, consulta la documentazione dell'azione.
Intervallo di tempo DDL

Ultime 24 ore

Valori possibili:
Ultima ora

Ultime 12 ore

Ultime 24 ore

Ultimi 30 giorni

Ultimi 365 giorni

Personalizzato

Specifica l'intervallo di tempo per la query. Se è selezionata l'opzione "Personalizzato", devi fornire anche l'ora di inizio, mentre l'ora di fine utilizzerà l'ora attuale per impostazione predefinita.
Ora di inizio Stringa No

Specifica l'ora di inizio della query. Formato:

AAAA-MM-GGThh:mm:ssZ o timestamp.

Ora di fine Stringa No

Specifica l'ora di fine della query.Formato:

AAAA-MM-GGThh:mm:ssZ o timestamp. Se non viene specificato nulla, l'azione utilizzerà l'ora corrente come ora di fine.

Repos CSV No Specifica un elenco separato da virgole dei nomi dei repository. Se non viene fornito alcun valore, l'azione eseguirà la ricerca in tutti i repository.
Chiave entità IP Stringa No Specifica la chiave da utilizzare con le entità IP. Per informazioni dettagliate, consulta la documentazione dell'azione.
Chiave entità nome host Stringa No Specifica quale chiave deve essere utilizzata con le entità Nome host durante la preparazione del file . Per informazioni dettagliate, consulta la documentazione dell'azione.
Chiave entità hash file No Specifica la chiave da utilizzare con le entità Hash file. Per informazioni dettagliate, consulta la documentazione dell'azione.
Chiave entità utente No Specifica quale chiave deve essere utilizzata con le entità Utente. Per informazioni dettagliate, consulta la documentazione dell'azione.
Chiave entità URL No Specifica la chiave da utilizzare con le entità URL. Per informazioni dettagliate, consulta la documentazione dell'azione.
Chiave entità indirizzo email No Specifica quale chiave deve essere utilizzata con le entità Indirizzo email. Per informazioni dettagliate, consulta la documentazione dell'azione.
Interrompi se non ci sono entità sufficienti Casella di controllo Selezionata Se abilitata, l'azione non verrà eseguita, a meno che tutti i tipi di entità non siano disponibili per le "Chiavi entità" specificate. Esempio: se vengono specificate "Chiave entità IP" e "Chiave entità hash file", ma nell'ambito non sono presenti hash file, se questo parametro è abilitato, l'azione non eseguirà la query.
Operatore cross-entity DDL

OPPURE

Valori possibili:

OPPURE

E

Specifica l'operatore logico da utilizzare tra i diversi tipi di entità.
Numero massimo di risultati da restituire Numero intero 100 No Specifica il numero di risultati da restituire.

Run On

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Host
  • Utente
  • Hash
  • URL

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "query_type": "simple",
    "rows": [
        {
            "msg": "2021-01-10 10:27:50 Benchmarker; reporting speed; service=norm_front; actual_mps=1; doable_mps=19096;",
            "log_ts": 1610274470,
            "actual_mps": "1",
            "doable_mps": "19096",
            "_type_str": "_tz device_name msg source_name col_type object norm_id service collected_at label device_ip
    _enrich_policy action _fromV550 repo_name logpoint_name",
    "device_name": "localhost",
            "_offset": 48317,
            "logpoint_name": "Logpoint",
            "action": "reporting speed",
            "repo_name": "_logpoint",
            "source_name": "/opt/immune/var/log/benchmarker/norm_front.log",
            "col_ts": 1610274470,
            "_tz": "UTC",
            "norm_id": "Logpoint",
            "_identifier": "0",
            "collected_at": "Logpoint",
            "device_ip": "127.0.0.1",
            "service": "norm_front",
            "_fromV550": "t",
            "_enrich_policy": "None",
            "_type_num": "actual_mps doable_mps col_ts sig_id log_ts _offset _identifier",
            "_type_ip": "device_ip",
            "sig_id": "10505",
            "col_type": "filesystem",
            "object": "Benchmarker",
            "_labels": [
                "Logpoint",
                "Benchmarker"
            ]
        }
    ],
    "version": 6,
    "extracted_terms": [],
    "time_range": [
        1609496280,
        1610274480
    ],
    "orig_search_id": "9acac4a0-e530-4a19-a446-e17d4d9f8aae",
    "success": true,
    "final": true,
    "totalPages": 1,
    "estim_count": 185003,
    "complete": true,
    "status": {
        "Logpoint": {
            "default": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 3,
                "final": true
            },
            "_logpoint": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 185000,
                "final": true
            },
            "LogSource1": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            },
            "_LogpointAlerts": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            }
        }
    }
}
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 success == true per tutte le richieste (is_success = true): "Successfully executed query and retrieved results from Logpoint".

Se success == true per tutte le richieste, ma nessun risultato (is_success=false): "Non sono stati trovati dati per la query fornita."

Se success == false per almeno una richiesta (is_success = false): "L'azione non è riuscita a eseguire correttamente la query e a recuperare i risultati da Logpoint. Motivo: {0}".format(message)

Messaggio asincrono

"In attesa del completamento dell'elaborazione della query in Logpoint."

Se l'opzione "Interrompi se non ci sono abbastanza entità" è attivata e non sono disponibili tipi di entità sufficienti per le "Chiavi entità" fornite (is_success=false): l'azione non è riuscita a creare la query perché non sono stati forniti tipi di entità sufficienti per le "Chiavi entità" specificate. Disattiva il parametro "Interrompi se non ci sono abbastanza entità" o fornisci almeno un'entità per ogni "Chiave entità" specificata.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Esegui query entità". Motivo: {0}''.format(error.Stacktrace)

Se si verifica un timeout:

Errore durante l'esecuzione dell'azione "Esegui query entità". Motivo: l'azione ha raggiunto il timeout. Restringi l'intervallo di tempo o riduci la quantità di risultati da restituire.

Se non viene trovato almeno un repository:
"Errore durante l'esecuzione dell'azione "Esegui query entità". Motivo: i seguenti repository non sono stati trovati in Logpoint: {0}. Assicurati che tutti i repository siano disponibili.".format(comma-separated list of repos that were not found)

Se non vengono specificate chiavi "Entity":

Errore durante l'esecuzione dell'azione "Esegui query entità". Motivo: specifica almeno un parametro "Chiave entità".

Se è selezionata l'opzione"Personalizzato ", ma non è stata fornita l'ora di inizio:

"Errore durante l'esecuzione dell'azione "Esegui query entità". Motivo: devi fornire l'"Ora di inizio" se è selezionato "Personalizzato" per l'intervallo di tempo.

Generale

Tabella della bacheca casi

Nome tabella: "Risultati"

Tutte le colonne della risposta verranno utilizzate come colonne della tabella.

Generale

List Repos

Descrizione

Elenca i repository disponibili in Logpoint.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Numero massimo di repository da restituire Numero intero 100 No Specifica il numero di report da restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "success": true,
    "allowed_repos": [
        {
            "repo": "default",
            "address": "127.0.0.1:5504/default"
        },
        {
            "repo": "_logpoint",
            "address": "127.0.0.1:5504/_logpoint"
        },
        {
            "repo": "_LogpointAlerts",
            "address": "127.0.0.1:5504/_LogpointAlerts"
        },
        {
            "repo": "LogSource1",
            "address": "127.0.0.1:5504/LogSource1"
        }
    ],
    "logpoint": [
        {
            "name": "Logpoint",
            "ip": "127.0.0.1"
        }
    ]
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
if success == true (is_success = true): "Successfully retrieve available repos query from Logpoint".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Elenca repository". Motivo: {0}''.format(error.Stacktrace)

Generale
Tabella Bacheca casi

Nome tabella: "Available Repos"

Nome - allowed_repos/repo

Indirizzo - allowed_repos/address

Generale

Aggiorna stato incidente

Descrizione

Aggiorna lo stato dell'incidente in Logpoint.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID incidente Stringa N/D Specifica l'ID dell'incidente che vuoi aggiornare.
Azione DLL

Chiudi

Valori possibili:

Risolvi

Chiudi

Specifica l'azione per l'incidente.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
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 success== true (is_success = true): "Successfully {0} incident with ID {1} in Logpoint.".format(resolved/closed, incident_id)

if success== false(is_success = true): "Action wasn't able to {0} incident with ID {1} in Logpoint.".format(resolve/close, incident_id)

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

if fatal error, like wrong credentials, no connection to server, other: "Error executing action "Update Incident Status". Motivo: {0}''.format(error.Stacktrace)

Generale

Connettore

Punto di log - Connettore incidenti

Descrizione

Estrai gli incidenti da Logpoint.

Configura il connettore Logpoint - Incidents in Google SecOps

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

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome campo prodotto Stringa Nome prodotto Inserisci il nome del campo di origine per recuperare il nome del campo prodotto.
Nome campo evento Stringa tipo 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 ambiente Stringa .* No

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

Il valore predefinito è .* per acquisire 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 è null o vuoto oppure il valore dell'ambiente è null, il risultato finale dell'ambiente è l'ambiente predefinito.

Timeout dello script (secondi) Numero intero 180 Limite di timeout per il processo Python che esegue lo script corrente.
Indirizzo IP Stringa https://x.x.x.x Indirizzo IP dell'istanza Logpoint.
Nome utente Stringa N/D Nome utente dell'account Logpoint.
Secret Password N/D Secret dell'account Logpoint.
Ore massime indietro Numero intero 1 No Numero di ore da cui recuperare gli incidenti.
Rischio più basso di recupero Stringa N/D No

Rischio più basso degli incidenti da recuperare. Valori possibili:

Critica, Elevata, Media, Bassa.

Numero massimo di incidenti da recuperare Numero intero 10 No Quanti incidenti elaborare per un'iterazione del connettore.
Utilizzare la lista consentita come lista nera Casella di controllo Deselezionata Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL Casella di controllo Deselezionata Se abilitata, verifica che il certificato SSL per la connessione al server Logpoint sia valido.
File del certificato CA Stringa N/D No File del certificato CA con codifica Base64.
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 per l'autenticazione.
Filtro utente CSV N/D No Un elenco separato da virgole di nomi utente utilizzati per filtrare gli incidenti. Vengono importati solo gli incident creati dagli utenti validi. Se non viene fornito nulla, questo filtro non viene applicato e il connettore acquisisce gli incidenti di tutti gli utenti.

Regole del connettore

Supporto proxy

Il connettore supporta il proxy.

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