Authorization

The Pushed Authorization Endpoint performs Authentication Request registration

Changed on

Registers Pushed Authorization Request at Pushed Authorization Endpoint using request parameters defined by https://datatracker.ietf.org/doc/html/draft-ietf-oauth-par-08.

post/restv1/par

Request

  • Base URL
    https://jans.local.io/jans-auth
  • Auth
    none declared

Request body application/x-www-form-urlencoded

scopestring required

OpenID Connect requests MUST contain the openid scope value. If the openid scope value is not present, the behavior is entirely unspecified. Other scope values MAY be present.

response_typestring required

OAuth 2.0 Response Type value that determines the authorization processing flow to be used, including what parameters are returned from the endpoints used.

client_idstring required

OAuth 2.0 Client Identifier valid at the Authorization Server.

redirect_uristring required

Redirection URI to which the response will be sent. This URI MUST exactly match one of the Redirection URI values for the Client pre-registered at the OpenID Provider.

statestring

Opaque value used to maintain state between the request and the callback.

response_modestring

Informs the Authorization Server of the mechanism to be used for returning parameters from the Authorization Endpoint.

noncestring

String value used to associate a Client session with an ID Token, and to mitigate replay attacks.

displaystring

ASCII string value that specifies how the Authorization Server displays the authentication and consent user interface pages to the End-User.

promptstring

Space delimited, case sensitive list of ASCII string values that specifies whether the Authorization Server prompts the End-User for reauthentication and consent.

max_ageinteger

Maximum Authentication Age. Specifies the allowable elapsed time in seconds since the last time the End-User was actively authenticated by the OP.

ui_localesstring

End-User's preferred languages and scripts for the user interface, represented as a space-separated list of BCP47 [RFC5646] language tag values, ordered by preference.

id_token_hintstring

ID Token previously issued by the Authorization Server being passed as a hint about the End-User's current or past authenticated session with the Client. If the End-User identified by the ID Token is logged in or is logged in by the request, then the Authorization Server returns a positive response.

login_hintstring

Hint to the Authorization Server about the login identifier the End-User might use to log in (if necessary).

acr_valuesstring

Requested Authentication Context Class Reference values. Space-separated string that specifies the acr values that the Authorization Server is being requested to use for processing this Authentication Request, with the values appearing in order of preference.

amr_valuesstring

AMR Values.

requeststring

This parameter enables OpenID Connect requests to be passed in a single, self-contained parameter and to be optionally signed and/or encrypted. The parameter value is a Request Object value. It represents the request as a JWT whose Claims are the request parameters.

request_session_idstring

Request session id.

session_idstring

Session id of this call.

origin_headersstring

Origin headers. Used in custom workflows.

code_challengestring

PKCE code challenge.

code_challenge_methodstring

PKCE code challenge method.

custom_response_headersstring

Custom Response Headers.

claimsstring

Requested Claims.

Example request

{
  "ui_locales": "\\\"fr-CA fr en\\\" represents a preference for French as spoken in Canada, then French (without a region designation), followed by English (without a region designation)."
}

Response

Created

request_uristring required

The request URI corresponding to the authorization request posted. This URI is used as reference to the respective request data in the subsequent authorization request only. The way the authorization process obtains the authorization request data is at the discretion of the authorization server and out of scope of this specification. There is no need to make the authorization request data available to other parties via this URI.

expires_instring required

A JSON number that represents the lifetime of the request URI in seconds as a positive integer. The request URI lifetime is at the discretion of the authorization server but will typically be relatively short (e.g., between 5 and 600 seconds).

Changes