You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/configuration.md
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,12 +11,14 @@ The `usbguard-daemon.conf` file is loaded by the USBGuard daemon after it parses
11
11
12
12
*`RuleFile=<path>`
13
13
The USBGuard daemon will use this file to load the policy rule set from it and to write new rules received via the IPC interface.
14
+
Default: `%sysconfdir%/usbguard/rules.conf`
14
15
15
16
*`ImplicitPolicyTarget=<target>`
16
17
How to treat devices that don't match any rule in the policy.
17
18
* allow - authorize the device
18
19
* block - deauthorize the device
19
20
* reject - logically remove the device node from the system
21
+
`Default: block`
20
22
21
23
*`PresentDevicePolicy=<policy>`
22
24
How to treat devices that are already connected when the daemon starts:
@@ -25,6 +27,7 @@ The `usbguard-daemon.conf` file is loaded by the USBGuard daemon after it parses
25
27
* reject - remove every present device
26
28
* keep - just sync the internal state and leave it
27
29
* apply-policy - evaluate the ruleset for every present device
30
+
Default: `apply-policy`
28
31
29
32
*`PresentControllerPolicy=<policy>`
30
33
How to treat USB controllers that are already connected when the daemon starts:
@@ -33,9 +36,11 @@ The `usbguard-daemon.conf` file is loaded by the USBGuard daemon after it parses
33
36
* reject - remove every present device
34
37
* keep - just sync the internal state and leave it
35
38
* apply-policy - evaluate the ruleset for every present device
39
+
Default: `keep`
36
40
37
41
*`InsertedDevicePolicy=<policy>`
38
42
How to treat USB devices that are already connected after the daemon starts. One of block, reject, apply-policy.
43
+
Default: `apply-policy`
39
44
40
45
*`RestoreControllerDeviceState=<boolean>`
41
46
The USBGuard daemon modifies some attributes of controller devices like the default authorization state of new child device instances. Using this setting, you can control whether the daemon will try to restore the attribute values to the state before modification on shutdown.
@@ -46,6 +51,7 @@ The `usbguard-daemon.conf` file is loaded by the USBGuard daemon after it parses
46
51
47
52
*`IPCAllowedUsers=<username> [<username> ...]`
48
53
A space delimited list of usernames that the daemon will accept IPC connections from.
54
+
Default: `root`
49
55
50
56
*`IPCAllowedGroups=<groupname> [<groupname> ...]`
51
57
A space delimited list of groupnames that the daemon will accept IPC connections from.
@@ -55,16 +61,20 @@ The `usbguard-daemon.conf` file is loaded by the USBGuard daemon after it parses
55
61
56
62
*`DeviceRulesWithPort=<boolean>`
57
63
Generate device specific rules including the "via-port" attribute.
64
+
Default: `false`
58
65
59
66
*`AuditBackend=<backend>`
60
67
USBGuard audit events log backend. The backend value should be one of FileAudit or LinuxAudit.
68
+
Default: `FileAudit`
61
69
62
70
*`AuditFilePath=<filepath>`
63
71
USBGuard audit events log file path. Required if AuditBackend is set to FileAudit.
0 commit comments