NAME
ssp-add - add an entry
SYNOPSIS
ssp add [OPTION..] ENTRY
SECRET
DESCRIPTION
The add command allows to add a new entry to an existing database, or to create a new database.
ENTRY
must be the entry's name, that will be used to identify the
newly-created entry.
SECRET
must be the entry's secret, encoded in base32.
Unless --time is used, the new entry will be set to be counter-based. Unless set with --algo, the hashing algorithm is SHA1.
Afterwards, the entry will be shown. This is done by re-opening the database
and processing the entry as via ssp show <entry>
As such, it can serve as a confirmation that the database was successfully
edited.
OPTIONS
-a, --algo ALGO
Set ALGO
as hashing algorithm; Defaults to sha1. Use list
to list
available algorithms.
-C, --comments COMMENTS
Set COMMENTS
as the entry's comments.
-c, --counter NUM
Set entry to be counter-based (HOTP) with the next counter value to be NUM
Defaults to 1.
-d, --digits NUM
Set to return an OTP of NUM
digits. Valid values are from 5 to 9 (both
included); Defaults to 6.
-t, --time[=SECS
]
Set entry to be time-based (TOTP) with a precision of SECS
seconds. Valid
values are from 10 to 59 (both included); Default to 30.
EXAMPLES
To create a new entry named "test" using the ASCII string "12345678901234567890" as actual secret :
$ ssp add test GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ
To create a new time-based entry named "foobar" with a 1 minute (60s) precision, using SHA256 as hashing algorithm and SECRET= as (base32-encoded) secret :
$ ssp a --algo sha256 -t60 foobar SECRET=