TFA U2F

Categories

Component ID

2922630

Component name

TFA U2F

Component type

module

Maintenance status

Development status

Component security advisory coverage

not-covered

Component created

Component changed

Component body

U2F (Universal 2nd-Factor) plugin for TFA (Two-Factor Authentication module) for use with Yubikeys and other U2F devices.

This module allows administrators to enable their users to register U2F devices with their Drupal accounts. After doing so, the user will then be required to verify the registered device before logging in.

Requirements:

Installation:

Since this module requires an additional library, it is recommended you install it using Composer. If you do not have a composer-based Drupal installation, you will need to acquire the yubico/u2flib-server library by some other means.

Configuration:

Configure TFA to use this plugin at Configuration » People » Two-Factor Authentication:

  • Validation Plugin: TFA Universal 2nd Factor
  • (optional) Validation Fallback Plugins: TFA Recovery Code
  • Extra Settings:
    • Application ID: Your website base URL. Ex: https://example.org
    • Challenge Text: Any arbitrary text that will be encoded and used during device registration and verification. This cannot be changed once set.
    • Timeout: Amount of time a user has to insert and verify their device.

Configure your Drupal account to use a U2F device at user/{uid}/security/tfa

  • Click "Setup new device"
  • Provide your account password
  • Insert your device and touch the button on it.
  • Provide a name for this new device, and submit the form.