Les jetons d'authentification permettent un accès sécurisé et programmatique à EarthRanger pour les intégrations et la communication API. Ce guide explique comment créer un jeton d'authentification et l'utiliser avec vos comptes de service.

Prérequis : Compte de service
 

Pour créer un jeton d'authentification, vous devez d'abord configurer un compte de service avec les autorisations appropriées. Si vous n'avez pas encore configuré de compte de service, suivez les étapes décrites dans la section Création et gestion des comptes de service.
 

Étape 1 : Créer un jeton d’authentification

1. Accéder à la page des jetons d'accès DAS
   1. Connectez-vous à la page d'administration d'Earthranger.
2. Accédez à Configuration DAS > Jetons d'accès DAS.
   1. Ajouter un nouveau jeton d'accès
   2. Cliquez sur « Ajouter un jeton d'accès » en haut à droite.
3. Générer le jeton
   1. Saisissez une chaîne alphanumérique aléatoire de 40 caractères comme jeton. Cela signifie que vous devez utiliser uniquement des lettres (A-Z, a-z) et des chiffres (0-9), en évitant les caractères spéciaux comme @, # ou %.
4. Vous pouvez :
   1. Utiliser un outil de randomisation en ligne, tel que Random Alphanumeric Generator.
   2. Assurez-vous que le résultat est limité aux lettres et aux chiffres.
   3. Modifier manuellement un jeton existant pour créer un caractère aléatoire en remplaçant plusieurs caractères par de nouvelles valeurs alphanumériques.
5. Définir la date et l'heure d'expiration
   1. Sélectionnez la date d'expiration du jeton d'authentification (par exemple, 2049-01-01)
   2. Ou choisissez une date dans le calendrier.
   3. Sélectionnez « Maintenant » dans le créneau horaire.
   4. Définir les détails du périmètre
6. Saisissez « lecture-écriture » ​​dans le champ « Périmètre ».
   1. Sélectionnez l'utilisateur du jeton.
7. Cliquez sur l'icône de recherche à côté de « Utilisateur ».
   1. Recherchez le compte de service concerné (par exemple, « Compte de service d'intégration »).
   2. Sélectionnez le compte de service.
   3. Définir l'application du jeton
8. Sélectionnez l'application associée à ce jeton. Si l'application n'existe pas, contactez un membre de l'équipe d'assistance qui pourra vous aider à créer l'application DAS.
9. Une fois les informations complétées, cliquez sur « Enregistrer ».

Étape 2 : Livrer/utiliser le jeton d'authentification

Une fois le jeton d’authentification créé :

1. Distribuer le jeton en toute sécurité
   1. Fournir le jeton à l'application ou à l'intégration concernée (par exemple, Gundi, accès API).
   2. Vérifier que le jeton est stocké de manière sécurisée afin d'empêcher tout accès non autorisé.
2. Intégrer le jeton
3. Utiliser le jeton dans la configuration de l'API ou de l'intégration, selon les besoins.
   1. Consultez la documentation de l'intégration pour plus de détails sur la mise en œuvre.

Pour plus de détails sur la création de comptes de service, reportez-vous à Création et gestion des comptes de service

Si vous avez besoin d’aide pour gérer d’autres types d’utilisateurs, consultez Gestion des utilisateurs dans EarthRanger Admin.