Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Integra Zendesk con Google SecOps

Questo documento spiega come integrare Zendesk con Google Security Operations.

Casi d'uso

L'integrazione di Zendesk utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

Automatizza il ticketing degli incidenti: crea automaticamente ticket Zendesk dagli avvisi di sicurezza per garantire che ogni incidente venga monitorato e assegnato al team corretto.
Semplifica la comunicazione degli analisti: aggiungi commenti e note interne ai ticket direttamente dai playbook per tenere informati gli stakeholder senza uscire dalla piattaforma.
Standardizza i flussi di lavoro di risposta: applica le macro di Zendesk ai ticket per automatizzare le azioni ripetitive e garantire una gestione coerente dei problemi di sicurezza comuni.
Monitora la risoluzione dei ticket: recupera periodicamente i dettagli dei ticket e gli aggiornamenti di stato per sincronizzare il ciclo di vita degli incidenti su entrambe le piattaforme.
Cerca nel contesto storico: esegui query sui ticket esistenti per parola chiave per trovare incidenti storici correlati e accelerare le indagini in corso.

Prima di iniziare

Prima di configurare l'integrazione in Google SecOps, verifica i seguenti requisiti nel tuo ambiente Zendesk:

Token API: un amministratore deve generare un token API valido per autenticare la connessione. Per istruzioni dettagliate, consulta Gestione dell'accesso dei token API all'API Zendesk.
Autorizzazioni dell'account: assicurati che l'account utilizzato per generare il token API disponga di autorizzazioni sufficienti per creare e aggiornare i ticket nei gruppi di destinazione. L'API eredita le autorizzazioni dell'utente che esegue l'autenticazione. Ciò significa che un token API generato da un amministratore è limitato dalle autorizzazioni del ruolo assegnato a quell'amministratore.
Accesso tramite token: attiva l'accesso tramite token nelle impostazioni dell'API Zendesk per consentire all'integrazione di comunicare con l'API Zendesk.

Parametri di integrazione

L'integrazione di Zendesk richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Server Address`	Obbligatorio. L'URL dell'istanza Zendesk, Il valore predefinito è `https://{subdomain}.zendesk.com`.
`User Email Address`	Obbligatorio. L'indirizzo email dell'account utente Zendesk utilizzato per autenticare la connessione.
`Api Token`	Obbligatorio. Il token API univoco generato nelle impostazioni amministratore di Zendesk.

Server Address

Obbligatorio.

L'URL dell'istanza Zendesk,

Il valore predefinito è https://{subdomain}.zendesk.com.

User Email Address

Obbligatorio.

L'indirizzo email dell'account utente Zendesk utilizzato per autenticare la connessione.

Api Token

Obbligatorio.

Il token API univoco generato nelle impostazioni amministratore di Zendesk.

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.

Aggiungi commento al ticket

Aggiungi un commento a un ticket esistente.

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	Numero biglietto.
Testo del commento	Stringa	N/D	N/D
Nome dell'autore	Stringa	N/D	N/D
Nota interna	Booleano	N/D	N/D

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Applica macro al ticket

Applicare una macro a un ticket.

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	Numero biglietto.
Titolo macro	Stringa	N/D	N/D

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
is_applied	Vero/Falso	is_applied:False

Risultato JSON

N/A

Crea ticket

Crea un ticket con proprietà specifiche.

Limitazioni note

Le email con caratteri Unicode non sono supportate dall'API Zendesk. Interessa il parametro "Email CC". L'azione li ignorerà

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
Oggetto	Stringa	N/D	N/D
Descrizione	Stringa	N/D	N/D
Utente assegnato	Stringa	N/D	Nome completo dell'utente.
Gruppo di assegnazione	Stringa	N/D	Nome del gruppo.
Priorità	Stringa	N/D	La priorità sarà una delle seguenti: urgente, alta, normale o bassa.
Tipo di biglietto	Stringa	N/D	La priorità sarà una delle seguenti: urgente, alta, normale o bassa.
Tag	Stringa	N/D	N/D
Nota interna	Casella di controllo	Opzione non selezionata	Specifica se il commento deve essere pubblico o interno. Se l'opzione è deselezionata, l'app sarà pubblica; se è selezionata, l'app sarà solo interna
Email in Cc	CSV	N/D	Specifica un elenco di indirizzi email separati da virgole che devono ricevere anche la notifica della creazione del ticket. Nota: è possibile aggiungere un massimo di 48 indirizzi email in CC. Si tratta di una limitazione di Zendesk.
Convalida i CC email	Booleano	Selezionata	Se questa opzione è abilitata, l'azione tenterà di verificare l'esistenza degli utenti con gli indirizzi email forniti nel parametro "Email CC". Se almeno un utente non esiste, l'azione non andrà a buon fine. Se questo parametro è disattivato, l'azione non eseguirà questo controllo.

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
ticket_id	N/D	N/D

Risultato JSON

N/A

Bacheca casi

Tipo di risultato	Valore/Descrizione	Tipo
Messaggio di output*	Se l'opzione "Convalida indirizzi email in CC" è attiva e almeno un indirizzo email non è stato trovato (errore): Errore durante l'esecuzione dell'azione "{action name}". Motivo: gli utenti con i seguenti indirizzi email non sono stati trovati: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Convalida indirizzi email in CC". Se almeno un input non è un indirizzo email valido: Errore durante l'esecuzione dell'azione "{action name}". Motivo: gli utenti con i seguenti indirizzi email non sono stati trovati: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Convalida indirizzi email in CC".	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

Se l'opzione "Convalida indirizzi email in CC" è attiva e almeno un indirizzo email non è stato trovato (errore): Errore durante l'esecuzione dell'azione "{action name}". Motivo: gli utenti con i seguenti indirizzi email non sono stati trovati: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Convalida indirizzi email in CC".

Se almeno un input non è un indirizzo email valido: Errore durante l'esecuzione dell'azione "{action name}". Motivo: gli utenti con i seguenti indirizzi email non sono stati trovati: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Convalida indirizzi email in CC".

Generale

Ottieni i dettagli del ticket

Recupera i dettagli, i commenti e gli allegati del ticket in base all'ID ticket.

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	L'ID del ticket.

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
ticket_details	N/D	N/D

Risultato JSON

{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Dindin

Testa la connettività.

Parametri

N/D

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
is_connected	Vero/Falso	is_connected:False

Risultato JSON

N/A

Cerca ticket

Cercare i ticket per parola chiave.

Parametri

Parametri	Tipo	Valore predefinito	Descrizione
Query di ricerca	Stringa	N/D	Contenuto della query (esempio: type:ticket status:pending).

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
results_count	N/D	N/D

Risultato JSON

N/A

Aggiorna ticket

Aggiorna i dettagli del ticket esistente

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	Numero biglietto.
Oggetto	Stringa	N/D	L'oggetto del ticket.
Utente assegnato	Stringa	N/D	Nome completo dell'utente.
Gruppo di assegnazione	Stringa	N/D	Nome del gruppo.
Priorità	Stringa	N/D	La priorità sarà una delle seguenti: urgente, alta, normale o bassa.
Tipo di biglietto	Stringa	N/D	Il tipo di ticket sarà uno dei seguenti: problema, incidente, domanda o attività.
Tag	Stringa	N/D	Tag da aggiungere al ticket.
Stato	Stringa	N/D	Lo stato sarà uno dei seguenti: nuovo, aperto, in attesa, sospeso, risolto o chiuso.
Commento aggiuntivo	Stringa	N/D	Se vuoi aggiungere un commento al ticket, specifica qui il testo che vuoi aggiungere come commento.
Nota interna	Casella di controllo	Opzione non selezionata	Specifica se il commento deve essere pubblico o interno. Se l'opzione è deselezionata, l'app sarà pubblica; se è selezionata, l'app sarà solo interna

Casi d'uso

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Script Result Name	Opzioni di valore	Esempio
is_updated	Vero/Falso	is_updated:False

Risultato JSON

N/A

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