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
| Champ | Description |
|---|---|
| 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
- Accédez à la Zoho API Console.
- Connectez-vous avec votre compte Zoho.
- Naviguez vers Client > Self Client.
- Cliquez sur Create pour enregistrer un Self Client.
- Accédez à l'onglet Client Secret pour récupérer :
- Client ID
- Client Secret
- Dans l'onglet Generate Code, entrez les scopes requis (ex :
SDPOnDemand.requests.READ, SDPOnDemand.assets.READ) et cliquez sur Create. - Copiez le Code d'autorisation généré (valide quelques minutes).
- É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
- Connectez-vous à votre instance ServiceDesk Plus.
- Naviguez vers Admin > Technicians.
- Sélectionnez un compte technicien ou créez un nouveau compte de service pour OverSOC.
- Cliquez sur Generate API Key et notez la clé générée.
Configurer le connecteur dans OverSOC
- Dans OverSOC, accédez à Data Sources Settings > Sources.
- Sélectionnez ServiceDesk Plus et cliquez sur Configure.
- 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)
- Cliquez sur Save Configuration.
Référence : Documentation OAuth 2.0 ManageEngine
Permissions requises
Les permissions minimales requises sur le compte ManageEngine :
Readsur les tickets et incidentsReadsur l'inventaire CMDBReadsur les utilisateurs et services