Micro-apps

Intégrer Citrix Virtual Apps and Desktops Service

Déployez l’intégration Citrix Virtual Apps and Desktops Service (CVAD) pour ajouter des micro-apps qui aident les utilisateurs à effectuer des actions en libre-service à partir de Citrix Workspace. Les utilisateurs peuvent vérifier l’état de leurs machines et sessions associées, ainsi qu’effectuer des opérations telles que le redémarrage, la déconnexion et la fermeture de session. Les administrateurs peuvent également activer le mode de maintenance pour les machines dotées d’une micro-app Mode administrateur.

Visionnez cette courte vidéo Tech Insight (98 secondes) illustrant la fonctionnalité :

Pour plus d’informations sur les micro-apps dans cette intégration, consultez la section Utiliser les micro-apps Citrix Virtual Apps and Desktops Service. Pour plus d’informations sur la mise à niveau de cette intégration de Citrix Virtual Apps and Desktops Service, reportez-vous à la section Mettre à niveau une intégration.

Étapes de déploiement

  1. Créez un client sécurisé qui est utilisé par l’intégration pour communiquer avec les API du service CVAD.
  2. Choisissez un emplacement approprié du proxy API pour l’URL du jeton.
  3. Collectez les informations requises qui doivent être renseignées dans la configuration de l’intégration.
  4. Ajoutez l’intégration du service CVAD et configurez-la.
  5. Abonnez les utilisateurs aux micro-apps pour qu’elles puissent être utilisées.

Vérifier les conditions préalables

Pour configurer cette intégration, vous devez activer Citrix Workspace avec le service de micro-apps et Citrix Virtual Apps and Desktops Service dans Citrix Cloud.

Ce modèle d’intégration prend en charge les VDA locaux et cloud si vous utilisez Citrix Virtual Apps and Desktops Service pour la négociation des connexions.

Cette intégration ne prend pas en charge les VDA établis à partir de l’instance CVAD locale. En effet, l’instance CVAD locale n’a pas d’API publiques disponibles, et cette intégration repose sur les API publiques du service CVAD.

Les valeurs que vous entrez lorsque vous configurez l’intégration du service CVAD dans les micro-apps Citrix Workspace sont les suivantes :

  • ID client : ID client utilisé lors de l’appel des API du service CVAD. Votre ID client se trouve dans Citrix Cloud sur la page Clients sécurisés.
  • URL du jeton : par défaut, il s’agit de l’URL du proxy de l’API aux États-Unis. Consultez Proxy API pour obtenir d’autres URL de proxy d’API régionales.
  • ID client : ID client créé sur le site Web Gestion des identités et des accès de Citrix Cloud. Ceci est nécessaire pour obtenir le jeton de porteur requis pour l’authentification auprès des API du service CVAD. Consultez Générer l’ID client et la clé secrète client.
  • Clé secrète client : clé secrète créée sur le site Web Gestion des identités et des accès de Citrix Cloud. Ceci est nécessaire pour obtenir le jeton de porteur requis pour l’authentification auprès des API du service CVAD.

Autorisations pour l’ID client et la clé secrète client (client sécurisé)

Lors de la création du client sécurisé à partir du site Gestion des identités et des accès, le compte avec lequel vous êtes connecté lors de la génération du client sécurisé doit disposer des autorisations Citrix Virtual Apps and Desktops Service suivantes :

  • Administrateur en lecture seule, Tous : permet d’extraire les données de Citrix Virtual Apps and Desktops Service.
  • Administrateur de session, Tous : permet d’effectuer des actions de déconnexion et de redémarrage.
  • Administrateur du service d’assistance, Tous : permet de d’activer et désactiver le mode de maintenance.

Les informations d’identification du client sécurisé héritent des autorisations de l’utilisateur connecté. Si les autorisations de l’utilisateur connecté lors de la création du client sécurisé sont modifiées, ces nouvelles autorisations s’appliquent également à l’intégration.

Générer l’ID client et la clé secrète client (client sécurisé)

Un ID client et une clé secrète client (client sécurisé) sont nécessaires pour obtenir le jeton de porteur requis pour l’authentification et l’utilisation des API du service CVAD.

Créez un client sécurisé à partir de la page Gestion des identités et des accès de Citrix Cloud et conservez un enregistrement de l’ID client et de la clé secrète client en toute sécurité. Vous aurez besoin de ces valeurs lors de la configuration de l’intégration.

Le nom du client sécurisé permet d’identifier rapidement le client. Pour cette intégration, un nom tel que « Micro-apps pour l’intégration CVAD » peut convenir. Ce nom n’est pas nécessaire pour configurer l’intégration du service CVAD.

Un ID client est composé de chiffres et de lettres, séparés par des traits d’union. Par exemple : 91132682-26af-460c-af73-18c0d2e95121

Une clé secrète client se présente comme suit : DTcs_w_akE6mKlberYMgtg==

Vous trouverez des instructions détaillées sur la création d’un client sécurisé à partir du guide de migration CVAD : Génération des ID client et de la clé secrète.

Choisir un proxy API

Citrix fournit des proxy API dans plusieurs régions. Choisissez un proxy le plus proche de la région dans laquelle réside votre instance Citrix Cloud :

  • États-Unis : https://api-us.cloud.com/cctrustoauth2//tokens/clients
  • Union Européenne : https://api-eu.cloud.com/cctrustoauth2//tokens/clients
  • Asie-Pacifique Sud : https://api-ap-s.cloud.com/cctrustoauth2//tokens/clients

Par défaut, la configuration de l’intégration est définie sur les États-Unis. Copiez et collez l’URL d’une autre région dans le champ URL du jeton si nécessaire.

Collecter les données de configuration à saisir

Lors de la configuration de l’intégration, vous aurez besoin des informations suivantes :

  1. ID client de l’instance Citrix Cloud
  2. ID client et clé secrète client générés lors de la création du client sécurisé
  3. URL du proxy de l’API à entrer dans le champ URL du jeton, si elle diffère du proxy États-Unis par défaut

Ajouter l’intégration

Ajoutez l’intégration Citrix Virtual Apps and Desktops Service aux micro-apps Citrix Workspace.

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 après y avoir abonné des utilisateurs ou des groupes.

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 Citrix Virtual Apps and Desktops Service.
  3. Cliquez sur Ajouter.
  4. À partir de la page Configuration :

    1. Enter your Customer ID in the Customer ID field. To find your customer ID, see Generating the customer ID.

      CVADS customer ID

    2. Confirm the Token URL field is the desired API Proxy URL collected earlier. This value is prefilled with the US API Proxy.
    3. In the Token URL field replace with your customer ID. For example, if the customer ID was acmecorp, the URL would look like: https://api-us.cloud.com/cctrustoauth2/acmecorp/tokens/clients
    4. Enter your Client ID, generated when the Secure Client was created
    5. Enter your Client secret. The client secret is the unique string issued with the Client ID when creating the Secure Client.

      CVADS token, id, secret fields

  5. Sélectionnez Enregistrer pour continuer.

Le service de micro-apps va maintenant se synchroniser avec les API du service CVAD et charger les données. Pour plus d’informations sur la synchronisation, reportez-vous à la section Synchroniser les données.

Abonner des groupes ou des utilisateurs aux micro-apps

Après avoir configuré l’intégration, les utilisateurs doivent être abonnés aux micro-apps pour les voir dans Workspace. Découvrez comment attribuer des abonnés.

Abonnez vos utilisateurs à chaque micro-app selon vos besoins. Toutefois, en règle générale, procédez comme suit :

  1. Abonnez tous les utilisateurs qui utilisent les applications virtuelles ou les bureaux virtuels aux micro-apps Mes sessions et Mes bureaux.
  2. Abonnez les administrateurs CVAD à la micro-app Bureaux virtuels (mode administrateur).

Utiliser les micro-apps CVAD

L’intégration Citrix Virtual Apps and Desktops Service est fournie avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Mes bureaux : permet de rechercher vos bureaux Citrix Virtual Desktops et d’effectuer des actions en libre-service à partir de Citrix Workspace, telles que le redémarrage.

Notification ou Page Workflows de cas d’utilisation
Page Détails du bureau virtuel Fournit une page contenant les détails du bureau, ainsi que les options Redémarrer bureau et Forcer redémarrage du bureau.
Page Bureaux virtuels Fournit une liste consultable des bureaux virtuels Citrix Virtual Desktops associés à l’utilisateur, ainsi qu’un lien vers la page Détails du bureau virtuel.

Mes sessions : permet de rechercher vos sessions Citrix Virtual Desktops et d’effectuer des actions en libre-service à partir de Citrix Workspace, telles que la déconnexion et la fermeture de session.

Notification ou Page Workflows de cas d’utilisation
Page Liste des sessions Fournit une liste consultable des sessions Virtual Desktops associées à l’utilisateur, ainsi qu’un lien vers la page Détails de la session.
Page Détails de la session Fournit une page contenant les détails de la session Virtual Desktop et de la machine, ainsi que les options Fermer session et Déconnecter session.

Bureaux virtuels (mode administrateur) : permet aux administrateurs CVAD Citrix Workspace de rechercher des machines, d’afficher leurs détails, de mettre les machines en mode de maintenance et de redémarrer les machines.

Notification ou Page Workflows de cas d’utilisation
Notification Une machine est défectueuse Lorsqu’un nouvel enregistrement d’une machine signale un état défectueux, tous les abonnés reçoivent une notification qui renvoie à la page Détails du bureau virtuel.
Page Liste des bureaux virtuels Fournit une liste consultable des bureaux Citrix Virtual Desktops, ainsi qu’un lien vers la page Détails du bureau virtuel. Vous pouvez effectuer une recherche par machine ou par utilisateur.
Page Détails du bureau virtuel Fournit une page contenant les détails du bureau, ainsi que les options Redémarrer bureau, Forcer redémarrage du bureau, Activer le mode Maintenance et Désactiver le mode Maintenance.

Mettre à niveau votre intégration

Si vous utilisez déjà l’intégration Citrix Virtual Apps and Desktops, utilisez ce processus pour effectuer une mise à niveau vers la dernière version. Avec ce processus, vous n’avez pas besoin de réabonner tous vos utilisateurs.

Améliorations :

  • L’ID du site est obtenu automatiquement.
  • Toutes les machines sont affichées (pas seulement les machines défectueuses).
  • La synchronisation incrémentielle est plus rapide. La synchronisation ne supprime pas les sessions supprimées. De plus, la synchronisation ne met pas à jour les machines, mais uniquement les sessions.
  • Ajout de mises à jour après des actions qui suppriment les sessions après la déconnexion, mettent à jour les sessions après la déconnexion et définissent l’état de redémarrage des machines.
  • Ajout d’une option permettant de mettre à jour les informations pour plus de détails sur les machines et les sessions afin que les utilisateurs puissent s’assurer que les informations visibles sont identiques à celles de Citrix Virtual Apps and Desktops Service.

Procédez comme suit :

  1. Téléchargez et ajoutez ce script dans l’onglet Scripting de votre ancienne intégration de Citrix Virtual Apps and Desktops Service.
    1. Dans l’écran de configuration de l’intégration, sélectionnez Scripting dans la navigation de gauche.
    2. Téléchargez ce script : Upgrade Citrix-Virtual-Apps-and-Desktops-service
    3. Sélectionnez Télécharger le script. Vous pouvez également saisir votre script directement dans la zone de texte en sélectionnant Modifier.
    4. Faites glisser votre script dans la fenêtre contextuelle d’importation. Sélectionnez Importer.
  2. Ajoutez la nouvelle intégration de Citrix Virtual Apps and Desktops Service à partir du catalogue de modèles fournis par Citrix, mais ne la configurez pas.
  3. Après avoir ajouté les intégrations, exportez chaque micro-app individuellement. Pour chaque micro-app, sélectionnez le menu en regard de la micro-app et sélectionnez Exporter. Effectuez cette procédure pour les trois micro-apps.
  4. Dans l’ancienne intégration (c’est-à-dire l’intégration que vous utilisez actuellement), importez les fichiers que vous avez exportés.
    1. Sélectionnez le menu en regard de la micro-app et sélectionnez Importer nouvelle version.
    2. Faites glisser ou parcourez votre ordinateur pour ajouter les fichiers correspondant à chaque micro-app.
    3. Activez la bascule Supprimer les fiches de flux existantes pour remplacer la micro-app d’origine.
    4. Sélectionnez Importer en bas de l’écran.
  5. Supprimez tous les points de terminaison de données, sauf les points de terminaison scriptés.
    1. Sélectionnez Modifier en regard de l’intégration.
    2. Sur la page Chargement des données, sélectionnez le menu en regard d’une intégration qui n’est pas scriptée, sélectionnez Supprimer, puis confirmez.
  6. Mettez à jour la configuration de l’intégration. Plus précisément, l’URL de base, l’ID client et le préfixe d’en-tête conformément aux instructions de la section Ajouter l’intégration. N’oubliez pas de sélectionner Enregistrer pour terminer la procédure.

Vous avez mis à niveau l’intégration Citrix Virtual Apps and Desktops.

Fonctionnement de l’intégration

L’intégration du service CVAD utilise les API REST Citrix Virtual Apps and Desktops, ainsi qu’un ID client et une clé secrète client Citrix Cloud (« client sécurisé ») pour fonctionner.

Les exigences liées à l’actualisation du jeton du porteur des API du service CVAD sont gérées par un proxy d’API fourni par Citrix. Le proxy d’API utilise l’ID client et la clé secrète client pour actualiser automatiquement le jeton du porteur, et utilise le jeton pour s’authentifier auprès des API du service CVAD lorsque des actions de micro-app sont effectuées ou que des données sont synchronisées.

Le service de micro-apps, qui fait partie de Citrix Workspace, synchronise les données des API du service CVAD, à l’aide du jeton du porteur du proxy d’API.

Les données synchronisées sont ensuite présentées dans Workspace via des micro-apps et permettent aux utilisateurs de Workspace d’effectuer des actions sur les sessions et les machines du service CVAD, en plus d’afficher des informations aux utilisateurs sur leurs sessions et leurs machines, le tout à partir de Workspace.

Documentation et ressources complémentaires

Accédez à la session Citrix Tech Zone Live couvrant l’intégration du service CVAD, y compris les origines des micro-apps, leurs actions, leur fonctionnement et une démonstration (~16 minutes) : Outils nécessaires aux utilisateurs pour mettre en libre-service leurs sessions VDI

Pour plus d’informations sur les points de terminaison d’API et les entités de table du service CVAD, consultez la section Spécifications du connecteur Citrix Virtual Apps and Desktops Service.