Enregistrement dynamique de client

Avant de commencer

L'enregistrement dynamique des clients repose sur les spécifications de l' OpenID, notamment celles relatives à l'enregistrement dynamique des clients (Dynamic Client Registration) et à l' 1.0.

Les nouvelles applications OIDC sont créées par un administrateur titulaire ou un utilisateur disposant d'un accès administrateur au titulaire. Désormais, un client API disposant de l'habilitation appropriée peut également créer une application OIDC via un noeud final d'enregistrement dynamique de client. L'application créée est une « application personnalisée » dont la méthode de connexion est définie sur « Connexion via l' OpenID ».

Le nœud final d'enregistrement de client dynamique se trouve ici : https://{{tenant}}/v1.0/endpoint/default/client_registration.

Envisagez d'utiliser le nouveau point de terminaison d'enregistrement dynamique des clients s'il répond à vos besoins. Pour plus d'informations, consultez la section « Enregistrement dynamique des clients avec le nouveau fournisseur Connect d' OpenID ».

A propos de cette tâche

Pour enregistrer un client de manière dynamique, obtenez un jeton d'accès initial, puis enregistrez la nouvelle application OIDC à l'aide de l'API d'enregistrement.

Paramètres dynamiques d'enregistrement des clients

Les paramètres d'enregistrement dynamique des clients peuvent être configurés afin de définir les valeurs par défaut pour l'enregistrement dynamique des clients. Voir la section « Configuration des paramètres d'enregistrement dynamique des clients OIDC ».

Les paramètres concernés sont décrits dans le tableau ci-dessous.

Les sections « Déclaration du logiciel », « Demande d'autorisation » et « Jeton d'accès d'enregistrement » des paramètres ne s'appliquent pas à ce fournisseur Connect d' OpenID.

Acquérir un jeton d'accès initial

Pour accéder à un nœud final d'enregistrement de client dynamique, utilisez un jeton d'accès avec le droit d'accès Manage OIDC client registration dynamically.

Créez un client d'API avec le droit d'accès Manage OIDC client registration dynamically. Pour créer un client API, consultez la section Création de clients API.

Une fois le client API créé, utilisez le flux client_credentials pour obtenir le jeton d'accès. Prenons cet exemple :

curl -ki -v https://{{tenant}}/v1.0/endpoint/default/`token -d "grant_type=client_credentials&client_id=<clientId>&client_secret=<clientSecret>"

Enregistrer une nouvelle application à l'aide de l'API d'enregistrement

En utilisant le jeton d'accès généré dans la section précédente, vous pouvez créer une nouvelle application OIDC.

Le tableau ci-dessous présente la liste des métadonnées client actuellement prises en charge.

Exemple d'enregistrement d'une nouvelle application

curl -ki -H "Authorization: bearer <access-token>" -H "Content-Type:application/json" -X POST https://{{tenant}}/v1.0/endpoint/default/client_registration --data-binary '{"redirect_uris":["https://www.redirect.com"],"client_name":"MyApplication"}'

{
	"grant_types": [
		"authorization_code"
	],
	"client_secret_expires_at": "0",
	"registration_client_uri": "https://{{tenant}}/v1.0/endpoint/default/client_registration/<clientId>",
	"client_secret": "<client_secret>",
	"redirect_uris": [
		"https://www.redirect.com"
	],
	"client_id_issued_at": "1586933118",
	"client_name": "MyApplication",
	"registration_access_token": "<access_token>",
	"client_id": "<clientId>",
	"id_token_signed_response_alg": "RS256"
}

Configuration supplémentaire de l'application

Une fois l'application créée, vous disposez d'autres options à configurer, telles que le mappage des attributs, la politique d'accès, les sources d'identité, les utilisateurs autorisés, etc. Pour configurer ces options, voir Configuration de la connexion unique dans le fournisseur OpenID Connect.

L'option de mise à jour à l'aide de l'API d'enregistrement n'est pas prise en charge.

Lire l'application OIDC à l'aide de l'API d'enregistrement

curl -ki -H "Authorization: bearer <registration-access-token>" https://{{tenant}}/v1.0/endpoint/default/client_registration/<clientId>

Supprimer l'application OIDC à l'aide de l'API d'enregistrement

L'API d'enregistrement permet également de supprimer l'application OIDC.

curl -ki -H "Authorization: bearer <registration-access-token>" -X DELETE https://{{tenant}}/v1.0/endpoint/default/client_registration/<clientId>

Jeton d'accès à l'enregistrement expiré

Si le jeton d'accès à l'enregistrement arrive à expiration, achetez-en un nouveau. Voir « Obtenir un jeton d'accès initial ».