Micro-apps

Intégrer Google Agenda

Déployez l’intégration Google Agenda pour planifier les événements de calendrier, ainsi que répertorier les événements et les heures de bureau d’un utilisateur à partir de n’importe quel appareil ou site intranet. Cette intégration fournit les quatre cas d’utilisation suivants :

  • Avec la micro-app Créer un événement, les utilisateurs peuvent organiser des réunions uniques ou périodiques, ajouter des invités et sélectionner différents fuseaux horaires. La micro-app envoie également un e-mail de suivi à tous les invités avec l’objet de l’événement correspondant pour une intégration facile du calendrier.
  • La micro-app Mon calendrier (Mois en cours) permet aux utilisateurs d’afficher tous les événements à venir du mois en cours.
  • Avec la micro-app Mes heures de bureau, les utilisateurs peuvent configurer les heures de bureau virtuelles ou répertorier toutes les heures de bureau du mois en cours de l’utilisateur.

Remarque :

Nous mettons à votre disposition deux modèles d’intégration Google Agenda. Ce nouveau modèle basé sur HTTPS (sous la catégorie Version préliminaire du catalogue) est plus flexible et performant pour configurer la structure de données mise en cache. Le modèle basé sur Java (sous la catégorie Intégrations du catalogue) fournit davantage de cas d’utilisation.

Pour plus d’informations sur les micro-apps prêtes à l’emploi pour Google Agenda, consultez la section Utiliser les micro-apps Google Agenda.

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.

Vérifier les conditions préalables

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

  • URL de base : https://www.googleapis.com/
  • URL du jeton : https://oauth2.googleapis.com/token
  • URL d’autorisation : https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
  • 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.

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 Google Meet : 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 Google Agenda. Nous vous recommandons donc de créer un compte utilisateur dédié. Ce compte doit disposer des autorisations suivantes :

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

  • Étendues requises pour le compte de service :

    https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user

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://workspace.google.com/intl/en/pricing.html

Activer les API

L’accès est activé pour les API Google Agenda via les services Web pour le compte payant par défaut.

Configurer OAuth

  1. Connectez-vous avec le compte de service à : https://console.cloud.google.com
  2. Sélectionnez API et services dans le menu de gauche.
  3. Sélectionnez le projet approprié dans la liste des projets du menu de navigation.
  4. Sélectionnez Activer les API et les services, puis activez toutes les API requises à partir de G-Suite. API recommandées : API Google Agenda et SDK Admin.
  5. Retournez à la page API et services, puis sélectionnez Écran d’autorisation OAuth sur l’écran de gauche.
  6. Sélectionnez Type d’utilisateur en fonction de vos besoins (nous vous recommandons l’option Interne), puis sélectionnez ****Créer**.
  7. Remplissez les champs requis, y compris Champs d’application requis pour le compte de service, et enregistrez les détails. Les champs d’application requis sont les suivants :

Configurer le serveur d’URL de rappel

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

  1. Connectez-vous avec le compte de service à : https://console.cloud.google.com
  2. Sélectionnez API et services dans le menu de gauche.
  3. Sélectionnez le projet approprié dans la liste des projets du menu de navigation.
  4. Sélectionnez Identifiants sur l’écran de gauche.
  5. Sélectionnez Créer des identifiants et sélectionnez ID client OAuth dans la liste.
  6. Sélectionnez Application Web dans la liste Type d’application, puis donnez-lui un nom.
  7. Sélectionnez Ajouter un URI sous URI de redirection autorisés.
  8. Entrez les URL de redirection autorisées suivantes pour cette intégration dans le champ URI :

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  9. Sélectionnez Créer.
  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 d’URL de rappel

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

  1. Connectez-vous avec le compte de service à : https://console.cloud.google.com
  2. Sélectionnez API et services dans le menu de gauche.
  3. Sélectionnez le projet approprié dans la liste des projets du menu de navigation.
  4. Sélectionnez Identifiants sur l’écran de gauche.
  5. Sélectionnez Créer des identifiants et sélectionnez ID client OAuth dans la liste.
  6. Sélectionnez Application Web dans la liste Type d’application, puis donnez-lui un nom.
  7. Sélectionnez Ajouter un URI sous URI de redirection autorisés.
  8. Entrez les URL de redirection autorisées suivantes pour cette intégration dans le champ URI :

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  9. Sélectionnez Créer.
  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 aux micro-apps Citrix Workspace

Ajoutez l’intégration Google Agenda aux micro-apps Citrix Workspace pour vous connecter à votre application. 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 Google Agenda.
  3. Donnez un nom à l’intégration.
    • Entrez l’URL de base de l’instance : https://www.googleapis.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.
  4. 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 Corps de la requête dans le menu Autorisation de jeton.
    3. L’URL d’autorisation est pré-remplie : https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    4. L’URL du jeton est pré-remplie : https://oauth2.googleapis.com/token
    5. Assurez-vous que les éléments suivants sont saisis sous Étendue : https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user
    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 collectez 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 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

  5. 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 Corps de la requête dans le menu Autorisation de jeton.
    4. L’URL d’autorisation est pré-remplie : https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    5. L’URL du jeton est pré-remplie : https://oauth2.googleapis.com/token
    6. Assurez-vous que les éléments suivants sont saisis sous Étendue : https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events
    7. 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 collectez 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.
    8. 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

  6. Activez l’option Activer la limitation du taux de demandes. Entrez 100 pour Nombre de demandes et 1 minute pour Intervalle de temps.
  7. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.

    Limitation de taux et journalisation

  8. Sélectionnez Enregistrer pour continuer.
  9. 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 Google.
    1. Entrez le nom d’utilisateur et le mot de passe de votre compte de service, puis sélectionnez Connexion.
    2. Sélectionnez Accepter.

    Autoriser

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 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.

Remarque :

Il est recommandé de définir l’intervalle « Synchronisation complète » sur Hebdomadaire pour retirer les événements annulés ou supprimés de la plate-forme de micro-apps, puis du calendrier de l’utilisateur.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Google Agenda.

Utiliser les micro-apps Google Agenda

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.

Remarque :

Les fuseaux horaires actuellement disponibles sont codés en dur dans la micro-app Créer un événement, Mes heures de bureau et Mon calendrier (Mois en cours). Par conséquent, si vous souhaitez ajouter tout autre fuseau horaire, l’administrateur doit les ajouter manuellement.

Créer un événement : permet de planifier un événement en fonction des préférences de l’utilisateur.

Notification ou Page Workflows de cas d’utilisation
Page Créer un événement Fournit un formulaire permettant de planifier un événement, ainsi que ses détails correspondants : Titre de l’événement, Lien de la vidéo Google Meet, Heure de début et de fin, Fuseau horaire, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle), Description, Lieu et Participants à l’événement.

Mon calendrier (Mois en cours) : permet d’afficher la liste des événements uniques et périodiques du mois en cours à venir et de modifier les événements.

Notification ou Page Workflows de cas d’utilisation
Page Détails de la notification d’événements Page détaillée qui affiche tous les détails appropriés d’un événement et inclut le bouton Participer pour démarrer la réunion. L’utilisateur peut également accéder à Google Agenda en sélectionnant Ouvrir mon calendrier.
Page Charger les événements Fournit une liste des événements de calendrier uniques et périodiques disponibles pour l’utilisateur, ainsi que le bouton Actualiser la liste pour actualiser la liste. Les utilisateurs peuvent afficher les détails de l’événement en cliquant sur les événements disponibles dans la liste.
Page Liste des événements Fournit une liste à jour des événements de calendrier uniques et périodiques disponibles pour l’utilisateur. Les utilisateurs peuvent afficher les détails de l’événement en cliquant sur les événements disponibles dans la liste.
Page Détails de l’événement Page détaillée qui affiche tous les détails appropriés de l’événement. L’utilisateur peut démarrer ou participer à la réunion en sélectionnant Participer et accéder à Google Agenda en sélectionnant Ouvrir mon calendrier.
Page Détails de l’événement de type « Toute la journée » Page détaillée qui affiche tous les détails appropriés des événements de type « Toute la journée ». L’utilisateur peut démarrer ou participer à la réunion en sélectionnant Participer et accéder à Google Agenda en sélectionnant Ouvrir mon calendrier.
Page Modifier l’événement unique Formulaire permettant de modifier l’événement unique.
Page Modifier l’événement périodique Formulaire permettant de modifier l’événement périodique existant.

Mes heures de bureau : permet de créer, modifier et afficher les heures de bureau.

Remarque :

Le bouton Actualiser est utilisé pour synchroniser le cache avec les données les plus récentes, au lieu d’une synchronisation complète ou incrémentielle.

Notification ou Page Workflows de cas d’utilisation
Page Créer des heures de bureau Fournit un formulaire permettant de créer des heures de bureau et d’ajouter les détails suivants : Heure de début et de fin, Fuseau horaire, Récurrence (Unique, Quotidienne, Hebdomadaire, Mensuelle).
Page Liste de mes heures de bureau Fournit une liste des heures de bureau de l’utilisateur, ainsi qu’un bouton Actualiser la liste/Charger mes heures pour mettre à jour/actualiser la liste. L’utilisateur peut ajouter des heures de bureau en sélectionnant Ajouter des heures de bureau.
Page Modifier mes heures de bureau Formulaire permettant de modifier les heures de bureau de l’utilisateur.