]> Cypherpunks.ru repositories - govpn.git/blobdiff - doc/verifier.texi
Use stderr for passphrase prompt, to prevent newclient.sh from catching it
[govpn.git] / doc / verifier.texi
index 07ba19826e5ccf2fb40f89ff819d472f6817a3b1..861bef0a25ee6cbd76146b8e0211571f908f3f5d 100644 (file)
@@ -1,34 +1,30 @@
 @node Verifier
-@section Verifier
+@cindex Verifier
+@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 @code{govpn-verifier} utility.
 
 @example
-% utils/storekey.sh mypass.txt
-Enter passphrase:[hello world]
-% govpn-verifier -key mypass.txt
+% govpn-verifier
+Passphrase:[hello world]
 $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
 $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg
 @end example
 
 First line is the verifier for the server side. Second line is for the
-client -- it lacks generated public key. However you can server's one
-on the client side too.
-
-Store @code{$argon2d...u10} string on the server's side in corresponding
-@code{verifier} configuration file's field.
+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}
 option with the path to verifier file:
 
 @example
-% govpn-verifier -key mypass.txt -verifier '$argon2d...'
+% govpn-verifier -verifier '$argon2d...'
+Passphrase:[hello world]
 true
 @end example
 
-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 @code{-key} option.