Micro-apps

Intégrer Cherwell

Déployez le modèle d’intégration Cherwell pour gérer et être informé des modifications apportées aux incidents et aux demandes de service.

Votre avis nous intéresse ! Veuillez fournir vos commentaires pour ce modèle d’intégration au fur et à mesure que vous l’utilisez. Pour tout problème, notre équipe surveille également nos forums dédiés quotidiennement.

Pour plus de détails sur la micro-app prête à l’emploi pour Cherwell, consultez la section Utiliser les micro-apps Cherwell.

Vérifier les conditions préalables

Une fois l’intégration avec Cherwell configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : https:/{Cherwell_Instance_URL}/CherwellAPI/api/. {Cherwell_Instance_URL} est obtenu auprès de Cherwell lors de l’achat.
  • URL du jeton : https:/{Cherwell_Instance_URL}/CherwellAPI/token. {Cherwell_Instance_URL} est obtenu auprès de Cherwell lors de l’achat.
  • Nom d’utilisateur : ce paramètre et le paramètre Mot de passe représentent les informations d’identification du compte de service avec accès à Cherwell.
  • Mot de passe : ce paramètre et le paramètre Nom d’utilisateur représentent les informations d’identification du compte de service avec accès à Cherwell.
  • ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
  • Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

L’intégration nécessite un accès régulier à votre instance Cherwell. Nous vous recommandons donc de créer un compte utilisateur dédié. Ce compte doit disposer des autorisations suivantes :

  • Groupe de sécurité administrateur

Créer l’ID client et la clé secrète client

Avant d’effectuer cette procédure, accédez à https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/, téléchargez la solution Cherwell Service Management et installez-la.

  1. Connectez-vous avec votre ID utilisateur et mot de passe.
  2. Sur l’écran Cherwell Service Management APP, sélectionnez Security.
  3. Accédez à Edit REST API client settings.
  4. Sélectionnez Create new client.
  5. Renseignez les champs suivants :

    • Name
    • Description
    • Entrez 360 sous Token lifespan.
    • Entrez 1440 sous **Refresh Token lifespan.
    • Cochez la case API Access enabled.
  6. Sélectionnez Save current client.
  7. Copiez et enregistrez la valeur Client Key. Il s’agit de la valeur pour ID client et Clé secrète client que vous utilisez pour l’authentification du service lors de la configuration de l’intégration.

Créer un nom d’utilisateur et un mot de passe

Avant d’effectuer cette procédure, accédez à https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/, téléchargez la solution Cherwell Service Management et installez-la.

  1. Connectez-vous avec votre ID utilisateur et mot de passe.
  2. Sur l’écran Cherwell Service Management APP, sélectionnez Security.
  3. Sélectionnez Edit Users.
  4. Sélectionnez Create new user.
  5. Renseignez les champs suivants :

    • Login ID
    • Mot de passe
    • Confirm password
  6. Sélectionnez « Security Group: Admin », et renseignez les champs Full name et E-mail.
  7. Cochez la case Password never expires.
  8. Sélectionnez Save current user.

Remarque :

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration Cherwell aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  2. Choisissez la vignette Cherwell.
  3. Donnez un nom à l’intégration.
  4. Renseignez la section Paramètres du connecteur.
    • Entrez l’URL de base de l’instance : https:/{Cherwell_Instance_URL}/CherwellAPI/api/. {Cherwell_Instance_URL} est obtenu auprès de Cherwell lors de l’achat.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.
  5. Sous Authentification du service, sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué. Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.
    1. Sélectionnez Mot de passe du propriétaire de la ressource dans le menu Type d’autorisation.
    2. Entrez le mot de passe sous Valeur du type d’autorisation.
    3. Sélectionnez Corps de la requête sous Autorisation de jeton.
    4. Sélectionnez URL du formulaire codée sous Type de contenu du jeton.
    5. Entrez l’URL du jeton : https:/{Cherwell_Instance_URL}/CherwellAPI/token. {Cherwell_Instance_URL} est obtenu auprès de Cherwell lors de l’achat.
    6. Renseignez le champ Nom d’utilisateur. Ce paramètre et le paramètre Mot de passe représentent les informations d’identification du compte de service avec accès à Cherwell.
    7. Renseignez le champ Mot de passe. Ce paramètre et le paramètre Nom d’utilisateur représentent les informations d’identification du compte de service avec accès à Cherwell.
    8. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
    9. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
    10. Sélectionnez Porteur dans le menu Préfixe d’en-tête.
    11. Dans le menu Paramètres du jeton d’accès, entrez auth_mode sous Nom et Interne sous Valeur.
  6. N’activez pas l’option Authentification des actions de service.
  7. Désactivez l’option Activer la limitation du taux de demandes.
  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Sélectionnez Enregistrer pour continuer.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Cherwell.

Utiliser les micro-apps Cherwell

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Créer un incident : permet à l’utilisateur de créer un incident.

Notification ou Page Workflows de cas d’utilisation
Page Créer un incident Fournit un formulaire permettant de créer un incident.

Créer une demande de service : permet de créer une nouvelle demande de service à partir du catalogue ou de sélectionner des modèles de demandes de service prédéfinis.

Notification ou Page Workflows de cas d’utilisation
Page Créer une demande de service Fournit un formulaire permettant de sélectionner un modèle prédéfini ou de créer une demande à partir du catalogue de services.

Mes incidents ouverts : permet d’afficher et de gérer les incidents ouverts qui appartiennent à l’utilisateur de l’espace de travail.

Notification ou Page Workflows de cas d’utilisation
Notification Incident créé Lorsqu’un nouvel incident est créé, le propriétaire de l’incident reçoit une notification.
Notification Seuils du SLA de la résolution de l’incident atteints Lorsque le SLA d’une résolution d’incident est manqué, le propriétaire de l’incident reçoit une notification.
Notification Seuils du SLA de la réponse de l’incident atteints Lorsque le SLA d’une réponse d’incident est manqué, le propriétaire de l’incident reçoit une notification.
Notification Changement d’état de l’incident Lorsque l’état d’un incident est modifié, le propriétaire de l’incident reçoit une notification.
Page Mes incidents ouverts Fournit une liste des incidents ouverts appartenant à l’utilisateur de l’espace de travail.
Page Détails de l’incident Fournit des détails sur l’incident, y compris des commentaires, ainsi que la possibilité d’ajouter des commentaires et de supprimer l’incident.

Mes demandes de service ouvertes : permet d’afficher et de gérer les demandes de service ouvertes qui appartiennent à l’utilisateur de l’espace de travail.

Notification ou Page Workflows de cas d’utilisation
Notification Demande de service créée Lorsqu’une nouvelle demande de service est créée, le propriétaire de l’incident reçoit une notification.
Notification Seuils du SLA de la résolution de la demande de service atteints Lorsque le SLA d’une résolution de demande de service est manqué, le propriétaire de l’incident reçoit une notification.
Notification Seuils du SLA de la réponse de la demande de service atteints Lorsque le SLA d’une réponse de demande de service est manqué, le propriétaire de l’incident reçoit une notification.
Notification L’état de la demande de service a été modifié Lorsque l’état d’une nouvelle demande de service est modifié, le propriétaire de l’incident reçoit une notification.
Mes demandes de service ouvertes Fournit une liste des demandes de service ouvertes appartenant à l’utilisateur de l’espace de travail.
Détails de la demande de service Fournit des détails sur les demandes de service, y compris des commentaires, ainsi que la possibilité d’ajouter des commentaires et de supprimer la demande de service.
Intégrer Cherwell