Registro do cliente dinâmico

Antes de começar

O Registro Dinâmico de Clientes baseia-se nas especificações do Registro Dinâmico de Clientes do OpenID Connect 1.0.

Novos aplicativos OIDC são criados por um administrador de locatários ou por um usuário com acesso administrativo ao locatário. Agora, um cliente da API com a autorização certa também pode criar um aplicativo OIDC por meio de um terminal de registro de cliente dinâmico. O aplicativo criado é um "aplicativo personalizado" com o método de login definido como " OpenID Connect".

O terminal de registro do cliente dinâmico está localizado aqui: https://{{tenant}}/v1.0/endpoint/default/client_registration.

Considere utilizar o novo ponto de extremidade de registro dinâmico de clientes, caso ele atenda às suas necessidades. Para obter mais informações, consulte o artigo “Registro dinâmico de clientes com o novo provedor OpenID Connect ”.

Sobre esta tarefa

Para registrar dinamicamente um cliente, obtenha um token de acesso inicial e, em seguida, registre o novo aplicativo OIDC usando a API de registro.

Configurações dinâmicas de registro de clientes

As configurações de registro dinâmico de clientes podem ser definidas para estabelecer os valores padrão para o registro dinâmico de clientes. Consulte “Configuração das opções de registro dinâmico de clientes OIDC ”.

As configurações relevantes estão descritas na tabela a seguir.

As seções "Declaração de software", "Solicitar autorização" e "Token de acesso de registro" das configurações não são relevantes para este provedor do OpenID Connect.

Adquirir o token de acesso inicial

Para acessar um terminal de registro de cliente dinâmico, use um token de acesso com a autorização Manage OIDC client registration dynamically.

Crie um Cliente de API com a autorização Manage OIDC client registration dynamically. Para criar o cliente da API, consulte “Criação de clientes da API ”.

Depois que o Cliente da API for criado, use o fluxo client_credenciais para obter o token de acesso. Consulte o exemplo a seguir:

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

Registrar uma nova solicitação usando a API de registro

Ao usar o token de acesso produzido na seção anterior, é possível criar um novo aplicativo OIDC.

A tabela a seguir mostra a lista de metadados do cliente que são suportados atualmente.

Exemplo para registro de um novo aplicativo

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"
}

Configuração adicional do aplicativo

Após a criação do aplicativo, há mais opções que você pode configurar, como mapeamento de atributos, política de acesso, fontes de identidade, usuários autorizados e outras. Para configurar essas opções, consulte Configurando a conexão única no provedor do OpenID Connect.

A opção para atualizar usando a API de registro não é suportada.

Ler aplicativo OIDC usando a API de registro

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

Excluir aplicativo OIDC usando a API de registro

A API de registro também fornece uma maneira de excluir o aplicativo OIDC.

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

Token de acesso ao registro expirado

Se o token de acesso do registro expirar, adquira um novo token de acesso. Consulte “Obter o token de acesso inicial ”.