2019-12-25 16:34:32 +00:00
|
|
|
.TH LSSH 1 "25 Dec 2019" "version 2019.12.25"
|
2019-04-18 20:08:57 +00:00
|
|
|
.SH NAME
|
|
|
|
|
lssh \- a wrapper for Lastpass CLI and ssh-agent
|
|
|
|
|
.SH SYNOPSIS
|
2019-04-18 22:41:59 +00:00
|
|
|
lssh [ -hv ] [ssh key name]
|
2019-04-18 20:08:57 +00:00
|
|
|
.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
|
2019-04-18 22:41:59 +00:00
|
|
|
will search Lastpass for an entry named `SSH: [ssh key name]' and autofill the password
|
|
|
|
|
with the results. If that entry is not found, `[ssh key name]' will also be attempted
|
2019-04-18 22:31:41 +00:00
|
|
|
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.
|
2019-04-18 22:33:16 +00:00
|
|
|
|
|
|
|
|
Unless otherwise defined, this variable defaults to ~/.ssh/
|
2019-04-18 22:31:41 +00:00
|
|
|
.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
|
2019-04-18 22:41:59 +00:00
|
|
|
.SH DEPENDENCIES
|
|
|
|
|
.TP
|
|
|
|
|
.B lpass
|
|
|
|
|
The Lastpass CLI client
|
|
|
|
|
.TP
|
|
|
|
|
.B expect
|
|
|
|
|
programmed dialogue with interactive programs
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
James Tomasino
|
