73 lines
1.8 KiB
ReStructuredText
73 lines
1.8 KiB
ReStructuredText
cdist-type__pass(7)
|
|
===================
|
|
|
|
NAME
|
|
----
|
|
cdist-type__pass - Generate and use passwords using pass(1).
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This type allows a user to generate and query passwords stored using pass(1) on
|
|
the host machine. The password is then printed to the cdist message system, so
|
|
types depending on this one should require it. This enables an administrator to
|
|
ensure a password exists using this type and then, from another type, use it as
|
|
need be.
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
storedir
|
|
The host-local directory where the password store is to be found (or
|
|
created if it does not exist).
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
length
|
|
The length of the password to be created if it does not exist. Note that if
|
|
it exists, this has no effect (and hence will not update the password, even
|
|
if the length is different from the one specified).
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
------------------
|
|
no-symbols
|
|
If this parameter is set, then a newly generated password will only contain
|
|
alphanumeric characters, making it easier for typing by meatware.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
Assuming that __othertype takes the path of the password as an argument and
|
|
looks up in the cdist messages to find it:
|
|
|
|
.. code-block:: sh
|
|
|
|
require=__pass_init \
|
|
__pass database/services/arandomservice \
|
|
--storedir password/store/location
|
|
|
|
require='__pass/database/services/arandomservice' \
|
|
__othertype --password database/service/arandomservice
|
|
|
|
|
|
--
|
|
|
|
SEE ALSO
|
|
--------
|
|
`pass`\ (7), `cdist-type__pass_init`\ (7)
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
Joachim Desroches <joachim.desroches@epfl.ch>
|
|
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2020 Joachim Desroches. You can redistribute it
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|