Store SSH keys in the Secure Enclave
Go to file
Max Goedjen ee23c97b09
Restrict to tags
2020-03-14 19:52:06 -07:00
.github Restrict to tags 2020-03-14 19:52:06 -07:00
SecretAgent 11.3 Compatibility 2020-03-14 19:40:03 -07:00
SecretAgentKit Split out into separate files 2020-03-08 20:08:27 -07:00
SecretAgentKitTests Secure enclave implementation 2020-03-03 23:14:38 -08:00
SecretKit Remove return 2020-03-11 01:53:20 -07:00
SecretKitTests Setup 2020-02-18 19:36:41 -08:00
Secretive Guard preview providers 2020-03-11 23:07:22 -07:00
Secretive.xcodeproj Disable per-framework signing 2020-03-14 19:28:25 -07:00
SecretiveTests Setup 2020-02-18 19:36:41 -08:00
.gitignore Disable per-framework signing 2020-03-14 19:28:25 -07:00
LICENSE Initial commit 2020-02-18 19:34:46 -08:00
README.md #34 2020-03-14 14:40:49 -07:00

README.md

Secretive

Secretive is an app for storing and managing SSH keys in the Secure Enclave. It is inspired by the sekey project, but rewritten in Swift with no external dependencies and with a handy native management app.

Screenshot of Secretive

Why?

Safer Storage

The most common setup for SSH keys is just keeping them on disk, guarded by proper permissions. This is fine in most cases, but it's not super hard for malicious users or malware to copy your private key. If you store your keys in the Secure Enclave, it's impossible to export them, by design.

Access Control

If your Mac has a Secure Enclave, it also has support for strong biometric access controls like Touch ID. You can configure your key so that they require Touch ID (or Watch) authentication before they're accessed.

Screenshot of Secretive authenticating with Touch ID

Notifications

Secretive also notifies you whenever your keys are acceessed, so you're never caught off guard.

Screenshot of Secretive notifying the user

Support for Smart Cards Too!

For Macs without Secure Enclaves, you can configure a Smart Card (such as a YubiKey) and use it for signing as well.

Getting Started

Setup for Third Party Apps

When you first launch Secretive, you'll be prompted to set up your command line environment. You can redisplay this prompt at any time by going to Menu > Help -> Set Up Helper App. For non-command-line based apps, like GUI Git clients, you may need to go through app-specific setup.

Tower

Security Considerations

For the moment, you must build Secretive from source. For an app like this, it's critical that you trust that the app you're running is the app whose source you've checked out. To this end, Secretive has no third party dependecies, and is designed to be easy for you to audit for exploits.

A Note Around Code Signing and Keychains

While Secretive uses the Secure Enclave for key storage, it still relies on Keychain APIs to access them. Keychain restricts reads of keys to the app (and specifically, the bundle ID) that created them. If you build Secretive from source, make sure you are consistent in which bundle ID you use so that the Keychain is able to locate your keys.

Backups and Transfers to New Machines

Beacuse secrets in the Secure Enclave are not exportable, they are not able to be backed up, and you will not be able to transfer them to a new machine. If you get a new Mac, just create a new set of secrets specific to that Mac.