Registering Clients

When a developer comes to your website, they will need a way to create a new application and obtain credentials. Typically you will have them create a developer account, or create an account on behalf of their organization, before they can create an application.

While the OAuth 2.0 spec doesn’t require you to collect any application information in particular before granting credentials, most services collect basic information about an app, such as the app name and an icon, before issuing the client_id and client_secret. It is, however, important that you require the developer to register one or more redirect URLs for the application for security purposes. This is explained in more detail in Redirect URLs.

Typically services collect information about an application such as:

  • Application name

  • An icon for the application

  • URL to the application’s home page

  • A short description of the application

  • A link to the application’s privacy policy

  • A list of redirect URLs

The Client ID and Secret

Client ID

The client_id is a public identifier for apps. Even though it’s public, it’s best that it isn’t guessable by third parties, so many implementations use something like a 32-character hex string. It must also be unique across all clients that the authorization server handles. If the client ID is guessable, it makes it slightly easier to craft phishing attacks against arbitrary applications.

Client Secret

The client_secret is a secret known only to the application and the authorization server. It must be sufficiently random to not be guessable, which means you should avoid using common UUID libraries which often take into account the timestamp or MAC address of the server generating it. A great way to generate a secure secret is to use a cryptographically-secure library to generate a 256-bit value and convert it to a hexadecimal representation.

Get a registred client.

get

See information about a registred client.

Path parameters
client_idstringRequired

ID of the client

Header parameters
AuthorizationstringRequired

Bearer token obtained on the register process through the registration_access_token property giving access only to one client matching the client_id path parameter. An admin token can be also obtained through the client crendentials flow with as mandatory scope "dcr_admin".

Responses
200
Claims about the registred client.
application/json
get
GET /unknown/register/{client_id} HTTP/1.1
Host: auth.authority.io
Authorization: text
Accept: */*
{
  "client_id": "text",
  "client_secret": "text",
  "registration_access_token": "text",
  "registration_client_uri": "text",
  "client_id_issued_at": "text",
  "client_secret_expires_at": 1,
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}

Delete a registred client.

delete

Delete a registred client.

Path parameters
client_idstringRequired

ID of the client

Header parameters
AuthorizationstringRequired

Bearer token obtained on the register process through the registration_access_token property giving access only to one client matching the client_id path parameter. An admin token can be also obtained through the client crendentials flow with as mandatory scope "dcr_admin".

Responses
204
Client deleted
*/*
delete
DELETE /unknown/register/{client_id} HTTP/1.1
Host: auth.authority.io
Authorization: text
Accept: */*
{
  "client_id": "text",
  "client_secret": "text",
  "registration_access_token": "text",
  "registration_client_uri": "text",
  "client_id_issued_at": "text",
  "client_secret_expires_at": 1,
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}

Patch a registred client.

patch

Update information about a registred client.

Path parameters
client_idstringRequired

ID of the client

Header parameters
AuthorizationstringRequired

Bearer token obtained on the register process through the registration_access_token property giving access only to one client matching the client_id path parameter. An admin token can be also obtained through the client crendentials flow with as mandatory scope "dcr_admin".

Body
redirect_urisstring[]Required

REQUIRED. Array of Redirection URI values used by the Client. One of these registered Redirection URI values MUST exactly match the redirect_uri parameter value used in each Authorization Request

response_typesstring[]Optional

JSON array containing a list of the OAuth 2.0 response_type values that the Client is declaring that it will restrict itself to using. If omitted, the default is that the Client will use only the code Response Type.

grant_typesstring[]Optional

JSON array containing a list of the OAuth 2.0 Grant Types that the Client is declaring that it will restrict itself to using. Values used by OpenID Connect are authorization_code, implicit and refresh_token

application_typestringOptional

Kind of the application. The default, if omitted, is web. The defined values are native or web.

contactsstring[]Optional

Array of e-mail addresses of people responsible for this Client. This might be used by some providers to enable a Web user interface to modify the Client information.

client_namestringOptional

Name of the Client to be presented to the End-User.

logo_uristringOptional

URL that references a logo for the Client application.

client_uristringOptional

URL of the home page of the Client. The value of this field MUST point to a valid Web page.

policy_uristringOptional

URL that the Relying Party Client provides to the End-User to read about the how the profile data will be used.

tos_uristringOptional

URL that the Relying Party Client provides to the End-User to read about the Relying Party's terms of service.

jwks_uristringOptional

URL for the Client's JSON Web Key Set [JWK] document.

sector_identifier_uristringOptional

URL using the https scheme to be used in calculating Pseudonymous Identifiers by the OP. The URL references a file with a single JSON array of redirect_uri values.

subject_typestringOptional

subject_type requested for responses to this Client. The subject_types_supported Discovery parameter contains a list of the supported subject_type values for this server. Valid types include pairwise and public.

id_token_signed_response_algstringOptional

JWS alg algorithm [JWA] REQUIRED for signing the ID Token issued to this Client. The default, if omitted, is RS256. The public key for validating the signature is provided by retrieving the JWK Set referenced by the jwks_uri element from OpenID Connect Discovery 1.0 [OpenID.Discovery].

id_token_encrypted_response_algstringOptional

JWE alg algorithm [JWA] REQUIRED for encrypting the ID Token issued to this Client. If this is requested, the response will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that no encryption is performed.

id_token_encrypted_response_encstringOptional

JWE enc algorithm [JWA] REQUIRED for encrypting the ID Token issued to this Client. If id_token_encrypted_response_alg is specified, the default for this value is A128CBC-HS256. When id_token_encrypted_response_enc is included, id_token_encrypted_response_alg MUST also be provided.

userinfo_signed_response_algstringOptional

WS alg algorithm [JWA] REQUIRED for signing UserInfo Responses. If this is specified, the response will be JWT [JWT] serialized, and signed using JWS. The default, if omitted, is for the UserInfo Response to return the Claims as a UTF-8 encoded JSON object using the application/json content-type.

userinfo_encrypted_response_algstringOptional

JWE [JWE] alg algorithm [JWA] REQUIRED for encrypting UserInfo Responses. If both signing and encryption are requested, the response will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that no encryption is performed.

userinfo_encrypted_response_encstringOptional

JWE enc algorithm [JWA] REQUIRED for encrypting UserInfo Responses. If userinfo_encrypted_response_alg is specified, the default for this value is A128CBC-HS256. When userinfo_encrypted_response_enc is included, userinfo_encrypted_response_alg MUST also be provided.

request_object_signing_algstringOptional

JWS [JWS] alg algorithm [JWA] that MUST be used for signing Request Objects sent to the OP. All Request Objects from this Client MUST be rejected, if not signed with this algorithm. Request Objects are described in Section 6.1 of OpenID Connect Core 1.0 [OpenID.Core]. This algorithm MUST be used both when the Request Object is passed by value (using the request parameter) and when it is passed by reference (using the request_uri parameter). Servers SHOULD support RS256. The value none MAY be used. The default, if omitted, is that any algorithm supported by the OP and the RP MAY be used.

request_object_encryption_algstringOptional

JWE [JWE] alg algorithm [JWA] the RP is declaring that it may use for encrypting Request Objects sent to the OP. This parameter SHOULD be included when symmetric encryption will be used, since this signals to the OP that a client_secret value needs to be returned from which the symmetric key will be derived, that might not otherwise be returned. The RP MAY still use other supported encryption algorithms or send unencrypted Request Objects, even when this parameter is present. If both signing and encryption are requested, the Request Object will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that the RP is not declaring whether it might encrypt any Request Objects.

request_object_encryption_encstringOptional

JWE enc algorithm [JWA] the RP is declaring that it may use for encrypting Request Objects sent to the OP. If request_object_encryption_alg is specified, the default for this value is A128CBC-HS256. When request_object_encryption_enc is included, request_object_encryption_alg MUST also be provided.

token_endpoint_auth_methodstringOptional

Requested Client Authentication method for the Token Endpoint. The options are client_secret_post, client_secret_basic, client_secret_jwt, private_key_jwt, and none, as described in Section 9 of OpenID Connect Core 1.0 [OpenID.Core]. Other authentication methods MAY be defined by extensions. If omitted, the default is client_secret_basic -- the HTTP Basic Authentication Scheme specified in Section 2.3.1 of OAuth 2.0 [RFC6749].

token_endpoint_auth_signing_algstringOptional

JWS [JWS] alg algorithm [JWA] that MUST be used for signing the JWT [JWT] used to authenticate the Client at the Token Endpoint for the private_key_jwt and client_secret_jwt authentication methods. All Token Requests using these authentication methods from this Client MUST be rejected, if the JWT is not signed with this algorithm. Servers SHOULD support RS256. The value none MUST NOT be used. The default, if omitted, is that any algorithm supported by the OP and the RP MAY be used.

default_max_ageintegerOptional

Default Maximum Authentication Age. Specifies that the End-User MUST be actively authenticated if the End-User was authenticated longer ago than the specified number of seconds. The max_age request parameter overrides this default value. If omitted, no default Maximum Authentication Age is specified.

require_auth_timebooleanOptional

Boolean value specifying whether the auth_time Claim in the ID Token is REQUIRED. It is REQUIRED when the value is true.

default_acr_valuesstring[]Optional

Default requested Authentication Context Class Reference values. Array of strings that specifies the default acr values that the OP is being requested to use for processing requests from this Client, with the values appearing in order of preference.

initiate_login_uristringOptional

URI using the https scheme that a third party can use to initiate a login by the RP, as specified in Section 4 of OpenID Connect Core 1.0 [OpenID.Core].

request_urisstring[]Optional

Array of request_uri values that are pre-registered by the RP for use at the OP.

scopestring[]Optional

String containing a space-separated list of scope values

software_idstringOptional

A unique identifier string (e.g., a Universally Unique Identifier (UUID)) assigned by the client developer or software publisher used by registration endpoints to identify the client software to be dynamically registered.

software_versionstringOptional

A version identifier string for the client software identified by "software_id". The value of the "software_version" SHOULD change on any update to the client software identified by the same "software_id".

software_statementstringOptional

A software statement containing client metadata values about the client software as claims. This is a string value containing the entire signed JWT.

Responses
200
Claims about the updated client.
application/json
patch
PATCH /unknown/register/{client_id} HTTP/1.1
Host: auth.authority.io
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 1084

{
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}
{
  "client_id": "text",
  "client_secret": "text",
  "registration_access_token": "text",
  "registration_client_uri": "text",
  "client_id_issued_at": "text",
  "client_secret_expires_at": 1,
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}

Register (create) a new client.

post

The Dynamic Client Registration (dcr) Endpoint is an OAuth 2.0 Protected Resource through which a new Client registration can be requested.

Header parameters
AuthorizationstringOptional

Bearer token obtained through client crendentials flow with as mandatory scope "dcr_admin". Token required unless open dynamic client registration is enabled.

Body
redirect_urisstring[]Required

REQUIRED. Array of Redirection URI values used by the Client. One of these registered Redirection URI values MUST exactly match the redirect_uri parameter value used in each Authorization Request

response_typesstring[]Optional

JSON array containing a list of the OAuth 2.0 response_type values that the Client is declaring that it will restrict itself to using. If omitted, the default is that the Client will use only the code Response Type.

grant_typesstring[]Optional

JSON array containing a list of the OAuth 2.0 Grant Types that the Client is declaring that it will restrict itself to using. Values used by OpenID Connect are authorization_code, implicit and refresh_token

application_typestringOptional

Kind of the application. The default, if omitted, is web. The defined values are native or web.

contactsstring[]Optional

Array of e-mail addresses of people responsible for this Client. This might be used by some providers to enable a Web user interface to modify the Client information.

client_namestringOptional

Name of the Client to be presented to the End-User.

logo_uristringOptional

URL that references a logo for the Client application.

client_uristringOptional

URL of the home page of the Client. The value of this field MUST point to a valid Web page.

policy_uristringOptional

URL that the Relying Party Client provides to the End-User to read about the how the profile data will be used.

tos_uristringOptional

URL that the Relying Party Client provides to the End-User to read about the Relying Party's terms of service.

jwks_uristringOptional

URL for the Client's JSON Web Key Set [JWK] document.

sector_identifier_uristringOptional

URL using the https scheme to be used in calculating Pseudonymous Identifiers by the OP. The URL references a file with a single JSON array of redirect_uri values.

subject_typestringOptional

subject_type requested for responses to this Client. The subject_types_supported Discovery parameter contains a list of the supported subject_type values for this server. Valid types include pairwise and public.

id_token_signed_response_algstringOptional

JWS alg algorithm [JWA] REQUIRED for signing the ID Token issued to this Client. The default, if omitted, is RS256. The public key for validating the signature is provided by retrieving the JWK Set referenced by the jwks_uri element from OpenID Connect Discovery 1.0 [OpenID.Discovery].

id_token_encrypted_response_algstringOptional

JWE alg algorithm [JWA] REQUIRED for encrypting the ID Token issued to this Client. If this is requested, the response will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that no encryption is performed.

id_token_encrypted_response_encstringOptional

JWE enc algorithm [JWA] REQUIRED for encrypting the ID Token issued to this Client. If id_token_encrypted_response_alg is specified, the default for this value is A128CBC-HS256. When id_token_encrypted_response_enc is included, id_token_encrypted_response_alg MUST also be provided.

userinfo_signed_response_algstringOptional

WS alg algorithm [JWA] REQUIRED for signing UserInfo Responses. If this is specified, the response will be JWT [JWT] serialized, and signed using JWS. The default, if omitted, is for the UserInfo Response to return the Claims as a UTF-8 encoded JSON object using the application/json content-type.

userinfo_encrypted_response_algstringOptional

JWE [JWE] alg algorithm [JWA] REQUIRED for encrypting UserInfo Responses. If both signing and encryption are requested, the response will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that no encryption is performed.

userinfo_encrypted_response_encstringOptional

JWE enc algorithm [JWA] REQUIRED for encrypting UserInfo Responses. If userinfo_encrypted_response_alg is specified, the default for this value is A128CBC-HS256. When userinfo_encrypted_response_enc is included, userinfo_encrypted_response_alg MUST also be provided.

request_object_signing_algstringOptional

JWS [JWS] alg algorithm [JWA] that MUST be used for signing Request Objects sent to the OP. All Request Objects from this Client MUST be rejected, if not signed with this algorithm. Request Objects are described in Section 6.1 of OpenID Connect Core 1.0 [OpenID.Core]. This algorithm MUST be used both when the Request Object is passed by value (using the request parameter) and when it is passed by reference (using the request_uri parameter). Servers SHOULD support RS256. The value none MAY be used. The default, if omitted, is that any algorithm supported by the OP and the RP MAY be used.

request_object_encryption_algstringOptional

JWE [JWE] alg algorithm [JWA] the RP is declaring that it may use for encrypting Request Objects sent to the OP. This parameter SHOULD be included when symmetric encryption will be used, since this signals to the OP that a client_secret value needs to be returned from which the symmetric key will be derived, that might not otherwise be returned. The RP MAY still use other supported encryption algorithms or send unencrypted Request Objects, even when this parameter is present. If both signing and encryption are requested, the Request Object will be signed then encrypted, with the result being a Nested JWT, as defined in [JWT]. The default, if omitted, is that the RP is not declaring whether it might encrypt any Request Objects.

request_object_encryption_encstringOptional

JWE enc algorithm [JWA] the RP is declaring that it may use for encrypting Request Objects sent to the OP. If request_object_encryption_alg is specified, the default for this value is A128CBC-HS256. When request_object_encryption_enc is included, request_object_encryption_alg MUST also be provided.

token_endpoint_auth_methodstringOptional

Requested Client Authentication method for the Token Endpoint. The options are client_secret_post, client_secret_basic, client_secret_jwt, private_key_jwt, and none, as described in Section 9 of OpenID Connect Core 1.0 [OpenID.Core]. Other authentication methods MAY be defined by extensions. If omitted, the default is client_secret_basic -- the HTTP Basic Authentication Scheme specified in Section 2.3.1 of OAuth 2.0 [RFC6749].

token_endpoint_auth_signing_algstringOptional

JWS [JWS] alg algorithm [JWA] that MUST be used for signing the JWT [JWT] used to authenticate the Client at the Token Endpoint for the private_key_jwt and client_secret_jwt authentication methods. All Token Requests using these authentication methods from this Client MUST be rejected, if the JWT is not signed with this algorithm. Servers SHOULD support RS256. The value none MUST NOT be used. The default, if omitted, is that any algorithm supported by the OP and the RP MAY be used.

default_max_ageintegerOptional

Default Maximum Authentication Age. Specifies that the End-User MUST be actively authenticated if the End-User was authenticated longer ago than the specified number of seconds. The max_age request parameter overrides this default value. If omitted, no default Maximum Authentication Age is specified.

require_auth_timebooleanOptional

Boolean value specifying whether the auth_time Claim in the ID Token is REQUIRED. It is REQUIRED when the value is true.

default_acr_valuesstring[]Optional

Default requested Authentication Context Class Reference values. Array of strings that specifies the default acr values that the OP is being requested to use for processing requests from this Client, with the values appearing in order of preference.

initiate_login_uristringOptional

URI using the https scheme that a third party can use to initiate a login by the RP, as specified in Section 4 of OpenID Connect Core 1.0 [OpenID.Core].

request_urisstring[]Optional

Array of request_uri values that are pre-registered by the RP for use at the OP.

scopestring[]Optional

String containing a space-separated list of scope values

software_idstringOptional

A unique identifier string (e.g., a Universally Unique Identifier (UUID)) assigned by the client developer or software publisher used by registration endpoints to identify the client software to be dynamically registered.

software_versionstringOptional

A version identifier string for the client software identified by "software_id". The value of the "software_version" SHOULD change on any update to the client software identified by the same "software_id".

software_statementstringOptional

A software statement containing client metadata values about the client software as claims. This is a string value containing the entire signed JWT.

Responses
201
Claims about the registred client
application/json
post
POST /unknown/register HTTP/1.1
Host: auth.authority.io
Content-Type: application/json
Accept: */*
Content-Length: 1084

{
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}
{
  "client_id": "text",
  "client_secret": "text",
  "registration_access_token": "text",
  "registration_client_uri": "text",
  "client_id_issued_at": "text",
  "client_secret_expires_at": 1,
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}

Renew the client secret of a registred client.

post

Renew the client secret of a registred client.

Path parameters
client_idstringRequired

ID of the client

Header parameters
AuthorizationstringRequired

Bearer token obtained on the register process through the registration_access_token property giving access only to one client matching the client_id path parameter. An admin token can be also obtained through the client crendentials flow with as mandatory scope "dcr_admin".

Responses
200
Claims about the updated client.
application/json
post
POST /unknown/register/{client_id}/renew_secret HTTP/1.1
Host: auth.authority.io
Authorization: text
Accept: */*
{
  "client_id": "text",
  "client_secret": "text",
  "registration_access_token": "text",
  "registration_client_uri": "text",
  "client_id_issued_at": "text",
  "client_secret_expires_at": 1,
  "redirect_uris": [
    "text"
  ],
  "response_types": [
    "text"
  ],
  "grant_types": [
    "text"
  ],
  "application_type": "text",
  "contacts": [
    "text"
  ],
  "client_name": "text",
  "logo_uri": "text",
  "client_uri": "text",
  "policy_uri": "text",
  "tos_uri": "text",
  "jwks_uri": "text",
  "jwks": {
    "keys": [
      {
        "kty": "text",
        "use": "text",
        "key_ops": "text",
        "alg": "text",
        "kid": "text",
        "x5u": "text",
        "x5c": "text",
        "x5t": "text",
        "x5t#S256": "text"
      }
    ]
  },
  "sector_identifier_uri": "text",
  "subject_type": "text",
  "id_token_signed_response_alg": "text",
  "id_token_encrypted_response_alg": "text",
  "id_token_encrypted_response_enc": "text",
  "userinfo_signed_response_alg": "text",
  "userinfo_encrypted_response_alg": "text",
  "userinfo_encrypted_response_enc": "text",
  "request_object_signing_alg": "text",
  "request_object_encryption_alg": "text",
  "request_object_encryption_enc": "text",
  "token_endpoint_auth_method": "text",
  "token_endpoint_auth_signing_alg": "text",
  "default_max_age": 1,
  "require_auth_time": true,
  "default_acr_values": [
    "text"
  ],
  "initiate_login_uri": "text",
  "request_uris": [
    "text"
  ],
  "scope": [
    "text"
  ],
  "software_id": "text",
  "software_version": "text",
  "software_statement": "text"
}

Last updated

Was this helpful?