Intégrer ServiceNow à Google SecOps

Ce document explique comment intégrer ServiceNow à Google Security Operations (Google SecOps).

Cas d'utilisation

L'intégration de ServiceNow utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Création automatisée de tickets d'incident : créez automatiquement des incidents ServiceNow à partir d'alertes de sécurité provenant de votre SIEM ou d'autres outils de sécurité.

  • Enrichissement et réponse aux incidents : simplifiez les workflows de réponse aux incidents en réduisant la création manuelle de tickets et en enrichissant les incidents avec des informations pertinentes provenant de l'alerte d'origine.

  • Correction de l'hameçonnage : automatisez les étapes répétitives d'investigation de l'hameçonnage, telles que la collecte des en-têtes d'e-mails, l'examen des pièces jointes et la recherche d'e-mails similaires, ce qui accélère les temps de réponse.

  • Orchestration de la correction des failles : orchestrez les workflows de correction des failles en créant automatiquement des demandes de modification ServiceNow pour les actions d'application de correctifs ou de correction en fonction des résultats de l'analyse des failles.

  • Automatisation du cycle de vie des utilisateurs : automatisez les tâches de provisionnement et de déprovisionnement des utilisateurs dans différents systèmes (contrôle des accès, plates-formes de messagerie, applications) en fonction de déclencheurs issus des workflows ServiceNow.

  • Contexte des renseignements sur les menaces : enrichissez les alertes de sécurité avec des données de renseignement sur les menaces provenant directement de la plate-forme ServiceNow, ce qui fournit plus de contexte aux analystes pour prioriser les actions de réponse.

Avant de commencer

Avant de configurer l'intégration dans la plate-forme Google SecOps, assurez-vous d'avoir rempli les conditions préalables suivantes :

  • Compte utilisateur ServiceNow : compte utilisateur dédié disposant des autorisations suffisantes pour interroger, créer et mettre à jour les enregistrements cibles.
  • Rôles ServiceNow : assurez-vous que le compte dispose des rôles système requis (sn_incident_write et itil) et d'une configuration d'accès utilisateur personnalisée pour autoriser l'accès en lecture aux commentaires du journal.
  • Connectivité réseau : configuration réseau qui permet au trafic provenant des adresses IP Google SecOps ou de votre infrastructure d'agent distant d'atteindre le point de terminaison de votre instance ServiceNow.
  • Détails de l'authentification : déterminez la règle d'authentification de votre organisation. Vous pouvez vous authentifier à l'aide de l'authentification de base standard ou de l'authentification OAuth 2.0.

Configurer l'accès des utilisateurs dans ServiceNow

Pour permettre à l'intégration de synchroniser les commentaires, de mettre à jour les champs et d'exécuter des actions de manière fluide, vous devez effectuer les tâches d'administration suivantes sur la plate-forme ServiceNow.

Pour obtenir des instructions spécifiques sur la navigation dans l'interface ServiceNow, consultez la documentation officielle du produit ServiceNow.

  1. Créer un rôle personnalisé : accédez à Rôles > Nouveau et créez un rôle dédié à la gestion de l'accès aux commentaires de l'API.
  2. Créer une règle de liste de contrôle d'accès (LCA) : l'intégration nécessite un accès en lecture à la table sys_journal_field pour suivre les commentaires et les notes de travail. Accédez à Contrôles des accès> Nouveau. Vous devez vous connecter avec un compte disposant d'autorisations élevées pour créer cette règle.

  3. Configurez les paramètres de LCA :

    • Définissez le Type sur record.
    • Définissez Opération sur read.
    • Dans les champs Name (Nom), sélectionnez Journal Entry sys_journal_field (Écriture de journal) dans le premier menu déroulant, puis -- None -- (Aucun) dans le deuxième.
    • Accédez à la liste Rôle requis en bas du formulaire, puis ajoutez le rôle de commentaire personnalisé que vous venez de créer. Cliquez sur Envoyer.

  4. Attribuer des rôles au compte d'intégration : accédez à Utilisateurs, ouvrez votre compte d'intégration dédié et attribuez les rôles suivants :

    • Le rôle personnalisé que vous avez créé pour lire les commentaires.
    • sn_incident_write : requis pour les interactions de base, telles que les actions Obtenir un incident et Mettre à jour un incident.
    • itil : requis pour les actions CMDB et les fonctions de recherche de gestion de configuration des éléments associés.

Options de configuration de l'authentification

L'intégration ServiceNow est compatible avec trois méthodes d'authentification différentes. Choisissez l'une des options de configuration suivantes qui correspond aux exigences de sécurité de votre organisation.

Option 1 : Flux d'identifiants client OAuth 2.0 (recommandé)

Cette méthode utilise une attribution d'identifiants client OAuth 2.0 ainsi que l'emprunt d'identité pour limiter l'accès aux données de manière sécurisée sans exposer de mot de passe utilisateur statique à la plate-forme.

Phase 1 : Créer un point de terminaison OAuth dans ServiceNow

  1. Recherchez Registres d'applications dans le menu de navigation de ServiceNow, puis cliquez sur Nouveau.
  2. Sélectionnez New Inbound Integration Experience (Nouvelle expérience d'intégration entrante).
  3. Dans la liste des types de connexion, sélectionnez OAuth - Client credentials grant (OAuth - Attribution des identifiants client).
  4. Dans le champ Nom, indiquez un nom descriptif pour la configuration du point de terminaison.
  5. Indiquez le nom ou l'identifiant du fournisseur OAuth requis pour établir le contexte du profil d'identité.
  6. Dans le champ Utilisateur de l'application OAuth, sélectionnez le compte utilisateur ServiceNow dédié qui sera emprunté et utilisé pour toutes les activités d'API automatisées.
  7. Cliquez sur Envoyer ou Enregistrer.
  8. Rouvrez l'enregistrement de registre que vous venez de créer pour copier et sécuriser l'ID client et le code secret du client générés.
Conservez ce paramètre par défaut tel quel.

Phase 2 : Configurer dans Google SecOps

  1. Dans Google SecOps, accédez à Automatisation > Configuration des intégrations, puis ouvrez la fenêtre de configuration de ServiceNow.
  2. Saisissez votre racine d'API (en remplaçant l'espace réservé par défaut par l'URL de votre instance ServiceNow).
  3. Indiquez l'ID client et le code secret du client générés lors de la phase 1.
  4. Assurez-vous que les champs Nom d'utilisateur, Mot de passe et Jeton d'actualisation sont vides.
  5. Cochez la case Use Oauth Authentication (Utiliser l'authentification OAuth).
  6. Cliquez sur Tester pour valider les paramètres à l'aide d'un test ping de connectivité. Si le test réussit, cliquez sur Enregistrer.

Option 2 : Authentification de base

Cette méthode utilise la validation directe des identifiants. Elle est simple à configurer, mais peut être limitée si votre entreprise applique l'authentification multifacteur (MFA) ou bloque les en-têtes d'authentification de base.

  1. Dans ServiceNow, vérifiez que votre utilisateur d'intégration dispose d'un nom d'utilisateur et d'un mot de passe locaux.
  2. Lorsque vous configurez l'intégration dans Google SecOps, indiquez la racine de l'API (en remplaçant l'espace réservé par défaut par l'URL de votre instance ServiceNow), le nom d'utilisateur et le mot de passe.
  3. Laissez les champs liés à OAuth vides et assurez-vous que Use Oauth Authentication est désactivé (case décochée).
  4. Cliquez sur Tester pour valider les paramètres de connexion. Si la validation réussit, cliquez sur Enregistrer.

Option 3 : Flux de jeton d'actualisation

Utilisez cette méthode si votre organisation nécessite des contrôles de sécurité OAuth à l'aide d'une chaîne de jetons d'actualisation pour récupérer de manière programmatique des jetons d'accès en coulisses.

  1. Effectuez la phase 1 dans votre instance ServiceNow pour générer un ID client et un code secret du client.
  2. Suivez la procédure décrite dans la section Générer un jeton d'actualisation pour récupérer une chaîne de jeton d'autorisation valide.
  3. Dans Google SecOps, ouvrez la fenêtre de configuration de votre instance d'intégration ServiceNow.
  4. Renseignez complètement les paramètres à l'aide de vos identifiants configurés :
    • Racine de l'API (en remplaçant le domaine d'espace réservé par défaut par l'URL de votre instance ServiceNow).
    • Username (Nom d'utilisateur)
    • Mot de passe
    • ID client
    • Code secret du client
  5. Cochez la case Utiliser l'authentification OAuth.
  6. Collez la chaîne de jeton que vous avez récupérée dans le workflow de la section Générer un jeton d'actualisation dans le champ Jeton d'actualisation.
  7. Cliquez sur Tester pour valider les paramètres de connexion. Si la validation réussit, cliquez sur Enregistrer.

Générer un jeton d'actualisation (Google SecOps)

Pour générer le jeton d'actualisation, vous devez configurer temporairement l'intégration pour qu'elle exécute une action d'assistance.

  1. Dans Google SecOps, accédez à Automatisation > Configuration des intégrations.
  2. Assurez-vous que la case Utiliser l'authentification OAuth n'est pas cochée pour cette étape de configuration initiale.
  3. Configurez une instance d'intégration ServiceNow temporaire à l'aide des champs Api Root (Racine de l'API), Username (Nom d'utilisateur), Password (Mot de passe), Client ID (ID client) et Client Secret (Code secret du client), puis cliquez sur Save (Enregistrer).
  4. Simulez une demande ou ouvrez une demande existante.
  5. Exécutez manuellement l'action ServiceNow Get Oauth Token (Obtenir un jeton OAuth) sur la demande.
  6. Copiez la valeur refresh_token du résultat JSON de l'action pour l'utiliser dans le champ Jeton d'actualisation lors de la configuration de l'instance d'intégration finale.

Paramètres d'intégration

L'intégration ServiceNow nécessite les paramètres suivants :

Paramètre Description
Api Root

Obligatoire.

Racine de l'API de l'instance ServiceNow.

La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username

Obligatoire.

Nom d'utilisateur du compte ServiceNow.
Password

Obligatoire.

Mot de passe du compte ServiceNow.
Incident Table

Facultatif.

Nom ou chemin d'accès de la table d'API à utiliser pour les actions liées aux incidents et la récupération des enregistrements.

Par défaut, l'intégration utilise le chemin d'accès table/incident.
Verify SSL

Facultatif.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow.

Cette option est activée par défaut.
Client ID

Facultatif.

ID client pour l'intégration de ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide des identifiants client.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Client Secret

Facultatif.

Code secret du client pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Refresh Token

Facultatif.

Jeton d'actualisation pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'un jeton d'actualisation.

Ce jeton d'actualisation configuré expire tous les 90 jours.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Use Oauth Authentication

Facultatif.

Si cette option est sélectionnée, l'intégration utilise OAuth 2.0 pour l'authentification.

L'authentification OAuth 2.0 nécessite de définir les identifiants client (Client ID et Client Secret) ou Refresh Token.

Désactivé par défaut

Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Ajouter une pièce jointe

Utilisez l'action Ajouter une pièce jointe pour ajouter des pièces jointes à un enregistrement de table dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter une pièce jointe nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table contenant l'enregistrement auquel la pièce jointe est ajoutée.
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement auquel la pièce jointe est ajoutée.
File Path

Obligatoire.

Liste de chemins absolus pour les fichiers à joindre, séparés par une virgule.
Mode

Facultatif.

Comportement de l'action lorsqu'un fichier portant le même nom existe déjà dans l'enregistrement.

Les valeurs possibles sont les suivantes :

  • Add New Attachment : l'action ajoute le fichier en tant que nouvelle pièce jointe distincte. Les fichiers portant le même nom sont autorisés.
  • Overwrite Existing Attachment : l'action remplace le rattachement existant qui porte le même nom.

La valeur par défaut est Add New Attachment.

Sorties de l'action

L'action Ajouter une pièce jointe fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter une pièce jointe :

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}
Messages de sortie

L'action Ajouter une pièce jointe peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

 L'action a réussi.
Error executing action "Add Attachment". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ajouter une pièce jointe :

Nom du résultat du script Valeur
is_success true ou false

Ajouter un commentaire

Utilisez l'action Ajouter un commentaire pour ajouter un commentaire à un incident ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un commentaire nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Numéro de l'incident auquel ajouter le commentaire, au format INCINCIDENT_NUMBER.
Comment

Obligatoire.

Commentaire à ajouter à l'incident.

Sorties de l'action

L'action Ajouter un commentaire fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant liste les valeurs de sortie du résultat du script lorsque vous utilisez l'action Ajouter un commentaire :

Nom du résultat du script Valeur
is_success true ou false

Ajouter un commentaire et attendre une réponse

Utilisez l'action Ajouter un commentaire et attendre une réponse pour ajouter un commentaire à un incident ServiceNow, puis suspendez l'exécution du playbook jusqu'à ce qu'un nouveau commentaire ou une nouvelle réponse soit ajouté à cet incident. Le résultat de l'action est le contenu du nouveau commentaire.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un commentaire et attendre une réponse nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Numéro de l'incident auquel ajouter le commentaire, au format INCINCIDENT_NUMBER.
Comment

Obligatoire.

Commentaire à ajouter à l'incident.

Sorties de l'action

L'action Ajouter un commentaire et attendre une réponse fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Ajouter un commentaire et attendre une réponse :

Nom du résultat du script Valeur
new_comment

Ajouter un commentaire à l'enregistrement

Utilisez l'action Ajouter un commentaire à l'enregistrement pour ajouter un commentaire ou une note de travail à un enregistrement de table spécifique dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un commentaire à l'enregistrement nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table à laquelle ajouter le commentaire ou la note.
Type

Obligatoire.

Type de commentaire ou de note à ajouter.

Les valeurs possibles sont les suivantes :

  • Comment
  • Work Note

La valeur par défaut est Comment.
Record Sys ID

Obligatoire.

ID système (sys_id) auquel ajouter le commentaire ou la note de travail.
Text

Obligatoire.

Contenu du commentaire ou de la note de travail.
Wait For Reply

Facultatif.

Si cette option est sélectionnée, l'action s'exécute de manière asynchrone et suspend l'exécution jusqu'à ce qu'un nouveau commentaire ou une nouvelle note de travail soit ajouté à l'enregistrement.

L'action suit les commentaires si vous en ajoutez un, et les notes de travail si vous en ajoutez une.

Désactivé par défaut

Sorties de l'action

L'action Ajouter un commentaire à l'enregistrement fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter un commentaire à l'enregistrement :

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}
Messages de sortie

L'action Ajouter un commentaire à l'enregistrement peut renvoyer les messages de sortie suivants :

Message de sortie Description du message
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow. L'action a réussi.
Error executing action "Add Comment To Record". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Add Comment To Record (Ajouter un commentaire à l'enregistrement) :

Nom du résultat du script Valeur
is_success true ou false

Ajouter un incident parent

Utilisez l'action Ajouter un incident parent pour ajouter un incident parent aux incidents dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un incident parent nécessite les paramètres suivants :

Paramètre Description
Parent Incident Number

Obligatoire.

Numéro de l'incident parent, au format INCINCIDENT_NUMBER (par exemple, INC0000051).

L'action ajoute tous les incidents de Child Incident Numbers en tant qu'enfants de l'incident parent.
Child Incident Numbers

Obligatoire.

Liste de numéros d'incidents séparés par une virgule à définir comme incidents enfants pour l'incident parent spécifié, au format INCINCIDENT_NUMBER (par exemple, INC0000051).

Sorties de l'action

L'action Ajouter un incident parent fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter un incident parent :

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Messages de sortie

L'action Ajouter un incident parent peut renvoyer les messages de sortie suivants :

Message de sortie Description du message
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS. L'action a réussi.
Error executing action "Add Parent Incident". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Fermer l'incident

Utilisez l'action Fermer l'incident pour fermer un incident ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Fermer l'incident nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Numéro de l'incident à fermer, au format INCINCIDENT_NUMBER.
Close Reason

Obligatoire.

Raison de la clôture de l'incident.
Resolution Code

Obligatoire.

Code de résolution de l'incident.

Les valeurs possibles sont les suivantes :

  • Duplicate
  • Known error
  • No resolution provided
  • Resolved by caller
  • Resolved by change
  • Resolved by problem
  • Resolved by request
  • Solution provided
  • Workaround provided
  • User error

La valeur par défaut est Solution provided.
Close Notes

Obligatoire.

Notes de clôture de l'incident.

Sorties de l'action

L'action Fermer l'incident fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Fermer l'incident :

Nom du résultat du script Valeur
is_success true ou false

Créer un incident d'alerte

Utilisez l'action Créer un incident d'alerte pour créer un incident dans ServiceNow en fonction des détails de l'alerte qui lance l'exécution du playbook.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Créer un incident d'alerte nécessite les paramètres suivants :

Paramètre Description
Impact

Obligatoire.

Le niveau d'impact de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Urgency

Obligatoire.

Niveau d'urgence de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Category

Facultatif.

Catégorie de l'incident.
Assignment Group ID

Facultatif.

Nom complet du groupe auquel attribuer l'incident.
Assigned User ID

Facultatif.

Nom complet de l'utilisateur auquel attribuer l'incident.
Description

Facultatif.

Description de l'incident.

Sorties de l'action

L'action Créer un incident d'alerte fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Créer un incident d'alerte :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Créer un incident d'alerte :

Nom du résultat du script Valeur
is_success true ou false

Créer un incident

Utilisez l'action Créer un incident pour créer un incident dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Créer un incident nécessite les paramètres suivants :

Paramètre Description
Short Description

Obligatoire.

Brève description de l'incident.
Impact

Obligatoire.

Le niveau d'impact de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Urgency

Obligatoire.

Niveau d'urgence de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Category

Facultatif.

Catégorie de l'incident.
Assignment Group ID

Facultatif.

Nom complet du groupe auquel attribuer l'incident.

Assigned User ID

Facultatif.

Nom complet de l'utilisateur auquel attribuer l'incident.

Description

Facultatif.

Description de l'incident.
Custom Fields

Facultatif.

Chaîne au format JSON contenant les noms de champs et leurs valeurs correspondantes à mettre à jour (par exemple, {"location":"London", "category":"database"}).

Vous pouvez utiliser ce paramètre pour modifier des champs qui ne sont pas explicitement définis comme entrées d'action.

Sorties de l'action

L'action Créer un incident fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Créer un incident :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Créer un incident :

Nom du résultat du script Valeur
incident_number INCIDENT_NUMBER

Create Record

Utilisez l'action Créer un enregistrement pour créer des enregistrements dans différentes tables ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Créer un enregistrement nécessite les paramètres suivants :

Paramètre Description
Table Name

Facultatif.

Nom de la table ServiceNow dans laquelle le nouvel enregistrement est créé (par exemple, incident).
Object Json Data

Facultatif.

Objet JSON contenant les paires champ-valeur requises pour définir le nouvel enregistrement (par exemple, les champs d'incident ou les attributs d'élément CMDB).

Sorties de l'action

L'action Créer un enregistrement fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Créer un enregistrement :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Créer un enregistrement :

Nom du résultat du script Valeur
object_sys_id OBJECT_SYS_ID

Télécharger les pièces jointes

Utilisez l'action Télécharger les pièces jointes pour télécharger les fichiers et documents joints à un enregistrement ServiceNow spécifique dans un dossier local de votre environnement Google SecOps.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Télécharger les pièces jointes nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow contenant l'enregistrement à partir duquel télécharger les pièces jointes (par exemple, incident).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement à partir duquel les pièces jointes sont téléchargées.
Download Folder Path

Obligatoire.

Chemin absolu vers le dossier de l'environnement Google SecOps où les pièces jointes téléchargées sont enregistrées.
Overewrite

Facultatif.

Si cette option est sélectionnée, l'action écrase les fichiers portant le même nom.

Désactivé par défaut

Sorties de l'action

L'action Télécharger les pièces jointes fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Télécharger les pièces jointes :

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}
Messages de sortie

L'action Télécharger les pièces jointes peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

 L'action a réussi.
Error executing action "Download Attachments". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Télécharger les pièces jointes :

Nom du résultat du script Valeur
is_success true ou false

Obtenir les détails de l'incident enfant

Utilisez l'action Obtenir les détails de l'incident enfant pour récupérer des informations sur les incidents enfants en fonction de l'incident parent dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir les détails de l'incident enfant nécessite les paramètres suivants :

Paramètre Description
Parent Incident Number

Obligatoire.

Numéro de l'incident parent à partir duquel récupérer les détails de l'incident enfant, au format INCINCIDENT_NUMBER.
Max Child Incident To Return

Facultatif.

Nombre maximal d'incidents enfants que l'action renvoie à partir de l'incident parent.

La valeur par défaut est 50.

Sorties de l'action

L'action Obtenir les détails de l'incident enfant fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Obtenir les détails de l'incident enfant fournit le tableau suivant :

Nom de la table : Détails de l'incident enfant

Colonnes d'un tableau :

  • ID système (mappé en tant que sys_id)
  • Nombre (mappé en tant que number)
  • Description courte (mappée en tant que short_description)
  • Date de création (mappée en tant que sys_created_on)
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Get Child Incident Details (Obtenir les détails de l'incident enfant) :

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Messages de sortie

L'action Obtenir les détails de l'incident enfant peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.

Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found.

No child incidents were found.

 L'action a réussi.
Error executing action "Get Child Incident Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get Child Incident Details (Obtenir les détails de l'incident enfant) :

Nom du résultat du script Valeur
is_success true ou false

Obtenir les détails d'un enregistrement CMDB

Utilisez l'action Obtenir les détails de l'enregistrement CMDB pour obtenir des enregistrements CMDB détaillés de la même classe dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir les détails de l'enregistrement CMDB nécessite les paramètres suivants :

Paramètre Description
Class Name

Obligatoire.

Nom de la classe CMDB à partir de laquelle récupérer les enregistrements, par exemple cmdb_ci_appl.

Pour en savoir plus sur les noms de classes, consultez Afficher et modifier la définition et les métadonnées d'une classe.
Sys ID

Obligatoire.

Liste d'ID système (sys_id) des enregistrements CMDB pour lesquels récupérer des détails, séparés par une virgule.
Max Records To Return

Facultatif.

Nombre maximal de relations d'enregistrement à renvoyer pour chaque type de relation (par exemple, relates to ou depends on).

La valeur par défaut est 50.

Sorties de l'action

L'action Obtenir les détails de l'enregistrement CMDB fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Obtenir les détails de l'enregistrement CMDB :

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}
Messages de sortie

L'action Obtenir les détails de l'enregistrement CMDB peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST.

Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST

Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.

Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME.

Information about the provided Sys IDs was not found.

 L'action a réussi.
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get CMDB Record Details (Obtenir les détails de l'enregistrement CMDB) :

Nom du résultat du script Valeur
is_success true ou false

Obtenir un incident

Utilisez l'action Obtenir un incident pour récupérer des informations sur un incident ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Get Incident (Obtenir un incident) nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Identifiant unique de l'incident ServiceNow à récupérer, au format INCINCIDENT_NUMBER.

Sorties de l'action

L'action Get Incident (Obtenir un incident) fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Get Incident (Obtenir un incident) :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get Incident (Obtenir l'incident) :

Nom du résultat du script Valeur
incident_number INCIDENT_NUMBER

Obtenir un jeton OAuth

Utilisez l'action Obtenir un jeton OAuth pour obtenir un jeton d'actualisation OAuth pour ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

Aucune.

Sorties de l'action

L'action Obtenir un jeton OAuth fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Obtenir un jeton OAuth :

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}
Messages de sortie

L'action Obtenir un jeton OAuth peut renvoyer les messages de sortie suivants :

Message de sortie Description du message
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied. L'action a réussi.
Error executing action "Get Oauth Token". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get Oauth Token (Obtenir un jeton OAuth) :

Nom du résultat du script Valeur
is_success true ou false

Obtenir les détails de l'enregistrement

Utilisez l'action Obtenir les détails de l'enregistrement pour récupérer des informations sur des enregistrements de table spécifiques dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir les détails de l'enregistrement nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow contenant l'enregistrement à partir duquel récupérer les informations (par exemple, incident).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement ServiceNow spécifique pour lequel récupérer les détails.
Fields

Facultatif.

Liste de champs spécifiques (colonnes) séparés par une virgule à renvoyer à partir de l'enregistrement récupéré (par exemple, sys_id,number,short_description).

Si aucune valeur n'est fournie, l'action renvoie les champs par défaut de l'enregistrement.

Sorties de l'action

L'action Obtenir les détails de l'enregistrement fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Obtenir les détails de l'enregistrement :

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Messages de sortie

L'action Obtenir les détails de l'enregistrement peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.

Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.

 L'action a réussi.
Error executing action "Get Record Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Get Record Details (Obtenir les détails de l'enregistrement) :

Nom du résultat du script Valeur
is_success true ou false

Obtenir les détails de l'utilisateur

Utilisez l'action Get User Details (Obtenir les détails de l'utilisateur) pour récupérer des informations sur l'utilisateur à l'aide du paramètre sys_id dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir les détails de l'utilisateur nécessite les paramètres suivants :

Paramètre Description
User Sys IDs

Facultatif.

Liste d'ID système séparés par une virgule correspondant aux utilisateurs pour lesquels récupérer des informations (par exemple, sys_id_1,sys_id_2).
Emails

Facultatif.

Liste d'adresses e-mail séparées par une virgule correspondant aux utilisateurs pour lesquels récupérer des informations (par exemple, email1@example.com,email2@example.com).

Sorties de l'action

L'action Obtenir les détails de l'utilisateur fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Obtenir les détails de l'utilisateur fournit le tableau suivant :

Nom de la table : User Details

Colonnes d'un tableau :

  • ID système (mappé en tant que sys_id)
  • Nom (mappé en tant que name)
  • Nom d'utilisateur (mappé en tant que user_name)
  • Email (mappé en tant que email)
Résultat JSON

L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Obtenir les détails de l'utilisateur :

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "example@example.com",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}
Messages de sortie

L'action Obtenir les détails de l'utilisateur peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.

Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.

Information about the users with specified Sys IDs was not found in ServiceNow.

 L'action a réussi.
Error executing action "Get User Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get User Details (Obtenir les détails de l'utilisateur) :

Nom du résultat du script Valeur
is_success true ou false

Lister les enregistrements CMDB

Utilisez l'action Répertorier les enregistrements CMDB pour répertorier les enregistrements CMDB de la même classe dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Génération du filtre de requête…

Le paramètre Query Filter accepte les chaînes de requête encodées ServiceNow standards (sysparm_query). Vous pouvez générer ces chaînes directement dans l'interface ServiceNow (par exemple, en créant un filtre sur une vue sous forme de liste et en sélectionnant Copier la requête) ou en les construisant manuellement.

Pour savoir comment générer et utiliser ces chaînes, consultez Chaînes de requête encodées dans la documentation ServiceNow.

Entrées de l'action

L'action Lister les enregistrements CMDB nécessite les paramètres suivants :

Paramètre Description
Class Name

Obligatoire.

Nom de la classe CMDB à partir de laquelle récupérer les enregistrements, par exemple cmdb_ci_appl.

Pour en savoir plus sur les noms de classe ServiceNow, consultez Afficher et modifier la définition et les métadonnées de la classe.
Query Filter

Facultatif.

Chaîne de requête encodée utilisée pour filtrer les enregistrements renvoyés (par exemple, sys_idLIKE1^sys_idSTARTSWITH0).

Vous pouvez générer des chaînes de requête valides à l'aide de l'option Copier la requête dans les vues sous forme de liste ServiceNow. Pour en savoir plus, consultez Chaînes de requête encodées.
Max Records To Return

Facultatif.

Nombre maximal d'enregistrements à récupérer en fonction des filtres appliqués.

La valeur par défaut est 50.

Sorties de l'action

L'action Lister les enregistrements CMDB fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Lister les enregistrements CMDB fournit le tableau suivant :

Nom de la table : Enregistrements CLASS_NAME

Colonnes d'un tableau :

  • Nom (mappé en tant que name)
  • ID système (mappé en tant que sys_id)
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les enregistrements CMDB :

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}
Messages de sortie

L'action Lister les enregistrements CMDB peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.

Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)

 L'action a réussi.
Error executing action "List CMDB Records". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Lister les enregistrements CMDB :

Nom du résultat du script Valeur
is_success true ou false

Lister les commentaires d'un enregistrement

Utilisez l'action Lister les commentaires d'un enregistrement pour lister les commentaires associés à un enregistrement de table spécifique dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Lister les commentaires d'un enregistrement nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow contenant l'enregistrement pour lequel lister les commentaires (par exemple, incident).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement pour lequel lister les commentaires.
Type

Obligatoire.

Type de commentaires ou de notes à récupérer.

Les valeurs possibles sont les suivantes :

  • Comment
  • Work Note

La valeur par défaut est Comment.
Max Results To Return

Facultatif.

Nombre maximal de commentaires ou de notes de travail à renvoyer.

La valeur par défaut est 50.

Sorties de l'action

L'action Lister les commentaires d'un enregistrement fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les commentaires d'un enregistrement :

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
Messages de sortie

L'action Lister les commentaires d'un enregistrement peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 L'action a réussi.
Error executing action "List Record Comments". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les commentaires d'un enregistrement :

Nom du résultat du script Valeur
is_success true ou false

Utilisez l'action Lister les enregistrements associés à l'utilisateur pour lister les enregistrements d'une table associés à un utilisateur dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Lister les enregistrements associés à l'utilisateur nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow dans laquelle rechercher les enregistrements associés (par exemple, incident).
Usernames

Obligatoire.

Liste de noms d'utilisateur séparés par une virgule pour lesquels récupérer les enregistrements associés.
Max Days Backwards

Obligatoire.

Nombre de jours à compter de la date actuelle pour rechercher les enregistrements associés.

La valeur par défaut est 1.
Max Records To Return

Facultatif.

Nombre maximal d'enregistrements à renvoyer pour chaque utilisateur.

La valeur par défaut est 50.

Sorties de l'action

L'action Lister les enregistrements liés à l'utilisateur fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les enregistrements associés à l'utilisateur :

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Messages de sortie

L'action Lister les enregistrements associés à l'utilisateur peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

No related table records were retrieved for the provided users.

L'action a réussi.
Error executing action "List Records Related To User". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les enregistrements associés à l'utilisateur :

Nom du résultat du script Valeur
is_success true ou false

Ping

Utilisez l'action Ping pour tester la connectivité à ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

Aucune.

Sorties de l'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script Valeur
is_success true ou false

Mettre à jour l'incident

Utilisez l'action Mettre à jour l'incident pour mettre à jour les informations sur l'incident.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Mettre à jour l'incident nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Identifiant unique de l'incident ServiceNow à mettre à jour, au format INCINCIDENT_NUMBER.
Short Description

Facultatif.

Brève description de l'incident.
Impact

Facultatif.

Niveau d'impact de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Urgency

Facultatif.

Niveau d'urgence de l'incident.

Les valeurs possibles sont les suivantes :

  • 1 pour "Élevée"
  • 2 pour Medium
  • 3 pour "Faible"

La valeur par défaut est 1.
Category

Facultatif.

Catégorie de l'incident.
Assignment Group ID

Facultatif.

Nom complet du groupe auquel attribuer l'incident.
Assigned User ID

Facultatif.

Nom complet de l'utilisateur auquel attribuer l'incident.
Description

Facultatif.

Description de l'incident.
Incident State

Facultatif.

La valeur ServiceNow sous-jacente pour l'état de l'incident (par exemple, 1 ou in_progress) au lieu de l'étiquette (par exemple, New ou In Progress).
Custom Fields

Facultatif.

Chaîne au format JSON contenant les noms de champs et leurs valeurs correspondantes à mettre à jour (par exemple, {"location":"London", "category":"database"}).

Vous pouvez utiliser ce paramètre pour modifier des champs qui ne sont pas explicitement définis comme entrées d'action.

Sorties de l'action

L'action Mettre à jour l'incident fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Mettre à jour l'incident :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Update Incident (Mettre à jour l'incident) :

Nom du résultat du script Valeur
incident_number INCIDENT_NUMBER

Mettre à jour l'enregistrement

Utilisez l'action Mettre à jour l'enregistrement pour modifier les enregistrements existants appartenant à différentes tables dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Mettre à jour l'enregistrement nécessite les paramètres suivants :

Paramètre Description
Table Name

Facultatif.

Nom de la table ServiceNow contenant l'enregistrement à mettre à jour (par exemple, incident).
Object Json Data

Obligatoire.

Objet JSON contenant les paires champ-valeur à appliquer à l'enregistrement (par exemple, {"short_description": "Updated description"}).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement spécifique à mettre à jour.

Sorties de l'action

L'action Mettre à jour l'enregistrement fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Mettre à jour l'enregistrement :

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Mettre à jour l'enregistrement :

Nom du résultat du script Valeur
record_sys_id RECORD_SYS_ID

Attendre les commentaires

Utilisez l'action Attendre les commentaires pour suspendre l'exécution du playbook jusqu'à ce qu'un commentaire ou une note de travail soit ajouté à un enregistrement de table spécifique dans ServiceNow.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Attendre les commentaires nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow contenant l'enregistrement pour lequel attendre des commentaires (par exemple, incident).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement à surveiller pour les commentaires.
Type

Obligatoire.

Type de commentaires ou de notes que l'action doit attendre.

Les valeurs possibles sont les suivantes :

  • Comment
  • Work Note

La valeur par défaut est Comment.
Wait Mode

Obligatoire.

Condition qui détermine quand l'action cesse d'attendre et se poursuit.

Les valeurs possibles sont les suivantes :

  • Until Timeout : l'action attend la fin du délai avant expiration, puis renvoie tous les commentaires accumulés.
  • Until First Message : l'action attend que le premier nouveau commentaire ou la première nouvelle note de travail soit publié après le démarrage de l'action.
  • Until Specific Text : l'action attend qu'un commentaire ou une note de travail contenant le texte spécifié dans Text soit publié.

La valeur par défaut est Until Timeout.
Text

Facultatif.

Chaîne de texte spécifique que l'action attend dans un nouveau commentaire ou une nouvelle note de travail.

Ce paramètre n'est utilisé que lorsque Until Specific Text est sélectionné pour la valeur de Wait Mode.

Sorties de l'action

L'action Attendre les commentaires fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Attendre les commentaires :

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
Messages de sortie

L'action Attendre les commentaires peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 L'action a réussi.
Error executing action "Wait For Comments". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Attendre les commentaires :

Nom du résultat du script Valeur
is_success true ou false

Attendre la mise à jour du champ

Utilisez l'action Attendre la mise à jour du champ pour suspendre l'exécution du playbook jusqu'à ce qu'un champ spécifique d'un enregistrement de données ServiceNow soit mis à jour avec l'une des valeurs attendues.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Attendre la mise à jour du champ nécessite les paramètres suivants :

Paramètre Description
Table Name

Obligatoire.

Nom de la table ServiceNow contenant l'enregistrement à surveiller (par exemple, incident).
Record Sys ID

Obligatoire.

ID système (sys_id) de l'enregistrement à surveiller pour la mise à jour du champ.
Field - Column Name

Obligatoire.

Nom de la colonne (champ) dont l'action surveille les modifications.
Field - Values

Obligatoire.

Liste de valeurs séparées par une virgule qui, si elles sont trouvées dans le champ surveillé, entraînent l'arrêt de l'attente et la poursuite de l'action (par exemple, In Progress,Resolved).

Sorties de l'action

L'action Attendre la mise à jour du champ fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Attendre la mise à jour du champ :

Nom du résultat du script Valeur
updated_field UPDATED_FIELD

Attendre la mise à jour de l'état

Utilisez l'action Attendre la mise à jour de l'état pour suspendre l'exécution du playbook jusqu'à ce qu'un état d'incident ServiceNow spécifique soit mis à jour avec l'une des valeurs attendues.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Attendre la mise à jour de l'état nécessite les paramètres suivants :

Paramètre Description
Incident Number

Obligatoire.

Identifiant unique de l'incident ServiceNow à surveiller, au format INCINCIDENT_NUMBER.
Statuses

Obligatoire.

Liste d'états d'incident séparés par une virgule qui, s'ils sont atteints, entraînent l'arrêt de l'attente et la poursuite de l'action (par exemple, In Progress,Resolved).

Sorties de l'action

L'action Attendre la mise à jour de l'état fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Attendre la mise à jour de l'état :

Nom du résultat du script Valeur
new_status STATUS

Connecteurs

Pour en savoir plus sur la configuration des connecteurs dans Google SecOps, consultez Ingérer vos données (connecteurs).

Connecteur ServiceNow

Utilisez le connecteur ServiceNow pour récupérer des incidents depuis ServiceNow.

Utiliser la liste de requêtes dynamiques

Dans le connecteur ServiceNow, la liste dynamique modifie le sysparm_query que le connecteur utilise pour interroger ServiceNow. Cela permet de filtrer les enregistrements en fonction de n'importe quel champ compatible avec le type d'enregistrement.

Pour définir un filtre, configurez chaque élément de liste dynamique de sorte qu'il contienne une paire champ-valeur au format suivant : FIELD_NAME=VALUE.

Exemple : category=security.

Lorsque Use whitelist as a blacklist est activé, le connecteur inverse la logique de la requête, ce qui fait que la liste dynamique fonctionne comme une liste de blocage au lieu d'un filtre.

Entrées du connecteur

Le connecteur ServiceNow nécessite les paramètres suivants :

Paramètre Description
Product Field Name

Obligatoire.

Nom du champ dans lequel le nom du produit est stocké.

Le nom du produit a principalement un impact sur le mappage. Pour simplifier et améliorer le processus de mappage du connecteur, la valeur par défaut est résolue en une valeur de remplacement référencée à partir du code. Toute entrée non valide pour ce paramètre est résolue par défaut en une valeur de remplacement.

La valeur par défaut est Product Name.
Event Field Name

Obligatoire.

Nom du champ qui détermine le nom de l'événement (sous-type).

La valeur par défaut est sys_class_name.
Rule Generator

Facultatif.

Nom du champ dont la valeur définit la requête ou l'ensemble de règles spécifique à appliquer lors de la récupération des enregistrements.
Api Root

Obligatoire.

Racine de l'API de l'instance ServiceNow.

La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username

Obligatoire.

Nom d'utilisateur du compte ServiceNow.
Password

Obligatoire.

Mot de passe du compte ServiceNow.
Verify SSL

Facultatif.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow.

Cette option est activée par défaut.
Use sys_domain Environment

Facultatif.

Si cette option est sélectionnée, le connecteur utilise le champ ServiceNow sys_domain comme environnement pour la demande d'assistance ingérée.

Si ce champ est manquant ou indisponible, le connecteur utilise par défaut la valeur spécifiée dans le paramètre Environment.
Days Backwards

Facultatif.

Nombre de jours dans le passé à partir de l'heure actuelle pour récupérer les enregistrements.

Ce paramètre est utilisé pour l'exécution initiale du connecteur ou comme valeur de remplacement si un code temporel de connecteur précédent a expiré.

La valeur par défaut est 5.
Disable Overflow

Facultatif.

Si cette option est sélectionnée, le connecteur ignore le mécanisme de dépassement de Google SecOps.
Max Incidents Per Cycle

Facultatif.

Nombre maximal d'incidents à récupérer lors de chaque itération du connecteur.

La valeur par défaut est 10.
Environments Whitelist

Facultatif.

Liste d'environnements (domaines) séparés par une virgule que le connecteur doit ingérer dans Google SecOps, par exemple env1,env2.
Use whitelist as a blacklist

Facultatif.

Si cette option est sélectionnée, le connecteur utilise la liste dynamique comme liste de blocage.

Désactivé par défaut
PythonProcessTimeout

Obligatoire.

Délai avant expiration, en secondes, du processus Python qui exécute le script actuel.

La valeur par défaut est 60.
Incident Table

Facultatif.

Nom ou chemin d'accès de la table d'API à utiliser pour les actions liées aux incidents et la récupération des enregistrements.

Par défaut, l'intégration utilise le chemin d'accès table/incident.
Client ID

Facultatif.

ID client pour l'intégration de ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide des identifiants client.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Client Secret

Facultatif.

Code secret du client pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Refresh Token

Facultatif.

Jeton d'actualisation pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'un jeton d'actualisation.

Ce jeton d'actualisation configuré expire tous les 90 jours.

Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Assignment Group

Facultatif.

Nom du groupe d'attribution dont le connecteur doit ingérer les enregistrements.
Use Oauth Authentication

Facultatif.

Si cette option est sélectionnée, l'intégration utilise OAuth 2.0 pour l'authentification.

L'authentification OAuth 2.0 nécessite de définir les identifiants client (Client ID et Client Secret) ou Refresh Token.

Désactivé par défaut
Server Time Zone

Facultatif.

Fuseau horaire configuré sur le serveur ServiceNow (par exemple, UTC ou Asia/Jerusalem).

La valeur par défaut est UTC.
Table Name

Facultatif.

Nom de la table à partir de laquelle récupérer les enregistrements, par exemple incident.
Event Name

Facultatif.

Nom de l'événement Google SecOps créé lorsqu'un enregistrement est ingéré (par exemple, ServiceNowEvent).
Proxy Server Address

Facultatif.

Adresse du serveur proxy à utiliser.
Proxy Username

Facultatif.

Nom d'utilisateur du proxy pour l'authentification.
Proxy Password

Facultatif.

Mot de passe du proxy pour l'authentification.
Get User Information

Facultatif.

Si cette option est sélectionnée, le connecteur récupère également les informations sur les utilisateurs associés à l'incident.

Désactivé par défaut

Jobs

Pour en savoir plus sur les jobs, consultez Configurer un nouveau job et Planification avancée.

ServiceNow : synchroniser les incidents fermés

Utilisez le job ServiceNow - Sync Closed Incidents pour synchroniser les incidents ServiceNow fermés avec les alertes et les cas Google SecOps correspondants.

Ce job traite les incidents ServiceNow ingérés en tant qu'alertes et demandes contenant le tag ServiceNow et une valeur de contexte TICKET_ID avec le numéro d'incident.

Paramètres de job

Le job ServiceNow - Sync Closed Incidents nécessite les paramètres suivants :

Paramètre Description
API Root Mandatory

Racine de l'API de l'instance ServiceNow. La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username Mandatory

Nom d'utilisateur de l'instance ServiceNow.
Password Mandatory

Mot de passe de l'instance ServiceNow.
Verify SSL Optional

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow. Cette option est activée par défaut.
Client ID Optional

ID client pour l'intégration de ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Client Secret Optional

Code secret du client pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Refresh Token Optional

Jeton d'actualisation pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'un jeton d'actualisation. Ce jeton d'actualisation configuré expire tous les 90 jours. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Use OAuth Authentication Optional

Si cette option est sélectionnée, l'intégration utilise OAuth 2.0 pour l'authentification. L'authentification OAuth 2.0 nécessite de définir les identifiants client (Client ID et Client Secret) ou Refresh Token. Désactivé par défaut
Max Hours Backwards Optional

Nombre d'heures à remonter à partir de l'heure actuelle pour rechercher et synchroniser les incidents clos. La valeur par défaut est 24.
Table Name Mandatory

Nom de la table de base de données dans laquelle rechercher les incidents clos (par exemple, incident).

ServiceNow - Synchroniser les incidents

Utilisez le job ServiceNow - Sync Incidents pour synchroniser les champs et les pièces jointes des incidents ServiceNow avec les demandes et les alertes associées dans Google SecOps.

Pour exécuter ce job, l'utilisateur de l'intégration ServiceNow doit disposer du rôle ITIL (itil). Pour en savoir plus, consultez Rôles du système de base dans la documentation ServiceNow.

Exigences de l'emploi

Pour que le job fonctionne correctement, assurez-vous que les éléments suivants sont configurés sur la demande ou l'alerte Google SecOps (en fonction du paramètre Sync Level) :

  • Tag : la demande doit comporter le tag ServiceNow Incident Sync.
  • Valeur de contexte : la demande ou l'alerte doit comporter une clé de contexte TICKET_ID contenant une liste de numéros d'incidents ServiceNow séparés par une virgule (par exemple, INC0000050,INC0000051). Définissez la valeur de contexte TICKET_ID à l'aide de l'action Définir la valeur de contexte du champ d'application de l'intégration des utilitaires Siemplify.

Paramètres de job

Le job ServiceNow - Sync Incidents nécessite les paramètres suivants :

Paramètre Description
API Root Mandatory

Racine de l'API de l'instance ServiceNow. La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username Optional

Nom d'utilisateur de l'instance ServiceNow.

Ce paramètre est obligatoire lors de l'authentification à l'aide d'un mot de passe de base.
Password Optional

Mot de passe de l'instance ServiceNow.

Ce paramètre est obligatoire lors de l'authentification à l'aide d'un mot de passe de base.
Sync Level Mandatory

Niveau auquel le job synchronise les données. Valeurs possibles : Case, Alert. La valeur par défaut est Case.
Max Hours Backwards Mandatory

Nombre maximal d'heures à remonter dans le temps à partir de l'heure actuelle pour rechercher des demandes à synchroniser. La valeur par défaut est 24.
Verify SSL Optional

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow. Cette option est activée par défaut.
Use OAuth Authentication Optional

Si cette option est sélectionnée, le job utilise l'authentification OAuth au lieu de l'authentification de base. Lorsque cette option est sélectionnée, les paramètres Client ID, Client Secret et Refresh Token sont obligatoires. Désactivé par défaut
Client ID Optional

ID client de l'application ServiceNow. Obligatoire si Use OAuth Authentication est sélectionné.
Client Secret Optional

Code secret du client de l'application ServiceNow. Obligatoire si Use OAuth Authentication est sélectionné.
Refresh Token Optional

Jeton d'actualisation de l'application ServiceNow. Obligatoire si Use OAuth Authentication est sélectionné.

Synchroniser les commentaires des enregistrements de la table

Utilisez le job Sync Table Record Comments (Synchroniser les commentaires des enregistrements de table) pour synchroniser les commentaires entre les enregistrements de table ServiceNow et les demandes Google SecOps.

Paramètres de job

Le job Sync Table Record Comments nécessite les paramètres suivants :

Paramètre Description
API Root Mandatory

Racine de l'API de l'instance ServiceNow. La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username Mandatory

Nom d'utilisateur de l'instance ServiceNow.
Password Mandatory

Mot de passe de l'instance ServiceNow.
Verify SSL Optional

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow. Cette option est activée par défaut.
Client ID Optional

ID client pour l'intégration de ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Client Secret Optional

Code secret du client pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'identifiants client. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Refresh Token Optional

Jeton d'actualisation pour l'intégration ServiceNow, requis pour l'authentification OAuth 2.0 à l'aide d'un jeton d'actualisation. Ce jeton d'actualisation configuré expire tous les 90 jours. Vous pouvez vous authentifier à l'aide du jeton d'actualisation ou des identifiants client. Si le jeton d'actualisation et les identifiants client sont tous deux configurés, l'intégration utilise le jeton d'actualisation pour l'authentification.
Use OAuth Authentication Optional

Si cette option est sélectionnée, l'intégration utilise OAuth 2.0 pour l'authentification. L'authentification OAuth 2.0 nécessite de définir les identifiants client (Client ID et Client Secret) ou Refresh Token. Désactivé par défaut
Table Name Mandatory

Nom de la table ServiceNow dans laquelle rechercher les enregistrements à partir desquels synchroniser les commentaires (par exemple, incident).

Synchroniser les commentaires des enregistrements de table par tag

Utilisez le job Sync Table Record Comments By Tag pour synchroniser les commentaires entre les enregistrements de table ServiceNow et les demandes Google SecOps.

Exigences de l'emploi

Pour que le job fonctionne correctement, la demande Google SecOps doit comporter les deux tags suivants :

  • ServiceNow TABLE_NAME (où <var class="readonly">TABLE_NAME</var> est le nom de la table ServiceNow, par exemple incident).
  • ServiceNow TicketId: TICKET_ID (où <var class="readonly">TICKET_ID</var> est l'ID ou le numéro système de l'enregistrement correspondant).

Paramètres de job

Le job Sync Table Record Comments By Tag nécessite les paramètres suivants :

Paramètre Description
API Root Mandatory

Racine de l'API de l'instance ServiceNow. La valeur par défaut est https://INSTANCE.service-now.com/api/now/v1/.
Username Mandatory

Nom d'utilisateur de l'instance ServiceNow.
Password Mandatory

Mot de passe de l'instance ServiceNow.
Table Name Mandatory

Nom de la table de base de données à rechercher, par exemple incident.
Verify SSL Optional

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur ServiceNow. Cette option est activée par défaut.

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