Aide du Hub TheSocle · iam.apikeys.creer.valider

Créer la clé

Crée la clé et l'affiche une seule fois, en haut de la page. Copiez-la avant de quitter l'écran.

Voir l'élément dans l'écran : iam/api-keys

Explication

Le Hub génère la clé, en garde l'empreinte, et revient sur cette page avec un bandeau vert « Clé API créée avec succès » qui la montre une seule fois, avec un bouton Copier.

Rechargez la page ou partez, et la clé ne se reverra plus. Si elle est perdue : révoquez-la et créez-en une autre.

Dans ce démonstrateur, la clé affichée est une fausse clé de démonstration.

Fiche complète

Requête

POST /hub/iam/api-keys → iam_worker.create_api_key, par la voie « secrets » de l'exécuteur : la clé n'est pas recopiée dans l'audit (api_key=***).

Paramètre Obligatoire Vient du champ Remarque
user_id oui Utilisateur identifiant numérique du compte
key_name oui Nom de la clé
expires_in_days non Expiration 365 par défaut ; 0 ou négatif = jamais

Ce que rend l'action

Champ Sens
key_id identifiant de la clé (pour la révoquer)
api_key la clé en clair, rendue cette fois seulement
expires_at date d'expiration, vide si jamais
warning « Store this API key securely — it will not be shown again »

La clé est un UUID aléatoire, du type 00000000-0000-4000-8000-000000000001. Le Hub n'écrit en base que son empreinte SHA-256 (iam.tr_api_keys.key_hash).

Même chose par MCP

{ "name": "iam_worker__create_api_key",
  "arguments": { "user_id": "42", "key_name": "Intégration TheDash", "expires_in_days": 90 } }

Pièges

Sommaire du démonstrateur