com.nimbusds.openid.connect.sdk

Class Nonce

java.lang.Object

com.nimbusds.oauth2.sdk.id.Identifier

com.nimbusds.openid.connect.sdk.Nonce

All Implemented Interfaces:

net.minidev.json.JSONAware

@Immutable
public final class Nonce
extends Identifier

Nonce. This is a random, unique string value to associate a user-session with an ID Token and to mitigate replay attacks. This class is immutable.

Example generation of a nonce with eight random mixed-case alphanumeric characters:

 Nonce nonce = new Nonce(8);
 

Related specifications:

• OpenID Connect Messages 1.0, section 2.1.1 and 2.1.2.1.

Author:

Vladimir Dzhuvinov

Field Summary

Fields inherited from class com.nimbusds.oauth2.sdk.id.Identifier

DEFAULT_BYTE_LENGTH

Constructor Summary

Constructors

Constructor and Description
Nonce() Creates a new nonce with a randomly generated 256-bit (32-byte) value, Base64URL-encoded.
Nonce(int byteLength) Creates a new nonce with a randomly generated value of the specified byte length, Base64URL-encoded.
Nonce(String value) Creates a new nonce with the specified value.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object object) Overrides Object.equals().
static Nonce	parse(String s) Parses a nonce from the specified string.

Methods inherited from class com.nimbusds.oauth2.sdk.id.Identifier

getValue, hashCode, toJSONString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Nonce

public Nonce(String value)

Creates a new nonce with the specified value.

Parameters:

value - The nonce value. Must not be null or empty string.

Nonce

public Nonce(int byteLength)

Creates a new nonce with a randomly generated value of the specified byte length, Base64URL-encoded.

Parameters:

byteLength - The byte length of the value to generate. Must be greater than one.

Nonce

public Nonce()

Creates a new nonce with a randomly generated 256-bit (32-byte) value, Base64URL-encoded.

Method Detail

equals

public boolean equals(Object object)

Description copied from class: Identifier

Overrides Object.equals().

Specified by:

equals in class Identifier

Parameters:

object - The object to compare to.

Returns:

true if the objects have the same value, otherwise false.

parse

public static Nonce parse(String s)

Parses a nonce from the specified string.

Parameters:

s - The string to parse, null or empty if no nonce is specified.

Returns:

The nonce, null if the parsed string was null or empty.