Add man page for usergen(1)
This commit is contained in:
parent
f6fd20fdc4
commit
aefd6c6fda
|
@ -122,3 +122,6 @@ Written by Xavier Del Campo Romero.
|
|||
|
||||
.SH TODO
|
||||
Allow deleting files and directories from the web interface.
|
||||
|
||||
.SH SEE ALSO
|
||||
.B usergen(1)
|
||||
|
|
|
@ -0,0 +1,92 @@
|
|||
.TH USERGEN 1 usergen
|
||||
|
||||
.SH NAME
|
||||
usergen \- append a user into a slcl database
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B usergen
|
||||
dir
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B usergen
|
||||
performs the following steps:
|
||||
|
||||
.B 1.
|
||||
Reads user credentials and quota from standard input.
|
||||
|
||||
.B 2.
|
||||
Generates a JSON object with the read credentials and quota, as well as
|
||||
a random salt and signing key.
|
||||
|
||||
.B 3.
|
||||
Appends the newly generated JSON object into the
|
||||
.B users
|
||||
key in
|
||||
.BR dir/db.json .
|
||||
|
||||
.B 4.
|
||||
Creates a directory with the username in
|
||||
.BR dir/user/ .
|
||||
|
||||
.SH OPTIONS
|
||||
.B dir
|
||||
defines the directory where
|
||||
.B db.json
|
||||
is located.
|
||||
|
||||
.SH NOTES
|
||||
For security reasons, passwords are never stored in plaintext into
|
||||
.BR dir/db.json .
|
||||
Instead, a salted, multi-round hashed password is calculated and
|
||||
stored. Then,
|
||||
.B slcl(1)
|
||||
performs the same operations to ensure both tokens match.
|
||||
|
||||
.SH EXAMPLES
|
||||
|
||||
Below, there is an example of a new user called
|
||||
.B johndoe
|
||||
with password
|
||||
.B secret
|
||||
and a specified quota of 512 MiB:
|
||||
|
||||
.PP
|
||||
.EX
|
||||
$ ./usergen ~/db
|
||||
Username:
|
||||
johndoe
|
||||
Password:
|
||||
secret
|
||||
Quota, in MiB (leave empty for unlimited quota):
|
||||
512
|
||||
1000/1000
|
||||
.EE
|
||||
|
||||
Then,
|
||||
.B dir/db.json
|
||||
should be updated to something similar to:
|
||||
|
||||
.PP
|
||||
.EX
|
||||
{
|
||||
"users": [
|
||||
{
|
||||
"name": "johndoe",
|
||||
"password": "4c48385ec2be4798dc772d3c8f5649d8411afbdfc4708ada79379e3562af5abb",
|
||||
"salt": "835324df29527731f3faad663c58c3b19a07c193e97dc77f33e10d3942cdc91c",
|
||||
"key": "d0ae360b9af1177ce73eef3f499eea2627cd61b69df79dcb7a5c70bc658a4e63",
|
||||
"quota": "512"
|
||||
}
|
||||
]
|
||||
}
|
||||
.EE
|
||||
|
||||
.SH LICENSE
|
||||
See the LICENSE file for further reference.
|
||||
|
||||
.SH AUTHORS
|
||||
Written by Xavier Del Campo Romero.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.B slcl(1)
|
Loading…
Reference in New Issue