ServiceDesk Plus V3

Version de l'intégration : 4.0

Configurer ServiceDesk Plus V3 pour qu'il fonctionne avec Google Security Operations

Générer un jeton d'API

  1. Accédez à la console d'administration.

    Console ServiceDesk Plus V3

  2. Cliquez dessus, puis sur Générer une clé API.

    Générer une clé API dans la console ServiceDesk Plus V3

  3. Une boîte de dialogue affiche l'état de la génération de votre clé.

    • Si vous avez déjà généré la clé, veillez à la conserver dans un endroit sûr. Sinon, vous devrez la générer à nouveau.
    • Si ce n'est pas le cas, cliquez sur Générer une clé. La clé API s'affiche immédiatement.

    Régénérer la clé API dans la console ServiceDesk Plus V3

Configurer l'intégration de ServiceDesk Plus V3 dans Google SecOps

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

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Racine de l'API Chaîne http://{IP OR FQDN}:8080/api/v3/ Oui Racine de l'API de ServiceDesk Plus.
Jeton d'API Chaîne N/A Oui Jeton d'API de ServiceDesk Plus. (également appelée "clé du technicien")
Vérifier le protocole SSL Case à cocher Décochée Oui Si cette option est activée, elle vérifie que le certificat SSL pour la connexion au serveur ServiceDesk Plus est valide.

Actions

Ping

Description

Testez la connectivité à ServiceDesk Plus V3 avec les paramètres fournis sur la page de configuration de l'intégration dans l'onglet Google Security Operations Marketplace.

Paramètres

N/A

Cas d'utilisation

Cette action permet de tester la connectivité sur la page de configuration de l'intégration, dans l'onglet "Google Security Operations Marketplace". Elle peut être exécutée manuellement, mais n'est pas utilisée dans les playbooks.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "La connexion à ServiceDesk Plus V3 a été établie avec succès à l'aide des paramètres de connexion fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur critique est signalée (par exemple, des identifiants incorrects ou une perte de connectivité) :

"Échec de la connexion à ServiceDesk Plus V3 ! Error is {0}".format(exception.stacktrace)

 Général

Ajouter une note

Description

Ajoutez une note à une demande.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Oui ID des demandes.
Remarque Chaîne N/A Oui Contenu de la note.
Afficher au demandeur Case à cocher Décochée Non Indiquez si la note doit être affichée ou non pour le demandeur.
Avertir le technicien Case à cocher Décochée Non Indiquez si la note doit être affichée ou non pour le demandeur.
Marquer comme première réponse Case à cocher Décochée Non Indiquez si cette note doit être marquée comme première réponse.
Ajouter aux demandes associées Case à cocher Décochée Non Indiquez si cette note doit être ajoutée aux demandes associées.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "request_note": {
        "created_time": {
            "display_value": "Nov 10, 2020 01:14 AM",
            "value": "1690499678XXX"
        },
        "request": {
            "subject": "New Subject Dropdown",
            "id": "00"
        },
        "show_to_requester": false,
        "description": "New Note",
        "id": "23",
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        }
    }
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "Note ajoutée à la demande ServiceDesk Plus. ID de la demande : {ID} , ID de la note : {note.id}."

Si le paramètre "ID de la demande" est introuvable :

"L'action n'a pas pu ajouter de note à la demande portant l'ID {ID} dans ServiceDesk Plus. Motif : La demande portant l'ID {ID} est introuvable."

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Ajouter une note". Raison : {0}''.format(error.Stacktrace)

 Général

Fermer la demande

Description

Fermez une demande.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Oui ID de la demande.
Commentaire Chaîne N/A Oui Commentaire de clôture.
Résolution confirmée Case à cocher Décochée Non Indique si la résolution de la demande a été confirmée ou non.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "response_status": {
        "status_code": 2000,
        "messages": [
            {
                "status_code": 2000,
                "type": "success",
                "message": "Request(s) closed successfully."
            }
        ],
        "status": "success"
    }
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit :

Imprimez "La demande ServiceDesk Plus portant l'ID {ID} a bien été clôturée."

Si l'ID de la demande est introuvable :

Imprimer "L'action n'a pas pu clôturer la demande portant l'ID {ID} dans ServiceDesk Plus. Motif : La demande portant l'ID {ID} est introuvable."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si l'opération échoue :

Imprimez "Erreur lors de l'exécution de l'action "Fermer la demande". Raison : {0}''.format(error.Stacktrace)

 Général

Ajouter une note et attendre une réponse

Description

Ajoutez une note à une demande.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Oui ID des demandes.
Remarque Chaîne N/A Oui Contenu de la note.
Afficher au demandeur Case à cocher Décochée Non Indiquez si la note doit être affichée ou non pour le demandeur.
Avertir le technicien Case à cocher Décochée Non Indiquez si la note doit être affichée ou non pour le demandeur.
Marquer comme première réponse Case à cocher Décochée Non Indiquez si cette note doit être marquée comme première réponse.
Ajouter aux demandes associées Case à cocher Décochée Non Indiquez si cette note doit être ajoutée aux demandes associées.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "response_status": {
        "status": "Success",
        "statuscode": "2000"
    },
    "request_note": {
        "id": "1",
        "description": "Need more info on this topic. Please contact me.",
        "created_by": {
            "id": "4",
            "name": "administrator"
        },
        "show_to_requester": true,
        "request": {
            "id": "2"
        },
        "created_time": {
            "value": 1455520864880,
            "display_value": "Feb 15, 2016 12:51 PM"
        }
    }
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "Note ajoutée à la demande ServiceDesk Plus". ID de la demande : {ID} , ID de la note : {note.id}."

Si le paramètre "ID de la demande" est introuvable :

"L'action n'a pas pu ajouter de note à la demande portant l'ID {ID} dans ServiceDesk Plus. Motif : La demande portant l'ID {ID} est introuvable."

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Ajouter une note". Raison : {0}''.format(error.Stacktrace)

 Général

Créer une demande d'alerte

Description

Créez une demande concernant une alerte Google SecOps.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Subject Chaîne N/A Oui Objet de la demande.
Demandeur Chaîne Utilisateur de la clé API Oui Demandeur de la requête. Si aucune valeur n'est spécifiée, la valeur est définie sur l'utilisateur de la clé API.
Éléments Chaîne N/A Non Noms des composants à associer à la demande.
État Chaîne N/A Non État de la demande.
Technicien Chaîne N/A Non Nom du technicien affecté à la demande.
Priorité Chaîne N/A Non Priorité de la demande.
Urgence Chaîne N/A Non L'urgence de la demande.
Catégorie Chaîne N/A Non Catégorie de la demande.
Modèle de demande Chaîne N/A Non Modèle de la demande.
Type de requête Chaîne N/A Non

Type de la demande.

Exemple : Incident, Demande de service
Heure limite (ms) Chaîne N/A Non Date limite de la demande en millisecondes.
Mode Chaîne N/A Non

Mode dans lequel cette requête est créée.

Exemple : Adresse e-mail
Niveau Chaîne N/A Non Niveau de la demande.
Site Chaîne N/A Non Indique le site auquel appartient cette demande.
Groupe Chaîne N/A Non Groupe auquel appartient cette demande.
Impact Chaîne N/A Non Impact de la demande.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "request": {
        "ola_due_by_time": null,
        "subject": "Test request number 2",
        "resolution": {
            "submitted_on": {
                "display_value": "Oct 28, 2020 09:31 PM",
                "value": "1603945909120"
            },
            "submitted_by": {
                "email_id": null,
                "name": "administrator",
                "is_vipuser": false,
                "id": "4",
                "department": null
            },
            "resolution_attachments": [],
            "content": "Mail Fetching Server problem has been fixed"
        },
        "linked_to_request": null,
        "mode": null,
        "lifecycle": null,
        "reason_for_cancel": null,
        "assets": [
            {
                "name": "servicedesk.workgroup",
                "id": "24"
            }
        ],
        "is_trashed": false,
        "id": "6",
        "assigned_time": null,
        "group": null,
        "requester": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "cancel_requested_by": null,
        "email_to": [],
        "created_time": {
            "display_value": "Oct 28, 2020 09:31 PM",
            "value": "1603945909120"
        },
        "item": null,
        "level": null,
        "has_resolution_attachments": false,
        "approval_status": null,
        "impact": null,
        "service_category": null,
        "sla": null,
        "priority": null,
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "scheduled_end_time": null,
        "tags": [],
        "first_response_due_by_time": null,
        "last_updated_time": null,
        "has_notes": false,
        "impact_details": "Routine tasks are pending due to mail server problem",
        "subcategory": null,
        "email_cc": [],
        "status": {
            "color": "#0066ff",
            "name": "Open",
            "id": "2"
        },
        "scheduled_start_time": null,
        "template": {
            "is_service_template": false,
            "name": "Default Request",
            "id": "1"
        },
        "email_ids_to_notify": [],
        "request_type": {
            "name": "Incident",
            "id": "1"
        },
        "cancel_requested_time": null,
        "description": "I am unable to fetch mails from the mail server",
        "has_dependency": false,
        "has_conversation": false,
        "callback_url": null,
        "chat_type": 0,
        "is_service_request": false,
        "urgency": null,
        "is_shared": false,
        "cancel_requested": false,
        "has_request_initiated_change": false,
        "request_template_task_ids": [],
        "department": null,
        "is_reopened": false,
        "has_draft": false,
        "has_attachments": false,
        "has_linked_requests": false,
        "is_overdue": false,
        "technician": null,
        "has_request_caused_by_change": false,
        "has_problem": false,
        "due_by_time": null,
        "has_project": false,
        "is_first_response_overdue": false,
        "cancel_requested_is_pending": false,
        "category": null
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "Successfully created ServiceDesk Plus request" (Demande ServiceDesk Plus créée)

L'action doit échouer et arrêter l'exécution d'un playbook :

Si l'opération échoue : "Erreur lors de l'exécution de l'action "Create Alert Request action". Raison : {0}''.format(error.Stacktrace)

 Général

Créer une demande

Description

Créez une demande.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Subject Chaîne N/A Oui Objet de la demande.
Demandeur Chaîne Utilisateur de la clé API Oui Demandeur de la requête. Si aucune valeur n'est spécifiée, la valeur est définie sur l'utilisateur de la clé API.
Description Chaîne N/A Non Description de la demande.
Éléments Chaîne N/A Non Noms des composants à associer à la demande.
État Chaîne N/A Non État de la demande.
Technicien Chaîne N/A Non Nom du technicien affecté à la demande.
Priorité Chaîne N/A Non Priorité de la demande.
Urgence Chaîne N/A Non L'urgence de la demande.
Catégorie Chaîne N/A Non Catégorie de la demande.
Modèle de demande Chaîne N/A Non Modèle de la demande.
Type de requête Chaîne N/A Non

Type de la demande.

Exemple : Incident, Demande de service
Heure limite (ms) Chaîne N/A Non Date limite de la demande en millisecondes.
Mode Chaîne N/A Non

Mode dans lequel cette requête est créée.

Exemple : Adresse e-mail
Niveau Chaîne N/A Non Niveau de la demande.
Site Chaîne N/A Non Indique le site auquel appartient cette demande.
Groupe Chaîne N/A Non Groupe auquel appartient cette demande.
Impact Chaîne N/A Non Impact de la demande.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite : "La demande ServiceDesk Plus a bien été créée"

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Créer une demande". Raison : {0}''.format(error.Stacktrace)

 Général

Obtenir une demande

Description

Récupérez des informations sur une demande dans ServiceDesk Plus.

Paramètres

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

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de succès : "La demande ServiceDesk Plus associée à l'ID {ID} a bien été récupérée."

Si le paramètre "ID de la demande" est introuvable : "L'action n'a pas pu récupérer la demande avec l'ID {ID} dans ServiceDesk Plus. Motif : La demande portant l'ID {ID} est introuvable."

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Get Request action". Raison : {0}''.format(error.Stacktrace)

 Général

Attendre la mise à jour du champ

Description

Attendez qu'un champ d'une requête soit mis à jour avec la valeur souhaitée.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Oui ID de la demande.
Nom du champ Chaîne N/A Oui Nom du champ à mettre à jour.
Valeurs Chaîne N/A Oui Valeurs souhaitées pour le champ donné.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution du playbook :

Si une tâche d'attente (action asynchrone) a été créée pour le champ : "Created analysis tasks for the field: {0}".format([fields_list]).

Si la création d'une tâche d'analyse échoue pour tous les champs fournis : "Aucune tâche d'analyse ServiceDesk Plus n'a été créée."

Si vous attendez toujours que le champ soit mis à jour : "Action en attente de la prochaine mise à jour"

L'action doit échouer et arrêter l'exécution du playbook :

Si une erreur critique est signalée, comme des identifiants incorrects ou une perte de connectivité : "Échec de la connexion au service ServiceDesk ! Error is {0}".format(exception.stacktrace)

 Général

Demande de mise à jour

Description

Mettez à jour une demande ServiceDesk Plus à l'aide de son ID.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Vrai ID de la demande à mettre à jour.
Objet Chaîne N/A Non Objet de la demande.
Demandeur Chaîne N/A Non

Demandeur de la requête.

Si aucune valeur n'est spécifiée, la valeur est définie sur l'utilisateur de la clé API.
Description Chaîne N/A Non Description de la demande.
Éléments Chaîne N/A Non

Noms des composants à associer à la demande.

Le paramètre peut également obtenir une liste de chaînes séparées par une virgule avec les noms des composants.
État Chaîne N/A Non État de la demande.
Technicien Chaîne N/A Non Nom du technicien affecté à la demande.
Priorité Chaîne N/A Non Priorité de la demande.
Urgence Chaîne N/A Non L'urgence de la demande.
Catégorie Chaîne N/A Non Catégorie de la demande.
Modèle de demande Chaîne N/A Non Modèle de la demande.
Type de requête Chaîne N/A Non

Type de la demande.

Exemple : Incident, Demande de service
Heure limite (ms) Chaîne N/A Non Date limite de la demande en millisecondes.
Mode Chaîne N/A Non

Mode dans lequel cette requête est créée.

Exemple : Adresse e-mail
Niveau Chaîne N/A Non Niveau de la demande.
Site Chaîne N/A Non Indique le site auquel appartient cette demande.
Groupe Chaîne N/A Non Groupe auquel appartient cette demande.
Impact Chaîne N/A Non Impact de la demande.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de succès : "La demande ServiceDesk Plus portant l'ID {ID} a bien été mise à jour."

Si le paramètre "ID de la demande" est introuvable : "L'action n'a pas pu mettre à jour la demande avec l'ID {ID} dans ServiceDesk Plus. Motif : La demande portant l'ID {ID} est introuvable."

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". Raison : {0}''.format(error.Stacktrace)

 Général

Attendre la mise à jour de l'état

Description

Attendez que l'état d'une demande passe à l'état souhaité.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Identifiant de la demande Chaîne N/A Oui ID de la demande.
Valeurs Chaîne N/A Oui Valeurs souhaitées pour le champ donné.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution du playbook :

Si une tâche d'attente (action asynchrone) a été créée pour le champ : "Created analysis tasks for the field: {0}".format([fields_list]).

Si la création de la tâche d'analyse pour tous les champs fournis a échoué : "Aucune tâche d'analyse ServiceDesk Plus n'a été créée."

Si vous attendez toujours que le champ soit mis à jour : "Action en attente de la prochaine mise à jour"

L'action doit échouer et arrêter l'exécution du playbook :

Si une erreur critique est signalée, comme des identifiants incorrects ou une perte de connectivité : "Échec de la connexion au service ServiceDesk ! Error is {0}".format(exception.stacktrace)

 Général

Créer une demande : listes déroulantes

Description

Créez une demande.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Subject Chaîne N/A Oui Objet de la demande.
Demandeur Chaîne N/A Non Demandeur de la requête. Si aucune valeur n'est spécifiée, la valeur est définie sur l'utilisateur de la clé API.
Éléments Chaîne N/A Non

Noms des composants à associer à la demande.

Le paramètre peut également recevoir une liste de chaînes séparées par une virgule contenant les noms des composants.
Description Chaîne N/A Non Description de la demande.
État LDD N/A Non État de la demande.
Technicien Chaîne N/A Non Nom du technicien affecté à la demande.
Priorité LDD N/A Non Priorité de la demande.
Urgence LDD N/A Non L'urgence de la demande.
Catégorie LDD N/A Non Catégorie de la demande.
Modèle de demande Chaîne N/A Non Modèle de la demande.
Type de requête LDD N/A Non

Type de la demande.

Exemple : Incident, Demande de service
Heure limite (ms) Chaîne N/A Non Date limite de la demande en millisecondes.
Mode LDD N/A Non

Mode dans lequel cette requête est créée.

Exemple : Adresse e-mail
Niveau LDD N/A Non Niveau de la demande.
Site Chaîne N/A Non Indique le site auquel appartient cette demande.
Groupe Chaîne N/A Non Groupe auquel appartient cette demande.
Impact LDD N/A Non Impact de la demande.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite : "La demande ServiceDesk Plus a bien été créée"

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Erreur lors de l'exécution de l'action "Créer une demande". Raison : {0}''.format(error.Stacktrace)

 Général

Jobs

Synchroniser les demandes clôturées par tag

Description

Synchronise les demandes ServiceDesk Plus V3 créées dans le playbook Google SecOps Case et les requêtes Google SecOps.

Paramètres

Paramètre Type Valeur par défaut Obligatoire Description
Racine de l'API Chaîne http://{IP OR FQDN}:8080/api/v3/ Oui Racine de l'API de l'instance ServiceDesk Plus.
Clé API Mot de passe N/A Oui Clé API de l'instance ServiceDesk Plus.
Nombre maximal d'heures en arrière Integer 24 Non Spécifiez le nombre d'heures en arrière pour synchroniser les états.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, vérifiez que le certificat SSL pour la connexion au serveur ServiceDesk Plus est valide.

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