ssp 0.1.0

2024-01-09

ssp-add(1)
ssp
ssp-add(1)

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.

Information

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=

SEE ALSO

ssp-edit(1), ssp-remove(1)

ssp 0.1.0
2024-01-09
ssp-add(1)