Bläddra i källkod

Add documentation (#961).

Dan Helfman 4 månader sedan
förälder
incheckning
c392e4914c
1 ändrade filer med 20 tillägg och 2 borttagningar
  1. 20 2
      docs/how-to/provide-your-passwords.md

+ 20 - 2
docs/how-to/provide-your-passwords.md

@@ -24,11 +24,29 @@ or security reasons, read on.
 borgmatic supports calling another application such as a password manager to 
 borgmatic supports calling another application such as a password manager to 
 obtain the Borg passphrase to a repository.
 obtain the Borg passphrase to a repository.
 
 
-For example, to ask the *Pass* password manager to provide the passphrase:
+For example, to ask the [Pass](https://www.passwordstore.org/) password manager
+to provide the passphrase:
+
+```yaml
+encryption_passcommand: pass path/to/borg-passphrase
+```
+
+Another example for [KeePassXC](https://keepassxc.org/):
+
 ```yaml
 ```yaml
-encryption_passcommand: pass path/to/borg-repokey
+encryption_passcommand: keepassxc-cli show --show-protected --attributes Password credentials.kdbx borg_passphrase
 ```
 ```
 
 
+... where `borg_passphrase` is the title of the KeePassXC entry containing your
+Borg encryption passphrase in its `Password` field.
+
+<span class="minilink minilink-addedin">New in version 1.9.9</span> Instead of
+letting Borg run the passcommand—potentially mulitple times since borgmatic runs
+Borg multiple times—borgmatic now runs the passcommand itself and passes it
+securely to Borg via an anonymous pipe. This means you should only ever get
+prompted for your password manager's passphrase at most once per borgmatic run.
+
+
 ### Using systemd service credentials
 ### Using systemd service credentials
 
 
 Borgmatic supports using encrypted [credentials](https://systemd.io/CREDENTIALS/).
 Borgmatic supports using encrypted [credentials](https://systemd.io/CREDENTIALS/).