2019-04-18 20:08:57 +00:00
|
|
|
.TH LSSH 1 "18 Apr 2019" "version 2019.04.18"
|
|
|
|
.SH NAME
|
|
|
|
lssh \- a wrapper for Lastpass CLI and ssh-agent
|
|
|
|
.SH SYNOPSIS
|
|
|
|
lssh [options] [ssh-key]
|
|
|
|
.SH DESRIPTION
|
2019-04-18 22:31:41 +00:00
|
|
|
lssh quickly activates ssh keys by name, filling passwords via Lastpass CLI, and
|
2019-04-18 20:08:57 +00:00
|
|
|
adding them to ssh-agent. Keys are activated for 1-hour at a time.
|
2019-04-18 22:31:41 +00:00
|
|
|
|
|
|
|
The ssh key name provided to
|
|
|
|
.B lssh
|
|
|
|
will be used to look up both the key itself and the password for the key. If
|
|
|
|
that key has a password,
|
|
|
|
.B lssh
|
|
|
|
will search Lastpass for an entry named `SSH: [ssh-key]' and autofill the password
|
|
|
|
with the results. If that entry is not found, `[ssh-key]' will also be attempted
|
|
|
|
before giving up on a password search. The key will be passed to the ssh-agent
|
|
|
|
regardless.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
|
|
.B -h
|
|
|
|
Shows simple help.
|
|
|
|
.TP
|
|
|
|
.B -v
|
|
|
|
Shows current version number.
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
|
|
.TP
|
|
|
|
.B SSH_KEY_LOCATIONS
|
|
|
|
List of folders containing ssh keys.
|
|
|
|
|
|
|
|
This environment variable can contain any number of folder paths, space
|
|
|
|
separated, which will be used to search for the ssh keys. The folders are
|
|
|
|
searched in order and the search stops at the first successful match.
|
|
|
|
.TP
|
|
|
|
.B LASTPASS_USER
|
|
|
|
Login username to Lastpass. This is used to initiate a login if you are not
|
|
|
|
already logged in when initiating lssh
|
|
|
|
.SH EXAMPLES
|
|
|
|
If you have an ssh key located at ~/.ssh/work/id_rsa, it can be loaded by
|
|
|
|
entering:
|
|
|
|
|
|
|
|
$ lssh work
|