iboss

Questo documento fornisce indicazioni su come integrare iboss con Google SecOps.

Casi d'uso

  1. Esegui azioni di arricchimento: ottieni dati da iboss per arricchire i dati negli avvisi di Google Security Operations.
  2. Esegui azioni attive: blocca un IP o un URL in iboss da Google SecOps.

Autorizzazione del prodotto

Per l'autenticazione, le azioni eseguono due richieste. La prima richiesta serve per ottenere un token, mentre la seconda per ottenere un token XSRF speciale.

Configura l'integrazione di iboss in Google SecOps

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

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Nome istanza Stringa N/D No Nome dell'istanza per cui intendi configurare l'integrazione.
Descrizione Stringa N/D No Descrizione dell'istanza.
Root API Cloud Stringa https://cloud.iboss.com/ Sì Specifica la radice dell'API iboss cloud.
Root API account Stringa https://accounts.iboss.com/ Sì Specifica la radice dell'API dell'account iboss.
Nome utente Stringa N/D Sì Specifica il nome utente dell'account iboss.
Password Password N/D Sì Specifica la password dell'account iboss.
Verifica SSL Casella di controllo Deselezionata No Se l'opzione è attiva, verifica che il certificato SSL per la connessione al server cloud pubblico iboss sia valido.
Esegui da remoto Casella di controllo Selezionata No Seleziona il campo per eseguire l'integrazione configurata da remoto. Una volta selezionata, viene visualizzata l'opzione per selezionare l'utente remoto (agente).

Azioni

Dindin

Descrizione

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

Esegui il

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 di valore Esempio
is_success Vero/Falso is_success:False
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

The action should not fail nor stop a playbook execution:
if successful:
print "Successfully connected to the iboss server with the provided connection parameters!"

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

print "Failed to connect to the iboss server! Error is {0}".format(exception.stacktrace)

 Generale

Aggiungi URL all'elenco di blocco delle norme

Descrizione

Aggiungi l'URL alla lista bloccata di iboss.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica la categoria di policy a cui vuoi aggiungere l'URL.
Priorità Numero intero 50 Sì Specifica la priorità dell'URL che deve essere bloccato.
Direzione DDL

Destinazione

Valori possibili:

Destinazione

Origine

Destinazione e origine

 Sì Specifica la direzione dell'URL.
Porta di inizio Numero intero N/D No Specifica la porta di inizio relativa all'URL da bloccare. Nota: se viene specificato solo "Porta di inizio" o "Porta di fine", il valore verrà aggiunto a entrambi i parametri di azione.
Porta finale Numero intero N/D No Specifica la porta finale relativa all'URL da bloccare. Nota: se viene specificata solo "Porta iniziale" o "Porta finale", il valore verrà aggiunto a entrambi i parametri di azione.
Nota Stringa N/D No Aggiungi una nota relativa all'URL da bloccare.
È un'espressione regolare Casella di controllo Deselezionata No Se l'opzione è attiva, l'URL verrà considerato come un'espressione regolare.
Schema di striping Casella di controllo Deselezionata No Se abilitata, l'azione rimuoverà lo schema relativo all'URL.

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

If fail to block specific URLs(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

if fatal error, like wrong credentials, no connection to server, other:

print "Error executing action "Add URL to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 Generale

Aggiungi IP alla lista bloccata della policy

Descrizione

Aggiungi l'IP alla lista bloccata di iboss.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica la categoria di policy a cui vuoi aggiungere l'URL.
Priorità Numero intero 50 Sì Specifica la priorità dell'URL che deve essere bloccato.
Direzione DDL

Destinazione

Valori possibili:

Destinazione

Origine

Destinazione e origine

 Sì Specifica la direzione dell'URL.
Porta di inizio Numero intero N/D No Specifica la porta di inizio relativa all'URL da bloccare. Nota: se viene specificato solo "Porta di inizio" o "Porta di fine", il valore verrà aggiunto a entrambi i parametri di azione.
Porta finale Numero intero N/D No Specifica la porta finale relativa all'URL da bloccare. Nota: se viene specificata solo "Porta iniziale" o "Porta finale", il valore verrà aggiunto a entrambi i parametri di azione.
Nota Stringa N/D No Aggiungi una nota relativa all'URL da bloccare.
È un'espressione regolare Casella di controllo Falso No Se l'opzione è attiva, l'URL verrà considerato come un'espressione regolare.

Esegui il

Questa azione viene eseguita sull'entità Indirizzo IP.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

If fail to block specific URLs(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata: (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

if fatal error, like wrong credentials, no connection to server, other:

print "Error executing action "Add URL to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 Generale

Aggiungi IP alla lista bloccata della policy

Descrizione

Aggiungi l'IP alla lista bloccata di iboss.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica la categoria di policy a cui vuoi aggiungere l'IP.
Priorità Numero intero 50 Sì Specifica la priorità dell'IP da bloccare.
Direzione DDL

Destinazione

Valori possibili:

Destinazione

Origine

Destinazione e origine

 Sì Specifica la direzione dell'IP.
Porta di inizio Numero intero N/D No Specifica la porta di inizio relativa all'IP da bloccare. Nota: se viene specificato solo "Porta di inizio" o "Porta di fine", il valore verrà aggiunto a entrambi i parametri di azione.
Porta finale Numero intero N/D No Specifica la porta finale relativa all'IP da bloccare. Nota: se viene specificata solo "Porta iniziale" o "Porta finale", il valore verrà aggiunto a entrambi i parametri di azione.
Nota Stringa N/D No Aggiungi una nota relativa all'IP da bloccare.
È un'espressione regolare Casella di controllo Deselezionata No Se l'opzione è abilitata, l'IP verrà considerato come un'espressione regolare.

Esegui il

Questa azione viene eseguita sull'entità Indirizzo IP.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided IPs were blocked(is_success = true):
print "Successfully blocked the following IPs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

If fail to block specific IPs(is_success = true):
print "Action was not able to block the following IPs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

print: "No IPs were blocked in the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

if fatal error, like wrong credentials, no connection to server, other:

print "Error executing action "Add IP to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 Generale

Elenca le voci della lista bloccata delle policy

Descrizione

Restituisce le voci della lista bloccata di iboss in un gruppo specifico.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica in quale categoria di policy vuoi elencare le voci della lista bloccata.
Numero massimo di voci da restituire Numero intero 50 Sì Specifica il numero di voci da restituire.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
{
    "entries": [
       {
          "direction": 0,
          "endPort": 0,
          "isRegex": 0,
          "note": "",
          "priority": 0,
          "startPort": 0,
          "type": 0,
          "url": "asaa.com",
          "weight": 501
       }
    ],
    "message": ""
}
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 successful returned and is available data(is_success = true):
print "Successfully listed entries from the iboss Block List in a category with ID '{0}'".format(category_id)

Se restituito e senza dati (is_success = false):

print: "No Block List entries were found in the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata: (is_success = false)

Stampa "Category with ID {category_id} is not associated with a Block list."

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

if fatal error, like wrong credentials, no connection to server, other:

print "Error executing action "List Policy Block List Entries". Reason: {0}''.format(error.Stacktrace)

 Generale
Bacheca casi CSV

Nome: "Voci della lista bloccata. Categoria {0}".format(Category)

Colonne:

  • Nome (mappato come URL)
  • Priority (mappato come priority)
  • Peso (mappato come peso)
  • Direzione (mappata come direction. Controlla il comportamento dell'azione)
  • Porta di inizio (mappata come startPort)
  • Porta finale (mappata come endPort)
  • Nota (mappata come nota)
  • Regex (mappato come isRegex. 1 = True, 0 = False)

Rimuovi l'URL dalla lista bloccata delle policy

Descrizione

Rimuovi l'URL dalla lista bloccata di iboss.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica la categoria di norme da cui vuoi rimuovere l'URL.
Porta di inizio Numero intero N/D No Specifica la porta di inizio relativa all'URL da eliminare. Questo parametro è obbligatorio se l'URL desiderato ha una porta di avvio definita. Si tratta di una limitazione di iboss.
Porta finale Numero intero N/D No Specifica la porta finale relativa all'URL da eliminare. Questo parametro è obbligatorio se l'URL desiderato ha una porta finale definita. Si tratta di una limitazione di iboss.
Schema di striping Casella di controllo Opzione non selezionata No Se abilitata, l'azione rimuoverà lo schema relativo all'URL.

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided URLs were removed (is_success = true):
print "Successfully removed the following URLs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se non riesci a rimuovere URL specifici(is_success = true):

print "Action was not able to remove the following URLs from the category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

Print: "No URLs were removed from the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata (is_success = false):

Stampa "Category with ID {category_id} is not associated with a Block list."

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

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:

print "Error executing action "Remove URL from Policy Block List". Reason: {0}''.format(error.Stacktrace)

 Generale

Rimuovi l'IP dalla lista bloccata delle policy

Descrizione

Rimuovi l'IP dalla lista bloccata di iboss.

Come trovare l'ID categoria

  1. Vai a Web Security -> Policy Layers.
  2. Apri la console degli Strumenti per sviluppatori (Ctrl + Shift + I in Google Chrome).
  3. Vai alla scheda Rete.
  4. Prova a modificare la lista bloccata necessaria.

Nella console vedrai le richieste che vengono effettuate. Cerca tra queste richieste il parametro customCategoryId=xxxx.

Parametri
Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID categoria Numero intero 1001 Sì Specifica la categoria di policy da cui vuoi rimuovere l'IP.
Porta di inizio Numero intero N/D No Specifica la porta di inizio relativa all'IP da eliminare. Questo parametro è obbligatorio se l'URL desiderato ha una porta di avvio definita. Si tratta di una limitazione di iboss.
Porta finale Numero intero N/D No Specifica la porta finale relativa all'IP da eliminare. Questo parametro è obbligatorio se l'IP desiderato ha una porta finale definita. Si tratta di una limitazione di iboss.

Esegui il

Questa azione viene eseguita sull'entità Indirizzo IP.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided URLs was removed (is_success = true):
print "Successfully removed the following IPs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se non riesci a rimuovere URL specifici(is_success = true):

print "Action was not able to remove the following IPs from the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

print: "No IPs were removed from the iboss category with ID {0}.".format(category_id)

Se la policy non è una lista bloccata: (is_success = false)

Stampa "Category with ID {category_id} is not associated with a Block list."

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

In caso di errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro:

print "Error executing action "Remove IP from Policy Block List". Reason: {0}''.format(error.Stacktrace)

 Generale

URL Lookup

Descrizione

Esegui la ricerca dell'URL.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID gruppo Numero intero N/D No Specifica il gruppo per cui eseguire una ricerca URL. Se non viene specificato nulla, verrà utilizzato il gruppo "Predefinito".

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Nome host

Risultati dell'azione

Arricchimento delle entità
Nome del campo di arricchimento Origine (chiave JSON) Logica - Quando applicarle
IBOSS_group_{group_id}_categories categorie Se disponibile in JSON
IBOSS_group_{group_id}_action azione Se disponibile in JSON
IBOSS_group_{group_id}_message messaggio Se disponibile in JSON
Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
{
    "action": "Not Blocked",
    "categories": "Pornography/Nudity",
    "message": "Url Known."
}
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 successful and at least one of the provided URLs was looked up (is_success = true):
print "Successfully retrieved information about the following URLs: \n {0}".format( entity.identifier list)

Se la ricerca di URL specifici non va a buon fine(is_success = true):

Print: "Action was not able to retrieve information about the following URLs\n: {0}".format([entity.identifier])

Se la ricerca non va a buon fine per tutte le entità (is_success = false):

Stampa "Non sono state recuperate informazioni sugli URL".

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

In caso di errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro:

print "Error executing action "URL Lookup". Reason: {0}''.format(error.Stacktrace)

 Generale

URL Recategorization

Descrizione

Invia l'URL per la ricategorizzazione.

Esegui il

Questa azione viene eseguita sull'entità URL.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
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 successful and at least one of the provided URLs was submitted(is_success = true):
print "Successfully submitted the following URLs for recategorization: \n {0}".format( entity.identifier list)

Se non riesci a rimuovere URL specifici(is_success = true):

print "Action was not able to submit the following URLs for recategorization\n: {0}".format([entity.identifier])

Se l'arricchimento non riesce per tutte le entità (is_success = false):

print: "No URLs were submitted for recategorization."

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

if fatal error, like wrong credentials, no connection to server, other:

print "Error executing action "URL Recategorization". Reason: {0}''.format(error.Stacktrace)

 Generale

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