com.nimbusds.oauth2.sdk.auth

Class PrivateKeyJWT

java.lang.Object

com.nimbusds.oauth2.sdk.auth.ClientAuthentication

com.nimbusds.oauth2.sdk.auth.JWTAuthentication

com.nimbusds.oauth2.sdk.auth.PrivateKeyJWT

@Immutable
public final class PrivateKeyJWT
extends JWTAuthentication

Private key JWT authentication at the Token endpoint. Implements ClientAuthenticationMethod.PRIVATE_KEY_JWT.

Supported signature JSON Web Algorithms (JWAs) by this implementation:

• RS256
• RS384
• RS512
• PS256
• PS384
• PS512
• ES256
• ES384
• ES512

Example TokenRequest with private key JWT authentication:

 POST /token HTTP/1.1
 Host: server.example.com
 Content-Type: application/x-www-form-urlencoded

 grant_type=authorization_code&
 code=i1WsRn1uB1&
 client_id=s6BhdRkqt3&
 client_assertion_type=urn%3Aietf%3Aparams%3Aoauth%3Aclient-assertion-type%3Ajwt-bearer&
 client_assertion=PHNhbWxwOl...[omitted for brevity]...ZT
 

Related specifications:

• Assertion Framework for OAuth 2.0 (draft-ietf-oauth-assertions-16)
• JSON Web Token (JWT) Bearer Token Profiles for OAuth 2.0 (draft-ietf-oauth-jwt-bearer-09).

Field Summary

Fields inherited from class com.nimbusds.oauth2.sdk.auth.JWTAuthentication

CLIENT_ASSERTION_TYPE

Constructor Summary

Constructors

Constructor and Description
PrivateKeyJWT(com.nimbusds.jwt.SignedJWT clientAssertion) Creates a private key JWT authentication.

Method Summary

Methods

Modifier and Type	Method and Description
static Set<com.nimbusds.jose.JWSAlgorithm>	getSupportedJWAs() Gets the set of supported signature JSON Web Algorithms (JWAs) by this implementation of private key JSON Web Token (JWT) authentication.
static PrivateKeyJWT	parse(HTTPRequest httpRequest) Parses the specified HTTP POST request for a private key JSON Web Token (JWT) authentication.
static PrivateKeyJWT	parse(Map<String,String> params) Parses the specified parameters map for a private key JSON Web Token (JWT) authentication.
static PrivateKeyJWT	parse(String paramsString) Parses a private key JSON Web Token (JWT) authentication from the specified application/x-www-form-urlencoded encoded parameters string.

Methods inherited from class com.nimbusds.oauth2.sdk.auth.JWTAuthentication

applyTo, ensureClientAssertionType, getClientAssertion, getJWTAuthenticationClaimsSet, parseClientAssertion, parseClientID, toParameters

Methods inherited from class com.nimbusds.oauth2.sdk.auth.ClientAuthentication

getClientID, getMethod

Methods inherited from class java.lang.Object

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

Constructor Detail

PrivateKeyJWT

public PrivateKeyJWT(com.nimbusds.jwt.SignedJWT clientAssertion)

Creates a private key JWT authentication.

Parameters:

clientAssertion - The client assertion, corresponding to the client_assertion parameter, as a supported RSA or ECDSA-signed JWT. Must be signed and not null.

Method Detail

getSupportedJWAs

public static Set<com.nimbusds.jose.JWSAlgorithm> getSupportedJWAs()

Gets the set of supported signature JSON Web Algorithms (JWAs) by this implementation of private key JSON Web Token (JWT) authentication.

Returns:

The set of supported JSON Web Algorithms (JWAs).

parse

public static PrivateKeyJWT parse(Map<String,String> params)
                           throws ParseException

Parses the specified parameters map for a private key JSON Web Token (JWT) authentication. Note that the parameters must not be application/x-www-form-urlencoded encoded.

Parameters:

params - The parameters map to parse. The private key JSON Web Token (JWT) parameters must be keyed under "client_assertion" and "client_assertion_type". The map must not be null.

Returns:

The private key JSON Web Token (JWT) authentication.

Throws:

ParseException - If the parameters map couldn't be parsed to a private key JSON Web Token (JWT) authentication.

parse

public static PrivateKeyJWT parse(String paramsString)
                           throws ParseException

Parses a private key JSON Web Token (JWT) authentication from the specified application/x-www-form-urlencoded encoded parameters string.

Parameters:

paramsString - The parameters string to parse. The private key JSON Web Token (JWT) parameters must be keyed under "client_assertion" and "client_assertion_type". The string must not be null.

Returns:

The private key JSON Web Token (JWT) authentication.

Throws:

ParseException - If the parameters string couldn't be parsed to a private key JSON Web Token (JWT) authentication.

parse

public static PrivateKeyJWT parse(HTTPRequest httpRequest)
                           throws ParseException

Parses the specified HTTP POST request for a private key JSON Web Token (JWT) authentication.

Parameters:

httpRequest - The HTTP POST request to parse. Must not be null and must contain a valid application/x-www-form-urlencoded encoded parameters string in the entity body. The private key JSON Web Token (JWT) parameters must be keyed under "client_assertion" and "client_assertion_type".

Returns:

The private key JSON Web Token (JWT) authentication.

Throws:

ParseException - If the HTTP request header couldn't be parsed to a private key JSON Web Token (JWT) authentication.