Class JsonWebKey

java.lang.Object

de.christofreichardt.json.webkey.JsonWebKey

All Implemented Interfaces:

de.christofreichardt.diagnosis.Traceable

Direct Known Subclasses:

JsonWebKeyPair, JsonWebPublicKey, JsonWebSecretKey

public abstract sealed class JsonWebKey
extends Object
implements de.christofreichardt.diagnosis.Traceable
permits JsonWebKeyPair, JsonWebPublicKey, JsonWebSecretKey

Base class for JSON web keys.

Author:

Christof Reichardt

See Also:

• RFC 7517 (JSON Web Key)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JsonWebKey.Builder<T extends JsonWebKey.Builder<T>>	Base class for all JsonWebKey.Builders.

Field Summary

Fields

Modifier and Type	Field	Description
static final Map<String, ECParameterSpec>	EC_PARAMETER_SPEC_MAP	Maps curve names on appropriate ECParameterSpecs.
static final ECParameterSpec	SECP256R1	Public parameters of curve 'secp256r1'.
static final ECParameterSpec	SECP521R1	Public parameters of curve 'secp521r1'.

Method Summary

Modifier and Type	Method	Description
static <T extends JsonWebKey> T	fromJson(jakarta.json.JsonObject webKeyView, Class<T> clazz)	Generic method to create a JsonWebKey from a JSON representation.
de.christofreichardt.diagnosis.AbstractTracer	getCurrentTracer()
String	getKeyType()	Returns the required "kty" (Key Type) parameter.
String	getKid()	Returns the "kid" (Key ID) parameter.
jakarta.json.JsonObject	toJson()	Serializes the common JWK parameters.
String	toString()

Methods inherited from class Object

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

Field Details

EC_PARAMETER_SPEC_MAP

public static final Map<String, ECParameterSpec> EC_PARAMETER_SPEC_MAP

Maps curve names on appropriate ECParameterSpecs.

SECP256R1

public static final ECParameterSpec SECP256R1

Public parameters of curve 'secp256r1'.

See Also:

• Recommendations for Discrete Logarithm-based Cryptography: Elliptic Curve Domain Parameters

SECP521R1

public static final ECParameterSpec SECP521R1

Public parameters of curve 'secp521r1'.

See Also:

• Recommendations for Discrete Logarithm-based Cryptography: Elliptic Curve Domain Parameters

Method Details

fromJson

public static <T extends JsonWebKey> T fromJson(jakarta.json.JsonObject webKeyView,
 Class<T> clazz)
                                         throws GeneralSecurityException

Generic method to create a JsonWebKey from a JSON representation.

Type Parameters:

T - the type of the JsonWebKey class, modeled by the given Class object.

Parameters:

webKeyView - the JSON representation.

clazz - the actual JsonWebKey class, could be a JsonWebKeyPair, JsonWebPublicKey or JsonWebSecretKey.

Returns:

a JsonWebKey object.

Throws:

GeneralSecurityException - passed through from the underlying implementations of the algorithms by the JDK.

getKid

public String getKid()

Returns the "kid" (Key ID) parameter.

Returns:

the key id, may be null.

See Also:

• Section 4.5 of RFC 7517

getKeyType

public String getKeyType()

Returns the required "kty" (Key Type) parameter.

Returns:

the key type.

See Also:

• Section 4.1 of RFC 7517

toString

public String toString()

Overrides:

toString in class Object

toJson

public jakarta.json.JsonObject toJson()

Serializes the common JWK parameters.

Returns:

a JsonObject containing the shared JWK parameters.

getCurrentTracer

public de.christofreichardt.diagnosis.AbstractTracer getCurrentTracer()

Specified by:

getCurrentTracer in interface de.christofreichardt.diagnosis.Traceable