2018-07-19 21:57:58 +00:00
|
|
|
# Forward your Yubikey `gpg-agent` to a remote host.
|
2018-07-19 21:52:49 +00:00
|
|
|
### 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
|
|
|
|
|
```
|
2018-07-19 21:56:10 +00:00
|
|
|
|
|
|
|
|
The important part here is typing the **`username`** and **`hostname/IP`**. These variables are needed to write a correct config.
|
2018-07-19 22:22:58 +00:00
|
|
|
|
|
|
|
|
|
2018-07-19 22:24:06 +00:00
|
|
|
#### The one-liner version
|
2018-07-19 22:22:58 +00:00
|
|
|
|
|
|
|
|
```
|
2018-07-19 22:34:19 +00:00
|
|
|
git clone https://github.com/stationgroup/gpg-agent-forward.git && cd gpg-agent-forward && ./yubikey_gpg-agent-forward.sh USER HOST.COM
|
2018-07-19 22:22:58 +00:00
|
|
|
```
|
