forked from arachsys/totp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
_Fish README.txt
92 lines (52 loc) · 2.98 KB
/
_Fish README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
--------------------------------------------------------------------------------
TOTP
Fish's 'TOTP' (Time-Based One-Time-Password) Utility
https://github.com/Fish-Git/totp
Based on original work:
Copyright (C) Chris Webb <[email protected]>
https://github.com/arachsys/totp
--------------------------------------------------------------------------------
This program requires the "libcrypto-3-x64.dll" from the OpenSSL project.
OpenSSL for Windows may be installed from:
* https://slproweb.com/products/Win32OpenSSL.html
Afterwards, append its directories to your system's environment variables:
PATH (always!)
C:\Program Files\OpenSSL-Win64\bin
INCLUDE (only if building)
C:\Program Files\OpenSSL-Win64\include
C:\Program Files\OpenSSL-Win64\include\openssl
LIB (only if building)
C:\Program Files\OpenSSL-Win64\lib
C:\Program Files\OpenSSL-Win64\lib\VC
C:\Program Files\OpenSSL-Win64\lib\VC\static
--------------------------------------------------------------------------------
Changes and enhancements by Fish (version 1.2):
* Remove spaces from input line. This is mostly for Google Authenticator
compatibility as its SECRET is always shown to the user as a lowercase
string with a blank/space inserted after every 4 characters for read-
ability.
NOTE! THIS CHANGE REQUIRES ANY TRAILING COMMENT (IF ANY) TO BEGIN WITH
A NON-BASE32 CHARACTER (such as a '*', '#' or ';' comment char) SO THAT
THE END OF THE 'SECRET' STRING CAN BE PROPERLY DETECTED!
Changes and enhancements by Fish (version 1.1):
* Convert input to uppercase, since A-Z2-7 base32 encoding is required,
and currently we reject anything that is not valid base32. This is
mostly for Google Authenticator compatibility as its SECRET is always
shown to the user as a lowercase string.
Changes and enhancements by Fish (version 1.0):
. Made it a Visual Studio 2008 project (Duh!)
. Added my own Copyright to "COPYING".
. Coding style (Duh!). It's my own, not Chris's.
. Added a bunch of comments to try and explain what's going on
(i.e. how the program works). I also changed some of the variable
names and added a few new variables too. I hope I got them right!
. Added stdin "TEST:" option to allow testing for correctness of
functionality by verifying values produced match those that are
documented in RFC 6328 Appendix B. Refer to comments in source
file "totp.cpp" for usage information.
. Added support for comments in stdin input. Created stdin.txt file
to test with, as well as expected test results stdout.txt file.
. NOTE: comments in stdin.txt contain RFC 6328 errata corrections.
. Wrote my own "getline" function since Windows didn't have one.
. Added support to disable stdin keyboard echoing for security.
--------------------------------------------------------------------------------