org.forgerock.android.auth

Class TOTPMechanism

java.lang.Object

org.forgerock.android.auth.Mechanism

org.forgerock.android.auth.OathMechanism

org.forgerock.android.auth.TOTPMechanism

All Implemented Interfaces:

java.lang.Comparable<Mechanism>

public class TOTPMechanism
extends OathMechanism

Represents Time-based OTP authentication mechanism and is responsible for its related operation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TOTPMechanism.TOTPBuilder Builder class responsible for producing a TOTPMechanism Token.

Nested classes/interfaces inherited from class org.forgerock.android.auth.OathMechanism

OathMechanism.OathBuilder<T extends OathMechanism.OathBuilder>, OathMechanism.TokenType

Field Summary

Fields inherited from class org.forgerock.android.auth.OathMechanism

algorithm, digits

Fields inherited from class org.forgerock.android.auth.Mechanism

OATH, PUSH

Method Summary

Modifier and Type	Method and Description
static TOTPMechanism.TOTPBuilder	builder() Returns a builder for creating a TOTPMechanism Mechanism.
static TOTPMechanism	deserialize(java.lang.String jsonString) Deserializes the specified Json into an object of the TOTPMechanism object.
OathTokenCode	getOathTokenCode() Generates a new set of codes for this OathMechanism Token.
long	getPeriod() Returns the period of this OathMechanism.
java.lang.String	toJson() Creates a JSON string representation of T object.

Methods inherited from class org.forgerock.android.auth.OathMechanism

getAlgorithm, getDigits, getOathType

Methods inherited from class org.forgerock.android.auth.Mechanism

compareTo, equals, getAccountName, getId, getIssuer, getMechanismUID, getTimeAdded, getType, hashCode, matches

Methods inherited from class java.lang.Object

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

Method Detail

getPeriod

public long getPeriod()

Returns the period of this OathMechanism. The frequency with which the OTP changes in seconds

Returns:

period as long value

getOathTokenCode

public OathTokenCode getOathTokenCode()
                               throws OathMechanismException

Description copied from class: OathMechanism

Generates a new set of codes for this OathMechanism Token.

Specified by:

getOathTokenCode in class OathMechanism

Returns:

OathTokenCode object that contains the currently active token code

Throws:

OathMechanismException - If an error occur on generating the OTP codes

toJson

public java.lang.String toJson()

Creates a JSON string representation of T object. Sensitive information are not exposed.

Specified by:

toJson in class OathMechanism

Returns:

a JSON string object

deserialize

public static TOTPMechanism deserialize(java.lang.String jsonString)

Deserializes the specified Json into an object of the TOTPMechanism object.

Parameters:

jsonString - the json string representing the object to be deserialized

Returns:

an TOTPMechanism object from the string. Returns null if jsonString is null, if jsonString is empty or not able to parse it.

builder

public static TOTPMechanism.TOTPBuilder builder()

Returns a builder for creating a TOTPMechanism Mechanism.

Returns:

The OathMechanism builder.