Gestion des clés API

Une clé API sert d'identifiant unique pour authentifier un utilisateur, un développeur ou un programme appelant sur API. Les clés API sont généralement utilisées pour suivre et contrôler l'utilisation de l'interface afin d'éviter tout abus de API.

Présentation des clés API

Par défaut, les clés API sont désactivées dans Console de gestion. Pour activer les clés API, accédez à la section Paramètres. Un administrateur de clients peut révoquer des clés API. En revanche, pour éditer les paramètres des clés API et générer ou supprimer des clés API, vous devez posséder le rôle Développeur. Un administrateur de client attribue le rôle de développeur à un utilisateur. Si vous êtes un administrateur de client, vous pouvez vous attribuer le rôle de développeur.

La API table de clés affiche les informations suivantes relatives aux API clés : nom, ID, propriétaire, dernière mise à jour, date de création, date d'expiration et statut. Utilisez le champ de recherche pour effectuer une recherche dans les trois premiers champs : Nom de la clé, ID de la cléet propriétaire.

API états de clé

Les clés API peuvent avoir les états suivants :

Active : la clé API est utilisée.
A expiré : la date d'expiration est dépassée.
Révoquée : la API clé a été révoquée et ne peut plus être utilisée.

En qualité d’administrateur, vous pouvez contrôler les activités de clé API enregistrées dans la section Événements de Console de gestion. Si des activités suspectes sont détectées, par exemple si une clé API est utilisée de manière inhabituelle, vous pouvez révoquer la clé API. Ouvrez la liste détaillée en cliquant sur la flèche située à droite dans la table et copiez l'ID de la clé API. Vous pouvez rechercher l'ID dans la section de clés API pour trouver la clé API à révoquer.

Pour révoquer une seule API clé, cliquez sur le bouton ... situé à droite et sélectionnez Révoquer. Seules les clés possédant l'état Active peuvent être révoquées. Pour révoquer plusieurs clés, cochez les cases à gauche des clés à révoquer et cliquez sur Révoquer dans le coin supérieur droit. La révocation est définitive. Une clé API révoquée ne peut pas être réactivée.

Outre la révocation, vous disposez de l'option de suppression. Vous pouvez supprimer une clé APId'un hub mais pas de Console de gestion.

Activation de clés API dans le client

Le paramètre Activer les clés API est activé dans Console de gestion sur la page Paramètres. Par défaut, les clés API sont désactivées dans Console de gestion.

Propriétés des clés API
Propriété	Description
Activer les clés API	Ce commutateur permet d'activer ou de désactiver l'ensemble des clés API du client. Seul l'administrateur de clients peut activer des clés API.
Modifier la date d'expiration maximale du jeton	Si vous modifiez la valeur d'expiration de jeton, tous les nouveaux jetons appliqueront la nouvelle valeur d'expiration. Les API existantes ne seront pas affectées par la modification ; elles conserveront la même valeur d'expiration qu'auparavant. Il n'existe pas de limite maximale pour la valeur.
Modifier le nombre maximal de clés API par utilisateur	Ce paramètre affecte uniquement les nouvelles clés API. Si la création d'une nouvelle clé API entraîne le dépassement du nombre total maximal, elle échoue. La limite maximale de la valeur est 1 000.

Procédez comme suit :

Dans Console de gestion, accédez à la page Paramètres.
Sous la section Clés API, activez le bouton Activer les clés API.
Le cas échéant, modifiez les paramètres Changer l'expiration de jeton maximum et Changer les clés API maximum par utilisateur.

Génération d'une API clé à partir du hub

Vous pouvez générer API des clés à partir du hub. Avant de débuter, assurez-vous de respecter les trois conditions suivantes :

Vous utilisez une licence. Pour générer une clé API, il est nécessaire de posséder une licence.
Le paramètre Activer API les clés est activé dans Console de gestion.
L'administrateur du client vous a attribué le rôle de développeur.

Procédez comme suit :

Connectez-vous à votre client, par exemple https://<nomclient>.com.
Cliquez sur votre profil dans le coin supérieur droit et sélectionnez Paramètres du profil.
Sélectionnez des clés API.
Cliquez sur Générer une nouvelle clé.
Saisissez une description de clé API et sélectionnez la date d'expiration de la clé API.
Cliquez sur Générer.

Une clé API est générée.
Copiez la clé API et conservez-la dans un endroit sécurisé.

Après sa création, vous pouvez modifier le nom de la clé API. Vous pouvez également la supprimer.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici