net.openid.appauth

Class AuthorizationServiceConfiguration

java.lang.Object

net.openid.appauth.AuthorizationServiceConfiguration

public class AuthorizationServiceConfiguration
extends Object

Configuration details required to interact with an authorization service.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AuthorizationServiceConfiguration.RetrieveConfigurationCallback Callback interface for configuration retrieval.

Field Summary

Fields

Modifier and Type	Field and Description
Uri	authorizationEndpoint The authorization service's endpoint.
AuthorizationServiceDiscovery	discoveryDoc The discovery document describing the service, if it is an OpenID Connect provider.
static String	OPENID_CONFIGURATION_WELL_KNOWN_PATH The standard path at which an OpenID Connect discovery document can be found under an issuer's base URI.
Uri	tokenEndpoint The authorization service's token exchange and refresh endpoint.

Constructor Summary

Constructors

Constructor and Description
AuthorizationServiceConfiguration(AuthorizationServiceDiscovery discoveryDoc) Creates an service configuration for an OpenID Connect provider, based on its discovery document.
AuthorizationServiceConfiguration(Uri authorizationEndpoint, Uri tokenEndpoint) Creates a service configuration for a basic OAuth2 provider.

Method Summary

Modifier and Type	Method and Description
static void	fetchFromIssuer(Uri openIdConnectIssuerUri, AuthorizationServiceConfiguration.RetrieveConfigurationCallback callback) Fetch an AuthorizationServiceConfiguration from an OpenID Connect issuer URI.
static void	fetchFromUrl(Uri openIdConnectDiscoveryUri, AuthorizationServiceConfiguration.RetrieveConfigurationCallback callback) Fetch a AuthorizationServiceConfiguration from an OpenID Connect discovery URI.
static AuthorizationServiceConfiguration	fromJson(JSONObject json) Reads an Authorization service configuration from a JSON representation produced by the toJson() method or some other equivalent producer.
static AuthorizationServiceConfiguration	fromJson(String jsonStr) Reads an Authorization service configuration from a JSON representation produced by the toJson() method or some other equivalent producer.
JSONObject	toJson() Converts the authorization service configuration to JSON for storage or transmission.
String	toJsonString() Converts the authorization service configuration to a JSON string for storage or transmission.

Methods inherited from class java.lang.Object

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

Field Detail

OPENID_CONFIGURATION_WELL_KNOWN_PATH

public static final String OPENID_CONFIGURATION_WELL_KNOWN_PATH

The standard path at which an OpenID Connect discovery document can be found under an issuer's base URI.

See Also:

"OpenID Connect discovery", Constant Field Values

authorizationEndpoint

@NonNull
public final Uri authorizationEndpoint

The authorization service's endpoint.

tokenEndpoint

@NonNull
public final Uri tokenEndpoint

The authorization service's token exchange and refresh endpoint.

discoveryDoc

@Nullable
public final AuthorizationServiceDiscovery discoveryDoc

The discovery document describing the service, if it is an OpenID Connect provider.

Constructor Detail

AuthorizationServiceConfiguration

public AuthorizationServiceConfiguration(@NonNull
                                         Uri authorizationEndpoint,
                                         @NonNull
                                         Uri tokenEndpoint)

Creates a service configuration for a basic OAuth2 provider.

Parameters:

authorizationEndpoint - The authorization endpoint URI for the service.

tokenEndpoint - The token endpoint URI for the service.

AuthorizationServiceConfiguration

public AuthorizationServiceConfiguration(@NonNull
                                         AuthorizationServiceDiscovery discoveryDoc)

Creates an service configuration for an OpenID Connect provider, based on its discovery document.

Parameters:

discoveryDoc - The OpenID Connect discovery document which describes this service.

Method Detail

toJson

@NonNull
public JSONObject toJson()

Converts the authorization service configuration to JSON for storage or transmission.

toJsonString

public String toJsonString()

Converts the authorization service configuration to a JSON string for storage or transmission.

fromJson

@NonNull
public static AuthorizationServiceConfiguration fromJson(@NonNull
                                                                  JSONObject json)
                                                           throws JSONException

Reads an Authorization service configuration from a JSON representation produced by the toJson() method or some other equivalent producer.

Throws:

JSONException - if the provided JSON does not match the expected structure.

fromJson

public static AuthorizationServiceConfiguration fromJson(@NonNull
                                                         String jsonStr)
                                                  throws JSONException

Reads an Authorization service configuration from a JSON representation produced by the toJson() method or some other equivalent producer.

Throws:

JSONException - if the provided JSON does not match the expected structure.

fetchFromIssuer

public static void fetchFromIssuer(@NonNull
                                   Uri openIdConnectIssuerUri,
                                   @NonNull
                                   AuthorizationServiceConfiguration.RetrieveConfigurationCallback callback)

Fetch an AuthorizationServiceConfiguration from an OpenID Connect issuer URI. This method is equivalent to fetchFromUrl(Uri, RetrieveConfigurationCallback), but automatically appends the OpenID connect well-known configuration path to the URI.

Parameters:

openIdConnectIssuerUri - The issuer URI, e.g. "https://accounts.google.com"

callback - The callback to invoke upon completion.

See Also:

"OpenID Connect discovery"

fetchFromUrl

public static void fetchFromUrl(@NonNull
                                Uri openIdConnectDiscoveryUri,
                                @NonNull
                                AuthorizationServiceConfiguration.RetrieveConfigurationCallback callback)

Fetch a AuthorizationServiceConfiguration from an OpenID Connect discovery URI.

Parameters:

openIdConnectDiscoveryUri - The OpenID Connect discovery URI

callback - A callback to invoke upon completion

See Also:

"OpenID Connect discovery"