Gestion des jetons de connexion
Un jeton de connexion est une manière d'accéder à l'application, via le compte d'un utilisateur, sans avoir à fournir ses identifiants.
Cette fonctionnalité est communément utilisé pour réaliser des cartes ou applications publiques (sans avoir à renseigner des informations de connexion).
Utilité
Un jeton de connexion permet :
D'utiliser l'API
D'utiliser vMap comme un utilisateur normal mais sans que ce dernier ait la nécessité de se loguer à l'application (carte publique)
D'utiliser vMap sous forme de widget (intégrer vMap dans un site web).
Création d'un jeton
Il est possible de créer un jeton de connexion depuis le bouton Ajouter présent dans le mode "Utilisateurs" > "Jetons de connexion".
Les informations demandées permettent ainsi de définir :
- Le nom du jeton de connexion
- S'il possède une date limite de fonctionnement
- Un login et mot de passe utilisateur permettant à l'application de se connecter en tant que l'utilisateur renseigné
- Et enfin une restriction de ce jeton sur une IP précise.
Exemples d'utilisation
Utilisation d'un jeton dans l'API de vMap
Il est possible, via un jeton utilisateur, de récupérer un jeton de connexion, permettant d'utiliser l'API de vMap2.
Pour ce faire, il faut tout d'abord récupérer le champ ID au niveau du token dans la liste :
Il est ensuite possible d'obtenir un token d'authentification en requêtant la route vitis/privatetoken avec le jeton dans l'header Authorization :
Celui-ci peut ensuite être utilisé dans le reste des routes de l'API, dans le token Authorization, et permet de se servir de l'API comme une connection utilisateur/mot de passe classique :
Utilisation d'un jeton pour réaliser une "carte publique"
Pour réaliser une connexion publique (sans couple login / mot de passe à renseigner) dans vMap, il est nécessaire de mettre en place un jeton de connexion et de renseigner ce jeton
Pour ce faire, 2 propriétés sont à paramétrer dans la section Authetification du mode Configuration > Général..
Une fois ces informations mises en place, il est possible d'accéder à l'application sans connexion de l'utilisateur.
Exemple d'application avec le mode public
Utilisation d'un jeton pour réaliser un "widget carte"
Dans vMap2, il est également possible de créer un widget de type carte permettant d'intégrer des cartes dans d'autres applications WEB.
Pour fonctionner, les widgets nécessitent un jeton de connexion existant.
Pour créer un widget, éditer une carte depuis le mode Cartes et Couches > Cartes de l'application :
Se rendre dans la section Appel externe, y ajouter un nouvel enregistrement et y renseigner les informations demandées, notamment le jeton de connexion (indirectement le login de l'utilisateur) qui sera utilisé lors de chaque utilisation du widget :
Une fois créé, l'application génère un code HTML qu'il suffit de copier / coller à l'endroit souhaité sur le site web :
