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

Integrare Zendesk con Google SecOps

Questo documento spiega come integrare Zendesk con Google Security Operations.

Casi d'uso

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

Automatizza l'emissione di ticket per gli 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 e gli aggiornamenti di stato dei ticket per sincronizzare il ciclo di vita degli incidenti su entrambe le piattaforme.
Cerca 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, vedi Gestire l'accesso al token API all'API Zendesk.
Autorizzazioni 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 all'amministratore.
Accesso con token: attiva Accesso con token nelle impostazioni dell'API Zendesk per consentire all'integrazione di comunicare con l'API Zendesk.

Parametri di integrazione

L'integrazione Zendesk richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Server Address`	Obbligatorio. L'URL della tua 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 di amministratore di Zendesk.

Server Address

Obbligatorio.

L'URL della tua 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 di amministratore di Zendesk.

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

Se necessario, potrai 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 ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Aggiungere un commento al ticket

Aggiungere un commento a una richiesta 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

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	Opzioni di valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Applicare macro al ticket

Applica 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

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	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. Influisce sul 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	Deselezionata	Specifica se il commento deve essere pubblico o interno. Se la casella non è selezionata, il documento sarà pubblico. Se è selezionata, sarà solo interno.
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 al massimo 48 indirizzi email in CC. Si tratta di una limitazione di Zendesk.
Convalidare i destinatari in copia conoscenza dell'email	Booleano	Selezionata	Se questa opzione è abilitata, l'azione tenterà di verificare l'esistenza degli utenti con gli indirizzi email forniti nel parametro "Email in 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

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	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 CC email" è attivata e non è stata trovata almeno un'email (errore): Errore durante l'esecuzione dell'azione "{action name}". Motivo: non sono stati trovati utenti con i seguenti indirizzi email: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Validate Email CCs" (Verifica i destinatari in copia conoscenza dell'email). se almeno un input non è un indirizzo email valido: Errore durante l'esecuzione dell'azione "{action name}". Motivo: non sono stati trovati utenti con i seguenti indirizzi email: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Validate Email CCs" (Verifica i destinatari in copia conoscenza dell'email).	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

Se l'opzione "Convalida CC email" è attivata e non è stata trovata almeno un'email (errore): Errore durante l'esecuzione dell'azione "{action name}". Motivo: non sono stati trovati utenti con i seguenti indirizzi email: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Validate Email CCs" (Verifica i destinatari in copia conoscenza dell'email).

se almeno un input non è un indirizzo email valido: Errore durante l'esecuzione dell'azione "{action name}". Motivo: non sono stati trovati utenti con i seguenti indirizzi email: {entity.identifier}. Controlla l'ortografia o disattiva il parametro "Validate Email CCs" (Verifica i destinatari in copia conoscenza dell'email).

Generale

Visualizzare i dettagli del ticket

Ottieni i dettagli, i commenti e gli allegati del ticket tramite l'ID ticket.

Parametri

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

Casi d'uso

N/D

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	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

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	Opzioni di valore	Esempio
is_connected	Vero/Falso	is_connected:False

Risultato JSON

N/A

Cerca biglietti

Cercare i ticket in base a una parola chiave.

Parametri

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

Casi d'uso

N/D

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	Opzioni di valore	Esempio
results_count	N/D	N/D

Risultato JSON

N/A

Aggiorna biglietto

Aggiornare i dettagli di una richiesta 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, in 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	Deselezionata	Specifica se il commento deve essere pubblico o interno. Se la casella non è selezionata, il documento sarà pubblico. Se è selezionata, sarà solo interno.

Casi d'uso

N/D

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script

Nome del risultato dello script	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.