com.nimbusds.openid.connect.sdk

Class UserInfoErrorResponse

java.lang.Object

com.nimbusds.openid.connect.sdk.UserInfoResponse

com.nimbusds.openid.connect.sdk.UserInfoErrorResponse

All Implemented Interfaces:

ErrorResponse, Message, Response

@Immutable
public final class UserInfoErrorResponse
extends UserInfoResponse
implements ErrorResponse

UserInfo error response. This class is immutable.

Standard OAuth 2.0 Bearer Token errors:

• BearerTokenError.MISSING_TOKEN
• BearerTokenError.INVALID_REQUEST
• BearerTokenError.INVALID_TOKEN
• BearerTokenError.INSUFFICIENT_SCOPE

Example HTTP response:

 HTTP/1.1 401 Unauthorized
 WWW-Authenticate: Bearer realm="example.com",
                   error="invalid_token",
                   error_description="The access token expired"
 

Related specifications:

• OpenID Connect Messages 1.0, section 2.3.3.
• OpenID Connect Standard 1.0, section 4.3.
• OAuth 2.0 Bearer Token Usage (RFC 6750), section 3.1.

Author:

Vladimir Dzhuvinov

Constructor Summary

Constructors

Constructor and Description
UserInfoErrorResponse(BearerTokenError error) Creates a new UserInfo error response.

Method Summary

Methods

Modifier and Type	Method and Description
ErrorObject	getErrorObject() Gets the error associated with the error response.
static Set<BearerTokenError>	getStandardErrors() Gets the standard errors for a UserInfo error response.
static UserInfoErrorResponse	parse(HTTPResponse httpResponse) Parses a UserInfo error response from the specified HTTP response.
static UserInfoErrorResponse	parse(String wwwAuth) Parses a UserInfo error response from the specified HTTP response WWW-Authenticate header.
HTTPResponse	toHTTPResponse() Returns the HTTP response for this UserInfo error response.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UserInfoErrorResponse

public UserInfoErrorResponse(BearerTokenError error)

Creates a new UserInfo error response.

Parameters:

error - The OAuth 2.0 bearer token error. Should match one of the standard errors for a UserInfo error response. Must not be null.

Method Detail

getStandardErrors

public static Set<BearerTokenError> getStandardErrors()

Gets the standard errors for a UserInfo error response.

Returns:

The standard errors, as a read-only set.

getErrorObject

public ErrorObject getErrorObject()

Description copied from interface: ErrorResponse

Gets the error associated with the error response.

Specified by:

getErrorObject in interface ErrorResponse

Returns:

The error, null if none.

toHTTPResponse

public HTTPResponse toHTTPResponse()

Returns the HTTP response for this UserInfo error response.

Example HTTP response:

 HTTP/1.1 401 Unauthorized
 WWW-Authenticate: Bearer realm="example.com",
                   error="invalid_token",
                   error_description="The access token expired"
 

Specified by:

toHTTPResponse in interface Response

Returns:

The HTTP response matching this UserInfo error response.

parse

public static UserInfoErrorResponse parse(String wwwAuth)
                                   throws ParseException

Parses a UserInfo error response from the specified HTTP response WWW-Authenticate header.

Parameters:

wwwAuth - The WWW-Authenticate header value to parse. Must not be null.

Throws:

ParseException - If the WWW-Authenticate header value couldn't be parsed to a UserInfo error response.

parse

public static UserInfoErrorResponse parse(HTTPResponse httpResponse)
                                   throws ParseException

Parses a UserInfo error response from the specified HTTP response.

Note: The HTTP status code is not checked for matching the error code semantics.

Parameters:

httpResponse - The HTTP response to parse. Its status code must not be 200 (OK). Must not be null.

Throws:

ParseException - If the HTTP response couldn't be parsed to a UserInfo error response.