mirror of
https://github.com/element-hq/synapse.git
synced 2024-12-26 17:36:27 +00:00
8da16e55fe
`hash_password` now actually accepts password from stdin. The `getpass` reads from TTY, and does NOT accept stdin in any way. The manpage has been updated to reflect that.
72 lines
2.3 KiB
Groff
72 lines
2.3 KiB
Groff
.\" generated with Ronn-NG/v0.10.1
|
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
.TH "HASH_PASSWORD" "1" "August 2024" ""
|
|
.SH "NAME"
|
|
\fBhash_password\fR \- Calculate the hash of a new password, so that passwords can be reset
|
|
.SH "SYNOPSIS"
|
|
.TS
|
|
allbox;
|
|
\fBhash_password\fR [\fB\-p\fR \fB\-\-password\fR [password]] [\fB\-c\fR \fB\-\-config\fR \fIfile\fR]
|
|
.TE
|
|
.SH "DESCRIPTION"
|
|
\fBhash_password\fR calculates the hash of a supplied password using bcrypt\.
|
|
.P
|
|
\fBhash_password\fR takes a password as an parameter either on the command line or the \fBSTDIN\fR if not supplied\.
|
|
.P
|
|
It accepts an YAML file which can be used to specify parameters like the number of rounds for bcrypt and password_config section having the pepper value used for the hashing\. By default \fBbcrypt_rounds\fR is set to \fB12\fR\.
|
|
.P
|
|
The hashed password is written on the \fBSTDOUT\fR\.
|
|
.SH "FILES"
|
|
A sample YAML file accepted by \fBhash_password\fR is described below:
|
|
.P
|
|
bcrypt_rounds: 17 password_config: pepper: "random hashing pepper"
|
|
.SH "OPTIONS"
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-password\fR
|
|
Read the password form the command line if [password] is supplied, or from \fBSTDIN\fR\. If not, prompt the user and read the password from the tty prompt\. It is not recommended to type the password on the command line directly\. Use the STDIN instead\.
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-config\fR
|
|
Read the supplied YAML \fIfile\fR containing the options \fBbcrypt_rounds\fR and the \fBpassword_config\fR section containing the \fBpepper\fR value\.
|
|
.SH "EXAMPLES"
|
|
Hash from the command line:
|
|
.IP "" 4
|
|
.nf
|
|
$ hash_password \-p "p@ssw0rd"
|
|
$2b$12$VJNqWQYfsWTEwcELfoSi4Oa8eA17movHqqi8\.X8fWFpum7SxZ9MFe
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Hash from the stdin:
|
|
.IP "" 4
|
|
.nf
|
|
$ cat password_file | hash_password
|
|
Password:
|
|
Confirm password:
|
|
$2b$12$AszlvfmJl2esnyhmn8m/kuR2tdXgROWtWxnX\.rcuAbM8ErLoUhybG
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Hash from the prompt:
|
|
.IP "" 4
|
|
.nf
|
|
$ hash_password
|
|
Password:
|
|
Confirm password:
|
|
$2b$12$AszlvfmJl2esnyhmn8m/kuR2tdXgROWtWxnX\.rcuAbM8ErLoUhybG
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Using a config file:
|
|
.IP "" 4
|
|
.nf
|
|
$ hash_password \-c config\.yml
|
|
Password:
|
|
Confirm password:
|
|
$2b$12$CwI\.wBNr\.w3kmiUlV3T5s\.GT2wH7uebDCovDrCOh18dFedlANK99O
|
|
.fi
|
|
.IP "" 0
|
|
.SH "COPYRIGHT"
|
|
This man page was written by Rahul De «rahulde@swecha\.net» for Debian GNU/Linux distribution\.
|
|
.SH "SEE ALSO"
|
|
synctl(1), synapse_port_db(1), register_new_matrix_user(1), synapse_review_recent_signups(1)
|