Créer une clé d'API de preuves
Créez une clé en lecture seule avec les portées dont votre plateforme de gestion a besoin, renouvelez-la ou révoquez-la.
Avant de commencer
Vous devez être administrateur de l'entreprise.
Étapes
Allez dans Paramètres → API et webhooks de preuves.
Dans Clés d'API, appuyez sur Nouvelle clé.
Saisissez le Nom (par exemple, « SofIA Gestión »).
Dans Portées, cochez uniquement ce que la plateforme doit lire.
Dans Restrictions, choisissez quand elle Expire dans : 90 jours, 180 jours, 1 an, 2 ans ou Sans expiration.
Si vous voulez que la clé ne lise que ce que voit un rôle, choisissez le rôle dans Limiter à la portée d'un rôle. Sinon, laissez Toute l'entreprise.
Si vous voulez limiter les endroits d'où elle est utilisée, cochez Uniquement depuis certaines IP ou certains réseaux et ajoutez chaque IP ou réseau (par exemple, 200.1.2.3 ou 10.0.0.0/8) avec Ajouter une IP ou un réseau.
Appuyez sur Créer.
Copiez la Clé et remettez-la à la plateforme de gestion. Appuyez sur Terminé.
La clé ne s'affiche qu'une seule fois. ARGUNIS ne peut pas l'afficher de nouveau.
États d'une clé
État | Ce que cela signifie |
|---|---|
en vigueur | Elle fonctionne |
expire bientôt | Elle expire dans moins de 30 jours |
en rotation | Une nouvelle clé la remplace déjà |
expirée | Son échéance est passée |
révoquée | Elle ne fonctionne plus |
Le tableau affiche aussi ses portées, les IP depuis lesquelles elle est autorisée, sa dernière utilisation (avec l'IP) et le nombre de requêtes sur 24 heures. Appuyez sur Voir les révoquées pour inclure les clés révoquées.
Renouveler
Appuyez sur Renouveler sur la ligne de la clé.
Indiquez pendant combien d'heures la clé actuelle reste en vigueur dans La clé actuelle reste en vigueur (heures).
Confirmez et copiez la nouvelle clé.
Une nouvelle clé est créée avec les mêmes portées ; l'actuelle expire à la fin du délai.
Révoquer
Appuyez sur Révoquer et confirmez avec Révoquer. La requête suivante avec cette clé échouera et c'est irréversible.