diff options
| author | Nat Lasseter <nat.lasseter@york.ac.uk> | 2022-09-29 12:27:19 +0100 |
|---|---|---|
| committer | Nat Lasseter <nat.lasseter@york.ac.uk> | 2022-09-29 12:27:19 +0100 |
| commit | 5a27585bbb467802c579ae3a1d043e31cd8c315d (patch) | |
| tree | 5c321d5ee8dd8dd8118d2afb6705cef8e34c94cb /Readme.textile | |
| parent | 16f7d3f1e3ef999c9515b93f0525d0e2db215633 (diff) | |
Added HOTP functionality
Diffstat (limited to 'Readme.textile')
| -rw-r--r-- | Readme.textile | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/Readme.textile b/Readme.textile index 3051c29..8997f39 100644 --- a/Readme.textile +++ b/Readme.textile @@ -13,7 +13,7 @@ p. For clipboard tasks, twofa requires the _clipboard_ gem, and either the _xcli h2. Usage bc.. $ twofa -h -twofa is a command line TOTP code generator. +twofa is a command line OTP code generator. Usage: twofa [opts] ISSUER @@ -26,6 +26,18 @@ where [opts] are: h3. twofa secrets file -p. The twofa secrets file is normally found at @~./twofa@, and has the format: +p. The twofa secrets file is normally found at @~./twofa@, and each record has the following fields. If any of the optional fields are given, all preceeding optional fields must also be given. -bc. ISSUER SECRET [interval | default(30)] [length | default(6)] [hashing algorithm | default(sha1)] +p. If a HOTP code is requested, the file will be canoncalised. + +h4. Required fields + +- Method := The OTP type, currently @totp@ or @hotp@ +- Issuer := Human name for this issuer +- Secret := The BASE32 shared secret + +h4. Optional fields + +- Time interval or Counter := Either the time interval (for TOTP) or counter (for HOTP). The former defaults to 30 if not given, the latter to 0. +- Length := The output code length. Defaults to 6 digits. +- Hashing algorithm := The algorithm used to generate the HMAS hash. Defaults to @sha1@. |