The ''password'' sub-command

This sub-command is used to create a hashed password for users to be authenticated.

It reads a password from standard input (two times, both must be equal) and writes the hashed password to standard output.

The general usage is:

zettelstore password IDENT ZETTEL-ID

IDENT is the identification for the user that should be authenticated. ZETTEL-ID is the identifier of the zettel that later acts as a user zettel.

See Creating a user zettel for some background information.

An example:

# zettelstore password bob 20200911115600
Password:
   Again:
credential: $2a$10$1q92v1Ya8Too5HD/4rKpPuCP8fZTYPochsC6DcY1T4JKwhSx8uLu6
user-id: bob

This will produce a hashed password (“credential”) for the new user “bob” to be stored in zettel “20200911115600”.

You should copy the relevant output to the zettel of the user to be secured, especially by setting the meta keys credential and user-id to the copied values.

Please note that the generated hashed password is tied to the given user identification (user-id) and to the identifier of its zettel. Changing one of these will prevent the user from being authenticated with the given password. In this case you have to re-run this sub-command.