v16

OpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-04-0886158866.0 KB
Authorization Endpoint

Issue Authorization Response

This API parses request parameters of an authorization request and returns necessary data for the authorization server implementation to process the authorization request further.

post/api/{serviceId}/auth/authorization/issue

Path parameters

serviceIdstring required

A service ID.

Request body

ticketstring required

The ticket issued from Authlete /auth/authorization API.

subjectstring required

The subject (= a user account managed by the service) who has granted authorization to the client application.

authTimeinteger

The time when the authentication of the end-user occurred. Its value is the number of seconds from 1970-01-01.

acrstring

The Authentication Context Class Reference performed for the end-user authentication.

claimsstring

The claims of the end-user (= pieces of information about the end-user) in JSON format. See OpenID Connect Core 1.0, 5.1. Standard Claims for details about the format.

scopesstring[]

Scopes to associate with an access token and/or an authorization code. If a non-empty string array is given, it replaces the scopes specified by the original authorization request.

substring

The value of the sub claim to embed in an ID token. If this request parameter is null or empty, the value of the subject request parameter is used as the value of the sub claim.

idtHeaderParamsstring

JSON that represents additional JWS header parameters for ID tokens that may be issued based on the authorization request.

claimsForTxstring

Claim key-value pairs that are used to compute transformed claims.

consentedClaimsstring[]

the claims that the user has consented for the client application to know.

jwtAtClaimsstring

Additional claims that are added to the payload part of the JWT access token.

accessTokenstring

The representation of an access token that may be issued as a result of the Authlete API call.

accessTokenDurationinteger

The duration (in seconds) of the access token that may be issued as a result of the Authlete API call.

When this request parameter holds a positive integer, it is used as the duration of the access token in. In other cases, this request parameter is ignored.

sessionIdstring

The session ID of the user's authentication session. The specified value will be embedded in the ID token as the value of the sid claim. This parameter needs to be provided only if you want to support the OpenID Connect Native SSO for Mobile Apps 1.0 specification (a.k.a. "Native SSO"). To enable support for the Native SSO specification, the nativeSsoSupported property of your service must be set to true.

idTokenAudTypestring

The type of the aud claim of the ID token being issued. Valid values are as follows.

ValueDescription
"array"The type of the aud claim is always an array of strings.
"string"The type of the aud claim is always a single string.
nullThe type of the aud claim remains the same as before.

This request parameter takes precedence over the idTokenAudType property of the service.

verifiedClaimsForTxstring[]

Values of verified claims requested indirectly by "transformed claims".

Response

resultCodestring

The code which represents the result of the API call.

resultMessagestring

A short message which explains the result of the API call.

action'INTERNAL_SERVER_ERROR' | 'BAD_REQUEST' | 'LOCATION' | 'FORM'

The next action that the authorization server implementation should take.

responseContentstring

The content that the authorization server implementation is to return to the client application. Its format varies depending on the value of action parameter.

accessTokenstring

The newly issued access token. Note that an access token is issued from an authorization endpoint only when response_type contains token.

accessTokenExpiresAtinteger

The datetime at which the newly issued access token will expire. The value is represented in milliseconds since the Unix epoch (1970-01-01).

accessTokenDurationinteger

The duration of the newly issued access token in seconds.

idTokenstring

The newly issued ID token. Note that an ID token is issued from an authorization endpoint only when response_type contains id_token.

authorizationCodestring

The newly issued authorization code. Note that an authorization code is issued only when response_type contains code.

jwtAccessTokenstring

The newly issued access token in JWT format. If the service is not configured to issue JWT-based access tokens, this property is always set to null.