diff options
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@. |