Enregistrement dynamique des clients
Permettez aux applications clientes de s'enregistrer via OAuth 2.0 Dynamic Client Registration, à l'aide d'initial access tokens.
Remarque : Disponible avec les abonnements Advanced et Pro. L'enregistrement ouvert pour les agents IA nécessite Pro.
Avec l'enregistrement dynamique des clients, une application cliente s'enregistre elle-même au lieu d'être créée manuellement dans l'Admin Console. Elle envoie ses métadonnées (nom, URI de redirection, authentification du client) au point de terminaison d'enregistrement et reçoit en retour un ID client et, pour les clients confidentiels, un secret client. La plateforme implémente OAuth 2.0 Dynamic Client Registration (RFC 7591) ainsi que le protocole de gestion qui permet au client de lire, mettre à jour et supprimer ultérieurement son propre enregistrement (RFC 7592).
Par défaut, chaque enregistrement nécessite un initial access token que vous émettez ; vous décidez ainsi qui peut enregistrer des clients et à quelle fréquence. Pour les agents IA et les autres clients publics, vous pouvez en outre autoriser l'enregistrement ouvert.
Vous gérez les initial access tokens sous Intégrations → Applications → Enregistrements dynamiques dans l'Admin Console.
Fonctionnement
- Vous émettez un initial access token et le remettez à la partie qui enregistre le client, par exemple un partenaire ou un pipeline de déploiement.
- Le client envoie une demande d'enregistrement au point de terminaison d'enregistrement, avec l'initial access token comme jeton Bearer.
- La plateforme vérifie les métadonnées au regard des règles ci-dessous, crée l'application et répond avec les identifiants du client, un registration access token et l'URL de gestion propre au client.
- Avec le registration access token, le client peut lire, mettre à jour ou supprimer son enregistrement. Chaque mise à jour émet un nouveau registration access token et invalide le précédent.
Le client enregistré est répertorié dans l'onglet Enregistrements dynamiques, sous Applications enregistrées, avec son mode d'enregistrement et sa dernière utilisation. Sa page de détail est la même que pour toute autre application, avec la mention Enregistrée dynamiquement. Personne ne peut encore s'y connecter : comme pour toute nouvelle application, l'accès doit d'abord être attribué.
Émettre un initial access token
- Accédez à Intégrations → Applications et ouvrez l'onglet Enregistrements dynamiques.
- Sélectionnez Émettre le jeton.
- Saisissez un Nom, par exemple le partenaire ou le système auquel le jeton est destiné. Il apparaît dans la liste et dans le journal d'audit.
- Définissez la Validité en jours (de 1 à 365). Le jeton expire au terme de cette période.
- Laissez Usage unique sélectionné si le jeton doit permettre exactement un enregistrement. Décochez cette option pour autoriser un nombre illimité d'enregistrements jusqu'à l'expiration du jeton.
- Sélectionnez Émettre le jeton et copiez le jeton. Il n'est affiché qu'une seule fois et ne peut pas être récupéré ultérieurement.
La page affiche également le Point de terminaison d'enregistrement à transmettre avec le jeton. Il est aussi publié sous la forme registration_endpoint dans le document de découverte OpenID Connect.
La liste indique pour chaque jeton son mode d'utilisation, le nombre d'enregistrements effectués avec lui, sa date d'expiration et la personne qui l'a émis. Révoquer empêche l'utilisation d'un jeton pour de nouveaux enregistrements. Les applications déjà enregistrées avec ce jeton ne sont pas affectées. Les jetons expirés sont supprimés automatiquement.
Enregistrement ouvert pour les agents IA
Remarque : Disponible avec l'abonnement Pro.
Les agents IA, par exemple les clients du Model Context Protocol (MCP), et les outils en ligne de commande s'enregistrent eux-mêmes dès qu'un utilisateur les connecte, sans que personne ne remette de jeton. Chaque installation enregistre généralement son propre client. L'enregistrement ouvert permet précisément cela pour les clients publics, qui n'ont pas de secret client et connectent les utilisateurs via le flux authorization code avec PKCE.
- Accédez à Paramètres → Avancé.
- Dans la carte Enregistrement ouvert, activez Enregistrement ouvert pour les clients publics.
- Sous Utilisateurs autorisés à se connecter, sélectionnez les répertoires dont les utilisateurs peuvent utiliser de tels clients.
- Sélectionnez Enregistrer les modifications.
Pour les clients enregistrés de manière ouverte :
- Seuls les clients publics sont acceptés. Un enregistrement sans initial access token doit envoyer
"token_endpoint_auth_method": "none", et le client reste public : une mise à jour ultérieure ne peut pas ajouter de secret client. Les clients confidentiels nécessitent toujours un initial access token. - L'accès découle des répertoires. Les utilisateurs des répertoires sélectionnés peuvent se connecter après avoir donné leur consentement, sans attribution par application. La sélection s'applique aux nouveaux enregistrements ; les applications déjà enregistrées conservent les répertoires avec lesquels elles ont été enregistrées.
- Les enregistrements sont limités à 10 par heure par adresse IP client et à 200 par heure au total (20 pendant la période d'essai).
- Les enregistrements inutilisés sont supprimés. Un client auquel personne ne s'est connecté est supprimé au bout de 24 heures, de même qu'un client sans connexion ni demande de jeton depuis 90 jours. Chaque suppression est enregistrée dans le journal d'audit.
- Il n'y a pas de propriétaire. Les applications enregistrées de manière ouverte ne sont attribuées à aucun administrateur.
Le point de terminaison d'enregistrement est annoncé dans le document de découverte, servi sous /.well-known/openid-configuration et, pour les clients OAuth qui le cherchent à cet endroit, sous /.well-known/oauth-authorization-server. Si un agent demande un access token pour une ressource précise, par exemple un serveur MCP, enregistrez cette ressource en tant qu'API.
La désactivation de l'enregistrement ouvert arrête les nouveaux enregistrements anonymes. Les clients déjà enregistrés continuent de fonctionner et peuvent toujours gérer leur enregistrement. Sans l'abonnement Pro, les utilisateurs des répertoires n'obtiennent plus automatiquement l'accès aux clients enregistrés de manière ouverte : attribuez-les explicitement, sinon les clients inutilisés sont supprimés au bout de 90 jours.
Enregistrer un client
Le client envoie ses métadonnées sous forme de requête JSON POST :
curl -X POST https://id.example.com/oidc/register \
-H "Authorization: Bearer <initial access token>" \
-H "Content-Type: application/json" \
-d '{
"client_name": "Partner Portal",
"redirect_uris": ["https://portal.partner.example/callback"],
"post_logout_redirect_uris": ["https://portal.partner.example/"],
"grant_types": ["authorization_code", "refresh_token"],
"token_endpoint_auth_method": "client_secret_basic"
}'Un enregistrement réussi répond avec 201 Created :
{
"client_id": "V1StGXR8_Z5jdHi6B-myT",
"client_secret": "...",
"client_name": "Partner Portal",
"redirect_uris": ["https://portal.partner.example/callback"],
"grant_types": ["authorization_code", "refresh_token"],
"response_types": ["code"],
"token_endpoint_auth_method": "client_secret_basic",
"registration_client_uri": "https://id.example.com/oidc/register/V1StGXR8_Z5jdHi6B-myT",
"registration_access_token": "..."
}Le client conserve client_secret et registration_access_token en lieu sûr. Aucun des deux ne peut être récupéré à nouveau.
Gérer l'enregistrement
Le client gère son enregistrement à l'adresse registration_client_uri, authentifié par son registration access token actuel :
| Requête | Effet |
|---|---|
GET | Renvoie l'enregistrement actuel. |
PUT | Remplace l'enregistrement par les métadonnées envoyées. Le corps doit contenir client_id ; un champ omis est supprimé. La réponse contient un nouveau registration access token. |
DELETE | Supprime l'application. Ses utilisateurs ne peuvent plus s'y connecter. |
Un administrateur peut modifier ou supprimer une application enregistrée dynamiquement dans l'Admin Console comme n'importe quelle autre. Gardez à l'esprit que le prochain PUT du client écrase les champs qui lui appartiennent (nom, URI de redirection, grant types, authentification du client, URI du client et clés du client). Les attributions, politiques, propriétaires et le paramètre de consentement restent tels que l'administrateur les a définis.
Ce qu'un client enregistré peut être
| Métadonnées | Règle |
|---|---|
token_endpoint_auth_method | client_secret_basic (par défaut), client_secret_post, private_key_jwt ou none. |
| Type d'application | Déduit de l'authentification du client : none crée une application monopage (SPA), ou une application native lorsque "application_type": "native" est envoyé ou que chaque URI de redirection est une adresse de bouclage (http://127.0.0.1, http://[::1], http://localhost) ou un schéma propre à l'application. Une redirection de bouclage native correspond à n'importe quel port. Toute autre méthode crée une application web. Un client natif doit utiliser none. |
grant_types | Doit contenir authorization_code, peut ajouter refresh_token. Les grants implicit, client credentials, device et token exchange sont refusés. |
response_types | code uniquement. |
redirect_uris, post_logout_redirect_uris | Pas de caractères génériques, pas d'URI sur le domaine propre du fournisseur d'identité. |
client_uri | Doit utiliser https. |
jwks | Clés publiques uniquement, RSA d'au moins 2048 bits ou EC sur la courbe P-256. Nécessaire pour private_key_jwt. |
jwks_uri, sector_identifier_uri, backchannel_logout_uri, request_uris | Refusés, car la plateforme devrait appeler elle-même ces URL. Un administrateur peut ensuite définir les options correspondantes sur l'application. |
client_name | Facultatif. Sans nom, l'application s'appelle « Dynamic client » suivi de son ID client. Un nom déjà utilisé se voit ajouter une partie de l'ID client. |
default_max_age | Accepté. |
Toutes les autres métadonnées sont ignorées et ne figurent pas dans la réponse.
Certains paramètres sont toujours fixés par la plateforme, quel que soit le contenu de la requête :
- Exiger le consentement de l'utilisateur est activé. Les utilisateurs confirment l'accès demandé lors de leur première connexion, et les refresh tokens ne sont émis que si le client demande le scope
offline_access. - Aucun profil de sécurité n'est appliqué. Un administrateur peut en définir un ensuite, voir Financial-grade API security.
- L'application n'est pas répertoriée dans le portail d'applications des utilisateurs.
- L'administrateur qui a émis l'initial access token devient propriétaire de l'application. Les applications enregistrées de manière ouverte n'ont pas de propriétaire.
Les enregistrements sont décomptés de la limite d'applications de votre abonnement.
Journal d'audit
| Événement | Consigné lorsque |
|---|---|
INITIAL_ACCESS_TOKEN_CREATED | Un administrateur émet un initial access token. |
INITIAL_ACCESS_TOKEN_REVOKED | Un administrateur révoque un initial access token. |
CONFIGURATION_UPDATED | Un administrateur active ou désactive l'enregistrement ouvert ou modifie ses répertoires. |
APPLICATION_REGISTERED | Un client s'enregistre. Le client qui s'enregistre est consigné comme acteur. |
APPLICATION_UPDATED | Un client met à jour son enregistrement. |
APPLICATION_DEREGISTERED | Un client supprime son enregistrement, un administrateur supprime l'application, ou un enregistrement ouvert inutilisé est supprimé. |
Voir Types d'événements d'audit pour la liste complète.
Dépannage
invalid_tokenlors de l'enregistrement : l'initial access token est inconnu, expiré, révoqué, ou un jeton à usage unique a déjà été utilisé. Émettez-en un nouveau. Sans jeton, l'enregistrement ouvert est désactivé.429lors d'un enregistrement anonyme : la limite de débit de l'enregistrement ouvert est atteinte. Réessayez plus tard.invalid_tokenlors d'une lecture, mise à jour ou suppression : le registration access token a été remplacé par un plus récent lors de la dernière mise à jour, ou l'application a été supprimée.invalid_client_metadataavec "dynamic client registration is not available" : l'abonnement n'inclut pas la fonctionnalité. Les enregistrements et mises à jour sont refusés ; la lecture et la suppression d'un enregistrement existant continuent de fonctionner.invalid_client_metadata: les métadonnées enfreignent l'une des règles ci-dessus. L'error_descriptionindique le champ concerné. Une requête refusée ne consomme pas de jeton à usage unique.- Les utilisateurs ne peuvent pas se connecter après l'enregistrement : l'application n'a encore aucune attribution. Attribuez des utilisateurs, groupes ou répertoires dans l'onglet Attributions de l'application. Pour un client enregistré de manière ouverte, vérifiez que l'utilisateur appartient à l'un de ses répertoires.