Micro-apps

Intégrer Zoom

Déployez l’intégration Citrix pour Zoom pour planifier des réunions depuis n’importe où et à partir de n’importe quel appareil ou site intranet. L’intégration pour Zoom permet aux utilisateurs de :

  • Créer des réunions uniques ou périodiques, ajouter des co-organisateurs et sélectionner différents fuseaux horaires. La micro-app fournit également les détails de l’invitation de la réunion qui est planifiée par l’utilisateur.
  • Afficher, modifier et démarrer les réunions créées.
  • Planifier des réunions Zoom pendant les heures de bureau.
  • Recevoir la notification d’enregistrement de réunion après la fin de la réunion et lire les enregistrements.

Remarque :

Votre avis nous intéresse ! Veuillez fournir vos commentaires pour ce modèle d’intégration au fur et à mesure que vous l’utilisez. Pour tout problème, notre équipe surveille également notre forum dédié quotidiennement.

Pour plus de détails sur la micro-app prête à l’emploi pour Zoom, consultez la section Utiliser des micro-apps pour Zoom.

Vérifier les conditions préalables

Ces conditions préalables supposent que l’administrateur fait partie de la configuration d’intégration Zoom de l’organisation. Ce compte administrateur Zoom doit disposer de privilèges de lecture complets sur les informations de l’utilisateur. Une fois l’intégration avec Zoom configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : https://api.zoom.us/v2/
  • URL d’autorisation : https://zoom.us/oauth/authorize
  • URL du jeton : https://zoom.us/oauth/token
  • ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
  • Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

Remarque :

Nous vous recommandons 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.

Configurez Citrix Gateway pour prendre en charge l’authentification unique pour Zoom : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-On), consultez Citrix Gateway Service https://docs.citrix.com/en-us/citrix-gateway-service/.

L’intégration nécessite un accès régulier à votre instance Zoom. Nous vous recommandons donc de créer un compte utilisateur dédié. Vous pouvez afficher les permission/privilèges en accédant à https://marketplace.zoom.us/docs/api-reference/other-references/privileges. Ce compte doit disposer des autorisations suivantes :

  • Autorisations requises pour le compte de service : privilèges administrateur complets

Le nombre de requêtes d’API pouvant être exécutées sur des ressources spécifiques est limité. Nous recommandons donc ce qui suit :

Créer un compte de service

Connectez-vous ici : https://zoom.us/signin. Reportez-vous à l’URL ci-dessous pour les nouveaux comptes de service : https://marketplace.zoom.us/docs/guides/getting-started.

Configurer le serveur OAuth

Configurez le serveur OAuth pour lire les données via l’intégration Zoom.

  1. Connectez-vous avec votre compte de service à : https://marketplace.zoom.us/.
  2. Sélectionnez le menu déroulant Develop en haut à droite.
  3. Sélectionnez Build App.
  4. Sélectionnez Create pour l’application OAuth et choisissez le type d’application comme Account-Level App.
  5. Désactivez l’option permettant de publier l’application sur le site Marketplace et sélectionnez Create.
  6. Entrez les URL de redirection autorisées suivantes pour cette intégration dans les champs Redirect URL et Whitelist URL. Sélectionnez Continue.

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  7. Renseignez les champs requis, puis sélectionnez Continue.
  8. Sous la section Scopes, sélectionnez Add Scopes et sélectionnez les étendues associées à Meeting, Recording et User. Sélectionnez Done.
  9. Sélectionnez Install. Un nouvel onglet s’ouvre pour autoriser l’application. Sélectionnez Authorize et fermez l’onglet.
  10. Copiez et enregistrez les champs ClientId et Secret affichés à l’écran. Vous utilisez ces détails pour l’authentification du service lors de la configuration de l’intégration.

Configurer le client OAuth

Configurez le client OAuth pour écrire les données via l’intégration Zoom.

  1. Connectez-vous avec votre compte de service, comme ci-dessus : https://marketplace.zoom.us/.
  2. Sélectionnez le menu déroulant Develop en haut à droite.
  3. Sélectionnez Build App.
  4. Sélectionnez Create pour l’application OAuth et choisissez le type d’application comme User-Managed App.
  5. Désactivez l’option permettant de publier l’application sur le site Marketplace et sélectionnez Create.
  6. Entrez les URL de redirection autorisées suivantes pour cette intégration dans les champs Redirect URL et Whitelist URL. Sélectionnez Continue.

    • <https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
  7. Renseignez les champs requis, puis sélectionnez Continue.
  8. Sous la section Scopes, sélectionnez Add Scopes et sélectionnez les étendues associées à Meeting, Recording et User. Sélectionnez Done.
  9. Sélectionnez Install. Un nouvel onglet s’ouvre pour autoriser l’application. Sélectionnez Authorize et fermez l’onglet.
  10. Copiez et enregistrez les champs ClientId et Secret affichés à l’écran. Vous utilisez ces détails pour l’authentification des actions de service lors de la configuration de l’intégration.

Ajouter l’intégration

Ajoutez l’intégration Réunion Zoom aux micro-apps Citrix Workspace pour vous connecter à votre application. 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 Réunion Zoom.
  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.zoom.us/v2/.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.

    Nom et URL de base

  5. 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 Code d’autorisation dans le menu Type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application.
    2. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
    3. L’URL d’autorisation est pré-remplie : https://zoom.us/oauth/authorize
    4. L’URL du jeton est pré-remplie : https://zoom.us/oauth/token
    5. Assurez-vous que les éléments suivants sont saisis sous Étendue : meeting:read:admin,recording:read:admin,user:read:admin meeting:read,meeting:write

      Remarque :

      Pour activer la micro-app Créer une réunion ; meeting:read,meeting:write, meeting:read:admin Pour activer la micro-app Réunions à venir (semaine en cours) ; meeting:read,meeting:write, meeting:read:admin Pour activer la micro-app Mes heures de bureau ; meeting:read,meeting:write, meeting:read:admin Pour activer la micro-app Enregistrements de réunions ; recording:read:admin

    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. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le serveur OAuth. Vous devez ajouter l’URL de rappel que vous voyez sur la page de configuration de l’intégration.
    7. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

    Authentification du service

  6. Sous Authentification des actions de service, activez Utiliser authentification utilisateur distincte dans Actions. L’authentification des actions de service s’authentifie au niveau de l’action de service. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.

    1. Sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
    2. Sélectionnez Code d’autorisation dans le menu Type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application.
    3. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
    4. L’URL d’autorisation est pré-remplie : https://zoom.us/oauth/authorize
    5. L’URL du jeton est pré-remplie : https://zoom.us/oauth/token
    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. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le client OAuth. Vous devez ajouter l’URL de rappel que vous voyez sur la page de configuration de l’intégration.
    7. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

    Authentification des actions de service

  7. Activez l’option Activer la limitation du taux de demandes. Entrez 55 pour Nombre de demandes et 1 seconde pour Intervalle de temps.

    Limitation de taux et journalisation

  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Sélectionnez Enregistrer pour continuer.
  10. Sous Autorisation OAuth, sélectionnez Autoriser pour vous connecter avec votre compte de service. Une fenêtre contextuelle apparaît avec un écran de connexion Zoom.
    1. Entrez le nom d’utilisateur et le mot de passe de votre compte de service, puis sélectionnez Connexion.
    2. Sélectionnez Accepter. Authentification du service

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation. Pour plus d’informations, consultez Vérifier les entités requises. 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 HTTP Zoom. Pour plus d’informations sur la gestion de l’accès et des abonnés, consultez la section Attribuer des abonnés. Pour supprimer une intégration, sur la page Intégrations de micro-apps, sélectionnez le menu en regard de l’intégration que vous souhaitez désinstaller. Sélectionnez Supprimer intégration, puis confirmez votre sélection.

Utiliser des micro-apps pour Zoom

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Créer une réunion : permet de planifier des réunions en fonction des préférences de l’utilisateur. L’utilisateur peut choisir le titre de la réunion, la durée, la date de début, les co-organisateurs, etc.

Notification ou Page Workflows de cas d’utilisation
Page Créer une réunion Fournit un formulaire permettant de planifier une réunion et d’ajouter les détails suivants selon la préférence de l’utilisateur : Titre de la réunion, Heure de début, Durée, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle), Mot de passe, Co-organisateurs, Numéros d’appel pour la réunion.
Page Nouvelles réunions uniques Cette page affiche le message de réussite pour les réunions créées avec le bouton Afficher les détails pour les réunions uniques.
Page Nouvelles réunions périodiques Cette page fournit le message de réussite pour les réunions créées avec un bouton Afficher les détails pour les réunions périodiques.
Page Invitations Fournit instantanément les détails de l’invitation de la réunion après sa création, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, Détails des occurrences, URL de participation, Heure de début, ID de réunion, Numéros d’appel.

Réunions à venir (Semaine en cours) : permet d’afficher toutes les réunions à venir de la semaine en cours. L’utilisateur peut modifier et démarrer la réunion.

Notification ou Page Workflows de cas d’utilisation
Notification Rappel de réunion ponctuelle Lorsque la réunion unique commence dans moins d’une heure, l’organisateur de la réunion reçoit une notification.
Notification Rappel de réunion périodique Lorsque la réunion périodique commence dans moins d’une heure, l’organisateur de la réunion reçoit une notification.
Page Toutes les réunions Fournit des informations sur toutes les réunions à venir (réunions uniques et périodiques) pour la semaine en cours avec l’option de recherche permettant de filtrer les réunions en fonction du sujet de la réunion.
Page Détails de la réunion ponctuelle Fournit les détails de l’invitation de la réunion unique à venir, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, URL de participation, Heure de début, ID de réunion, Numéros d’appel avec les boutons d’option Modifier et Démarrer.
Page Détails de la réunion périodique Fournit les détails de l’invitation de la réunion périodique à venir, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, Détails des occurrences, URL de participation, Heure de début, ID de réunion, Numéros d’appel avec les boutons d’option Modifier et Démarrer.
Page Modifier la réunion ponctuelle Fournit un formulaire permettant de modifier une réunion unique et d’ajouter les détails suivants selon la préférence de l’utilisateur : Titre de la réunion, Heure de début, Durée, Fuseau horaire, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle), Mot de passe, Co-organisateurs pour la réunion.
Page Modifier la réunion périodique Fournit un formulaire permettant de modifier une réunion périodique et d’ajouter les détails suivants selon la préférence de l’utilisateur : Titre de la réunion, Heure de début, Durée, Fuseau horaire, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle), Mot de passe, Co-organisateurs pour la réunion. L’option permettant d’enregistrer cette occurrence et d’enregistrer toutes les occurrences est également disponible.
Page Rappel de réunion ponctuelle Fournit les détails de l’invitation de la réunion unique à venir, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, URL de participation, Heure de début, ID de réunion, Numéros d’appel avec les boutons d’option Démarrer et Fermer.
Page Rappel de réunion périodique Fournit les détails de l’invitation de la réunion périodique à venir, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, URL de participation, Heure de début, ID de réunion, Numéros d’appel avec les boutons d’option Démarrer et Fermer.

Mes heures de bureau : permet de planifier la réunion pendant les heures de bureau selon les préférences. L’utilisateur peut choisir la durée, la date de début, les numéros d’appel, etc.

Notification ou Page Workflows de cas d’utilisation
Heures de bureau virtuelles Fournit les détails de la réunion planifiée pendant les heures de bureau dans le tableau pour le mois en cours. Cette page aide également l’utilisateur à créer les heures de bureau si l’utilisateur n’a pas planifié de réunions pour le mois en cours.
Configuration des heures virtuelles Fournit un formulaire permettant de planifier une réunion pendant les heures de bureau et d’ajouter les détails suivants selon la préférence de l’utilisateur : Heure de début, Date, Durée, Fuseau horaire, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle), Mot de passe, Numéros d’appel pour la réunion.
Nouvelle réunion Affiche le message de réussite une fois la réunion créée avec succès à l’aide du bouton « Afficher les détails »
Invitations Fournit instantanément les détails de l’invitation de la réunion après sa création, tels que Sujet de la réunion, Mot de passe, Détails du calendrier, Détails des occurrences, URL de participation, Heure de début, ID de réunion, Numéros d’appel.
Modifier les heures de bureau Permet de modifier la réunion planifiée pendant les heures de bureau selon les préférences de l’utilisateur pour les champs suivants : Heure de début, Durée, Date.

Enregistrements de réunion : permet de visualiser tous les enregistrements de réunion pour les sept derniers jours. Elle permet également aux utilisateurs de lire des enregistrements depuis n’importe quel appareil.

Notification ou Page Workflows de cas d’utilisation
Notification Enregistrements de réunion Lorsqu’un nouvel enregistrement de réunion est disponible, l’organisateur de la réunion reçoit une notification.
Page Table d’enregistrement Fournit un tableau affichant tous les enregistrements de réunion de l’organisateur pour les sept derniers jours.
Détails de l’enregistrement Fournit des informations détaillées de l’enregistrement, telles que Sujet de la réunion, Date, Heure, URL de téléchargement avec le bouton d’option Lire l’enregistrement.
Intégrer Zoom