com.yubico.u2f

Class U2fPrimitives

java.lang.Object

com.yubico.u2f.U2fPrimitives

public class U2fPrimitives
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUTHENTICATE_TYP
static String	REGISTER_TYPE
static String	U2F_VERSION

Constructor Summary

Constructors

Constructor and Description
U2fPrimitives()
U2fPrimitives(com.yubico.u2f.crypto.Crypto crypto, com.yubico.u2f.crypto.ChallengeGenerator challengeGenerator)

Method Summary

Modifier and Type	Method and Description
void	finishAuthentication(AuthenticateRequest authenticateRequest, AuthenticateResponse response, DeviceRegistration deviceRegistration)
void	finishAuthentication(AuthenticateRequest authenticateRequest, AuthenticateResponse response, DeviceRegistration deviceRegistration, Set<String> facets) Finishes a previously started authentication.
DeviceRegistration	finishRegistration(RegisterRequest registerRequest, RegisterResponse response)
DeviceRegistration	finishRegistration(RegisterRequest registerRequest, RegisterResponse response, Set<String> facets) Finishes a previously started registration.
AuthenticateRequest	startAuthentication(String appId, DeviceRegistration deviceRegistration) Initiates the authentication process.
AuthenticateRequest	startAuthentication(String appId, DeviceRegistration deviceRegistration, byte[] challenge) Initiates the authentication process.
RegisterRequest	startRegistration(String appId)
RegisterRequest	startRegistration(String appId, byte[] challenge) Initiates the registration of a device.

Methods inherited from class java.lang.Object

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

Field Detail

AUTHENTICATE_TYP

public static final String AUTHENTICATE_TYP

See Also:

Constant Field Values

REGISTER_TYPE

public static final String REGISTER_TYPE

See Also:

Constant Field Values

U2F_VERSION

public static final String U2F_VERSION

See Also:

Constant Field Values

Constructor Detail

U2fPrimitives

public U2fPrimitives(com.yubico.u2f.crypto.Crypto crypto,
                     com.yubico.u2f.crypto.ChallengeGenerator challengeGenerator)

U2fPrimitives

public U2fPrimitives()

Method Detail

startRegistration

public RegisterRequest startRegistration(String appId)

See Also:

startRegistration(String, byte[])

startRegistration

public RegisterRequest startRegistration(String appId,
                                         byte[] challenge)

Initiates the registration of a device.

Parameters:

appId - the U2F AppID. Set this to the Web Origin of the login page, unless you need to support logging in from multiple Web Origins.

challenge - the challenge to use

Returns:

a RegisterRequest, which should be sent to the client and temporary saved by the server.

finishRegistration

public DeviceRegistration finishRegistration(RegisterRequest registerRequest,
                                             RegisterResponse response)
                                      throws U2fBadInputException

Throws:

U2fBadInputException

See Also:

finishRegistration(com.yubico.u2f.data.messages.RegisterRequest, com.yubico.u2f.data.messages.RegisterResponse, java.util.Set)

finishRegistration

public DeviceRegistration finishRegistration(RegisterRequest registerRequest,
                                             RegisterResponse response,
                                             Set<String> facets)
                                      throws U2fBadInputException

Finishes a previously started registration.

Parameters:

registerRequest -

response - the response from the device/client.

Returns:

a DeviceRegistration object, holding information about the registered device. Servers should persist this.

Throws:

U2fBadInputException

startAuthentication

public AuthenticateRequest startAuthentication(String appId,
                                               DeviceRegistration deviceRegistration)

Initiates the authentication process.

See Also:

startAuthentication(String, com.yubico.u2f.data.DeviceRegistration, byte[])

startAuthentication

public AuthenticateRequest startAuthentication(String appId,
                                               DeviceRegistration deviceRegistration,
                                               byte[] challenge)

Initiates the authentication process.

Parameters:

appId - the U2F AppID. Set this to the Web Origin of the login page, unless you need to support logging in from multiple Web Origins.

deviceRegistration - the DeviceRegistration for which to initiate authentication.

challenge - the challenge to use

Returns:

an AuthenticateRequest which should be sent to the client and temporary saved by the server.

finishAuthentication

public void finishAuthentication(AuthenticateRequest authenticateRequest,
                                 AuthenticateResponse response,
                                 DeviceRegistration deviceRegistration)
                          throws U2fBadInputException,
                                 DeviceCompromisedException

Throws:

U2fBadInputException

DeviceCompromisedException

See Also:

finishAuthentication(com.yubico.u2f.data.messages.AuthenticateRequest, com.yubico.u2f.data.messages.AuthenticateResponse, com.yubico.u2f.data.DeviceRegistration, java.util.Set)

finishAuthentication

public void finishAuthentication(AuthenticateRequest authenticateRequest,
                                 AuthenticateResponse response,
                                 DeviceRegistration deviceRegistration,
                                 Set<String> facets)
                          throws U2fBadInputException,
                                 DeviceCompromisedException

Finishes a previously started authentication.

Parameters:

authenticateRequest -

response - the response from the device/client.

Throws:

U2fBadInputException

DeviceCompromisedException