Gérer les clés API
Les clés API vous permettent d'authentifier les requêtes auprès de l'API Ferndesk. Vous pouvez créer, afficher et révoquer des clés depuis les paramètres de votre compte.
Les clés API accordent un accès complet à votre espace de travail. Gardez-les secrètes et ne les soumettez jamais à un système de contrôle de version.
Créer une clé API
Pour générer une nouvelle clé API :
Cliquez sur API dans la barre latérale gauche, sous la section Développeurs.
Cliquez sur New API key.
Saisissez un nom descriptif (par exemple, « Production » ou « CI/CD pipeline »).
Cliquez sur Create key.
Copiez votre clé immédiatement. Vous ne pourrez plus la visualiser après avoir fermé la boîte de dialogue.
Conservez la clé en toute sécurité dans votre gestionnaire de mots de passe ou un coffre-fort de secrets.
Afficher vos clés API
Toutes vos clés API apparaissent sur la page API. Vous y verrez le nom de la clé, la date de création et l'horodatage de la dernière utilisation — mais pas la clé elle-même.
Révoquer une clé API
Si une clé est compromise ou n'est plus nécessaire :
Accédez à la page API.
Cliquez sur le menu à trois points à côté de la clé.
Sélectionnez Revoke.
La révocation d'une clé bloque immédiatement toutes les requêtes l'utilisant. Toutes les intégrations ou scripts cesseront de fonctionner jusqu'à ce que vous les mettiez à jour avec une nouvelle clé.
Renouvelez régulièrement vos clés API et révoquez celles qui sont inutilisées pour minimiser les risques de sécurité.