Skip to content

muesli/pam-beacon

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

pam-beacon

Latest Release Build Status Go ReportCard GoDoc

PAM module for (multi-factor) authentication with Bluetooth Devices & Beacons

Installation

Packages

ArchLinux: install the AUR package pam_beacon-git.

Manually

Make sure you have a working Go environment (Go 1.11 or higher is required). See the install instructions. libpam and its development headers are also required.

$ make
$ sudo make install

Configuration

Create a file named .authorized_beacons in your home directory. You can put the MAC addresses of as many beacons in it as you like, one per line. The auth will succeed as long as pam-beacon can find at least one of the beacons.

Example:

00:11:22:AA:BB:CC
FF:EE:DD:99:88:77

Copy config/pam.d/system-auth-beacon to /etc/pam.d. Include this PAM module wherever you want to require it for authentication, e.g. in /etc/pam.d/system-login:

auth    include     system-auth-beacon

Careful: if your bluetooth beacon isn't discoverable, you will lock yourself out of your system! It's probably a good idea to keep a root-shell open during installation & testing of pam-beacon.

Testing

You can run pam-beacon as an application to test its behavior:

$ go build
$ ./pam-beacon [mac]

This will return successfully if pam-beacon managed to find & connect to your bluetooth beacon, or return an error if it encounters any problems.

About

PAM module for multi-factor authentication with Bluetooth Devices & Beacons

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published