tyler/proxmox-backup
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: Document new environment variabless to specify secret values

Browse Source 
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Dietmar Maurer 2021-07-21 11:59:55 +02:00 committed by Thomas Lamprecht
parent 16a01c19dd
commit 99a73fad15
1 changed files with 33 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
docs/backup-client.rst
View File

@ -49,15 +49,48 @@ Environment Variables
When set, this value is used for the password required for the backup server. When set, this value is used for the password required for the backup server.
You can also set this to a API token secret. You can also set this to a API token secret.
.. Note:: if not set, we also query ``PBS_PASSWORD_FD``,
``PBS_PASSWORD_FILE`` and ``PBS_PASSWORD_CMD`` (in that order)
and return the first value set.
``PBS_PASSWORD_FD``
Like ``PBS_PASSWORD``, but read data from Unix file descriptor.
``PBS_PASSWORD_FILE``
Like ``PBS_PASSWORD``, but read data from specified file name.
``PBS_PASSWORD_CMD``
Like ``PBS_PASSWORD``, but read data from specified command (stdout).
``PBS_ENCRYPTION_PASSWORD`` ``PBS_ENCRYPTION_PASSWORD``
When set, this value is used to access the secret encryption key (if When set, this value is used to access the secret encryption key (if
protected by password). protected by password).
.. Note:: if not set, we also query ``PBS_ENCRYPTION_PASSWORD_FD``,
``PBS_ENCRYPTION_PASSWORD_FILE`` and
``PBS_ENCRYPTION_PASSWORD_CMD`` (in that order) and return the
first value set.
``PBS_ENCRYPTION_PASSWORD_FD``
Like ``PBS_ENCRYPTION_PASSWORD``, but read data from Unix file descriptor.
``PBS_ENCRYPTION_PASSWORD_FILE``
Like ``PBS_ENCRYPTION_PASSWORD``, but read data from specified file name.
``PBS_ENCRYPTION_PASSWORD_CMD``
Like ``PBS_ENCRYPTION_PASSWORD``, but read data from specified command (stdout).
``PBS_FINGERPRINT`` When set, this value is used to verify the server ``PBS_FINGERPRINT`` When set, this value is used to verify the server
certificate (only used if the system CA certificates cannot validate the certificate (only used if the system CA certificates cannot validate the
certificate). certificate).
.. Note:: Passwords must be valid UTF8 an may not contain
newlines. For your convienience, we just use the first line as
password, so you can add arbitrary comments after the
first newline.
Output Format Output Format
------------- -------------