Skip to content

shtirlic/yubikeylockd

Repository files navigation

yubikeylockd

Simple daemon for locking and unlocking macOS with Yubikey.

Install

Via Homebrew formula:

brew tap shtirlic/yubikeylockd https://github.com/shtirlic/yubikeylockd
brew install shtirlic/yubikeylockd/yubikeylockd

Additional requirements

How it works

When you attach Yubikey for the first time launchctl will run yubikeylockd daemon that will simply monitor the state of the Yubikey USB devices. Daemon based on the sample provided by Apple for IOKit development.

It does two things:

  • when device is attached it makes activity via IOPMAssertionDeclareUserActivity call to turn screen on
  • after device is detached it uses IORequestIdle to put display to sleep and (if you configured it) also locks the OS X