Prise en main

Cet article vous explique le processus de configuration du service Citrix ITSM Adapter.

Préparations

Pour configurer le service ITSM Adapter, assurez-vous d’avoir les éléments suivants à portée de main :

• Un compte avec l’autorisation d’administrateur système pour votre instance ServiceNow

  Une fois le service configuré, vous pouvez y implémenter un contrôle d’accès basé sur les rôles. Pour plus d’informations, consultez la section Gestion des accès.

• Un abonnement actif à Citrix DaaS

  Vous pouvez également vous inscrire pour un essai gratuit. Pour plus d’informations, consultez Vérifier que vous êtes abonné à Citrix DaaS.

• Un compte administrateur Citrix Cloud avec accès complet

• Connectivité entre votre instance ServiceNow et l’adresse IP de la région où se trouve votre compte Citrix Cloud

  Région Citrix Cloud	Adresse IP
  États-Unis	52.158.218.132/30
  UE	20.54.214.12/30
  Asie-Pacifique	20.195.2.68/30

Vérifiez que vous êtes abonné à Citrix DaaS

Connectez-vous à Citrix Cloud ou créez un nouveau compte.

Si vous avez un abonnement actif à Citrix DaaS ou si vous vous êtes inscrit pour un essai gratuit, le service ITSM Adapter apparaît dans la liste Mes services . Sinon, vérifiez auprès de vos représentants Citrix.

Conseil :

Le bouton Gérer n’est disponible que si votre organisation dispose d’un abonnement valide à Citrix DaaS Premium Edition. Sinon, le bouton Request Demo s’affiche.

Étape 1 : installer le plug-in Citrix ITSM Connector dans ServiceNow

Installez le plug-in Citrix ITSM Connector sur votre instance ServiceNow.

1. Connectez-vous à votre portail de gestion des services ServiceNow à l’aide d’un compte associé au rôle system administrator.

2. Vérifiez que vous avez activé le plug-in ServiceNow Orchestration.

   Si une dépendance est manquante sur votre instance ServiceNow, vous êtes invité à procéder à l’installation.

   

3. Installez le plug-in Citrix IT Service Management Connector pour votre instance ServiceNow :

   1. Dans le volet gauche, sélectionnez Toutes les applications disponibles > Toutes. Pour localiser rapidement le menu, saisissez Applications dans le champ Navigateur de filtres .

   2. Sur la page Toutes les applications qui s’affiche, recherchez Citrix dans la barre de recherche.

      

   3. Dans les résultats de la recherche, recherchez Citrix IT Service Management Connector, puis cliquez sur Install.

   4. Suivez les instructions à l’écran pour procéder à l’installation.

   Remarque :

   Pour vérifier que vous avez téléchargé la dernière version du plug-in du connecteur Citrix ITSM, cliquez sur Other App Versions.

Étape 2 : configurer le plug-in Citrix ITSM Connector

Configurez le plug-in pour configurer sa connexion avec Citrix Cloud.

Étapes :

1. Créer les informations d’identification d’authentification dans Citrix Cloud.
2. Ajouter les informations d’identification d’authentification au plug-in.

À partir de la version 22.3.0 du service d’adaptateur ITSM, une seule instance ServiceNow peut gérer des applications et des bureaux dans plusieurs comptes Citrix Cloud.

Créer les informations d’identification d’authentification dans Citrix Cloud

Pour communiquer avec Citrix Cloud, le plug-in Citrix ITSM Connector doit disposer des informations d’identification générées par Citrix Cloud.

Créez les informations d’identification d’authentification dans chaque compte Citrix Cloud que vous souhaitez gérer.

Étapes :

1. Connectez-vous à Citrix Cloud, puis sélectionnez le compte Citrix Cloud que vous souhaitez gérer.

2. Créez un client sécurisé pour le plug-in Citrix ITSM Connector. Pour plus d’informations, consultez la section Get started with Citrix Cloud APIs.

   

3. Stockez l’identifiant et le code secret du client sécurisé dans un endroit sûr.

4. Si vous avez d’autres comptes Citrix Cloud à gérer, répétez les étapes 1 à 3 pour chacun d’eux.

Ajouter les informations d’identification d’authentification au plug-in

Après avoir créé les informations d’identification d’authentification dans votre compte Citrix Cloud, ajoutez-les au plug-in ITSM Connector. Le plug-in utilise les informations d’identification pour configurer la connexion avec Citrix Cloud.

1. Connectez-vous à votre portail ServiceNow Service Management Portal.

2. Dans le volet gauche, sélectionnez IT Service Management Connector Citrix > Accueil.

3. Sur la page Premiers pas avec votre intégration Citrix Cloud qui s’affiche, cliquez sur Se connecter.

   

4. Dans la boîte de dialogue Authentification Citrix Cloud qui apparaît, tapez la paire Secure Client ID et Secret que vous avez créée dans votre compte Citrix Cloud. Pour plus d’informations, consultez Créer les informations d’identification d’authentification dans Citrix Cloud.

5. Cliquez sur Test pour tester la connexion à votre compte Citrix Cloud.

6. Enregistrez la configuration.

   Un accusé de réception provenant de ServiceNow apparaît indiquant que la connexion est en cours.

   

7. Si vous avez d’autres comptes Citrix Cloud à gérer, procédez comme suit pour chacun d’eux :

   1. Cliquez sur Ajouter un client.
   2. Répétez les étapes 4 à 6.

Une fois la configuration terminée, l’instance ServiceNow se connecte automatiquement à Citrix Cloud à l’aide des informations d’authentification fournies. Lorsque vous vous connectez à Citrix Cloud et que vous accédez à la page ITSM Adapter for ServiceNow > Gérer, vous pouvez voir toutes les instances qui ont configuré des connexions avec Citrix Cloud.

Ces instances ont le statut Non enregistré, ce qui indique que Citrix Cloud ne s’est pas enregistré auprès d’elles.**

Désactiver un compte Citrix

Pour mettre hors service un compte Citrix Cloud de votre instance ServiceNow, sur la page d’accueil, cliquez sur les points de suspension, puis sur Decommission.

Remarque :

Pour supprimer complètement les données Citrix ITSM d’un compte Citrix Cloud, désactivez le compte. La suppression ou la modification manuelle d’un compte peut laisser des données résiduelles dans votre environnement.

Étape 3 : Enregistrez Citrix Cloud auprès de votre instance ServiceNow

Pour permettre à Citrix Cloud d’envoyer des alertes et des notifications à votre instance ServiceNow, enregistrez Citrix Cloud auprès de votre instance ServiceNow en fournissant les informations suivantes :

• URL de votre instance ServiceNow

• Informations d’identification d’authentification générées par votre instance ServiceNow

À partir de la version 22.3.0 du service d’adaptateur ITSM, une seule instance ServiceNow peut gérer plusieurs comptes Citrix Cloud. Si vous devez gérer plusieurs comptes Citrix Cloud, ajoutez vos informations ServiceNow à chacun d’eux.

Étapes :

1. Connectez-vous à Citrix Cloud, puis sélectionnez le compte Citrix Cloud que vous souhaitez gérer.

2. Dans la vignette ITSM Adapter for ServiceNow, cliquez sur Gérer. La page IT Service Management Adapter s’affiche.

3. Cliquez sur l’onglet Manage. Toutes les instances qui ont établi des connexions avec Citrix Cloud apparaissent.

4. Localisez l’instance ServiceNow auprès de laquelle vous souhaitez vous enregistrer, puis sélectionnez Enregistrer dans le menu des points de suspension. La page suivante apparaît avec l’URL de l’instance ServiceNow automatiquement renseignée.

   

   Vous pouvez également cliquer sur Ajouter une instance ServiceNow pour démarrer l’enregistrement.

5. Suivez les instructions à l’écran pour que ServiceNow génère un point de terminaison OAuth pour le compte Citrix Cloud :

   1. Copiez l’URL de redirection fournie dans les instructions.
   2. Ouvrez un nouvel onglet dans votre navigateur pour accéder à votre portail de gestion des services ServiceNow.
   3. Dans le portail, créez un point de terminaison OAuth pour le compte Citrix Cloud. Vous devez saisir l’URL de redirection copiée à l’étape a lors de la création du point de terminaison. Pour plus d’informations, consultez Créer un point de terminaison OAuth pour un compte Citrix Cloud.

6. Retournez à l’onglet dans lequel la boîte de dialogue Ajouter une instance ServiceNow dans Citrix Cloud est ouverte et entrez les informations d’identification OAuth requises :

   • (Facultatif) Entrez un nom descriptif pour l’instance ServiceNow.
   • Entrez les détails du point de terminaison OAuth (ID client et secret client) générés à l’étape 5.

   • Pour utiliser un compte de service ServiceNow pour la connexion et l’autorisation d’enregistrement à ServiceNow, activez Utiliser le compte de service ServiceNow, entrez l’ID utilisateur et le mot de passe du compte de service, puis cliquez sur Valider pour vérifier les informations d’identification du compte de service.

     Remarque :

     Vous pouvez utiliser un compte de service ServiceNow auquel le rôle x_cion_citrix_it_s.ctx_itsm_admin a été attribué pour terminer la validation. Pour permettre à ServiceNow de générer des incidents pour les alertes et les notifications depuis Citrix Cloud, assurez-vous que le rôle incident_manager nécessaire est également attribué à ce compte de service.

     

   • Pour utiliser un compte utilisateur ServiceNow pour la connexion à ServiceNow et l’autorisation d’enregistrement, maintenez la case Utiliser le compte de service ServiceNow désactivée et procédez comme suit :

     Remarque :

     Pour effectuer cette tâche, vous pouvez utiliser un compte utilisateur ServiceNow auquel ce rôle x_cion_citrix_it_s.ctx_itsm_admin a été attribué. Pour permettre à ServiceNow de générer des incidents pour les alertes et les notifications depuis Citrix Cloud, assurez-vous que le rôle incident_manager nécessaire est également attribué à ce compte utilisateur.

     1. Cliquez sur Connect. La page de connexion de votre instance ServiceNow s’affiche.

     2. Entrez le nom d’utilisateur et le mot de passe du compte utilisateur ServiceNow, puis cliquez sur Se connecter. Une page apparaît, vous demandant l’autorisation pour que le service ITSM Adapter se connecte à ce compte ServiceNow dans votre instance ServiceNow.

        

     3. Cliquez sur Autoriser. Vous revenez à la boîte de dialogue Add a ServiceNow Instance in Citrix Cloud.

        

   Remarque :

   Les données envoyées par Citrix DaaS à ServiceNow via le canal authentifié par le point de terminaison OAuth sont stockées dans la base de données ServiceNow. Les enregistrements de base de données correspondants indiquent clairement qu’ils ont été créés par le compte que vous avez utilisé pour la connexion et l’autorisation d’enregistrement de ServiceNow.

7. Cliquez sur Save instance. Le service ITSM Adapter commence à tester les connexions avec le connecteur Citrix ITSM. Si le test aboutit, le statut de l’instance passe à Registered.

   

   Conseil :

   Si l’état de l’instance apparaît comme ServiceNowInstance Unauthorized, vérifiez que les informations d’identification OAuth n’ont pas expiré et réauthentifiez-vous si nécessaire en sélectionnant Réauthentifier dans le menu des points de suspension.

8. Si vous avez d’autres comptes Citrix Cloud à gérer, répétez les étapes 1 à 7 pour chacun d’eux.

Une fois que vous avez terminé les étapes précédentes, les services d’assistance informatique et les utilisateurs finaux peuvent désormais accéder aux services Citrix ITSM.

Inscrivez-vous auprès d’une autre instance ServiceNow

Un compte Citrix Cloud ne peut être enregistré que sur une seule instance ServiceNow. Pour l’enregistrer auprès d’une autre instance ServiceNow, annulez d’abord l’enregistrement de l’instance existante.

1. Sur la page Gérer du service ITSM Adapter, cliquez sur les points de suspension à côté de l’instance ServiceNow existante.
2. Sélectionnez Unregister.
3. Pour enregistrer Citrix Cloud auprès d’une autre instance de service ServiceNow, localisez l’enregistrement de l’instance, puis sélectionnez Enregistrer dans les points de suspension.
4. Suivez les instructions qui s’affichent à l’écran pour terminer la procédure.

Créer un point de terminaison OAuth pour un compte Citrix Cloud

Dans votre instance ServiceNow, créez un point de terminaison OAuth (y compris un ID client et un secret client) pour un compte Citrix Cloud.

Étapes :

1. Connectez-vous à votre portail ServiceNow Service Management Portal.

2. Dans le volet gauche, sélectionnez System OAuth > Registre des applications. Pour localiser rapidement le menu, saisissez oauth dans le champ Filter navigator.

3. Sur la page Application Registries, cliquez sur New en regard de Application Registries.

   

4. Sur la page OAuth application qui s’affiche, sélectionnez Create an OAuth API endpoint for external clients.

5. Sur la page Application Registries New record qui s’affiche, créez un point de terminaison OAuth :

   1. Entrez un nom pour le point de terminaison OAuth.
   2. Cliquez sur l’icône en forme de cadenas en regard du champ URL de redirection, puis tapez l’URL de redirection qui a été demandée dans la boîte de dialogue Ajouter une instance ServiceNow dans Citrix Cloud .
   3. Cliquez sur Envoyer.

6. Sur la page Application Registries qui s’affiche, localisez le point de terminaison OAuth que vous avez créé.

7. Cliquez sur le nom du point de terminaison OAuth pour ouvrir sa page détaillée.

   

8. Stockez l’ID client et la clé secrète du client.

9. Revenez à la console Citrix Cloud pour poursuivre les étapes restantes.

Étape 4 : (Facultatif) Ajouter des sites locaux à Citrix Cloud à des fins de gestion

Si vous possédez des sites locaux et que vous souhaitez gérer leurs ressources (telles que les sessions et les machines) à l’aide des flux de travail ITSM de ServiceNow, procédez comme suit :

1. Connectez-vous à Citrix Cloud et sélectionnez votre compte Citrix Cloud.

2. Créez des emplacements de ressources pour vos sites locaux et installez Cloud Connector sur chaque emplacement en suivant les instructions qui s’affichent à l’écran.

   Pour plus d’informations, consultez la section Installation du Cloud Connector.

3. Ajoutez ces sites locaux au service ITSM Adapter en suivant les étapes suivantes :

   1. Dans la vignette ITSM Adapter for ServiceNow, cliquez sur Gérer. La page ITSM Adapter s’affiche.

      

   2. Dans l’onglet Gérer, activez l’option Activer les sites locaux.

   3. Cliquez sur Ajouter un site. La page Ajouter un site s’affiche.

      

   4. Entrez les informations suivantes pour le site que vous souhaitez gérer :

      • Sélectionnez l’emplacement des ressources où se trouve ce site.
      • Tapez le nom de domaine complet d’un Delivery Controller sur ce site.
      • Entrez les informations d’identification d’un administrateur de site doté du rôle d’administrateur complet, y compris le nom d’utilisateur, le mot de passe et le nom de domaine.

   5. Cliquez sur Test. Le test de connectivité commence. Une fois l’opération terminée, les Cloud Connector de l’emplacement des ressources sélectionné apparaissent.

      

   6. Répétez les étapes c à e pour ajouter les sites locaux restants.