Intégrer Citrix DaaS

Déployez l’intégration Citrix DaaS pour ajouter des micro-apps qui permettent aux utilisateurs d’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 de cette intégration, consultez la section Utiliser les micro-apps Citrix DaaS. Pour plus d’informations sur la mise à niveau de cette intégration Citrix DaaS, consultez Mettre à niveau votre 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, Citrix Workspace, les micro-appset Citrix DaaS doivent être activés dans Citrix Cloud.

Ce modèle d’intégration prend en charge les VDA locaux et dans le cloud si vous utilisez Citrix DaaS comme broker.

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 DaaS suivantes :

• Administrateur en lecture seule, Tous : permet d’extraire les données de Citrix DaaS.
• 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 DaaS » 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. Pa 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 DaaS 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.

Suivez ces étapes :

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 DaaS.
3. Cliquez sur Ajouter.

4. À partir de la page Configuration :

   1. Entrez votre ID de client dans le champ ID client. Pour obtenir votre ID client, consultez la section Générer l’ID client.

      

   2. Vérifiez que le champ URL du jeton correspond à l’URL de proxy de l’API souhaitée collectée précédemment. Cette valeur est pré-remplie avec le proxy de l’API aux États-Unis.
   3. Dans le champ URL du jeton, remplacez par votre ID client. Par exemple, si l’ID client est acmecorp, l’URL ressemblera à ce qui suit : https://api-us.cloud.com/cctrustoauth2/acmecorp/tokens/clients
   4. Entrez votre ID client, généré lors de la création du client sécurisé.

   5. Entrez la Clé secrète client. La clé secrète client est la chaîne unique émise avec l’ID client lors de la création du client sécurisé.

      

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 des micro-apps DaaS

L’intégration Citrix DaaS 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 DaaS.

Suivez ces étapes :

1. Téléchargez et ajoutez ce script dans l’onglet Script de votre ancienne intégration Citrix DaaS.
   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 Citrix DaaS à partir du catalogue de modèles fournis par Citrix, mais ne configurez pas l’intégration.
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, consultez la section Spécifications du connecteur d’état Citrix DaaS.