@Immutable public class LogoutRequest extends AbstractRequest
Example HTTP request:
https://server.example.com/op/logout? id_token_hint=eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient.example.org%2Fpost-logout &state=af0ifjsldkj
Related specifications:
Constructor and Description |
---|
LogoutRequest(URI uri)
Creates a new OpenID Connect logout request without a post-logout
redirection.
|
LogoutRequest(URI uri,
com.nimbusds.jwt.JWT idTokenHint)
Creates a new OpenID Connect logout request without a post-logout
redirection.
|
LogoutRequest(URI uri,
com.nimbusds.jwt.JWT idTokenHint,
URI postLogoutRedirectURI,
State state)
Creates a new OpenID Connect logout request.
|
Modifier and Type | Method and Description |
---|---|
com.nimbusds.jwt.JWT |
getIDTokenHint()
Returns the ID token hint.
|
URI |
getPostLogoutRedirectionURI()
Return the post-logout redirection URI.
|
State |
getState()
Returns the state parameter for a post-logout redirection URI.
|
static LogoutRequest |
parse(HTTPRequest httpRequest)
Parses a logout request from the specified HTTP request.
|
static LogoutRequest |
parse(Map<String,String> params)
Parses a logout request from the specified parameters.
|
static LogoutRequest |
parse(String query)
Parses a logout request from the specified URI query string.
|
static LogoutRequest |
parse(URI uri)
Parses a logout request from the specified URI.
|
static LogoutRequest |
parse(URI uri,
Map<String,String> params)
Parses a logout request from the specified parameters.
|
static LogoutRequest |
parse(URI uri,
String query)
Parses a logout request from the specified URI query string.
|
HTTPRequest |
toHTTPRequest()
Returns the matching HTTP request.
|
Map<String,String> |
toParameters()
Returns the parameters for this logout request.
|
String |
toQueryString()
Returns the URI query string for this logout request.
|
URI |
toURI()
Returns the complete URI representation for this logout request,
consisting of the
end-session endpoint URI
with the query string appended. |
getEndpointURI
public LogoutRequest(URI uri, com.nimbusds.jwt.JWT idTokenHint, URI postLogoutRedirectURI, State state)
uri
- The URI of the end-session endpoint.
May be null
if the
toHTTPRequest()
method will not
be used.idTokenHint
- The ID token hint (recommended),
null
if not specified.postLogoutRedirectURI
- The optional post-logout redirection
URI, null
if not specified.state
- The optional state parameter for the
post-logout redirection URI,
null
if not specified.public LogoutRequest(URI uri, com.nimbusds.jwt.JWT idTokenHint)
uri
- The URI of the end-session endpoint. May be
null
if the toHTTPRequest()
method
will not be used.idTokenHint
- The ID token hint (recommended), null
if
not specified.public LogoutRequest(URI uri)
uri
- The URI of the end-session endpoint. May be null
if the toHTTPRequest()
method will not be used.public com.nimbusds.jwt.JWT getIDTokenHint()
null
if not specified.public URI getPostLogoutRedirectionURI()
null
if not
specified.public State getState()
null
if not specified.public Map<String,String> toParameters()
Example parameters:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... post_logout_redirect_uri = https://client.example.com/post-logout state = af0ifjsldkj
public String toQueryString()
Note that the '?' character preceding the query string in an URI is not included in the returned string.
Example URI query string:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
public URI toURI()
end-session endpoint URI
with the query string
appended.
Example URI:
https://server.example.com/logout? id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
public HTTPRequest toHTTPRequest()
Request
public static LogoutRequest parse(Map<String,String> params) throws ParseException
Example parameters:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... post_logout_redirect_uri = https://client.example.com/post-logout state = af0ifjsldkj
params
- The parameters, empty map if none. Must not be
null
.ParseException
- If the parameters couldn't be parsed to a
logout request.public static LogoutRequest parse(URI uri, Map<String,String> params) throws ParseException
Example parameters:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... post_logout_redirect_uri = https://client.example.com/post-logout state = af0ifjsldkj
uri
- The URI of the end-session endpoint. May be
null
if the toHTTPRequest()
method
will not be used.params
- The parameters, empty map if none. Must not be
null
.ParseException
- If the parameters couldn't be parsed to a
logout request.public static LogoutRequest parse(String query) throws ParseException
Example URI query string:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
query
- The URI query string, null
if none.ParseException
- If the query string couldn't be parsed to a
logout request.public static LogoutRequest parse(URI uri, String query) throws ParseException
Example URI query string:
id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
uri
- The URI of the end-session endpoint. May be
null
if the toHTTPRequest()
method
will not be used.query
- The URI query string, null
if none.ParseException
- If the query string couldn't be parsed to a
logout request.public static LogoutRequest parse(URI uri) throws ParseException
Example URI:
https://server.example.com/logout? id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
uri
- The URI. Must not be null
.ParseException
- If the URI couldn't be parsed to a logout
request.public static LogoutRequest parse(HTTPRequest httpRequest) throws ParseException
Example HTTP request (GET):
https://server.example.com/logout? id_token_hint = eyJhbGciOiJSUzI1NiJ9.eyJpc3Mi... &post_logout_redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fpost-logout &state=af0ifjsldkj
httpRequest
- The HTTP request. Must not be null
.ParseException
- If the HTTP request couldn't be parsed to a
logout request.Copyright © 2018 Connect2id Ltd.. All rights reserved.