gpg-agent-forward/README.md
2018-07-19 15:22:58 -07:00

22 lines
808 B
Markdown

# Forward your Yubikey `gpg-agent` to a remote host.
### Simple GPG agent-forwarding config maker for Yubikey use with SSH.
## 📖 Getting Started
⚠️ Storing SSH keys on disk can be dangerous. Using a hardware crypto key can help mitigate key exfiltration from your local or remote hosts.
This assumes you [already added a GPG key to your Yubikey](https://github.com/drduh/YubiKey-Guide) and now just want to forward it to a remote host.
```
./yubikey_gpg-agent-forward.sh admin host.example.com
```
The important part here is typing the **`username`** and **`hostname/IP`**. These variables are needed to write a correct config.
### The one-liner version
```
git clone git@github.com:stationgroup/gpg-agent-forward.git ; cd gpg-agent-forward ; ./yubikey_gpg-agent-forward.sh USER HOST.COM
```