|
- hash_password(1) -- Calculate the hash of a new password, so that passwords can be reset
- ========================================================================================
-
- ## SYNOPSIS
-
- `hash_password` [`-p`|`--password` [password]] [`-c`|`--config` <file>]
-
- ## DESCRIPTION
-
- **hash_password** calculates the hash of a supplied password using bcrypt.
-
- `hash_password` takes a password as an parameter either on the command line
- or the `STDIN` if not supplied.
-
- 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 `bcrypt_rounds` is set to **12**.
-
- The hashed password is written on the `STDOUT`.
-
- ## FILES
-
- A sample YAML file accepted by `hash_password` is described below:
-
- bcrypt_rounds: 17
- password_config:
- pepper: "random hashing pepper"
-
- ## OPTIONS
-
- * `-p`, `--password`:
- Read the password form the command line if [password] is supplied.
- If not, prompt the user and read the password form the `STDIN`.
- It is not recommended to type the password on the command line
- directly. Use the STDIN instead.
-
- * `-c`, `--config`:
- Read the supplied YAML <file> containing the options `bcrypt_rounds`
- and the `password_config` section containing the `pepper` value.
-
- ## EXAMPLES
-
- Hash from the command line:
-
- $ hash_password -p "p@ssw0rd"
- $2b$12$VJNqWQYfsWTEwcELfoSi4Oa8eA17movHqqi8.X8fWFpum7SxZ9MFe
-
- Hash from the STDIN:
-
- $ hash_password
- Password:
- Confirm password:
- $2b$12$AszlvfmJl2esnyhmn8m/kuR2tdXgROWtWxnX.rcuAbM8ErLoUhybG
-
- Using a config file:
-
- $ hash_password -c config.yml
- Password:
- Confirm password:
- $2b$12$CwI.wBNr.w3kmiUlV3T5s.GT2wH7uebDCovDrCOh18dFedlANK99O
-
- ## COPYRIGHT
-
- This man page was written by Rahul De <<rahulde@swecha.net>>
- for Debian GNU/Linux distribution.
-
- ## SEE ALSO
-
- synctl(1), synapse_port_db(1), register_new_matrix_user(1), synapse_review_recent_signups(1)
|