summary refs log tree commit diff
path: root/debian/hash_password.ronn
blob: eeb354602da28652b0064ed584bbdf8ea5110ec4 (plain) (blame)
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
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 **10**.

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)