]> Cypherpunks.ru repositories - govpn.git/blobdiff - doc/verifier.texi
Replace Argon2 with Balloon hashing
[govpn.git] / doc / verifier.texi
index 779f247f9e3fd81d725cb0c894db667b7e68a332..ecf98ad6ddc606342e78dc7886c1c19c99014b01 100644 (file)
@@ -1,34 +1,28 @@
 @node Verifier
-@cindex Verifier
-@cindex storekey.sh
-@cindex govpn-verifier
 @subsection Verifier
 
-Verifier is created using @code{govpn-verifier} utility. But currently
-Go does not provide native instruments to read passwords without echoing
-them to stdout. You can use @code{utils/storekey.sh} script to read them
-silently.
+Verifier is created using @command{govpn-verifier} utility.
 
-@example
-% utils/storekey.sh mypass.txt
-Enter passphrase:[hello world]
-% govpn-verifier -key mypass.txt
-$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
-$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg
-@end example
+@verbatim
+% govpn-verifier
+Passphrase:[hello world]
+$balloon$s=32768,t=16,p=2$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
+$balloon$s=32768,t=16,p=2$bwR5VjeCYIQaa8SeaI3rqg
+@end verbatim
 
 First line is the verifier for the server side. Second line is for the
 client -- it lacks generated public key. However you can use server's
 one on the client side too.
 
-You can check passphrase against verifier by specifying @code{-verifier}
+You can check passphrase against verifier by specifying @option{-verifier}
 option with the path to verifier file:
 
-@example
-% govpn-verifier -key mypass.txt -verifier '$argon2d...'
+@verbatim
+% govpn-verifier -verifier '$balloon...'
+Passphrase:[hello world]
 true
-@end example
+@end verbatim
 
-Plaintext passphrases @strong{must} be stored on volatile memory, for
-example either in memory disk, or on encrypted filesystem with
-restrictive permissions to the file.
+Optionally you can store plaintext passphrases on volatile memory
+(memory disk, encrypted filesystem with restrictive permissions to the
+file) and provide @option{-key} option.