Integra un'integrazione di esempio con Google SecOps
Questo documento è una guida completa a un'integrazione di esempio che illustra i pattern di progettazione comuni per la creazione di azioni, connettori e job per Google Security Operations (Google SecOps).
Parametri di integrazione
L'integrazione di esempio richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
API Root |
Obbligatorio. La radice dell'API per l'istanza di integrazione. In questo caso di esempio, viene utilizzato il servizio VAT Comply per l'integrazione con la radice dell'API Il valore predefinito è |
Password Field |
Facoltativo. Un esempio di campo della password dell'API. Questo parametro è incluso solo a scopo dimostrativo e non è richiesto dall'API per l'autenticazione. Il valore predefinito è |
Verify SSL |
Obbligatorio. Se selezionata, l'azione convalida il certificato SSL del server API. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
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
Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.
Dindin
Utilizza l'azione Ping per testare la connettività all'integrazione.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Ping fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script. | Disponibile |
Messaggi di output
L'azione Ping può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Failed to connect to the
API Service server!
Error is ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Esempio di azione semplice
Questo è un esempio di azione di base in Google SecOps.
Questa azione recupera i dati dal servizio api.vatcomply.com in base ai parametri forniti.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
| Parametro | Descrizione |
|---|---|
Currencies String |
Questo è un esempio di parametro che accetta un elenco separato da virgole di valori. Facoltativo. Un elenco separato da virgole di valute da elaborare. Il valore predefinito è |
Currencies DDL |
Questo è un esempio di parametro che accetta un elenco a discesa di valori. Facoltativo. Un elenco a discesa di valute da elaborare. Il valore predefinito è I valori possibili sono:
|
Time Frame |
Facoltativo. Il periodo di tempo per i risultati. Il valore predefinito è I valori possibili sono:
Se selezioni |
Start Time |
Facoltativo. L'ora di inizio dei risultati in formato ISO 8601. Questo parametro è obbligatorio se selezioni L'intervallo di tempo tra L'azione utilizza solo la parte della data del timestamp. |
End Time |
Facoltativo. L'ora di fine dei risultati in formato ISO 8601. Se selezioni L'intervallo di tempo tra L'azione utilizza solo la parte della data del timestamp. |
Return JSON Result |
Questo è un esempio di input booleano. Facoltativo. Se l'opzione è abilitata, l'azione restituisce un risultato JSON. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
Output azione
L'azione Cerca grafici fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Disponibile |
| Link alla bacheca casi | Disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Link alla bacheca casi
L'azione restituisce il seguente link:
- Valuta:
https://www.vatcomply.com/currencies/BASE_CURRENCY/date/DATE
Tabella della bacheca casi
L'azione fornisce la seguente tabella per ogni risposta dell'API:
Nome tabella: Currency: {base} - {date}
Colonne della tabella:
- Valuta (rate.keyname)
- Value (rate.keyname.value)
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione:
[
{
"date": "2000-03-03",
"exchange_rates": [
{
"base": "USD",
"rates": {
"EUR": 1.035303861683404,
"USD": 1.0,
"JPY": 107.8476032715602,
"CYP": 0.5955481933947614,
"CZK": 36.87752355316285,
"DKK": 7.711357283362667,
"EEK": 16.19898540221555,
"GBP": 0.6332953721917383,
"HUF": 265.60720571487735,
"LTL": 4.001035303861683,
"LVL": 0.5954032508541256,
"MTL": 0.4235428098146806,
"PLN": 4.125168236877524,
"ROL": 18961.590226731547,
"SEK": 8.769023708458434,
"SIT": 209.5625841184388,
"SKK": 43.26845429133451,
"CHF": 1.6630085930220522,
"ISK": 73.39269075473652,
"NOK": 8.369396417848638,
"TRL": 574745.8329019567,
"AUD": 1.647479035096801,
"CAD": 1.454705456051351,
"HKD": 7.782379128274149,
"KRW": 1119.9503054146392,
"NZD": 2.0485557511129517,
"SGD": 1.7232632777720263,
"ZAR": 6.4730303344031475
}
},
{
"base": "EUR",
"rates": {
"EUR": 1.0,
"USD": 0.9659,
"JPY": 104.17,
"CYP": 0.57524,
"CZK": 35.62,
"DKK": 7.4484,
"EEK": 15.6466,
"GBP": 0.6117,
"HUF": 256.55,
"LTL": 3.8646,
"LVL": 0.5751,
"MTL": 0.4091,
"PLN": 3.9845,
"ROL": 18315.0,
"SEK": 8.47,
"SIT": 202.4165,
"SKK": 41.793,
"CHF": 1.6063,
"ISK": 70.89,
"NOK": 8.084,
"TRL": 555147.0,
"AUD": 1.5913,
"CAD": 1.4051,
"HKD": 7.517,
"KRW": 1081.76,
"NZD": 1.9787,
"SGD": 1.6645,
"ZAR": 6.2523
}
}
]
}
]
Messaggi di output
L'azione può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action
"ACTION_NAME". Reason:
ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Esempio di azione Arricchisci entità
Questo è un esempio di un'azione che funziona con le entità in Google SecOps e le arricchisce.
Questa azione viene eseguita su tutte le entità Google SecOps fornite nel parametro Entity Type.
Input azione
L'azione Arricchisci entità richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Entity Type |
Obbligatorio. Le entità dell'ambito dell'avviso da elaborare. Il valore predefinito è I valori possibili sono: |
Output azione
L'azione Arricchisci entità fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella di arricchimento delle entità
L'azione Enrich Entity supporta il seguente arricchimento per le entità:
| Campo di arricchimento | Origine (chiave JSON) | Applicabilità |
|---|---|---|
SampleIntegration_enriched |
true |
Se disponibile nel risultato JSON. |
SampleIntegration_timestamp |
timestamp |
Se disponibile nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Arricchisci entità:
{
"Entity": "Entity",
"EntityResult": [
{
"enriched": "true",
"timestamp": "12123213123"
}
]
}
Messaggi di output
L'azione Arricchisci entità può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
No eligible entities were found in the scope of the alert. |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Arricchisci entità:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Esempio di azione asincrona
Questo è un esempio di azione asincrona in Google SecOps.
L'esecuzione dell'azione non verrà completata finché non viene raggiunto il timeout o finché alle richieste non viene assegnato un tag specificato nel parametro Case Tag To Wait For.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Async richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Case IDs |
Facoltativo. Un elenco separato da virgole di richieste da gestire. Se non viene fornito alcun valore, l'azione utilizza l'case ID da cui è stata eseguita l'azione. |
Case Tag To Wait For |
Obbligatorio. L'azione attende che i casi vengano taggati con questo valore prima di terminare l'esecuzione. |
Output azione
L'azione Async fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento delle entità | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Async:
[{
"case_id": "123",
"tags": ["Async"]
}, {
"case_id": "123",
"tags": ["Async"]
},]
Messaggi di output
L'azione Async può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action
"Async Action Example". Reason:
ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Async:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Connettori
Per scoprire di più sulla configurazione dei connettori in Google SecOps, consulta Importa i dati (connettori).
Integrazione di esempio - Esempio di connettore semplice
Utilizza l'integrazione di esempio - Esempio di connettore semplice per recuperare i tassi di cambio e altri dati dal servizio api.vatcomply.com.
Per utilizzare un elenco dinamico, utilizza il parametro alert_type.
Input del connettore
Il connettore Google Threat Intelligence - DTM Alerts richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Product Field Name |
Obbligatorio. Il nome del campo in cui è memorizzato il nome del prodotto. Il nome del prodotto influisce principalmente sulla mappatura. Per semplificare e migliorare il processo di mappatura per il connettore, il valore predefinito viene risolto in un valore di riserva a cui viene fatto riferimento dal codice. Qualsiasi input non valido per questo parametro viene risolto in un valore di riserva per impostazione predefinita. Il valore predefinito è |
Event Field Name |
Obbligatorio. Il nome del campo che determina il nome dell'evento (sottotipo). Il valore predefinito è |
Environment Field Name |
Facoltativo. Il nome del campo in cui è memorizzato il nome dell'ambiente. Se il campo dell'ambiente non è presente, il connettore utilizza il valore predefinito. Il valore predefinito è |
Environment Regex Pattern |
Facoltativo. Un pattern di espressione regolare da eseguire sul valore trovato nel campo Utilizza il valore predefinito Se il pattern dell'espressione regolare è nullo o vuoto o se il valore dell'ambiente è nullo, il risultato finale dell'ambiente è l'ambiente predefinito. |
Script Timeout (Seconds) |
Obbligatorio. Il limite di timeout, in secondi, per il processo Python che esegue lo script corrente. Il valore predefinito è |
API Root |
Obbligatorio. La radice dell'API per l'istanza di integrazione. In questo caso di esempio, viene utilizzato il servizio [VAT Comply](https://www.vatcomply.com/) per l'integrazione con la radice dell'API `api.vatcomply.com`. Il valore predefinito è |
Password Field |
Facoltativo. Un esempio di campo della password dell'API. Questo parametro è incluso solo a scopo dimostrativo e non è richiesto dall'API per l'autenticazione. Il valore predefinito è |
Currencies To Fetch |
Facoltativo. I tassi di cambio valuta da recuperare. Il valore predefinito è |
Create Alert Per Exchange Rate |
Facoltativo. Se abilitato, il connettore crea un avviso separato per ogni tasso di cambio. |
Alert Severity |
Facoltativo. Il livello di gravità dell'avviso. I valori possibili sono:
Il valore predefinito è |
Add Attachment |
Facoltativo. Se attivato, il connettore aggiunge un oggetto JSON all'avviso. Il valore predefinito è |
Max Days Backwards |
Obbligatorio. Il numero di giorni precedenti da cui recuperare gli avvisi. Il valore massimo è Il valore predefinito è |
Max Alerts To Fetch |
Obbligatorio. Il numero di avvisi da elaborare in ogni iterazione del connettore. Il valore predefinito è |
Use dynamic list as a blocklist |
Obbligatorio. Se selezionata, il connettore utilizza l'elenco dinamico come lista bloccata. Non selezionato per impostazione predefinita. |
Disable Overflow |
Facoltativo. Se selezionata, il connettore ignora il meccanismo di overflow di Google SecOps. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
Verify SSL |
Obbligatorio. Se selezionata, l'azione convalida il certificato SSL del server API. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
Proxy Server Address |
Facoltativo. L'indirizzo del server proxy da utilizzare. |
Proxy Username |
Facoltativo. Il nome utente del proxy con cui eseguire l'autenticazione. |
Proxy Password |
Facoltativo. La password del proxy con cui eseguire l'autenticazione. |
Job
L'integrazione di esempio consente l'utilizzo del seguente job:
Esempio di job semplice
Utilizza il job Simple Job Example per gestire automaticamente i casi.
Questo job ha due funzioni principali:
Chiudi una richiesta se ha un tag
Closed.Aggiungi un commento a una richiesta se ha un tag
Currency.
Input del job
Per configurare questo job, utilizza i seguenti parametri:
| Parametri | |
|---|---|
API Root |
Obbligatorio. La radice dell'API per l'istanza di integrazione. In questo caso di esempio, viene utilizzato il servizio [VAT Comply](https://www.vatcomply.com/) per l'integrazione con la radice dell'API `api.vatcomply.com`. Il valore predefinito è |
Password Field |
Facoltativo. Un esempio di campo della password dell'API. Questo parametro è incluso solo a scopo dimostrativo e non è richiesto dall'API per l'autenticazione. Il valore predefinito è |
Verify SSL |
Obbligatorio. Se selezionata, l'azione convalida il certificato SSL del server API. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.