Clés API

Générez, copiez, identifiez et révoquez une clé API Runner personnelle en toute sécurité.

Les clés API sont des secrets personnels pour l'accès programmatique à Runner. Créez-en une uniquement pour une application de confiance, stockez-la de manière sécurisée et révoquez-la lorsqu'elle n'est plus nécessaire.

Ce que couvre ce guide

Vous saurez comment créer et enregistrer le secret unique, identifier les clés existantes sans les exposer et révoquer une clé avec confirmation.

Disponibilité et conditions préalables

Clés API est conditionnelle et n'apparaît que si elle est activée pour votre compte.
Les clés appartiennent à votre compte personnel, pas à un magasin.
Ne mettez jamais une clé complète dans un chat, une mémoire d'agent, une compétence, une capture d'écran, un contrôle de source ou une documentation produit.

Chemin d'accès

Sélectionnez avatar → Paramètres → Personnel → Clés API. Si l'entrée est absente, la fonctionnalité n'est pas disponible pour le compte actuel.

Contrôles

Entrée ou bouton	Pourquoi c'est utile	Ce qui se passe ensuite
Générer une nouvelle clé	Créez une nouvelle identifiant.	Une boîte de dialogue s'ouvre avec un champ Nom facultatif.
Nom	Identifiez l'application plus tard sans exposer le secret.	Le nom apparaît dans le tableau des clés ; vide crée une clé sans titre.
Créer une clé	Générez l'identifiant.	Runner ouvre Clé API générée et affiche le secret complet une seule fois.
Icône d'œil	Vérifiez la valeur nouvellement générée complète avant de la stocker.	La valeur unique est affichée ou masquée dans la boîte de dialogue de succès.
Icône de copie	Copiez la nouvelle clé avec précision.	Runner la copie dans le presse-papiers et affiche une confirmation.
Je l'ai enregistré	Fermez la vue du secret unique.	La valeur complète est effacée de la boîte de dialogue et ne peut pas être affichée à nouveau là.
Tableau des clés existantes	Identifiez les clés en toute sécurité.	Runner affiche Nom, Préfixe, Créé et Dernière utilisation, pas le secret complet.
Icône de suppression	Révoquez une clé existante.	Une confirmation explique que la révocation ne peut pas être annulée.
Révoquer	Désactivez la clé sélectionnée.	Après succès, la clé est supprimée de la liste et ne peut plus s'authentifier.

Générer et stocker une clé

Ouvrez Personnel → Clés API.
Sélectionnez Générer une nouvelle clé.
Entrez un nom descriptif, tel que l'application ou l'environnement. Ne mettez pas de secret dans le nom.
Sélectionnez Créer une clé.
Dans Clé API générée, révélez la clé uniquement si nécessaire et sélectionnez Copier.
Stockez-la dans un gestionnaire de secrets de confiance.
Confirmez la valeur stockée avant de sélectionner Je l'ai enregistré.
Utilisez le préfixe du tableau pour identifier la clé plus tard sans exposer la valeur complète.

Runner avertit que la clé complète ne sera pas affichée à nouveau. Si vous fermez la boîte de dialogue sans l'enregistrer, révoquez cette clé et créez un remplacement plutôt que d'essayer de récupérer le secret.

Révoquer une clé

Faites correspondre la clé prévue par Nom et Préfixe.
Sélectionnez son icône de suppression.
Vérifiez la confirmation Révoquer.
Sélectionnez Révoquer uniquement lorsque l'application dépendante est prête à arrêter de l'utiliser.
Confirmez Clé API révoquée et supprimez l'ancien secret de l'application.

La révocation est destructive et ne peut pas être annulée. Créez une nouvelle clé si l'accès est nécessaire à nouveau.

États et limites

Aucune clé API pour le moment est l'état vide normal.
La valeur complète d'une nouvelle clé n'apparaît que dans sa boîte de dialogue de succès.
Les lignes existantes affichent un préfixe et les dates d'utilisation, pas une clé récupérable.
Jamais sous Dernière utilisation signifie que Runner n'a pas enregistré de demande pour cette clé.
Les boutons Créer et Révoquer affichent la progression et ne doivent pas être soumis à plusieurs reprises.

Dépannage

Si les clés API sont manquantes, n'utilisez pas un lien direct copié ; la fonctionnalité est désactivée pour ce compte.
Si la copie du presse-papiers échoue, révélez la nouvelle valeur et copiez-la manuellement dans un gestionnaire de secrets sécurisé, puis masquez-la à nouveau.
Si vous avez perdu une clé complète, révoquez sa ligne et générez un remplacement.
Si une application cesse de fonctionner après la révocation, mettez-la à jour avec une clé nouvellement créée ; l'ancienne clé ne peut pas être restaurée.
Si la mauvaise clé a été sélectionnée, annulez la confirmation et comparez à nouveau Nom et Préfixe.