com.yubico.webauthn.data

Enum AttestationConveyancePreference

java.lang.Object

java.lang.Enum<AttestationConveyancePreference>

com.yubico.webauthn.data.AttestationConveyancePreference

All Implemented Interfaces:

com.yubico.internal.util.json.JsonStringSerializable, java.io.Serializable, java.lang.Comparable<AttestationConveyancePreference>

public enum AttestationConveyancePreference
extends java.lang.Enum<AttestationConveyancePreference>
implements com.yubico.internal.util.json.JsonStringSerializable

Relying Parties may use this to specify their preference regarding attestation conveyance during credential generation.

See Also:

§5.4.6. Attestation Conveyance Preference Enumeration (enum AttestationConveyancePreference)

Enum Constant Summary

Enum Constants

Enum Constant and Description
DIRECT Indicates that the Relying Party wants to receive the attestation statement as generated by the authenticator.
INDIRECT Indicates that the Relying Party prefers an attestation conveyance yielding verifiable attestation statements, but allows the client to decide how to obtain such attestation statements.
NONE Indicates that the Relying Party is not interested in authenticator attestation.

Method Summary

Modifier and Type	Method and Description
java.lang.String	toJsonString()
static AttestationConveyancePreference	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static AttestationConveyancePreference[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NONE

public static final AttestationConveyancePreference NONE

Indicates that the Relying Party is not interested in authenticator attestation.

For example, in order to potentially avoid having to obtain user consent to relay identifying information to the Relying Party, or to save a roundtrip to an Attestation CA.

This is the default value.

INDIRECT

public static final AttestationConveyancePreference INDIRECT

Indicates that the Relying Party prefers an attestation conveyance yielding verifiable attestation statements, but allows the client to decide how to obtain such attestation statements. The client MAY replace the authenticator-generated attestation statements with attestation statements generated by an Anonymization CA, in order to protect the user’s privacy, or to assist Relying Parties with attestation verification in a heterogeneous ecosystem.

Note: There is no guarantee that the Relying Party will obtain a verifiable attestation statement in this case. For example, in the case that the authenticator employs self attestation.

DIRECT

public static final AttestationConveyancePreference DIRECT

Indicates that the Relying Party wants to receive the attestation statement as generated by the authenticator.

Method Detail

values

public static AttestationConveyancePreference[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (AttestationConveyancePreference c : AttestationConveyancePreference.values())
    System.out.println(c);

Returns:

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

valueOf

public static AttestationConveyancePreference valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (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:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

toJsonString

public java.lang.String toJsonString()

Specified by:

toJsonString in interface com.yubico.internal.util.json.JsonStringSerializable