Package com.yubico.webauthn.extension.uvm

Enum Class UserVerificationMethod

java.lang.Object

java.lang.Enum<UserVerificationMethod>

com.yubico.webauthn.extension.uvm.UserVerificationMethod

All Implemented Interfaces:

Serializable, Comparable<UserVerificationMethod>, Constable

public enum UserVerificationMethod
extends Enum<UserVerificationMethod>

The USER_VERIFY constants are flags in a bitfield represented as a 32 bit long integer. They describe the methods and capabilities of a FIDO authenticator for locally verifying a user. The operational details of these methods are opaque to the server. These constants are used in the authoritative metadata for FIDO authenticators, reported and queried through the UAF Discovery APIs, and used to form authenticator policies in UAF protocol messages. Each constant has a case-sensitive string representation (in quotes), which is used in the authoritative metadata for FIDO authenticators.

See Also:

• fromValue(int)
• fromName(String)
• FIDO Registry of Predefined Values §3.1 User Verification Methods

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
USER_VERIFY_ALL	If an authenticator sets multiple flags for the "_INTERNAL" and/or "_EXTERNAL" user verification types, it MAY also set this flag to indicate that all verification methods with respective flags set will be enforced (e.g.
USER_VERIFY_EYEPRINT_INTERNAL	This flag MUST be set if the authenticator uses any form of eye biometrics for user verification.
USER_VERIFY_FACEPRINT_INTERNAL	This flag MUST be set if the authenticator uses any manner of face recognition to verify the user.
USER_VERIFY_FINGERPRINT_INTERNAL	This flag MUST be set if the authenticator uses any type of measurement of a fingerprint for user verification.
USER_VERIFY_HANDPRINT_INTERNAL	This flag MUST be set if the authenticator uses any measurement of a full hand (including palm-print, hand geometry or vein geometry) for user verification.
USER_VERIFY_LOCATION_INTERNAL	This flag MUST be set if the authenticator uses any form of location sensor or measurement for user verification.
USER_VERIFY_NONE	This flag MUST be set if the authenticator will respond without any user interaction (e.g.
USER_VERIFY_PASSCODE_EXTERNAL	This flag MUST be set if the authenticator uses a local-only passcode (i.e.
USER_VERIFY_PASSCODE_INTERNAL	This flag MUST be set if the authenticator uses a local-only passcode (i.e.
USER_VERIFY_PATTERN_EXTERNAL	This flag MUST be set if the authenticator uses a drawn pattern for user verification that might be gathered outside the authenticator boundary.
USER_VERIFY_PATTERN_INTERNAL	This flag MUST be set if the authenticator uses a drawn pattern for user verification.
USER_VERIFY_PRESENCE_INTERNAL	This flag MUST be set if the authenticator is able to confirm user presence in any fashion.
USER_VERIFY_VOICEPRINT_INTERNAL	This flag MUST be set if the authenticator uses a voiceprint (also known as speaker recognition) for user verification.

Method Summary

Modifier and Type	Method	Description
static UserVerificationMethod	fromName(String name)
static UserVerificationMethod	fromValue(int value)
String	getName()
int	getValue()
static UserVerificationMethod	valueOf(String name)	Returns the enum constant of this class with the specified name.
static UserVerificationMethod[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

USER_VERIFY_PRESENCE_INTERNAL

public static final UserVerificationMethod USER_VERIFY_PRESENCE_INTERNAL

This flag MUST be set if the authenticator is able to confirm user presence in any fashion. If this flag and no other is set for user verification, the guarantee is only that the authenticator cannot be operated without some human intervention, not necessarily that the sensing of "presence" provides any level of user verification (e.g. a device that requires a button press to activate).

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_FINGERPRINT_INTERNAL

public static final UserVerificationMethod USER_VERIFY_FINGERPRINT_INTERNAL

This flag MUST be set if the authenticator uses any type of measurement of a fingerprint for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_PASSCODE_INTERNAL

public static final UserVerificationMethod USER_VERIFY_PASSCODE_INTERNAL

This flag MUST be set if the authenticator uses a local-only passcode (i.e. a passcode not known by the server) for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_VOICEPRINT_INTERNAL

public static final UserVerificationMethod USER_VERIFY_VOICEPRINT_INTERNAL

This flag MUST be set if the authenticator uses a voiceprint (also known as speaker recognition) for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_FACEPRINT_INTERNAL

public static final UserVerificationMethod USER_VERIFY_FACEPRINT_INTERNAL

This flag MUST be set if the authenticator uses any manner of face recognition to verify the user.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_LOCATION_INTERNAL

public static final UserVerificationMethod USER_VERIFY_LOCATION_INTERNAL

This flag MUST be set if the authenticator uses any form of location sensor or measurement for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_EYEPRINT_INTERNAL

public static final UserVerificationMethod USER_VERIFY_EYEPRINT_INTERNAL

This flag MUST be set if the authenticator uses any form of eye biometrics for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_PATTERN_INTERNAL

public static final UserVerificationMethod USER_VERIFY_PATTERN_INTERNAL

This flag MUST be set if the authenticator uses a drawn pattern for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_HANDPRINT_INTERNAL

public static final UserVerificationMethod USER_VERIFY_HANDPRINT_INTERNAL

This flag MUST be set if the authenticator uses any measurement of a full hand (including palm-print, hand geometry or vein geometry) for user verification.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_PASSCODE_EXTERNAL

public static final UserVerificationMethod USER_VERIFY_PASSCODE_EXTERNAL

This flag MUST be set if the authenticator uses a local-only passcode (i.e. a passcode not known by the server) for user verification that might be gathered outside the authenticator boundary.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_PATTERN_EXTERNAL

public static final UserVerificationMethod USER_VERIFY_PATTERN_EXTERNAL

This flag MUST be set if the authenticator uses a drawn pattern for user verification that might be gathered outside the authenticator boundary.

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_NONE

public static final UserVerificationMethod USER_VERIFY_NONE

This flag MUST be set if the authenticator will respond without any user interaction (e.g. Silent Authenticator).

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

USER_VERIFY_ALL

public static final UserVerificationMethod USER_VERIFY_ALL

If an authenticator sets multiple flags for the "_INTERNAL" and/or "_EXTERNAL" user verification types, it MAY also set this flag to indicate that all verification methods with respective flags set will be enforced (e.g. faceprint AND voiceprint). If flags for multiple user verification methods are set and this flag is not set, verification with only one is necessary (e.g. fingerprint OR passcode).

NOTE: The above requirements apply to authenticators; this library DOES NOT enforce them.

See Also:

• FIDO Registry of Predefined Values §3.1 User Verification Methods

Method Details

values

public static UserVerificationMethod[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static UserVerificationMethod valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

fromValue

public static UserVerificationMethod fromValue(int value)

Returns:

If value matches any UserVerificationMethod constant, returns that constant instance. Otherwise throws IllegalArgumentException.

fromName

public static UserVerificationMethod fromName(String name)

Returns:

If name matches any UserVerificationMethod constant, returns that constant instance. Otherwise throws IllegalArgumentException.

getValue

public int getValue()

getName

public String getName()