Micro-apps

Intégrer l’auto-certification Covid-19

Déployez l’intégration Auto-certification Covid-19 pour envoyer votre état d’auto-certification Covid-19 à l’aide de la réponse d’auto-certification de Citrix Workspace.

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 nos forums dédiés quotidiennement.

Pour de plus amples informations sur cette micro-app, consultez la section Utiliser les micro-apps Auto-certification Covid.

Vérifier les conditions préalables

Le pack d’application Podio Auto-certification COVID est requis pour cette intégration. Pour de plus amples informations, consultez la section Obtenir et configurer l’application Auto-certification Covid dans Citrix Podio.

Une fois l’intégration avec Auto-certification Covid-19 configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : https://api.podio.com
  • ID d’application Auto-certification Covid: entrez votre ID d’application Podio Workspace. Consultez Obtenir l’ID d’application et le jeton d’application.
  • ID de vue Auto-certification Covid: entrez votre ID de vue de l’application Podio Workspace. Consultez Obtenir l’ID de vue.
  • ID d’application Country Data : entrez votre ID d’application Country Data disponible dans l’application Auto-certification Covid-19. Consultez la section Obtenir l’ID d’application Country Data.
  • Méthode d’authentification : OAuth 2.0

    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.

  • Flux de type d’autorisation : code d’autorisation
  • Valeur du type d’autorisation : authorization_code
  • URL de rappel : https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  • Autorisation de jeton : corps de la requête
  • Type de contenu du jeton : formulaire codé en URL
  • URL d’autorisation : https://podio.com/oauth/authorize
  • URL du jeton : https://podio.com/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.
  • URL du jeton d’actualisation : SO
  • Portée : SO
  • État du relais : AUCUN
  • Paramètres du jeton d’accès : entrez le nom et les paramètres de valeur conformément aux instructions fournies ci-dessous :
    1. app_id : entrez votre ID d’application Podio Workspace. Consultez Obtenir l’ID d’application et le jeton d’application.
    2. app_token: entrez le jeton d’application Podio Workspace. Consultez Obtenir l’ID d’application et le jeton d’application.
    3. grant_type : application
  • Limitation du taux de demandes : 15 demandes par minute
  • Délai d’expiration des demandes : 120

Créer un compte de service

L’intégration nécessite un accès régulier à votre instance Auto-certification Covid. Nous vous recommandons donc de créer un compte utilisateur dédié. Ce compte doit être un administrateur ou un membre de l’application Podio Workspace Auto-certification Covid.

Pour ajouter plusieurs administrateurs/membres à l’application Podio Workspace Auto-certification Covid, accédez à la page Inviting and adding members to a Podio workspace.

Obtenir et configurer l’application Auto-certification Covid dans Citrix Podio

Le pack d’application Auto-certification COVID est requis pour cette intégration. Le pack d’application comprend l’application Auto-certification Covid et l’application Country Data. Installez ce pack d’application à partir de Podio App Market : COVID Self-Certification app pack.

Pour configurer l’application, procédez comme suit :

  1. Connectez-vous à votre instance Citrix Podio https://podio.com/ :
  2. Créez un espace de travail et donnez-lui un nom approprié.
  3. Ajoutez l’application Country Data à votre espace de travail et insérez les quatre champs suivants dans l’application Country Data :
    1. Region : ajoutez un composant Text nommé Region qui stocke le nom de la région.
    2. Countries : ajoutez un composant Text nommé Countries qui stocke les pays ou les villes de la région que vous souhaitez afficher auprès des utilisateurs,
    3. Guidelines : ajoutez un composant Text nommé Guidelines qui stocke les directives ou conditions que les utilisateurs doivent suivre.
    4. Image : ajoutez un composant Link nommé Image qui stocke toute image qui convient à votre région.
  4. Ajoutez l’application Auto-certification Covid dans votre espace de travail et insérez les six champs suivants dans l’application Auto-certification Covid :
    1. Name : ajoutez un composant Text nommé Name qui stocke le nom de l’employé/utilisateur.
    2. Email : ajoutez un composant Email nommé Email qui stocke l’e-mail de l’employé/utilisateur.
    3. Condition : ajoutez un composant Category nommé Condition et insérez deux options de catégorie : Agree et Disagree.
    4. CreatedOn : ajoutez un composant Date nommé CreatedOn qui stocke la date et l’heure acceptées/ignorées.
    5. Region : ajoutez un composant Text nommé Region qui stocke la valeur de région sélectionnée par l’utilisateur/employé.
    6. Country : ajoutez un composant Text nommé Country qui stocke la valeur de pays sélectionnée par l’utilisateur/employé.

Configurer l’application du client OAuth

  1. Connectez-vous au site Podio Developer en tant qu’administrateur de l’application Podio Workspace : https://developers.podio.com.
  2. Sélectionnez Generate Your API Key.
  3. Sélectionnez Get an API key now et renseignez les champs Application name et Domain conformément aux instructions ci-dessous.
    1. Application name : entrez le nom de votre application.
    2. Domain : entrez l’URL de votre instance de micro-apps dans le champ Full domain (without protocol) of your return URL. Cette section de l’URL {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
  4. Sélectionnez Generate API Key.
  5. Sous Your API keys, copiez et enregistrez les valeurs Client ID et Client Secret pour référence ultérieure.

Pour plus d’informations, consultez https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-client-id-and-client-secret.

Obtenir l’ID d’application et le jeton d’application

Obtenez l’ID d’application (App ID) et le jeton d’application (App Token) depuis Podio pour vous authentifier en tant qu’application plutôt qu’en tant qu’utilisateur. L’utilisation de l’ID d’application permet aux utilisateurs d’accéder uniquement aux données des applications dans l’espace de travail Podio associé. Vous obtenez cet ID à partir de l’application Podio pour l’espace de travail Podio. Si vous disposez de plusieurs applications dans un espace de travail, vous pouvez utiliser n’importe quel ID d’application affilié à l’espace de travail.

Procédez comme suit :

  1. Connectez-vous à Podio et accédez à votre application Podio.
  2. Sélectionnez l’icône Tools en regard du nom de l’application.
  3. Sous App, sélectionnez Developer.
  4. Copiez et enregistrez les champs App ID et Token. Vous entrez ces valeurs en tant que paramètres du jeton d’accès lorsque vous configurez l’intégration.

Pour plus d’informations, consultez https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-app-id-and-app-token.

Obtenir l’ID de vue

  1. Connectez-vous à Podio et accédez à votre application Podio.
  2. Passez la souris sur le champ spécifié ci-dessus pour afficher l’ID de vue en bas à gauche de votre page de navigateur. Pour l’auto-certification Covid-19, placez votre curseur sur Accepté/Non accepté et recherchez votre ID de vue dans le lien URL.

Pour plus d’informations, consultez https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-view-id.

Obtenir l’ID d’application Country Data

  1. Connectez-vous à Podio et accédez à votre application Podio.
  2. Sélectionnez l’icône Tools en regard du nom de l’application.
  3. Sous Country Data App, sélectionnez Developer.
  4. Copiez et enregistrez les champs App ID et Token. Vous entrez ces valeurs en tant que paramètres du jeton d’accès lorsque vous configurez l’intégration.

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

Ajoutez l’intégration Auto-certification Covid 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 Auto-certification Covid.
  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.podio.com.
    • Entrez votre ID d’application Podio.
    • Entrez votre ID de vue de l’application Workspace Podio.

    Configuration de l'auto-certification Covid

  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 Flux de type d’autorisation.
    2. Entrez authorization_code dans le champ Valeur du type d’autorisation.
    3. Entrez https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext dans le champ URL de rappel.
    4. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    5. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    6. Entrez https://podio.com/oauth/authorize dans le champ URL d’autorisation.
    7. Confirmez le champ URL du jeton. Cette valeur est pré-remplie : https://podio.com/oauth/token.
    8. Renseignez le champ ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez l’ID client et la clé secrète client lorsque vous avez généré une clé API. Consultez Configurer l’application du client OAuth.
    9. Renseignez le champ 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. Vous obtenez l’ID client et la clé secrète client lorsque vous avez généré une clé API. Consultez Configurer l’application du client OAuth.
  6. URL du jeton d’actualisation : SO
  7. Portée : SO
  8. État du relais : AUCUN

    Configuration de l'authentification pour l'auto-certification Covid

  9. Ajoutez les paramètres du jeton d’accès suivants. Pour de plus amples informations, consultez la section Obtenir l’ID d’application et le jeton d’application.
    1. app_id : entrez l’ID d’application Podio Workspace.
    2. app_token: entrez le jeton d’application Podio Workspace.
    3. grant_type : application

Configuration du jeton pour l'auto-certification Covid

  1. 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. Renseignez les champs Nom d’utilisateur du compte de service et Mot de passe du compte de service, puis sélectionnez Connexion.
    2. Sélectionnez Accepter.
  2. Entrez 15 demandes par minute dans le champ Limitation du taux de demandes.
  3. Entrez 120 dans le champ Délais d’expiration des demandes.
  4. Sélectionnez Enregistrer pour continuer.

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.

Remarque :

Nous vous recommandons de déclencher une synchronisation incrémentielle toutes les heures et une synchronisation complète deux ou trois fois par jour.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Auto-certification Covid-19.

Utiliser les micro-apps Auto-certification Covid-19

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.

Auto-certification : envoyez une réponse quotidienne liée à votre état d’auto-certification Covid-19 à partir de Citrix Workspace.

Notification ou Page Workflows de cas d’utilisation
Auto-certification Covid : Acceptée (notification de modification) Recevez des notifications de toutes les réponses d’auto-certification Covid-19 que vous avez acceptées.
Auto-certification Covid : Non acceptée (notification de modification) Recevez des notifications de toutes les réponses d’auto-certification Covid-19 que vous n’avez pas acceptées.
Nouvelle auto-certification : Acceptée (notification de nouvel élément) Recevez des notifications de toutes les réponses d’auto-certification Covid-19 que vous avez acceptées (nouvel utilisateur).
Nouvelle auto-certification : Non acceptée (notification de nouvel élément) Recevez des notifications de toutes les réponses d’auto-certification Covid-19 que vous n’avez pas acceptées (nouvel utilisateur).
Sélectionnez une région (page) Choisissez votre emplacement de travail.
Instructions d’auto-certification (page) Envoyez votre réponse pour l’auto-certification quotidienne.
Auto-certification acceptée (page) Affichez les détails des réponses acceptées pour l’auto-certification quotidienne.
Auto-certification confirmée (page) Affichez les détails des réponses acceptées pour l’auto-certification quotidienne à partir de votre flux de notification.
Auto-certification refusée (page) Affichez les détails des réponses que vous n’avez pas acceptées pour l’auto-certification quotidienne.
Auto-certification : Non acceptée (page) Permet d’afficher les détails des réponses d’auto-certification quotidienne que vous n’avez pas acceptées à partir de votre flux de notification.