com.authlete.common.dto

Class FederationRegistrationResponse

java.lang.Object

com.authlete.common.dto.ApiResponse

com.authlete.common.dto.FederationRegistrationResponse

All Implemented Interfaces:

Serializable

public class FederationRegistrationResponse
extends ApiResponse

Response from Authlete's /federation/registration API.

Authlete's /federation/registration API returns JSON which can be mapped to this class. The authorization server implementation should retrieve the value of the action response parameter from the API response and take the following steps according to the value.

OK

When the value of the action response parameter is OK, it means that the client registration request was processed successfully and a client was registered.

In this case, the implementation of the federation registration endpoint of the authorization server should return an HTTP response to the API caller with the HTTP status code "200 OK" and the content type "application/entity-statement+jwt". The message body (= an entity statement in the the JWT format) of the response has been prepared by Authlete's /federation/registration API and it is available as the responseContent response parameter.

The implementation of the federation registration endpoint can construct an HTTP response by doing like below.

 200 OK
 Content-Type: application/entity-statement+jwt
 (Other HTTP headers)

 (the value of the responseContent response parameter)

BAD_REQUEST

When the value of the action response parameter is BAD_REQUEST, it means that the client registration request is wrong or that a client having the same entity ID has already been registered.

In this case, the implementation of the federation registration endpoint of the authorization server should return an HTTP response to the API caller with the HTTP status code "400 Bad Request" and the content type "application/json". The message body (= error information in the JSON format) of the response has been prepared by Authlete's /federation/registration API and it is available as the responseContent response parameter.

The implementation of the federation registration endpoint can construct an HTTP response by doing like below.

 400 Bad Request
 Content-Type: application/json
 (Other HTTP headers)

 (the value of the responseContent response parameter)

NOT_FOUND

When the value of the action response parameter is NOT_FOUND, it means that the service configuration has not enabled the feature of OpenID Connect Federation 1.0 and so the federation registration endpoint should not be accessed.

In this case, the implementation of the federation registration endpoint of the authorization server should return an HTTP response to the API caller with the HTTP status code "404 Not Found" and the content type "application/json". The message body (= error information in the JSON format) of the response has been prepared by Authlete's /federation/registration API and it is available as the responseContent response parameter.

The implementation of the federation registration endpoint can construct an HTTP response by doing like below.

 404 Not Found
 Content-Type: application/json
 (Other HTTP headers)

 (the value of the responseContent response parameter)

INTERNAL_SERVER_ERROR

When the value of the action response parameter is INTERNAL_SERVER_ERROR, it means that an unexpected error has occurred on Authlete side or the service has not been set up properly yet. For example, when a JWK Set for federation (Service.federationJwks) has not been set up, when authority hints (Service.authorityHints) have not been set up, etc.

In this case, a simple implementation of the federation registration endpoint would return an HTTP response to the client application with the HTTP status code "500 Internal Server Error" and the content type "application/json". The message body (= error information in the JSON format) of the response has been prepared by Authlete's /federation/registration API and it is available as the responseContent response parameter.

Such a simple implementation of the entity configuration endpoint can construct an HTTP response by doing like below.

 500 Internal Server Error
 Content-Type: application/json
 (Other HTTP headers)

 (the value of the responseContent response parameter)

However, in real commercial deployments, it is rare for an authorization server to return "500 Internal Server Error" when it encounters an unexpected internal error. It's up to implementations of authorization servers what they actually return to API callers in the case of internal server error.

Since:

3.45, Authlete 2.3

See Also:

OpenID Connect Federation 1.0, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FederationRegistrationResponse.Action The next action that the implementation of the federation registration endpoint should take.

Constructor Summary

Constructors

Constructor and Description
FederationRegistrationResponse()

Method Summary

Modifier and Type	Method and Description
FederationRegistrationResponse.Action	getAction() Get the next action that the implementation of the federation registration endpoint should take.
Client	getClient() Get the information about the client that has been registered by the client registration request.
String	getResponseContent() Get the content that the implementation of the federation registration endpoint should use when it constructs a response to the API caller.
FederationRegistrationResponse	setAction(FederationRegistrationResponse.Action action) Set the next action that the implementation of the federation registration endpoint should take.
FederationRegistrationResponse	setClient(Client client) Set the information about the client that has been registered by the client registration request.
FederationRegistrationResponse	setResponseContent(String responseContent) Set the content that the implementation of the federation registration endpoint should use when it constructs a response to the API caller.

Methods inherited from class com.authlete.common.dto.ApiResponse

getResultCode, getResultMessage, setResultCode, setResultMessage

Methods inherited from class java.lang.Object

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

Constructor Detail

FederationRegistrationResponse

public FederationRegistrationResponse()

Method Detail

getAction

public FederationRegistrationResponse.Action getAction()

Get the next action that the implementation of the federation registration endpoint should take.

Returns:

The next action.

setAction

public FederationRegistrationResponse setAction(FederationRegistrationResponse.Action action)

Set the next action that the implementation of the federation registration endpoint should take.

Parameters:

action - The next action.

Returns:

this object.

getResponseContent

public String getResponseContent()

Get the content that the implementation of the federation registration endpoint should use when it constructs a response to the API caller.

The format of the content varies depending on the value of the action response parameter.

Returns:

The content that should be returned from the federation registration endpoint.

setResponseContent

public FederationRegistrationResponse setResponseContent(String responseContent)

Set the content that the implementation of the federation registration endpoint should use when it constructs a response to the API caller.

The format of the content varies depending on the value of the action response parameter.

Parameters:

responseContent - The content that should be returned from the federation registration endpoint.

Returns:

this object.

getClient

public Client getClient()

Get the information about the client that has been registered by the client registration request.

Returns:

The information about the registered client.

setClient

public FederationRegistrationResponse setClient(Client client)

Set the information about the client that has been registered by the client registration request.

Parameters:

client - The information about the registered client.

Returns:

this object.