/mandos/release

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

« back to all changes in this revision

Viewing changes to clients.conf

  • Committer: Teddy Hogeborn
  • Date: 2024-09-08 00:08:15 UTC
  • mto: This revision was merged to the branch mainline in revision 410.
  • Revision ID: teddy@recompile.se-20240908000815-x3gr5xion3kyyoio
Improve documentation

* mandos.conf.xml (DESCRIPTION): Remove the unnecessary word "simple".
* plugin-runner.xml (PLUGINS): Remove the unnecessary word "simply",
  and add the "executable" qualifier to the description of plugins.
* mandos-client.xml (DESCRIPTION, OPTIONS): Do not refer to
  "plugin-runner"; instead refer to the section "OVERVIEW".
  (OVERVIEW): Don't only describe plugin-runner; also describe
  how password-agent can start mandos-client.
  (EXAMPLE): Do not refer to "plugin-runner"; instead refer to the
  section "OVERVIEW".
  (SEE ALSO): Replace reference to "password-prompt" with
  "password-agent".

Show diffs side-by-side

added added

removed removed

Lines of Context:
clients.conf
4
4
 
5
5
# How long until a client is disabled and not be allowed to get the
6
6
# data this server holds.
7
 
;timeout = 5m
 
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
13
# above "timeout" occurs, at which time the client will be disabled,
13
14
# and any running checker killed.
14
 
;interval = 2m
 
15
# (RFC 3339 duration syntax)
 
16
;interval = PT2M
15
17
 
16
18
# Extended timeout is an added timeout that is given once after a
17
19
# password has been sent sucessfully to a client.  This allows for
18
20
# additional delays caused by file system checks and quota checks.
19
 
;extended_timeout = 15m
 
21
# (RFC 3339 duration syntax)
 
22
;extended_timeout = PT15M
20
23
 
21
24
# What command to run as "the checker".
22
25
;checker = fping -q -- %%(host)s
25
28
;approved_by_default = True
26
29
 
27
30
# How long to wait for approval.
28
 
;approval_delay = 0s
 
31
# (RFC 3339 duration syntax)
 
32
;approval_delay = PT0S
29
33
 
30
34
# How long one approval will last.
31
 
;approval_duration = 1s
 
35
# (RFC 3339 duration syntax)
 
36
;approval_duration = PT1S
 
37
 
 
38
# Whether this client is enabled by default
 
39
;enabled = True
32
40
 
33
41
 
34
42
;####
35
43
;# Example client
36
44
;[foo]
37
45
;
 
46
;# TLS public key ID
 
47
;key_id = f33fcbed11ed5e03073f6a55b86ffe92af0e24c045fb6e3b40547b3dc0c030ed
 
48
;
38
49
;# OpenPGP key fingerprint
39
50
;fingerprint =  7788 2722 5BA7 DE53 9C5A  7CFA 59CF F7CD BD9A 5920
40
51
;
41
52
;# This is base64-encoded binary data.  It will be decoded and sent to
42
 
;# the client matching the above fingerprint.  This should, of course,
43
 
;# be OpenPGP encrypted data, decryptable only by the client.
 
53
;# the client matching the above key_id (for GnuTLS 3.6.6 or later) or
 
54
;# the above fingerprint (for GnuTLS before 3.6.0).  This should, of
 
55
;# course, be OpenPGP encrypted data, decryptable only by the client.
44
56
;secret =
45
57
;        hQIOA6QdEjBs2L/HEAf/TCyrDe5Xnm9esa+Pb/vWF9CUqfn4srzVgSu234
46
58
;        REJMVv7lBSrPE2132Lmd2gqF1HeLKDJRSVxJpt6xoWOChGHg+TMyXDxK+N
65
77
;####
66
78
;# Another example client, named "bar".
67
79
;[bar]
 
80
;# The key ID is not space or case sensitive
 
81
;key_id = F33FCBED11ED5E03073F6A55B86FFE92 AF0E24C045FB6E3B40547B3DC0C030ED
 
82
;
68
83
;# The fingerprint is not space or case sensitive
69
84
;fingerprint = 3e393aeaefb84c7e89e2f547b3a107558fca3a27
70
85
;
71
86
;# If "secret" is not specified, a file can be read for the data.
72
 
;secfile = /etc/mandos/bar-secret.bin
 
87
;secfile = /etc/keys/mandos/bar-secret.bin
73
88
;
74
89
;# An IP address for host is also fine, if the checker accepts it.
75
90
;host = 192.0.2.3
76
91
;
77
92
;# Parameters from the [DEFAULT] section can be overridden per client.
78
 
;interval = 1m
 
93
;interval = PT1M
79
94
;
80
95
;# This client requires manual approval before it receives its secret.
81
96
;approved_by_default = False
82
97
;# Require approval within 30 seconds.
83
 
;approval_delay = 30s
 
98
;approval_delay = PT30S
84
99
;####