Mise en route

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érifier 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.

Citrix Cloud

Conseil :

Le bouton Gérer n’est disponible que lorsque 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 ServiceNow Service Management Portal.

  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.

    Invite pour les dépendances

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

    1. Dans le volet gauche, sélectionnez All Available Applications > All. Pour localiser rapidement le menu, saisissez Applications dans le champ Filter navigator.

    2. Sur la page All applications, recherchez Citrix dans la barre de recherche.

      Installation d'un connecteur ITSM

    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 du connecteur Citrix ITSM. Pour plus d’informations, consultez la section Get started with Citrix Cloud APIs.

    ID et clé secrète du client sécurisé

  3. Stockez l’ID et la clé secrète 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 d’authentification avec Citrix Cloud.

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

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

  3. Sur la page Get started with your Citrix Cloud integration qui s’affiche, cliquez sur Connect.

    Authentification ITSM ServiceNow

  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.

    Connecteur ITSM opérationnel

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

    1. Cliquez sur Add customer.
    2. Répétez les étapes 4 à 6.

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 : Ajoutez vos informations ServiceNow au service ITSM Adapter

Pour permettre à Citrix Cloud d’envoyer des alertes et des notifications à votre instance ServiceNow, ajoutez les informations suivantes à Citrix Cloud :

  • 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, puis sur Add a ServiceNow Instance. La boîte de dialogue Add a ServiceNow Instance in Citrix Cloud apparaît.

    Ajouter une instance ServiceNow

  4. 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.
  5. Revenez à l’onglet contenant la boîte de dialogue Add a ServiceNow Instance in Citrix Cloud. Saisissez l’URL de votre instance ServiceNow et les informations de point de terminaison OAuth (ID client et secret client) que votre instance ServiceNow a générées à l’étape 4.

    Remplir les champs avec les valeurs de l'instance ServiceNow

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

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

    Demande d'autorisation pour se connecter à ServiceNow

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

    Boîte de dialogue Add a ServiceNow Instance in Citrix Cloud

    Remarque :

    Les données envoyées depuis Citrix DaaS à ServiceNow via le canal authentifié du point de terminaison OAuth sont stockées dans la base de données ServiceNow. Les enregistrements de base de données correspondants indiquent qu’ils ont été créés par le compte utilisateur que vous avez utilisé pour vous connecter à l’étape 7 et pour cliquer sur Autoriser à l’étape 8.

  9. Cliquez sur Save instance. Le service ITSM Adapter commence à tester les connexions avec le connecteur Citrix ITSM. Si le test se termine avec succès, le service enregistre les informations de votre instance ServiceNow. L’instance apparaît dans l’onglet Manage du service ITSM Adapter.

    Ajout d'une instance ServiceNow

  10. Si vous avez d’autres comptes Citrix Cloud à gérer, répétez les étapes 1 à 9 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.

Passer à une autre instance ServiceNow

Un compte Citrix Cloud ne peut être lié qu’à une seule instance ServiceNow. Pour passer à une autre instance ServiceNow, annulez l’enregistrement de l’instance existante.

  1. Sur la page Manage du service ITSM Adapter, cliquez sur les points de suspension en regard de l’instance de service ServiceNow existante.
  2. Sélectionnez Unregister.
  3. Ajoutez une autre instance de service ServiceNow en cliquant sur Add a ServiceNow Instance.

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 > Application Registry. 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.

    Créer un point de terminaison OAuth dans ServiceNow

  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 de cadenas en regard du champ Redirect URL, puis tapez l’URL de redirection qui vous a été demandée dans la boîte de dialogue Add a ServiceNow Instance in Citrix Cloud.
    3. Cliquez sur Submit.
  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.

    Détails du point de terminaison OAuth

  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 via l’agrégation de sites

Pour gérer les applications et les bureaux dans vos sites Citrix Virtual Apps and Desktops locaux, ajoutez-les à votre compte Citrix Cloud.

Étapes :

  1. Cliquez sur l’onglet Manage. La page Manage s’affiche avec les sites suivants répertoriés :

    • Le site Citrix DaaS connecté à votre compte Citrix Cloud. Par défaut, le service ITSM Adapter est activé sur le site. Pour désactiver la gestion, cliquez sur les points de suspension en regard du site Citrix DaaS.

    • Les sites locaux que vous avez ajoutés à Citrix Cloud via l’agrégation de sites. Pour ajouter d’autres sites Ajouter des sites locaux à Citrix Cloud, consultez la documentation Citrix Workspace - Agrégation de sites.

    Onglet Manage

  2. Sur la page Manage, recherchez un site local selon vos besoins, puis sélectionnez Manage Credentials à partir des points de suspension.

    Sélectionner Manage Credentials

  3. Entrez les informations d’identification de l’administrateur complet du site.

  4. Cliquez sur Test pour vérifier la connexion.

    Un message s’affiche lorsque le site est en cours d’exécution et connecté au service ITSM Adapter.

  5. Cliquez sur Enregistrer.

  6. Répétez les étapes 2 à 5 sur chaque site local que vous souhaitez que le service gère.