SSOOIDC / Client / register_client

register_client#

SSOOIDC.Client.register_client(**kwargs)#

Registers a client with IAM Identity Center. This allows clients to initiate device authorization. The output should be persisted for reuse through many authentication requests.

See also: AWS API Documentation

Request Syntax

response = client.register_client(
    clientName='string',
    clientType='string',
    scopes=[
        'string',
    ]
)
Parameters:
  • clientName (string) –

    [REQUIRED]

    The friendly name of the client.

  • clientType (string) –

    [REQUIRED]

    The type of client. The service supports only public as a client type. Anything other than public will be rejected by the service.

  • scopes (list) –

    The list of scopes that are defined by the client. Upon authorization, this list is used to restrict permissions when granting an access token.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'clientId': 'string',
    'clientSecret': 'string',
    'clientIdIssuedAt': 123,
    'clientSecretExpiresAt': 123,
    'authorizationEndpoint': 'string',
    'tokenEndpoint': 'string'
}

Response Structure

  • (dict) –

    • clientId (string) –

      The unique identifier string for each client. This client uses this identifier to get authenticated by the service in subsequent calls.

    • clientSecret (string) –

      A secret string generated for the client. The client will use this string to get authenticated by the service in subsequent calls.

    • clientIdIssuedAt (integer) –

      Indicates the time at which the clientId and clientSecret were issued.

    • clientSecretExpiresAt (integer) –

      Indicates the time at which the clientId and clientSecret will become invalid.

    • authorizationEndpoint (string) –

      An endpoint that the client can use to request authorization.

    • tokenEndpoint (string) –

      An endpoint that the client can use to create tokens.

Exceptions

  • SSOOIDC.Client.exceptions.InvalidRequestException

  • SSOOIDC.Client.exceptions.InvalidScopeException

  • SSOOIDC.Client.exceptions.InvalidClientMetadataException

  • SSOOIDC.Client.exceptions.InternalServerException