Package com.nimbusds.oauth2.sdk.device

Class DeviceAuthorizationErrorResponse

java.lang.Object

com.nimbusds.oauth2.sdk.device.DeviceAuthorizationResponse

com.nimbusds.oauth2.sdk.device.DeviceAuthorizationErrorResponse

All Implemented Interfaces:

ErrorResponse, Message, Response

@Immutable
public class DeviceAuthorizationErrorResponse
extends DeviceAuthorizationResponse
implements ErrorResponse

OAuth 2.0 device authorization error response.

Standard authorization errors:

• OAuth2Error.INVALID_REQUEST
• OAuth2Error.INVALID_CLIENT
• OAuth2Error.INVALID_SCOPE

Example HTTP response:

 HTTP/1.1 400 Bad Request
 Content-Type: application/json
 Cache-Control: no-store
 Pragma: no-cache
 
 {
  "error" : "invalid_request"
 }
 

Related specifications:

• OAuth 2.0 Device Authorization Grant (RFC 8628)

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DeviceAuthorizationErrorResponse()	Creates a new OAuth 2.0 device authorization error response.
	DeviceAuthorizationErrorResponse(ErrorObject error)	Creates a new OAuth 2.0 device authorization 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 device authorization error response.
boolean	indicatesSuccess()	Checks if the response indicates success.
static DeviceAuthorizationErrorResponse	parse(HTTPResponse httpResponse)	Parses an OAuth 2.0 ciba authorization error, push error or token response - from the specified HTTP response.
static DeviceAuthorizationErrorResponse	parse(net.minidev.json.JSONObject jsonObject)	Parses an OAuth 2.0 device authorization response from the specified JSON object.
HTTPResponse	toHTTPResponse()	Returns the matching HTTP response.
net.minidev.json.JSONObject	toJSONObject()	Returns the JSON object for this token error response.

Methods inherited from class com.nimbusds.oauth2.sdk.device.DeviceAuthorizationResponse

toErrorResponse, toSuccessResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

DeviceAuthorizationErrorResponse

protected DeviceAuthorizationErrorResponse()

Creates a new OAuth 2.0 device authorization error response. No OAuth 2.0 error is specified.

DeviceAuthorizationErrorResponse

public DeviceAuthorizationErrorResponse(ErrorObject error)

Creates a new OAuth 2.0 device authorization error response.

Parameters:

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

Method Detail

getStandardErrors

public static Set<ErrorObject> getStandardErrors()

Gets the standard OAuth 2.0 errors for a device authorization 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 token error response.

Returns:

The JSON object for this token 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 DeviceAuthorizationErrorResponse parse(net.minidev.json.JSONObject jsonObject)
                                              throws ParseException

Parses an OAuth 2.0 device authorization 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 token error response.

Throws:

ParseException - If the JSON object couldn't be parsed to an OAuth 2.0 device authorization error response.

parse

public static DeviceAuthorizationErrorResponse parse(HTTPResponse httpResponse)
                                              throws ParseException

Parses an OAuth 2.0 ciba authorization error, push error or token 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 device authorization error response.

Throws:

ParseException - If the HTTP response couldn't be parsed to an OAuth 2.0 device authorization error response.