Cette page décrit comment générer ou régénérer un jeton API pour un utilisateur API.
Note : La page Administrateur de domaine n'est accessible qu'aux utilisateurs ayant l'accès Administrateur. Voir Niveau d'accès.
Un jeton est une donnée qui n'a pas de signification ou d'utilisation en soi, mais combinée avec le bon système de segmentation, devient un acteur essentiel dans la sécurisation de votre application. L'authentification basée sur les jetons fonctionne en garantissant que chaque demande adressée à un serveur est accompagnée d'un jeton signé dont le serveur vérifie l'authenticité et ne répond qu'alors à la demande.
Un jeton est requis pour un utilisateur de l'API lors de l'accès à l'API REST de Broadsign Publish. Consultez API REST de Broadsign Publish pour plus d'information.
Vous pouvez générer un jeton lors de la création d'un utilisateur ou lors de la mise à jour d'un utilisateur existant.
L'accès à un jeton persistera jusqu'à ce qu'un nouveau soit généré.
Pour générer un jeton API :
-
Dans l'interface Broadsign Publish, cliquez le lien Publish Admin en haut à droite de la fenêtre.
Le Tableau de bord du domaine s'ouvre :
- Sous Comptes, cliquez sur Utilisateurs API. La page Utilisateurs API s’ouvre.
- Sur la page Utilisateurs API, cliquez sur le nom de l’utilisateur pour lequel générer un jeton.
- Cliquez sur le bouton Générer un jeton API.
- Copiez le jeton.
- Une fois la clé copiée, cliquez sur Fermer.
La page Modifier utilisateur API s'ouvre.
Cela génère un jeton que l'utilisateur peut utiliser pour accéder à l'API REST de Broadsign Publish.
Attention : Le jeton d'API est généré et visible une seule fois, assurez-vous donc de le copier ou de le noter avant de fermer la fenêtre.
Il est possible de générer un nouveau jeton pour un utilisateur qui en possède déjà un. La régénération d'un jeton révoquera l'accès au jeton précédent et l'utilisateur n'aura plus accès lorsqu'il tentera d'utiliser l'ancien jeton. Assurez-vous de mettre à jour vos scripts avec le nouveau jeton API.
Pour régénérer un jeton API :
-
Dans l'interface Broadsign Publish, cliquez le lien Publish Admin en haut à droite de la fenêtre.
Le Tableau de bord du domaine s'ouvre :
- Sous Comptes, cliquez sur Utilisateurs API. La page Utilisateurs API s’ouvre.
- Sur la page Utilisateurs API, cliquez sur le bouton Régénérer le jeton API pour l’utilisateur pour lequel régénérer un jeton.
- Cliquez sur Confirmer.
Le nouveau jeton est généré.
- Copiez le jeton.
- Une fois la clé copiée, cliquez sur Fermer.
Un avertissement s'affiche.
Attention : La régénération d'un jeton révoquera l'accès au jeton précédent et l'utilisateur n'aura plus accès lorsqu'il tentera d'utiliser l'ancien jeton. Si vous continuez, assurez-vous de mettre à jour vos scripts avec le nouveau jeton API.
Attention : Le jeton d'API est généré et visible une seule fois, assurez-vous donc de le copier ou de le noter avant de fermer la fenêtre.