com.nimbusds.jose.jwk

Class KeyUse

java.lang.Object

com.nimbusds.jose.jwk.KeyUse

All Implemented Interfaces:

Serializable

public final class KeyUse
extends Object
implements Serializable

Enumeration of public key uses. Represents the use parameter in a JSON Web Key (JWK).

Public JWK use values:

• sig
• enc

Version:

2019-10-03

Author:

Vladimir Dzhuvinov

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static KeyUse	ENCRYPTION Encryption.
static KeyUse	SIGNATURE Signature.

Constructor Summary

Constructors

Constructor and Description
KeyUse(String identifier) Creates a new public key use with the specified identifier.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
static KeyUse	from(X509Certificate cert) Infers the public key use of the specified X.509 certificate.
String	getValue()
int	hashCode()
String	identifier() Returns the identifier of this public key use.
static KeyUse	parse(String s) Parses a public key use from the specified JWK use parameter value.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SIGNATURE

public static final KeyUse SIGNATURE

Signature.

ENCRYPTION

public static final KeyUse ENCRYPTION

Encryption.

Constructor Detail

KeyUse

public KeyUse(String identifier)

Creates a new public key use with the specified identifier.

Parameters:

identifier - The public key use identifier. Must not be null.

Method Detail

identifier

public String identifier()

Returns the identifier of this public key use.

Returns:

The identifier.

getValue

public String getValue()

See Also:

identifier()

toString

public String toString()

Overrides:

toString in class Object

See Also:

identifier()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

parse

public static KeyUse parse(String s)
                    throws ParseException

Parses a public key use from the specified JWK use parameter value.

Parameters:

s - The string to parse. May be null.

Returns:

The public key use, null if none.

Throws:

ParseException - If the string couldn't be parsed to a valid public key use.

from

public static KeyUse from(X509Certificate cert)

Infers the public key use of the specified X.509 certificate. Note that there is no standard algorithm for mapping PKIX key usage to JWK use. See RFC 2459, section 4.2.1.3, as well as the underlying code for the chosen algorithm to infer JWK use.

Parameters:

cert - The X.509 certificate. Must not be null.

Returns:

The public key use, null if the key use couldn't be reliably determined.