com.nimbusds.oauth2.sdk.device.DeviceAuthorizationRequest Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of oauth2-oidc-sdk Show documentation
Show all versions of oauth2-oidc-sdk Show documentation
OAuth 2.0 SDK with OpenID Connection extensions for developing client
and server applications.
/*
* oauth2-oidc-sdk
*
* Copyright 2012-2016, Connect2id Ltd and contributors.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use
* this file except in compliance with the License. You may obtain a copy of the
* License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed
* under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
*/
package com.nimbusds.oauth2.sdk.device;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.util.*;
import net.jcip.annotations.Immutable;
import com.nimbusds.oauth2.sdk.*;
import com.nimbusds.oauth2.sdk.auth.ClientAuthentication;
import com.nimbusds.oauth2.sdk.http.CommonContentTypes;
import com.nimbusds.oauth2.sdk.http.HTTPRequest;
import com.nimbusds.oauth2.sdk.id.ClientID;
import com.nimbusds.oauth2.sdk.util.MapUtils;
import com.nimbusds.oauth2.sdk.util.MultivaluedMapUtils;
import com.nimbusds.oauth2.sdk.util.StringUtils;
import com.nimbusds.oauth2.sdk.util.URLUtils;
/**
* Device authorisation request. Used to start the authorization flow for
* browserless and input constraint devices. Supports custom request
* parameters.
*
* Extending classes may define additional request parameters as well as
* enforce tighter requirements on the base parameters.
*
*
Example HTTP request:
*
*
* POST /device_authorization HTTP/1.1
* Host: server.example.com
* Content-Type: application/x-www-form-urlencoded
*
* client_id=459691054427
*
*
* Related specifications:
*
*
* - OAuth 2.0 Device Authorization Grant (draft-ietf-oauth-device-flow-15)
*
*/
@Immutable
public class DeviceAuthorizationRequest extends AbstractOptionallyIdentifiedRequest {
/**
* The registered parameter names.
*/
private static final Set REGISTERED_PARAMETER_NAMES;
static {
Set p = new HashSet<>();
p.add("client_id");
p.add("scope");
REGISTERED_PARAMETER_NAMES = Collections.unmodifiableSet(p);
}
/**
* The scope (optional).
*/
private final Scope scope;
/**
* Custom parameters.
*/
private final Map> customParams;
/**
* Builder for constructing authorisation requests.
*/
public static class Builder {
/**
* The endpoint URI (optional).
*/
private URI uri;
/**
* The client authentication (optional).
*/
private final ClientAuthentication clientAuth;
/**
* The client identifier (required if not authenticated).
*/
private final ClientID clientID;
/**
* The scope (optional).
*/
private Scope scope;
/**
* Custom parameters.
*/
private final Map> customParams = new HashMap<>();
/**
* Creates a new devize authorization request builder.
*
* @param clientID The client identifier. Corresponds to the {@code client_id}
* parameter. Must not be {@code null}.
*/
public Builder(final ClientID clientID) {
if (clientID == null)
throw new IllegalArgumentException("The client ID must not be null");
this.clientID = clientID;
this.clientAuth = null;
}
/**
* Creates a new device authorization request builder for an
* authenticated request.
*
* @param clientAuth The client authentication. Must not be
* {@code null}.
*/
public Builder(final ClientAuthentication clientAuth) {
if (clientAuth == null)
throw new IllegalArgumentException("The client authentication must not be null");
this.clientID = null;
this.clientAuth = clientAuth;
}
/**
* Creates a new device authorization request builder from the
* specified request.
*
* @param request The device authorization request. Must not be
* {@code null}.
*/
public Builder(final DeviceAuthorizationRequest request) {
uri = request.getEndpointURI();
clientAuth = request.getClientAuthentication();
scope = request.scope;
clientID = request.getClientID();
customParams.putAll(request.getCustomParameters());
}
/**
* Sets the scope. Corresponds to the optional {@code scope}
* parameter.
*
* @param scope The scope, {@code null} if not specified.
*
* @return This builder.
*/
public Builder scope(final Scope scope) {
this.scope = scope;
return this;
}
/**
* Sets a custom parameter.
*
* @param name The parameter name. Must not be {@code null}.
* @param values The parameter values, {@code null} if not
* specified.
*
* @return This builder.
*/
public Builder customParameter(final String name, final String... values) {
if (values == null || values.length == 0) {
customParams.remove(name);
} else {
customParams.put(name, Arrays.asList(values));
}
return this;
}
/**
* Sets the URI of the endpoint (HTTP or HTTPS) for which the
* request is intended.
*
* @param uri The endpoint URI, {@code null} if not specified.
*
* @return This builder.
*/
public Builder endpointURI(final URI uri) {
this.uri = uri;
return this;
}
/**
* Builds a new device authorization request.
*
* @return The device authorization request.
*/
public DeviceAuthorizationRequest build() {
try {
if (clientAuth == null) {
return new DeviceAuthorizationRequest(uri, clientID, scope, customParams);
} else {
return new DeviceAuthorizationRequest(uri, clientAuth, scope, customParams);
}
} catch (IllegalArgumentException e) {
throw new IllegalStateException(e.getMessage(), e);
}
}
}
/**
* Creates a new minimal device authorization request.
*
* @param uri The URI of the device authorization endpoint. May be
* {@code null} if the {@link #toHTTPRequest} method
* will not be used.
* @param clientID The client identifier. Corresponds to the
* {@code client_id} parameter. Must not be
* {@code null}.
*/
public DeviceAuthorizationRequest(final URI uri, final ClientID clientID) {
this(uri, clientID, null, null);
}
/**
* Creates a new device authorization request.
*
* @param uri The URI of the device authorization endpoint. May be
* {@code null} if the {@link #toHTTPRequest} method
* will not be used.
* @param clientID The client identifier. Corresponds to the
* {@code client_id} parameter. Must not be {@code null}.
* @param scope The request scope. Corresponds to the optional
* {@code scope} parameter. {@code null} if not
* specified.
*/
public DeviceAuthorizationRequest(final URI uri, final ClientID clientID, final Scope scope) {
this(uri, clientID, scope, null);
}
/**
* Creates a new device authorization request with extension and custom
* parameters.
*
* @param uri The URI of the device authorization endpoint.
* May be {@code null} if the {@link #toHTTPRequest}
* method will not be used.
* @param clientID The client identifier. Corresponds to the
* {@code client_id} parameter. Must not be
* {@code null}.
* @param scope The request scope. Corresponds to the optional
* {@code scope} parameter. {@code null} if not
* specified.
* @param customParams Custom parameters, empty map or {@code null} if
* none.
*/
public DeviceAuthorizationRequest(final URI uri,
final ClientID clientID,
final Scope scope,
final Map> customParams) {
super(uri, clientID);
if (clientID == null)
throw new IllegalArgumentException("The client ID must not be null");
this.scope = scope;
if (MapUtils.isNotEmpty(customParams)) {
this.customParams = Collections.unmodifiableMap(customParams);
} else {
this.customParams = Collections.emptyMap();
}
}
/**
* Creates a new authenticated device authorization request with
* extension and custom parameters.
*
* @param uri The URI of the device authorization endpoint.
* May be {@code null} if the {@link #toHTTPRequest}
* method will not be used.
* @param clientAuth The client authentication. Must not be
* {@code null}.
* @param scope The request scope. Corresponds to the optional
* {@code scope} parameter. {@code null} if not
* specified.
* @param customParams Custom parameters, empty map or {@code null} if
* none.
*/
public DeviceAuthorizationRequest(final URI uri,
final ClientAuthentication clientAuth,
final Scope scope,
final Map> customParams) {
super(uri, clientAuth);
if (clientAuth == null)
throw new IllegalArgumentException("The client authentication must not be null");
this.scope = scope;
if (MapUtils.isNotEmpty(customParams)) {
this.customParams = Collections.unmodifiableMap(customParams);
} else {
this.customParams = Collections.emptyMap();
}
}
/**
* Returns the registered (standard) OAuth 2.0 device authorization
* request parameter names.
*
* @return The registered OAuth 2.0 device authorization request
* parameter names, as a unmodifiable set.
*/
public static Set getRegisteredParameterNames() {
return REGISTERED_PARAMETER_NAMES;
}
/**
* Gets the scope. Corresponds to the optional {@code scope} parameter.
*
* @return The scope, {@code null} if not specified.
*/
public Scope getScope() {
return scope;
}
/**
* Returns the additional custom parameters.
*
* @return The additional custom parameters as a unmodifiable map,
* empty map if none.
*/
public Map> getCustomParameters() {
return customParams;
}
/**
* Returns the specified custom parameter.
*
* @param name The parameter name. Must not be {@code null}.
*
* @return The parameter value(s), {@code null} if not specified.
*/
public List getCustomParameter(final String name) {
return customParams.get(name);
}
/**
* Returns the matching HTTP request.
*
* @return The HTTP request.
*/
@Override
public HTTPRequest toHTTPRequest() {
if (getEndpointURI() == null)
throw new SerializeException("The endpoint URI is not specified");
URL endpointURL;
try {
endpointURL = getEndpointURI().toURL();
} catch (MalformedURLException e) {
throw new SerializeException(e.getMessage(), e);
}
HTTPRequest httpRequest = new HTTPRequest(HTTPRequest.Method.POST, endpointURL);
httpRequest.setContentType(CommonContentTypes.APPLICATION_URLENCODED);
if (getClientAuthentication() != null) {
getClientAuthentication().applyTo(httpRequest);
}
Map> params = httpRequest.getQueryParameters();
if (scope != null && !scope.isEmpty()) {
params.put("scope", Collections.singletonList(scope.toString()));
}
if (getClientID() != null) {
params.put("client_id", Collections.singletonList(getClientID().getValue()));
}
if (!getCustomParameters().isEmpty()) {
params.putAll(getCustomParameters());
}
httpRequest.setQuery(URLUtils.serializeParameters(params));
return httpRequest;
}
/**
* Parses an device authorization request from the specified HTTP
* request.
*
* Example HTTP request (GET):
*
*
* POST /device_authorization HTTP/1.1
* Host: server.example.com
* Content-Type: application/x-www-form-urlencoded
*
* client_id=459691054427
*
*
* @param httpRequest The HTTP request. Must not be {@code null}.
*
* @return The device authorization request.
*
* @throws ParseException If the HTTP request couldn't be parsed to an
* device authorization request.
*/
public static DeviceAuthorizationRequest parse(final HTTPRequest httpRequest) throws ParseException {
// Only HTTP POST accepted
URI uri;
try {
uri = httpRequest.getURL().toURI();
} catch (URISyntaxException e) {
throw new ParseException(e.getMessage(), e);
}
httpRequest.ensureMethod(HTTPRequest.Method.POST);
httpRequest.ensureContentType(CommonContentTypes.APPLICATION_URLENCODED);
// Parse client authentication, if any
ClientAuthentication clientAuth;
try {
clientAuth = ClientAuthentication.parse(httpRequest);
} catch (ParseException e) {
throw new ParseException(e.getMessage(),
OAuth2Error.INVALID_REQUEST.appendDescription(": " + e.getMessage()));
}
// No fragment! May use query component!
Map> params = httpRequest.getQueryParameters();
ClientID clientID;
String v;
if (clientAuth == null) {
// Parse mandatory client ID for unauthenticated requests
v = MultivaluedMapUtils.getFirstValue(params, "client_id");
if (StringUtils.isBlank(v)) {
String msg = "Missing \"client_id\" parameter";
throw new ParseException(msg,
OAuth2Error.INVALID_REQUEST.appendDescription(": " + msg));
}
clientID = new ClientID(v);
} else {
clientID = null;
}
// Parse optional scope
v = MultivaluedMapUtils.getFirstValue(params, "scope");
Scope scope = null;
if (StringUtils.isNotBlank(v))
scope = Scope.parse(v);
// Parse custom parameters
Map> customParams = null;
for (Map.Entry> p : params.entrySet()) {
if (!REGISTERED_PARAMETER_NAMES.contains(p.getKey())) {
// We have a custom parameter
if (customParams == null) {
customParams = new HashMap<>();
}
customParams.put(p.getKey(), p.getValue());
}
}
if (clientAuth == null) {
return new DeviceAuthorizationRequest(uri, clientID, scope, customParams);
} else {
return new DeviceAuthorizationRequest(uri, clientAuth, scope, customParams);
}
}
}