ServiceDesk Plus ServiceDesk Plus

Synchronisez vos tickets, incidents et inventaire depuis ManageEngine ServiceDesk Plus

Le connecteur ServiceDesk Plus permet de centraliser vos tickets d'incident, votre inventaire CMDB et vos utilisateurs depuis la plateforme ManageEngine.

Objectif

Le connecteur ServiceDesk Plus permet de récupérer les informations suivantes :

  • Tickets et incidents (statut, priorité, assignation)
  • Inventaire assets CMDB (équipements, configurations)
  • Utilisateurs et services

Prérequis

  • Accès à ManageEngine ServiceDesk Plus avec droits administrateur
  • Une application OAuth enregistrée dans le portail ManageEngine Developer
  • Génération des identifiants OAuth (Client ID, Client Secret)

Informations à fournir dans OverView

ChampDescription
RégionRégion du serveur ServiceDesk Plus (ex: us, eu, in)
Code d'autorisationCode d'autorisation obtenu après authentification OAuth
Identifiant clientID client de l'application OAuth enregistrée
Secret clientSecret client de l'application OAuth enregistrée
Révoquer le jeton à la suppressionRévoquer le jeton lorsque le connecteur est supprimé

Procédure

Pour la version Cloud : Créer un Self Client dans Zoho API Console

  1. Accédez à la Zoho API Console.
  2. Connectez-vous avec votre compte Zoho.
  3. Naviguez vers Client > Self Client.
  4. Cliquez sur Create pour enregistrer un Self Client.
  5. Accédez à l'onglet Client Secret pour récupérer :
    • Client ID
    • Client Secret
  6. Dans l'onglet Generate Code, entrez les scopes requis (ex : SDPOnDemand.requests.READ, SDPOnDemand.assets.READ) et cliquez sur Create.
  7. Copiez le Code d'autorisation généré (valide quelques minutes).
  8. Échangez le code d'autorisation pour un Refresh Token via curl : 
    curl -X POST https://accounts.zoho.com/oauth/v2/token \
  -d "grant_type=authorization_code&client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>&code=<AUTH_CODE>"

Pour la version On-Premises : Générer une clé API

  1. Connectez-vous à votre instance ServiceDesk Plus.
  2. Naviguez vers Admin > Technicians.
  3. Sélectionnez un compte technicien ou créez un nouveau compte de service pour OverView.
  4. Cliquez sur Generate API Key et notez la clé générée.

Configurer le connecteur dans OverView

  1. Dans OverView, accédez à Data Sources Settings > Sources.
  2. Sélectionnez ServiceDesk Plus et cliquez sur Configure.
  3. Renseignez les champs :
    • Region : Sélectionnez votre région
    • Client ID : Collez votre Client ID (Cloud) ou laissez vide pour on-premises
    • Client Secret : Collez votre Client Secret (Cloud) ou laissez vide pour on-premises
    • Authorization Code : Collez le code d'autorisation (Cloud uniquement)
  4. Cliquez sur Save Configuration.

Référence : Documentation OAuth 2.0 ManageEngine

Permissions requises

Les permissions minimales requises sur le compte ManageEngine :

  • Read sur les tickets et incidents
  • Read sur l'inventaire CMDB
  • Read sur les utilisateurs et services
Alternative : import par fichiers via DropPoint

L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à ServiceDesk Plus.

Où déposer les fichiers ?

Bucket : s3://servicedesk/

Exemple : s3://servicedesk/export.csv

La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.

← PrécédentOCS InventorySuivant →ServiceNow