Package com.yubico.webauthn.data

Class AuthenticatorTransport

java.lang.Object

com.yubico.webauthn.data.AuthenticatorTransport

All Implemented Interfaces:

Comparable<AuthenticatorTransport>

public final class AuthenticatorTransport
extends Object
implements Comparable<AuthenticatorTransport>

Authenticators may communicate with Clients using a variety of transports. This enumeration defines a hint as to how Clients might communicate with a particular Authenticator in order to obtain an assertion for a specific credential. Note that these hints represent the Relying Party's best belief as to how an Authenticator may be reached. A Relying Party may obtain a list of transports hints from some attestation statement formats or via some out-of-band mechanism; it is outside the scope of this specification to define that mechanism.

Authenticators may implement various transports for communicating with clients. This enumeration defines hints as to how clients might communicate with a particular authenticator in order to obtain an assertion for a specific credential. Note that these hints represent the WebAuthn Relying Party's best belief as to how an authenticator may be reached. A Relying Party may obtain a list of transports hints from some attestation statement formats or via some out-of-band mechanism; it is outside the scope of the Web Authentication specification to define that mechanism.

See Also:

• §5.10.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

Field Summary

Fields

Modifier and Type	Field	Description
static final AuthenticatorTransport	BLE	Indicates the respective authenticator can be contacted over Bluetooth Smart (Bluetooth Low Energy / BLE).
static final AuthenticatorTransport	HYBRID	Deprecated. EXPERIMENTAL: This feature is from a not yet mature standard; it could change as the standard matures.
static final AuthenticatorTransport	INTERNAL	Indicates the respective authenticator is contacted using a client device-specific transport.
static final AuthenticatorTransport	NFC	Indicates the respective authenticator can be contacted over Near Field Communication (NFC).
static final AuthenticatorTransport	USB	Indicates the respective authenticator can be contacted over removable USB.

Method Summary

Modifier and Type	Method	Description
int	compareTo(AuthenticatorTransport other)
boolean	equals(Object o)
@NonNull String	getId()
int	hashCode()
static AuthenticatorTransport	of(@NonNull String id)
String	toString()
static AuthenticatorTransport	valueOf(String name)
static AuthenticatorTransport[]	values()

Methods inherited from class java.lang.Object

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

Field Details

USB

public static final AuthenticatorTransport USB

Indicates the respective authenticator can be contacted over removable USB.

See Also:

• 5.8.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

NFC

public static final AuthenticatorTransport NFC

Indicates the respective authenticator can be contacted over Near Field Communication (NFC).

See Also:

• 5.8.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

BLE

public static final AuthenticatorTransport BLE

Indicates the respective authenticator can be contacted over Bluetooth Smart (Bluetooth Low Energy / BLE).

See Also:

• 5.8.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

HYBRID

@Deprecated
public static final AuthenticatorTransport HYBRID

Deprecated.

EXPERIMENTAL: This feature is from a not yet mature standard; it could change as the standard matures.

Indicates the respective authenticator can be contacted using a combination of (often separate) data-transport and proximity mechanisms. This supports, for example, authentication on a desktop computer using a smartphone.

See Also:

• 5.8.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

INTERNAL

public static final AuthenticatorTransport INTERNAL

Indicates the respective authenticator is contacted using a client device-specific transport. These authenticators are not removable from the client device.

See Also:

• 5.8.4. Authenticator Transport Enumeration (enum AuthenticatorTransport)

Method Details

values

public static AuthenticatorTransport[] values()

Returns:

An array containing all predefined values of AuthenticatorTransport known by this implementation.

of

public static AuthenticatorTransport of(@NonNull
 @NonNull String id)

Returns:

If id is the same as that of any of USB, NFC, BLE, HYBRID or INTERNAL, returns that constant instance. Otherwise returns a new instance containing id.

See Also:

• valueOf(String)

valueOf

public static AuthenticatorTransport valueOf(String name)

Returns:

If name equals "USB", "NFC", "BLE", "HYBRID" or "INTERNAL", returns the constant by that name.

Throws:

IllegalArgumentException - if name is anything else.

See Also:

• of(String)

compareTo

public int compareTo(AuthenticatorTransport other)

Specified by:

compareTo in interface Comparable<AuthenticatorTransport>

getId

@NonNull
public @NonNull String getId()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object