Frapper

Émet la clé APIM de la source et affiche les blocs à coller. La clé n'apparaît qu'ici, une seule fois. Sur une source qui en a une : rotation.

Voir l'élément dans l'écran : supervision/sources

Explication

Le navigateur demande deux choses :

1. le tenant porteur de la clé (un slug ; supervision est proposé) ;
2. le propriétaire (une adresse ; vide = le premier membre du tenant).

Le Hub émet une clé APIM au scope supervision:rapport:write, puis affiche le panneau À coller chez …, avec la clé en clair dans les blocs 1 et 2, et un avertissement rouge.

Copier la clé maintenant. Elle n'est ni stockée en clair ni réaffichable. Perdue, il faut frapper de nouveau.

Sur une source qui a déjà un jeton, frapper est une rotation : la nouvelle clé prend la suite, et l'ancienne reste acceptée pendant 24 heures, le temps de changer la constante chez la source. À l'échéance, le Hub révoque l'ancienne de lui-même.

Fiche complète

Requête

POST /hub/supervision/sources/{source_id}/jeton (tenant, user) → SupervisionEnrolementService.frapper, comme l'action supervision_externe_worker.frapper_jeton (source_id, tenant, user, expires_in_days).

La clé émise

Une clé hérite du tenant de son propriétaire : choisir le tenant avant la première frappe. Le Hub ne garde que l'identifiant de la clé et ses quatre derniers signes.

Réponse

{ok, api_key, fin4, tenant, proprietaire, expire_le, constantes_wp_config, curl_pousser, curl_lire_inventaire, url_reception}, ou {ok:false, error} : « Frappe refusée par l'APIM : … ».

Pièges

• L'écran n'envoie pas d'échéance : la clé est sans fin. C'est voulu (une clé qui expire rendrait le site muet sans prévenir) ; pour une échéance, passer par l'action.
• Le tenant proposé par défaut doit exister sur le Hub.