27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# Bitwarden SSH Agent
|
|
|
|
## Requirements
|
|
* You need to have the [Bitwarden CLI tool](https://github.com/bitwarden/cli) installed and available in the `$PATH` as `bw`.
|
|
* `ssh-agent` must be running in the current session.
|
|
* Optional: `paramiko` must be installed to decrypt keys. If none of your keys are encrypted, `paramiko` is not needed
|
|
|
|
## What does it do?
|
|
Fetches SSH keys stored in Bitwarden vault and adds them to `ssh-agent`.
|
|
|
|
## How to use it
|
|
1. Run,
|
|
```shell
|
|
./bw_add_sshkeys.py
|
|
```
|
|
2. Enter your Bitwarden credentials, if a Bitwarden vault session is not already set.
|
|
3. (optional) Enter your SSH keys' passphrases.
|
|
|
|
|
|
## Storing the keys in BitWarden
|
|
1. Create a folder called `ssh-agent` (can be overridden on the command line).
|
|
2. Add an new secure note to that folder.
|
|
3. Upload the private key as an attachment.
|
|
4. Add the custom field `private` (can be overridden on the command line), containing the file name of the private key attachment.
|
|
5. Optional: If your key is encrypted with passphrase and you want it to decrypt automatically, save passphrase into custom field `passphrase` (field name can be overriden on the command line)
|
|
6. Repeat steps 2-6 for each subsequent key
|