Cette page a été traduite par l'API Cloud Translation.

Zendesk

Version de l'intégration : 8.0

Configurer Zendesk pour qu'il fonctionne avec Google Security Operations

Un administrateur génère un jeton d'API. Pour ce faire, veuillez suivre les étapes suivantes :

Accédez à la barre latérale de votre interface Zendesk, puis cliquez sur l'icône Admin (Admin), puis sélectionnez Channels > API (Canaux > API).

Cliquez sur l'onglet Settings (Paramètres), puis activez l'accès au jeton.
Cliquez sur le bouton + à droite de Jetons d'API actifs.
Vous pouvez également saisir une description sous Description du jeton d'API.
Copiez le jeton pour l'utiliser ultérieurement et collez-le dans un endroit sûr. Le jeton complet ne s'affichera plus une fois la fenêtre fermée.
Cliquez sur Enregistrer pour revenir à la page de l'API.

Configurer l'intégration de Zendesk dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Actions

Ajouter un commentaire à une demande

Description

Ajoutez un commentaire à une demande existante.

Paramètres

Paramètre	Type	Valeur par défaut	Description
ID de la demande	Chaîne	N/A	Numéro du billet.
Corps du commentaire	Chaîne	N/A	N/A
Nom de l'auteur	Chaîne	N/A	N/A
Note interne	Booléen	N/A	N/A

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success:False

Résultat JSON

N/A

Appliquer des macros aux demandes

Description

Appliquez une macro à une demande.

Paramètres

Paramètre	Type	Valeur par défaut	Description
ID de la demande	Chaîne	N/A	Numéro du billet.
Titre de la macro	Chaîne	N/A	N/A

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_applied	Vrai/Faux	is_applied:False

Résultat JSON

N/A

Créer une demande

Description

Créez une demande avec des propriétés spécifiques.

Limitations connues

L'API Zendesk n'accepte pas les e-mails contenant des caractères Unicode. Il affecte le paramètre "Email CC". L'action les ignorera simplement.

Paramètres

Paramètre	Type	Valeur par défaut	Description
Subject	Chaîne	N/A	N/A
Description	Chaîne	N/A	N/A
Utilisateur responsable	Chaîne	N/A	Nom complet de l'utilisateur.
Groupe d'attribution	Chaîne	N/A	Nom du groupe.
Priorité	Chaîne	N/A	La priorité sera l'une des suivantes : "Urgent", "Élevée", "Normale" ou "Faible".
Type de billet	Chaîne	N/A	La priorité sera l'une des suivantes : "Urgent", "Élevée", "Normale" ou "Faible".
Tag	Chaîne	N/A	N/A
Note interne	Case à cocher	Non cochée	Indiquez si le commentaire doit être public ou interne. Si la case n'est pas cochée, le document sera public. Si elle l'est, il sera réservé à un usage interne.
Adresses e-mail en copie	CSV	N/A	Spécifiez une liste d'adresses e-mail séparées par une virgule, qui doivent également recevoir la notification de création de la demande. Remarque : Vous pouvez ajouter jusqu'à 48 destinataires en copie CC. Il s'agit d'une limitation de Zendesk.
Valider les adresses e-mail en copie CC	Booléen	Cochée	Si cette option est activée, l'action tentera de vérifier que les utilisateurs dont les adresses e-mail sont fournies dans le paramètre "Adresses e-mail en copie" existent. Si au moins un utilisateur n'existe pas, l'action échouera. Si ce paramètre est désactivé, l'action n'effectuera pas cette vérification.

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	N/A	N/A

Résultat JSON

N/A

Mur des cas

Type de résultat	Valeur/Description	Type
Message de sortie*	Si l'option "Valider les CC d'e-mails" est activée et qu'au moins un e-mail n'a pas été trouvé (échec) : erreur lors de l'exécution de l'action "{nom de l'action}". Motif : les utilisateurs associés aux adresses e-mail suivantes sont introuvables : {entity.identifier}. Veuillez vérifier l'orthographe ou désactiver le paramètre "Valider les adresses e-mail en copie". Si au moins une entrée n'est pas une adresse e-mail valide : Erreur lors de l'exécution de l'action "{nom de l'action}". Motif : les utilisateurs associés aux adresses e-mail suivantes sont introuvables : {entity.identifier}. Veuillez vérifier l'orthographe ou désactiver le paramètre "Valider les adresses e-mail en copie".	Général

Type de résultat

Valeur/Description

Type

Message de sortie*

Si l'option "Valider les CC d'e-mails" est activée et qu'au moins un e-mail n'a pas été trouvé (échec) : erreur lors de l'exécution de l'action "{nom de l'action}". Motif : les utilisateurs associés aux adresses e-mail suivantes sont introuvables : {entity.identifier}. Veuillez vérifier l'orthographe ou désactiver le paramètre "Valider les adresses e-mail en copie".

Si au moins une entrée n'est pas une adresse e-mail valide : Erreur lors de l'exécution de l'action "{nom de l'action}". Motif : les utilisateurs associés aux adresses e-mail suivantes sont introuvables : {entity.identifier}. Veuillez vérifier l'orthographe ou désactiver le paramètre "Valider les adresses e-mail en copie".

Général

Obtenir les détails d'une demande

Description

Obtenez les détails, les commentaires et les pièces jointes d'une demande à partir de son ID.

Paramètres

Paramètre	Type	Valeur par défaut	Description
ID de la demande	Chaîne	N/A	ID du billet.

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_details	N/A	N/A

Résultat 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": ""}]
 }

Ping

Description

Testez la connectivité.

Paramètres

N/A

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_connected	Vrai/Faux	is_connected:False

Résultat JSON

N/A

Rechercher des billets

Description

Recherchez des tickets par mot clé.

Paramètres

Paramètres	Type	Valeur par défaut	Description
Requête de recherche	Chaîne	N/A	Contenu de la requête (par exemple, type:ticket status:pending).

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
results_count	N/A	N/A

Résultat JSON

N/A

Modifier un billet

Description

Modifier les informations d'un billet existant

Paramètres

Paramètre	Type	Valeur par défaut	Description
ID de la demande	Chaîne	N/A	Numéro du billet.
Objet	Chaîne	N/A	Objet de la demande.
Utilisateur responsable	Chaîne	N/A	Nom complet de l'utilisateur.
Groupe d'attribution	Chaîne	N/A	Nom du groupe.
Priorité	Chaîne	N/A	La priorité sera l'une des suivantes : "Urgent", "Élevée", "Normale" ou "Faible".
Type de billet	Chaîne	N/A	Le type de ticket peut être l'un des suivants : problème, incident, question ou tâche.
Tag	Chaîne	N/A	Tag à ajouter à la demande.
État	Chaîne	N/A	L'état peut être l'un des suivants : "Nouveau", "Ouvert", "En attente", "En suspens", "Résolu" ou "Fermé".
Commentaire supplémentaire	Chaîne	N/A	Si vous souhaitez ajouter un commentaire à la demande, indiquez le texte à ajouter ici.
Note interne	Case à cocher	Non cochée	Indiquez si le commentaire doit être public ou interne. Si la case n'est pas cochée, le document sera public. Si elle l'est, il sera réservé à un usage interne.

Cas d'utilisation

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Enrichissement d'entités

N/A

Insights

N/A

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_updated	Vrai/Faux	is_updated:False

Résultat JSON

N/A

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.