Créer

Aide du Hub TheSocle · portal.apim.keys.creer.valider

Crée la clé et l'affiche une seule et unique fois. Copiez-la aussitôt.

Voir l'élément dans l'écran : portal/apim/keys

Explication

Le Hub tire une clé au hasard, n'en garde que l'empreinte, et vous montre la clé brute dans une fenêtre « Conservez cette clé immédiatement ». Une fois cette fenêtre fermée, personne — pas même l'administrateur du Hub — ne peut la réafficher.

Rangez-la dans un coffre à secrets, jamais dans le code.

Fiche complète

Requête

POST /api/apim/me/keys (JSON)

Champ	Vient de	Remarque
`key_name`	Nom	`user-key` si absent
`scopes`	Scopes	liste ; chaque scope doit être actif dans `apim.db_scope`
`allowed_ips`	IPs autorisées	texte, `null` si vide
`expires_at`	Expire le	`null` si vide

Réponses

Cas	Code	Corps
succès	201	`status: created`, `x_id`, `raw_key`, `key_hash`, `warning`
50 clés actives déjà	429	`error: key_quota_exceeded`, `max: 50`
scope inconnu	403	`error: scope_not_allowed`, `rejected`
session sans tenant	401	—

Ce que le Hub écrit

Une ligne iam.tr_api_keys : tenant, compte, nom, empreinte, scopes, IP, expiration, tier = free, auteur tenant-self-service.

Envoyer la clé

La passerelle lit Authorization: Bearer apim_… ou X-API-Key: apim_…, et ne transmet ni l'un ni l'autre à l'application appelée.

curl -H "X-API-Key: apim_DEMO00000000000000000000000000000000000000000" \
     https://api.exemplia.example/…

Sommaire du démonstrateur