diff options
| author | Robin Krahl <robin.krahl@ireas.org> | 2019-01-06 00:10:44 +0100 |
|---|---|---|
| committer | Daniel Mueller <deso@posteo.net> | 2019-01-13 18:36:58 -0800 |
| commit | 53a2893ee725e4ad678b2060fd71729ff55e6cee (patch) | |
| tree | 0d17667568b8f6fcb19fa111cc5efd8a7c16df13 /nitrocli/doc/nitrocli.1 | |
| parent | 091e01ba40e488dfd68b43db56fc0693a350510a (diff) | |
| download | nitrocli-53a2893ee725e4ad678b2060fd71729ff55e6cee.tar.gz nitrocli-53a2893ee725e4ad678b2060fd71729ff55e6cee.tar.bz2 | |
Add the --format option to otp set to select the secret format
This patch introduces the -f/--format options for the otp set
subcommand to specify the format of the OTP secret. Previously, the
default format was hexadecimal and ASCII format could be selected using
the --ascii option. The new --format option takes the argument hex or
ascii, defaulting to hex, and replaces the --ascii option.
This patch does not remove the --ascii option but marks it as
deprecated. It may not be set together with --format, and a warning is
printed if it is set. It should be deleted with the next minor release.
This patch prepares the addition of a new format, base32.
Diffstat (limited to 'nitrocli/doc/nitrocli.1')
| -rw-r--r-- | nitrocli/doc/nitrocli.1 | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/nitrocli/doc/nitrocli.1 b/nitrocli/doc/nitrocli.1 index e4dbf10..16e06a0 100644 --- a/nitrocli/doc/nitrocli.1 +++ b/nitrocli/doc/nitrocli.1 @@ -82,15 +82,19 @@ This command might require the user PIN (see the Configuration section). \fBnitrocli otp set \fIslot name secret \ \fR[\fB\-a\fR|\fB\-\-algorithm \fIalgorithm\fR] \ [\fB\-d\fR|\fB\-\-digits \fIdigits\fR] [\fB\-c\fR|\fB\-\-counter \fIcounter\fR] \ -[\fB\-t\fR|\fB\-\-time-window \fItime window\fR] [\fB\-\-ascii\fR] +[\fB\-t\fR|\fB\-\-time-window \fItime-window\fR] \ +[\fB-f\fR|\fB\-\-format ascii\fR|\fBhex\fR] Configure a one-time password slot. \fIslot\fR is the number of the slot to configure. \fIname\fR is the name of the slot (may not be empty). \fIsecret\fR is the secret value to store in that slot. -If \fB\-\-ascii\fR is set, each character of the given secret is interpreted as -the ASCII code of one byte. -Otherwise, every two characters are interpreted as the hexadecimal value of one -byte. + +The \fB\-\-format\fR option specifies the format of the secret. +If it is set to \fBascii\fR, each character of the given secret is interpreted +as the ASCII code of one byte. +If it is set to \fBhex\fR, every two characters are interpreted as the +hexadecimal value of one byte. +The default value is \fBhex\fR. \fIalgorithm\fR is the OTP algorithm to use. Possible values are \fBhotp\fR for the HOTP algorithm according to RFC 4226 and @@ -222,9 +226,9 @@ Configure a one-time password slot with a hexadecimal secret representation: $ \fBnitrocli otp set 0 test\-rfc6238 3132333435363738393031323334353637383930 \-\-algorithm totp \-\-digits 8\fR .P Configure a one-time password slot with an ASCII secret representation: - $ \fBnitrocli otp set 0 test\-rfc4226 12345678901234567890 \-\-ascii \-\-algorithm hotp\fR - $ \fBnitrocli otp set 1 test\-foobar foobar \-\-ascii \-\-algorithm hotp\fR - $ \fBnitrocli otp set 0 test\-rfc6238 12345678901234567890 \-\-ascii \-\-algorithm totp \-\-digits 8\fR + $ \fBnitrocli otp set 0 test\-rfc4226 12345678901234567890 \-\-format ascii \-\-algorithm hotp\fR + $ \fBnitrocli otp set 1 test\-foobar foobar \-\-format ascii \-\-algorithm hotp\fR + $ \fBnitrocli otp set 0 test\-rfc6238 12345678901234567890 \-\-format ascii \-\-algorithm totp \-\-digits 8\fR .P Generate a one-time password: $ \fBnitrocli otp get 0 \-\-algorithm hotp\fR |