Micro-apps

Intégrer Citrix Virtual Apps and Desktops Service

Déployez l’intégration Citrix Virtual Apps and Desktops Service (CVAD) pour rechercher et exécuter des actions en libre-service à partir de votre instance Citrix Workspace. Les utilisateurs peuvent vérifier l’état de leurs machines associées. Effectuez 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.

Pour plus d’informations sur les micro-apps, 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 votre intégration.

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. Cette intégration n’est pas compatible avec une instance CVAD locale. Toutefois, ce modèle d’intégration prend en charge les VDA locaux si vous utilisez Citrix Virtual Apps and Desktops Service pour la négociation des connexions.

Les valeurs que vous entrez dans les micro-apps Citrix Workspace sont les suivantes :

  • URL de base : https://api.cloud.com/cvadapis/. Pour de plus amples informations, consultez API REST Citrix Virtual Apps and Desktops
  • ID client : ID client utilisé dans les API REST, requis pour accéder à toutes les API REST. Votre ID client se trouve dans Citrix Cloud. Pour trouver votre ID client, reportez-vous à la section Générer l’ID client.
  • URL du jeton : https://api-us.cloud.com/cctrustoauth2/{customerID}/tokens/clients. Consultez Proxy API.
  • 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 de toutes les API Rest. 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 de toutes les API Rest.
  • Préfixe d’en-tête : cette valeur est pré-remplie : CwsAuth bearer=

Autorisations

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.

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 :

  • Production (US) https://api-us.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients
  • Production (UE) https://api-eu.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients
  • Production (AP-S) https://api-ap-s.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients

Générer l’ID client et la clé secrète client

L’ID client et la clé secrète client (client sécurisé) sont nécessaires pour obtenir le jeton de porteur requis pour l’authentification de toutes les API Rest. Créez ces informations sur la page Gestion des identités et des accès Citrix Cloud. Pour plus d’informations, consultez Génération des ID client et de la clé secrète.

Ajouter l’intégration

Ajoutez l’intégration Citrix Virtual Apps and Desktops Service aux micro-apps Citrix Workspace. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. 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 Citrix Virtual Apps and Desktops Service.
  3. Donnez un nom d’intégration à l’intégration.
  4. Renseignez la section Paramètres du connecteur.
    • Entrez l’URL de base de l’instance : https://api.cloud.com/cvadapis/.
    • 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. Saisissez votre ID client. ID client utilisé dans les API REST, requis pour accéder à toutes les API REST. Votre ID client se trouve dans Citrix Cloud. Pour trouver votre ID client, reportez-vous à la section Générer l’ID client. Configuration CVAD 1

  6. 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 Informations d’identification du client dans le menu Flux de type d’autorisation.
    2. Entrez client_credentials dans le champ Valeur de type d’autorisation.
    3. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    4. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    5. Confirmez le champ URL du jeton. Cette valeur est pré-remplie : https://api-us.cloud.com/cctrustoauth2/{customerID}/tokens/clients
    6. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
    7. Entrez la Clé secrète client. La clé secrète client est une chaîne unique émise avec l’ID client.
    8. Le préfixe d’en-tête est pré-rempli : CwsAuth bearer=

    Configuration CVAD 2

  7. Dans le champ Limitation du taux de demandes, entrez 120.
  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Sélectionnez Enregistrer pour continuer.

    Configuration CVAD 3

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 Citrix Virtual Apps and Desktops Service.

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.
  • Non limité aux 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 : Mettre à niveau 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-application individuellement. Pour chaque micro-application, sélectionnez le menu en regard de la micro-application et sélectionnez Exporter. Effectuez cette procédure pour les trois micro-applications.
  4. Dans l’ancienne intégration (c’est-à-dire l’intégration que vous utilisez actuellement), importez les fichiers que vous venez d’exporter.
    1. Sélectionnez le menu en regard de la micro-application et sélectionnez Importer nouvelle version.
    2. Faites glisser et déposer ou parcourez votre ordinateur pour ajouter les fichiers correspondant à chaque micro-application.
    3. Activez la bascule Supprimer les fiches de flux existantes pour remplacer la micro-application 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.

Intégrer Citrix Virtual Apps and Desktops Service