Micro-apps

Intégrer GoToMeeting

Déployez l’intégration Citrix pour GoToMeeting pour planifier des réunions GoToMeeting à partir de n’importe quel appareil ou site intranet. Avec la micro-app Créer une réunion de GoToMeeting, n’importe quel utilisateur peut organiser des réunions uniques.

Remarque :

Ce modèle d’intégration se trouve en version préliminaire et est marqué comme Aperçu dans la liste des modèles disponibles affichés dans le produit lors de l’ajout d’une nouvelle intégration. Lorsqu’un modèle est en version préliminaire, nous ne nous engageons pas à fournir un service de support ; le support est fourni par le développeur de la manière la plus optimale possible. Les modèles d’intégration en version préliminaire sont partagés à des fins de test et de validation. Nous ne conseillons pas de les déployer dans des environnements de production. Pour de plus amples informations, consultez la section Déclaration de maintenance pour les modèles d’intégration de micro-apps.

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

Pour obtenir une liste complète des micro-apps GoToMeeting prêtes à l’emploi, consultez la section Utiliser les micro-apps GoToMeeting.

Vérifier les conditions préalables

Ces conditions préalables supposent que l’administrateur fait partie de la configuration d’intégration GoToMeeting de l’organisation. Ce compte administrateur GoToMeeting doit disposer de privilèges de lecture complets sur les informations de l’utilisateur.

Une fois l’intégration avec GoToMeeting configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace, en particulier la liste suivante de paramètres pour configurer l’intégration OAuth :

  • URL de base : https://api.getgo.com/
  • URL d’autorisation : https://api.getgo.com/oauth/v2/authorize
  • URL du jeton : https://api.getgo.com/oauth/v2/token
  • ID du client : l’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
  • Clé secrète client : la clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
  • ID de compte : cette valeur remplace le paramètre your_accountId du point de terminaison Tous les organisateurs. Consultez Obtenir l’ID de compte.

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 GoToMeeting : 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 la section Citrix Gateway Service.

L’intégration nécessite un accès régulier à votre instance GoToMeeting. Nous vous recommandons donc de créer un compte utilisateur dédié. Vous pouvez afficher les permission/privilèges en accédant à https://goto-developer.logmeininc.com/admin/#section/Overview/Users-Roles-Licenses-and-Groups.

  • 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 :

Activer les API

Les API GoToMeeting sont activées par défaut via les services Web pour les comptes payants.

Créer un compte de service

Inscrivez-vous ici : https://developer.goto.com/. Pour plus d’informations sur les nouveaux comptes de service, consultez https://support.goto.com/meeting/new-gotomeeting-guide.

Configurer le serveur OAuth

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

  1. Connectez-vous avec votre compte de service à : https://developer.goto.com/GoToMeetingV1.
  2. Sélectionnez OAuth Clients dans la barre de navigation supérieure.
  3. Sélectionnez Create a new client.
  4. Remplissez les détails et entrez les URL de redirection autorisées suivantes pour cette intégration dans le champ Redirect URL :

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  5. Sous la section Scopes, cochez la case Scopes.
  6. Sélectionnez Enregistrer.
  7. 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 GoToMeeting.

  1. Connectez-vous avec votre compte de service, comme ci-dessus : https://developer.goto.com/GoToMeetingV1.
  2. Sélectionnez OAuth Clients dans la barre de navigation supérieure.
  3. Sélectionnez Create a new client.
  4. Remplissez les détails et entrez les URL de redirection autorisées suivantes pour cette intégration dans le champ Redirect URL :

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  5. Sous la section Scopes, cochez la case Scopes.
  6. Sélectionnez Enregistrer.
  7. 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.

Obtenir l’ID de compte

Obtenez l’ID de compte et utilisez cette valeur pour remplacer le paramètre your_accountId dans le point de terminaison Tous les organisateurs.

  1. Connectez-vous à l’aide des informations d’identification administrateur sur https://admin.logmeininc.com/portal/.
  2. Identifiez l’URL sur la page d’accueil. L’ID de compte se trouve à l’aide de ce modèle : https://admin.logmeininc.com/portal/#accounts/<accountID>/users?filterType=usertype
  3. Copiez et enregistrez l’ID de compte pour l’utiliser pendant le processus de configuration. Consultez Remplacer la valeur Chargement des données.

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration GoToMeeting 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 GoToMeeting.
  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.getgo.com/.
    • 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://api.getgo.com/oauth/v2/token
    4. L’URL du jeton est pré-remplie : https://api.getgo.com/oauth/v2/authorize
    5. Saisissez votre ID client. L’ID du client permet de définir 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.
    6. Entrez la Clé secrète client. La clé secrète client permet de définir 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://api.getgo.com/oauth/v2/token
    5. L’URL du jeton est pré-remplie : https://api.getgo.com/oauth/v2/authorize
    6. Saisissez votre ID client. L’ID du client permet de définir 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 permet de définir 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 100 pour Nombre de demandes et 1 minute 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 Webex.
    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

Remplacer la valeur Chargement des données

Remplacez le paramètre your_accountId dans le point de terminaison Tous les organisateurs. Utilisez la valeur d’ID de compte que vous avez obtenue lors du processus Obtenir l’ID de compte.

  1. Sur la page Intégrations de micro-apps, sélectionnez le menu en regard de l’intégration GoToMeeting, puis Modifier. L’écran Chargement des données s’ouvre. Si vous êtes sur l’écran de configuration, sélectionnez Chargement des données dans la colonne de navigation gauche.
  2. Sélectionnez le menu en regard du point de terminaison Tous les organisateurs, puis sélectionnez Modifier ou sélectionnez le nom du point de terminaison : Tous les organisateurs.
  3. Sur l’écran Modifier le point de terminaison de données, recherchez la valeur comme indiqué dans la capture d’écran. Remplacez cette valeur par l’ID de compte que vous avez obtenu précédemment.
  4. Sélectionnez Appliquer en bas de l’écran et confirmez vos sélections.

    Limitation de taux et journalisation

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 de plus amples informations, consultez la section 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 GoToMeeting.

Utiliser les micro-apps GoToMeeting

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 une réunion en fonction des préférences de l’utilisateur. Les utilisateurs peuvent sélectionner la date, l’heure de début et l’heure de fin, le mot de passe et les co-organisateurs.

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 en fonction des préférences de l’utilisateur : Objet de la réunion, Heure de début et de fin, Mot de passe et Co-organisateurs de la réunion.
Page Nouvelle réunion Fournit un message de réussite ainsi qu’une option permettant d’afficher les détails de la réunion (à l’aide d’un bouton Afficher les détails) une fois qu’une réunion est planifiée avec succès.
Page Détails de la réunion Fournit des informations détaillées sur la réunion planifiée par l’utilisateur.