/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: 2014-06-22 02:19:30 UTC
  • Revision ID: teddy@recompile.se-20140622021930-icl7h4cm97blhjml
mandos-keygen: Generate "checker" option to use SSH fingerprints.

To turn this off, use a new "--no-ssh" option to mandos-keygen.

* INSTALL (Mandos Server, Mandos Client): Document new suggested
                                          installation of SSH.
* Makefile (confdir/clients.conf): Use new "--no-ssh" option to
                                   "mandos-keygen".
* debian/control (mandos/Depends): Changed to "fping | ssh-client".
  (mandos-client/Recommends): New; set to "ssh".
* intro.xml (FREQUENTLY ASKED QUESTIONS): Rename and rewrite section
                                          called "Faking ping
                                          replies?" to address new
                                          default behavior.
* mandos-clients.conf.xml (OPTIONS/checker): Briefly discuss new
                                             behavior of
                                             mandos-keygen.
* mandos-keygen: Bug fix: Suppress failure output of "shred" to remove
                 "sec*", since no such files may exist.
 (password mode): Scan for SSH key fingerprints and output as new
                  "checker" and "ssh_fingerprint" options, unless new
                  "--no-ssh" option is given.
* mandos-keygen.xml (SYNOPSIS/--force): Bug fix: Document short form.
  (OPTIONS/--no-ssh): New.
  (SEE ALSO): Add reference "ssh-keyscan(1)".
* plugins.d/mandos-client.xml (SECURITY): Briefly mention the
                                          possibility of using SSH key
                                          fingerprints for checking.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Default settings for all clients.  These values are the default
 
2
# values, so uncomment and change them if you want different ones.
 
3
[DEFAULT]
 
4
 
 
5
# How long until a client is disabled and not be allowed to get the
 
6
# data this server holds.
 
7
;timeout = PT5M
 
8
 
 
9
# How often to run the checker to confirm that a client is still up.
 
10
# Note: a new checker will not be started if an old one is still
 
11
# running.  The server will wait for a checker to complete until the
 
12
# above "timeout" occurs, at which time the client will be disabled,
 
13
# and any running checker killed.
 
14
;interval = PT2M
 
15
 
 
16
# Extended timeout is an added timeout that is given once after a
 
17
# password has been sent sucessfully to a client.  This allows for
 
18
# additional delays caused by file system checks and quota checks.
 
19
;extended_timeout = PT15M
 
20
 
 
21
# What command to run as "the checker".
 
22
;checker = fping -q -- %%(host)s
 
23
 
 
24
# Whether to approve a client by default after the approval delay.
 
25
;approved_by_default = True
 
26
 
 
27
# How long to wait for approval.
 
28
;approval_delay = PT0S
 
29
 
 
30
# How long one approval will last.
 
31
;approval_duration = PT1S
 
32
 
 
33
# Whether this client is enabled by default
 
34
;enabled = True
 
35
 
 
36
 
 
37
;####
 
38
;# Example client
 
39
;[foo]
 
40
;
 
41
;# OpenPGP key fingerprint
 
42
;fingerprint =  7788 2722 5BA7 DE53 9C5A  7CFA 59CF F7CD BD9A 5920
 
43
;
 
44
;# This is base64-encoded binary data.  It will be decoded and sent to
 
45
;# the client matching the above fingerprint.  This should, of course,
 
46
;# be OpenPGP encrypted data, decryptable only by the client.
 
47
;secret =
 
48
;        hQIOA6QdEjBs2L/HEAf/TCyrDe5Xnm9esa+Pb/vWF9CUqfn4srzVgSu234
 
49
;        REJMVv7lBSrPE2132Lmd2gqF1HeLKDJRSVxJpt6xoWOChGHg+TMyXDxK+N
 
50
;        Xl89vGvdU1XfhKkVm9MDLOgT5ECDPysDGHFPDhqHOSu3Kaw2DWMV/iH9vz
 
51
;        3Z20erVNbdcvyBnuojcoWO/6yfB5EQO0BXp7kcyy00USA3CjD5FGZdoQGI
 
52
;        Tb8A/ar0tVA5crSQmaSotm6KmNLhrFnZ5BxX+TiE+eTUTqSloWRY6VAvqW
 
53
;        QHC7OASxK5E6RXPBuFH5IohUA2Qbk5AHt99pYvsIPX88j2rWauOokoiKZo
 
54
;        t/9leJ8VxO5l3wf/U64IH8bkPIoWmWZfd/nqh4uwGNbCgKMyT+AnvH7kMJ
 
55
;        3i7DivfWl2mKLV0PyPHUNva0VQxX6yYjcOhj1R6fCr/at8/NSLe2OhLchz
 
56
;        dC+Ls9h+kvJXgF8Sisv+Wk/1RadPLFmraRlqvJwt6Ww21LpiXqXHV2mIgq
 
57
;        WnR98YgSvUi3TJHrUQiNc9YyBzuRo0AjgG2C9qiE3FM+Y28+iQ/sR3+bFs
 
58
;        zYuZKVTObqiIslwXu7imO0cvvFRgJF/6u3HNFQ4LUTGhiM3FQmC6NNlF3/
 
59
;        vJM2hwRDMcJqDd54Twx90Wh+tYz0z7QMsK4ANXWHHWHR0JchnLWmenzbtW
 
60
;        5MHdW9AYsNJZAQSOpirE4Xi31CSlWAi9KV+cUCmWF5zOFy1x23P6PjdaRm
 
61
;        4T2zw4dxS5NswXWU0sVEXxjs6PYxuIiCTL7vdpx8QjBkrPWDrAbcMyBr2O
 
62
;        QlnHIvPzEArRQLo=
 
63
;
 
64
;# Host name; used only by the checker, not used by the server itself.
 
65
;host = foo.example.org
 
66
;####
 
67
 
 
68
;####
 
69
;# Another example client, named "bar".
 
70
;[bar]
 
71
;# The fingerprint is not space or case sensitive
 
72
;fingerprint = 3e393aeaefb84c7e89e2f547b3a107558fca3a27
 
73
;
 
74
;# If "secret" is not specified, a file can be read for the data.
 
75
;secfile = /etc/mandos/bar-secret.bin
 
76
;
 
77
;# An IP address for host is also fine, if the checker accepts it.
 
78
;host = 192.0.2.3
 
79
;
 
80
;# Parameters from the [DEFAULT] section can be overridden per client.
 
81
;interval = PT1M
 
82
;
 
83
;# This client requires manual approval before it receives its secret.
 
84
;approved_by_default = False
 
85
;# Require approval within 30 seconds.
 
86
;approval_delay = PT30S
 
87
;####