Comment configurer une application d'accès invité

Sommaire :

  1. Qu’est-ce qu’une Guest Access App ?
  2. Création de la Guest App

1. Qu’est-ce qu’une Guest Access App ?

Microshare permet de fournir un accès contrôlé aux applications/tableaux de bord pour des utilisateurs anonymes (non authentifiés). Cela est souhaitable dans les situations où le grand public est invité à interagir avec les données. Cela ne doit être utilisé que pour des données destinées à une diffusion publique générale (données vertes).

Pour que cela fonctionne, un objet « Link To » est créé par le propriétaire de l’application, qui fournit un pointeur vers un actif accessible via une URL non authentifiée /guest. L’URL guest utilise l’identifiant de l’objet Link To pour déterminer le comportement attendu.

L’invité apparaîtra au système (APP et API) comme guest@microshare.net. Des règles de partage peuvent être créées pour rendre accessibles des actifs au-delà de l’application/du formulaire. Cela permet d’exploiter les vues et les partages. L’écriture de données dans le système via les commandes POST du serveur API est également possible dans la guest app. Les données créées seront la propriété de l’utilisateur guest@microshare.net avec l’organisation du propriétaire de l’application.

2. Création de la Guest App

  1. S’authentifier (via l’API Dauth) en tant que propriétaire de l’application/vue/données (ou un utilisateur partagé).
  2. Utiliser l’API dapp /links2 pour créer une entrée dans la collection links.
    • POST https://dapp.microshare.io/links2?Authorization=<sessionkey> Note : ceci est différent de l’utilisation du Bearer token dans l’en-tête authorization.
    • Les paramètres pour ce POST sont () raw puis choisir JSON dans le menu déroulant text.
    • Le sessionkey est utilisé via le paramètre de requête Authentication.
    • targetId : app id
    • Email : guest@microshare.net
    • targetType : app
    • Utiliser le corps d’exemple
{"name":"Feedback App Test", "recType":"pipe", 

"desc":"Link toFeedback App Test",  

"data":{ "email" : "guest@microshare.net", "targetId" : "5e6ce6b62b0000636ad81a38" , "targetType" : "app"}  

}

Note : veillez à utiliser .net et non .io pour l’email

  1. Récupérer l’id renvoyé par l’appel link ci-dessus.
    • Exemple de Product Suite dans le compte assets : 5e73b63d3a00002a934523d4.
    • Exemple d’application Touchless Feedback dans le compte assets : 5e77ac483a0000df97452437.
  2. Composer une URL https://dapp.microshare.io/guest/<linkid>?optional-query-string=optional.
    • Exemple d’URL pour Product Suite dans le compte assets : https://dapp.microshare.io/guest/5e73b63d3a00002a934523d4.
  3. Copier ce lien.
  4. Pour toute vue, créer des règles qui partagent des « filtered objects » avec guest@microshare.net avec les droits Execute.
  5. Pour consulter les données créées par un utilisateur invité interagissant avec un lien vers l’application, vous devez également créer une règle qui partage ces données depuis guest@microshare.net vers l’organisation (un administrateur d’organisation).


CGAG1


CGAG2


CGAG3


CGAG4

Cette documentation vous a-t-elle été utile ?

Pour toute question ou assistance supplémentaire, contactez-nous à support@microshare.io

ms logo