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 OverSOC

ChampDescription
Region*Région du serveur ServiceDesk Plus (ex: us, eu, in)
Authorization Code*Code d'autorisation obtenu après authentification OAuth
Client ID*ID client de l'application OAuth enregistrée
Client Secret*Secret client de l'application OAuth enregistrée

*Champs obligatoires

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 OverSOC.
  4. Cliquez sur Generate API Key et notez la clé générée.

Configurer le connecteur dans OverSOC

  1. Dans OverSOC, 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