Questa pagina è stata tradotta dall'API Cloud Translation.

Zendesk

Versione integrazione: 8.0

Configurare Zendesk in modo che funzioni con Google Security Operations

Un amministratore genera un token API. Per farlo, segui questi passaggi:

Vai alla barra laterale dell'interfaccia Zendesk e fai clic sull'icona Amministratore, poi seleziona Canali > API.

Fai clic sulla scheda Impostazioni e attiva l'accesso con token.
Fai clic sul pulsante + a destra di Token API attivi.
(Facoltativo) Inserisci una descrizione in Descrizione token API.
Copia il token per utilizzarlo in un secondo momento e incollalo in un luogo sicuro. Il token completo non verrà più visualizzato dopo la chiusura della finestra.
Fai clic su Salva per tornare alla pagina API.

Configurare l'integrazione di Zendesk in Google SecOps

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

Azioni

Aggiungere un commento al ticket

Descrizione

Aggiungere un commento a una richiesta esistente.

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	Numero biglietto.
Corpo 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

Approfondimenti

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

Descrizione

Applica una macro a un ticket.

Parametri

Parametro	Tipo	Valore predefinito	Descrizione
ID ticket	Stringa	N/D	Numero biglietto.
Titolo della 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

Approfondimenti

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

Descrizione

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	Non selezionata	Specifica se il commento deve essere pubblico o interno. Se la casella è deselezionata, 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 attivata, l'azione tenterà di verificare l'esistenza degli utenti con le email fornite 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

Approfondimenti

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 "Valida 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 "Valida 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

Descrizione

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

Approfondimenti

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

Descrizione

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

Approfondimenti

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

Descrizione

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

Approfondimenti

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

Descrizione

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	Non selezionata	Specifica se il commento deve essere pubblico o interno. Se la casella è deselezionata, 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

Approfondimenti

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.