gardesk/garcard / 04c9e0b

Browse files

Add garcard config scaffold

Authored by mfwolffe <wolffemf@dukes.jmu.edu>
SHA
04c9e0bccf2f0141a60ae8a039873424cff6a2c2
Parents
18c911a
Tree
b3e79d2

2 changed files

StatusFile+-
M README.md 3 1
A config/garcard/config.toml 26 0
README.mdmodified
@@ -27,7 +27,9 @@ Environment overrides:
2727
 9. `GARCARD_PROMPT_TIMEOUT_SECS`
2828
 10. `GARCARD_BACKEND_HEALTHCHECK_SECS`
2929
 
30
-See `examples/config.toml` for a starter file.
30
+Default scaffold file for packaging/integration: `config/garcard/config.toml`
31
+
32
+See `examples/config.toml` for a minimal local starter file.
3133
 
3234
 `GARCARD_PROMPT_COMMAND` is optional. If unset, `garcard` runs the built-in
3335
 `garcard prompt` gartk dialog path and falls back to `systemd-ask-password`
config/garcard/config.tomladded
@@ -0,0 +1,26 @@
1
+# garcard default configuration
2
+
3
+# Optional explicit socket path.
4
+# socket_path = "/tmp/garcard.sock"
5
+
6
+# Socket mode in octal string form.
7
+# Typical values:
8
+# - 600: owner read/write
9
+# - 660: owner/group read/write
10
+socket_mode = "600"
11
+
12
+# Backend mode:
13
+# - auto: try polkit, then fall back to stub if unavailable
14
+# - polkit: require polkit backend registration
15
+# - stub: run with local stub backend (dev/test only)
16
+agent_backend = "auto"
17
+
18
+# Polkit registration object path.
19
+polkit_object_path = "/org/gardesk/Garcard/AuthAgent"
20
+
21
+# Locale sent to polkit authority registration.
22
+locale = "en_US.UTF-8"
23
+
24
+# Backend health check interval in seconds.
25
+# Failed checks trigger a reconnect attempt for the selected auth backend.
26
+backend_healthcheck_secs = "5"