Package com.nimbusds.oauth2.sdk.ciba

Class CIBAErrorResponse

java.lang.Object

com.nimbusds.oauth2.sdk.ciba.CIBAResponse

com.nimbusds.oauth2.sdk.ciba.CIBAErrorResponse

All Implemented Interfaces:

ErrorResponse, Message, Response

@Immutable
public class CIBAErrorResponse
extends CIBAResponse
implements ErrorResponse

CIBA error response from an OpenID provider / OAuth 2.0 authorisation server backend authentication endpoint.

Standard CIBA errors:

• OAuth2Error.INVALID_REQUEST
• {@link OAuth2Error#INVALID_SCOPE)}
• OAuth2Error.INVALID_CLIENT
• OAuth2Error.UNAUTHORIZED_CLIENT
• OAuth2Error.ACCESS_DENIED
• CIBAError.EXPIRED_LOGIN_HINT_TOKEN
• CIBAError.UNKNOWN_USER_ID
• CIBAError.MISSING_USER_CODE
• CIBAError.INVALID_USER_CODE
• CIBAError.INVALID_BINDING_MESSAGE

Example HTTP response:

 HTTP/1.1 400 Bad Request
 Content-Type: application/json

 {
   "error": "unauthorized_client",
   "error_description": "The client 'client.example.org' is not allowed to use CIBA"
 }
 

Related specifications:

• OpenID Connect CIBA Flow - Core 1.0, sections 11, 12 and 13.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CIBAErrorResponse()	Creates a new CIBA error response.
	CIBAErrorResponse(ErrorObject error)	Creates a new CIBA error response.

Method Summary

Modifier and Type	Method	Description
ErrorObject	getErrorObject()	Gets the error associated with the error response.
static Set<ErrorObject>	getStandardErrors()	Gets the standard OAuth 2.0 errors for a CIBA error response.
boolean	indicatesSuccess()	Checks if the response indicates success.
static CIBAErrorResponse	parse(HTTPResponse httpResponse)	Parses a CIBA error response from the specified HTTP response.
static CIBAErrorResponse	parse(net.minidev.json.JSONObject jsonObject)	Parses a CIBA error response from the specified JSON object.
HTTPResponse	toHTTPResponse()	Returns the matching HTTP response.
net.minidev.json.JSONObject	toJSONObject()	Returns the JSON object for this CIBA error response.

Methods inherited from class com.nimbusds.oauth2.sdk.ciba.CIBAResponse

toErrorResponse, toRequestAcknowledgement

Methods inherited from class java.lang.Object

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

Constructor Detail

CIBAErrorResponse

protected CIBAErrorResponse()

Creates a new CIBA error response. No OAuth 2.0 error is specified.

CIBAErrorResponse

public CIBAErrorResponse(ErrorObject error)

Creates a new CIBA error response.

Parameters:

error - The error. Should match one of the standard errors for a CIBA error response. Must not be null.

Method Detail

getStandardErrors

public static Set<ErrorObject> getStandardErrors()

Gets the standard OAuth 2.0 errors for a CIBA error response.

Returns:

The standard errors, as a read-only set.

indicatesSuccess

public boolean indicatesSuccess()

Description copied from interface: Response

Checks if the response indicates success.

Specified by:

indicatesSuccess in interface Response

Returns:

true if the response indicates success, else false.

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.

toJSONObject

public net.minidev.json.JSONObject toJSONObject()

Returns the JSON object for this CIBA error response.

Returns:

The JSON object for this CIBA error response.

toHTTPResponse

public HTTPResponse toHTTPResponse()

Description copied from interface: Response

Returns the matching HTTP response.

Specified by:

toHTTPResponse in interface Response

Returns:

The HTTP response.

parse

public static CIBAErrorResponse parse(net.minidev.json.JSONObject jsonObject)
                               throws ParseException

Parses a CIBA error response from the specified JSON object.

Parameters:

jsonObject - The JSON object to parse. Its status code must not be 200 (OK). Must not be null.

Returns:

The CIBA error response.

Throws:

ParseException - If parsing failed.

parse

public static CIBAErrorResponse parse(HTTPResponse httpResponse)
                               throws ParseException

Parses a CIBA error response from the specified HTTP response.

Parameters:

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

Returns:

The CIBA error response.

Throws:

ParseException - If parsing failed.