/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to clients.conf

  • Committer: Teddy Hogeborn
  • Date: 2022-04-23 20:36:45 UTC
  • Revision ID: teddy@recompile.se-20220423203645-ktjgbbuwsha3z5ym
Add comment about duration syntax to default clients.conf.

* clients.conf (timeout, interval, extended_timeout, approval_delay,
  approval_duration): Add comment about this being RFC 3339 syntax.

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
# values, so uncomment and change them if you want different ones.
3
3
[DEFAULT]
4
4
 
5
 
# How long until a client is considered invalid - that is, ineligible
6
 
# to get the data this server holds.
7
 
;timeout = 1h
 
5
# How long until a client is disabled and not be allowed to get the
 
6
# data this server holds.
 
7
# (RFC 3339 duration syntax)
 
8
;timeout = PT5M
8
9
 
9
10
# How often to run the checker to confirm that a client is still up.
10
11
# Note: a new checker will not be started if an old one is still
11
12
# running.  The server will wait for a checker to complete until the
12
 
# "timeout" above occurs, at which time the client will be marked
13
 
# invalid, and any running checker killed.
14
 
;interval = 5m
 
13
# above "timeout" occurs, at which time the client will be disabled,
 
14
# and any running checker killed.
 
15
# (RFC 3339 duration syntax)
 
16
;interval = PT2M
 
17
 
 
18
# Extended timeout is an added timeout that is given once after a
 
19
# password has been sent sucessfully to a client.  This allows for
 
20
# additional delays caused by file system checks and quota checks.
 
21
# (RFC 3339 duration syntax)
 
22
;extended_timeout = PT15M
15
23
 
16
24
# What command to run as "the checker".
17
25
;checker = fping -q -- %%(host)s
18
26
 
 
27
# Whether to approve a client by default after the approval delay.
 
28
;approved_by_default = True
 
29
 
 
30
# How long to wait for approval.
 
31
# (RFC 3339 duration syntax)
 
32
;approval_delay = PT0S
 
33
 
 
34
# How long one approval will last.
 
35
# (RFC 3339 duration syntax)
 
36
;approval_duration = PT1S
 
37
 
 
38
# Whether this client is enabled by default
 
39
;enabled = True
 
40
 
19
41
 
20
42
;####
21
 
;# Example client named "foo"
 
43
;# Example client
22
44
;[foo]
23
45
;
24
 
;# OpenPGP key fingerprint for "foo"
 
46
;# TLS public key ID
 
47
;key_id = f33fcbed11ed5e03073f6a55b86ffe92af0e24c045fb6e3b40547b3dc0c030ed
 
48
;
 
49
;# OpenPGP key fingerprint
25
50
;fingerprint =  7788 2722 5BA7 DE53 9C5A  7CFA 59CF F7CD BD9A 5920
26
51
;
27
52
;# This is base64-encoded binary data.  It will be decoded and sent to
43
68
;        5MHdW9AYsNJZAQSOpirE4Xi31CSlWAi9KV+cUCmWF5zOFy1x23P6PjdaRm
44
69
;        4T2zw4dxS5NswXWU0sVEXxjs6PYxuIiCTL7vdpx8QjBkrPWDrAbcMyBr2O
45
70
;        QlnHIvPzEArRQLo=
46
 
;        =iHhv
47
71
;
48
72
;# Host name; used only by the checker, not used by the server itself.
49
73
;host = foo.example.org
52
76
;####
53
77
;# Another example client, named "bar".
54
78
;[bar]
 
79
;# The key ID is not space or case sensitive
 
80
;key_id = F33FCBED11ED5E03073F6A55B86FFE92 AF0E24C045FB6E3B40547B3DC0C030ED
 
81
;
55
82
;# The fingerprint is not space or case sensitive
56
83
;fingerprint = 3e393aeaefb84c7e89e2f547b3a107558fca3a27
57
84
;
58
85
;# If "secret" is not specified, a file can be read for the data.
59
 
;;secfile = /etc/mandos/bar-secret.txt.asc
 
86
;secfile = /etc/keys/mandos/bar-secret.bin
60
87
;
61
88
;# An IP address for host is also fine, if the checker accepts it.
62
89
;host = 192.0.2.3
63
90
;
64
91
;# Parameters from the [DEFAULT] section can be overridden per client.
65
 
;interval = 5m
 
92
;interval = PT1M
 
93
;
 
94
;# This client requires manual approval before it receives its secret.
 
95
;approved_by_default = False
 
96
;# Require approval within 30 seconds.
 
97
;approval_delay = PT30S
66
98
;####