https://github.com/shtirlic/yubikeylockd

Simple daemon for locking and unlocking macOS with Yubikey
https://github.com/shtirlic/yubikeylockd

cryptography daemon homebrew homebrew-formula lock macos security unlock unlock-os yubikey

Last synced: 12 days ago
JSON representation

Simple daemon for locking and unlocking macOS with Yubikey

• Host: GitHub
• URL: https://github.com/shtirlic/yubikeylockd
• Owner: shtirlic
• License: mit
• Created: 2015-08-14T09:49:25.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-02-05T23:16:34.000Z (almost 4 years ago)
• Last Synced: 2024-08-02T04:02:29.962Z (3 months ago)
• Topics: cryptography, daemon, homebrew, homebrew-formula, lock, macos, security, unlock, unlock-os, yubikey
• Language: C
• Homepage:
• Size: 21.5 KB
• Stars: 102
• Watchers: 5
• Forks: 19
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: License.txt

Awesome Lists containing this project

README

        
# 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

  * [YubiKey using the native smart card (PIV) mode](https://www.yubico.com/why-yubico/for-businesses/computer-login/mac-os-login/)

  * Require password *immediately* after sleep or screen saver begins

  ![](http://i.imgur.com/URXUukP.png)

## 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