/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

* DBUS-API: Document new "Expires" and "ExtendedTimeout" properties.
* README: Refer to the installed manual page more simply.
* mandos (Client.extended_timeout, Client.expires): New attributes.
  (Client.extended_timeout_milliseconds): New.
  (Client.__init__, Client.enable, Client.disable): Set new attributes.
  (Client.checked_ok): Take new "timeout" argument.
  (ClientDBus.expires): Transform into a property which sends a D-Bus
                        signal when changed.
  (ClientDBus._datetime_to_dbus): Return empty D-Bus string on None.
                                  All callers changed to use this.

  (ClientDBus.ApprovedByDefault_dbus_property,
  ClientDBus.ApprovalDelay_dbus_property,
  ClientDBus.ApprovalDuration_dbus_property,
  ClientDBus.Host_dbus_property, ClientDBus.Timeout_dbus_property,
  ClientDBus.Interval_dbus_property,
  ClientDBus.Checker_dbus_property): Bug fix: Only send D-Bus signal
                                     if new value is different.
  (ClientDBus.Timeout_dbus_property): Use new "expires" attribute.
  (ClientDBus.Expires_dbus_property,
  ClientDBus.ExtendedTimeout_dbus_property): New D-Bus properties.
  (ClientHandler.handle): Bump time using extended_timeout value.
  (main.client_defaults): Change default values of "timeout" and
                          "interval", added new default value for
                          "extended_timeout".
* mandos-clients.conf.xml (OPTIONS): Changed default values of
                                     "interval" and "timeout".  Add
                                     new "extended_timeout" option.
  (EXAMPLE): Updated default values.
* mandos-ctl: Show new "ExtendedTimeout" D-Bus property and change it
              using new "--extended-timeout" option.
* mandos-ctl.xml (SYNOPSIS, OPTIONS): Document new
                                      "--extended-timeout" option.
* mandos-monitor (MandosClientWidget.update): Use new "Expires" D-Bus
                                              property.
* mandos.xml (DESCRIPTION): Add reference to intro(8mandos) manual
                            page.
  (CHECKING): Refer to the new "extended_timeout" option in
  clients.conf.

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 = PT5M
 
7
;timeout = 1h
8
8
 
9
9
# How often to run the checker to confirm that a client is still up.
10
10
# Note: a new checker will not be started if an old one is still
11
11
# running.  The server will wait for a checker to complete until the
12
12
# above "timeout" occurs, at which time the client will be disabled,
13
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
 
14
;interval = 5m
20
15
 
21
16
# What command to run as "the checker".
22
17
;checker = fping -q -- %%(host)s
25
20
;approved_by_default = True
26
21
 
27
22
# How long to wait for approval.
28
 
;approval_delay = PT0S
 
23
;approval_delay = 0s
29
24
 
30
25
# How long one approval will last.
31
 
;approval_duration = PT1S
32
 
 
33
 
# Whether this client is enabled by default
34
 
;enabled = True
 
26
;approval_duration = 1s
35
27
 
36
28
 
37
29
;####
38
30
;# Example client
39
31
;[foo]
40
32
;
41
 
;# TLS public key ID
42
 
;key_id = f33fcbed11ed5e03073f6a55b86ffe92af0e24c045fb6e3b40547b3dc0c030ed
43
 
;
44
33
;# OpenPGP key fingerprint
45
34
;fingerprint =  7788 2722 5BA7 DE53 9C5A  7CFA 59CF F7CD BD9A 5920
46
35
;
71
60
;####
72
61
;# Another example client, named "bar".
73
62
;[bar]
74
 
;# The key ID is not space or case sensitive
75
 
;key_id = F33FCBED11ED5E03073F6A55B86FFE92 AF0E24C045FB6E3B40547B3DC0C030ED
76
 
;
77
63
;# The fingerprint is not space or case sensitive
78
64
;fingerprint = 3e393aeaefb84c7e89e2f547b3a107558fca3a27
79
65
;
80
66
;# If "secret" is not specified, a file can be read for the data.
81
 
;secfile = /etc/keys/mandos/bar-secret.bin
 
67
;secfile = /etc/mandos/bar-secret.bin
82
68
;
83
69
;# An IP address for host is also fine, if the checker accepts it.
84
70
;host = 192.0.2.3
85
71
;
86
72
;# Parameters from the [DEFAULT] section can be overridden per client.
87
 
;interval = PT1M
 
73
;interval = 5m
88
74
;
89
75
;# This client requires manual approval before it receives its secret.
90
76
;approved_by_default = False
91
77
;# Require approval within 30 seconds.
92
 
;approval_delay = PT30S
 
78
;approval_delay = 30s
93
79
;####