Skip to content

neuronmaker/Linux-U2F-Login-Utility

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Linux-U2F-Login-Utilities

Some utilities to make U2F configuration on Linux easier for casual user to manage this type of authentication. It is my hope that someone from one of the beginner-friendly Linux distros will see this repository and build something into their settings program to manage U2F authentication.

Until that happens, this tool will have to suffice.

u2f-enroll.sh

A BASH script that repeatedly runs the pamu2fcfg program and appends the output to a file, use this to generate the u2f_mappings file that libpam-u2f uses for authentication.

Run this program once for each user that should be in the mappings file, they can register as many U2F devices as your system's configuration supports (typically 24 U2F devices per user at any given time). Once the file is created, it can be installed to wherever your specific system is set up to look for it. Typically, the preferred way is to move the output file to /etc/u2f_mappings and set the permissions so that only the root user can edit or view the file.

You can set the permissions on the mappings file with the command sudo chmod 600 /etc/u2f_mappings

Dependencies

This script was created on a system with a new version of pamu2fcfg from the libpam-u2f package. If you are using a version that is quite old (prior to 1.2.1), then try to install Yubico's repository.

On Ubuntu systems you might be able to get away by using the command:

sudo add-apt-repository ppa:yubico/stable && sudo apt-get update

And then allowing apt to upgrade libpam-u2f to the latest version

sudo apt-get upgrade

And if you have not already, install the PAM module

sudo apt-get install libpam-u2f

The above command also installs pamu2fcfg alongside libpam-u2f.

About

Tools to simplify setup of U2F login for Linux systems

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages