/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 mandos-monitor

Documentation changes:

* DBUS-API: New file documenting the server D-Bus interface.

* clients.conf: Add examples of new approval settings.

* debian/mandos.docs: Added "DBUS-API".

* mandos-clients.conf.xml (OPTIONS): Added "approved_by_default",
                                     "approval_delay", and
                                     "approval_duration".
* mandos.xml (D-BUS INTERFACE): Refer to the "DBUS-API" file.
  (BUGS): Remove mention of lack of a remote query interface.

Show diffs side-by-side

added added

removed removed

Lines of Context:
40
40
urwid.curses_display.curses.A_UNDERLINE |= (
41
41
    urwid.curses_display.curses.A_BLINK)
42
42
 
 
43
def isoformat_to_datetime(iso):
 
44
    "Parse an ISO 8601 date string to a datetime.datetime()"
 
45
    if not iso:
 
46
        return None
 
47
    d, t = iso.split(u"T", 1)
 
48
    year, month, day = d.split(u"-", 2)
 
49
    hour, minute, second = t.split(u":", 2)
 
50
    second, fraction = divmod(float(second), 1)
 
51
    return datetime.datetime(int(year),
 
52
                             int(month),
 
53
                             int(day),
 
54
                             int(hour),
 
55
                             int(minute),
 
56
                             int(second),           # Whole seconds
 
57
                             int(fraction*1000000)) # Microseconds
 
58
 
43
59
class MandosClientPropertyCache(object):
44
60
    """This wraps a Mandos Client D-Bus proxy object, caches the
45
61
    properties and calls a hook function when any of them are
57
73
        self.properties.update(
58
74
            self.proxy.GetAll(client_interface,
59
75
                              dbus_interface = dbus.PROPERTIES_IFACE))
60
 
        super(MandosClientPropertyCache, self).__init__(
61
 
            proxy_object=proxy_object, *args, **kwargs)
 
76
 
 
77
        #XXX This break good super behaviour!
 
78
#        super(MandosClientPropertyCache, self).__init__(
 
79
#            *args, **kwargs)
62
80
    
63
81
    def property_changed(self, property=None, value=None):
64
82
        """This is called whenever we get a PropertyChanged signal
83
101
        # Logger
84
102
        self.logger = logger
85
103
        
 
104
        self._update_timer_callback_tag = None
 
105
        self.last_checker_failed = False
 
106
        
86
107
        # The widget shown normally
87
108
        self._text_widget = urwid.Text(u"")
88
109
        # The widget shown when we have focus
112
133
                                     self.rejected,
113
134
                                     client_interface,
114
135
                                     byte_arrays=True)
 
136
        last_checked_ok = isoformat_to_datetime(self.properties
 
137
                                                [u"LastCheckedOK"])
 
138
        if last_checked_ok is None:
 
139
            self.last_checker_failed = True
 
140
        else:
 
141
            self.last_checker_failed = ((datetime.datetime.utcnow()
 
142
                                         - last_checked_ok)
 
143
                                        > datetime.timedelta
 
144
                                        (milliseconds=
 
145
                                         self.properties
 
146
                                         [u"Interval"]))
 
147
        if self.last_checker_failed:
 
148
            self._update_timer_callback_tag = (gobject.timeout_add
 
149
                                               (1000,
 
150
                                                self.update_timer))
115
151
    
116
152
    def checker_completed(self, exitstatus, condition, command):
117
153
        if exitstatus == 0:
118
 
            #self.logger(u'Checker for client %s (command "%s")'
119
 
            #            u' was successful'
120
 
            #            % (self.properties[u"name"], command))
 
154
            if self.last_checker_failed:
 
155
                self.last_checker_failed = False
 
156
                gobject.source_remove(self._update_timer_callback_tag)
 
157
                self._update_timer_callback_tag = None
 
158
            self.logger(u'Checker for client %s (command "%s")'
 
159
                        u' was successful'
 
160
                        % (self.properties[u"Name"], command))
 
161
            self.update()
121
162
            return
 
163
        # Checker failed
 
164
        if not self.last_checker_failed:
 
165
            self.last_checker_failed = True
 
166
            self._update_timer_callback_tag = (gobject.timeout_add
 
167
                                               (1000,
 
168
                                                self.update_timer))
122
169
        if os.WIFEXITED(condition):
123
170
            self.logger(u'Checker for client %s (command "%s")'
124
171
                        u' failed with exit code %s'
125
 
                        % (self.properties[u"name"], command,
 
172
                        % (self.properties[u"Name"], command,
126
173
                           os.WEXITSTATUS(condition)))
127
 
            return
128
 
        if os.WIFSIGNALED(condition):
 
174
        elif os.WIFSIGNALED(condition):
129
175
            self.logger(u'Checker for client %s (command "%s")'
130
176
                        u' was killed by signal %s'
131
 
                        % (self.properties[u"name"], command,
 
177
                        % (self.properties[u"Name"], command,
132
178
                           os.WTERMSIG(condition)))
133
 
            return
134
 
        if os.WCOREDUMP(condition):
 
179
        elif os.WCOREDUMP(condition):
135
180
            self.logger(u'Checker for client %s (command "%s")'
136
181
                        u' dumped core'
137
 
                        % (self.properties[u"name"], command))
138
 
        self.logger(u'Checker for client %s completed mysteriously')
 
182
                        % (self.properties[u"Name"], command))
 
183
        else:
 
184
            self.logger(u'Checker for client %s completed'
 
185
                        u' mysteriously')
 
186
        self.update()
139
187
    
140
188
    def checker_started(self, command):
141
189
        #self.logger(u'Client %s started checker "%s"'
142
 
        #            % (self.properties[u"name"], unicode(command)))
 
190
        #            % (self.properties[u"Name"], unicode(command)))
143
191
        pass
144
192
    
145
193
    def got_secret(self):
 
194
        self.last_checker_failed = False
146
195
        self.logger(u'Client %s received its secret'
147
 
                    % self.properties[u"name"])
 
196
                    % self.properties[u"Name"])
148
197
    
149
198
    def need_approval(self, timeout, default):
150
199
        if not default:
152
201
        else:
153
202
            message = u'Client %s will get its secret in %s seconds'
154
203
        self.logger(message
155
 
                    % (self.properties[u"name"], timeout/1000))
 
204
                    % (self.properties[u"Name"], timeout/1000))
156
205
    
157
206
    def rejected(self, reason):
158
207
        self.logger(u'Client %s was rejected; reason: %s'
159
 
                    % (self.properties[u"name"], reason))
 
208
                    % (self.properties[u"Name"], reason))
160
209
    
161
210
    def selectable(self):
162
211
        """Make this a "selectable" widget.
184
233
                          u"bold-underline-blink":
185
234
                              u"bold-underline-blink-standout",
186
235
                          }
187
 
        
 
236
 
188
237
        # Rebuild focus and non-focus widgets using current properties
189
 
        self._text = (u'%(name)s: %(enabled)s'
190
 
                      % { u"name": self.properties[u"name"],
191
 
                          u"enabled":
192
 
                              (u"enabled"
193
 
                               if self.properties[u"enabled"]
194
 
                               else u"DISABLED")})
 
238
 
 
239
        # Base part of a client. Name!
 
240
        base = (u'%(name)s: '
 
241
                      % {u"name": self.properties[u"Name"]})
 
242
        if not self.properties[u"Enabled"]:
 
243
            message = u"DISABLED"
 
244
        elif self.properties[u"ApprovalPending"]:
 
245
            if self.properties[u"ApprovedByDefault"]:
 
246
                message = u"Connection established to client. (d)eny?"
 
247
            else:
 
248
                message = u"Seeks approval to send secret. (a)pprove?"
 
249
        elif self.last_checker_failed:
 
250
            timeout = datetime.timedelta(milliseconds
 
251
                                         = self.properties
 
252
                                         [u"Timeout"])
 
253
            last_ok = isoformat_to_datetime(
 
254
                max((self.properties[u"LastCheckedOK"]
 
255
                     or self.properties[u"Created"]),
 
256
                    self.properties[u"LastEnabled"]))
 
257
            timer = timeout - (datetime.datetime.utcnow() - last_ok)
 
258
            message = (u'A checker has failed! Time until client'
 
259
                       u' gets diabled: %s'
 
260
                           % unicode(timer).rsplit(".", 1)[0])
 
261
        else:
 
262
            message = u"enabled"
 
263
        self._text = "%s%s" % (base, message)
 
264
            
195
265
        if not urwid.supports_unicode():
196
266
            self._text = self._text.encode("ascii", "replace")
197
267
        textlist = [(u"normal", self._text)]
208
278
        if self.update_hook is not None:
209
279
            self.update_hook()
210
280
    
 
281
    def update_timer(self):
 
282
        "called by gobject"
 
283
        self.update()
 
284
        return True             # Keep calling this
 
285
    
211
286
    def delete(self):
 
287
        if self._update_timer_callback_tag is not None:
 
288
            gobject.source_remove(self._update_timer_callback_tag)
 
289
            self._update_timer_callback_tag = None
212
290
        if self.delete_hook is not None:
213
291
            self.delete_hook(self)
214
292
    
221
299
    def keypress(self, (maxcol,), key):
222
300
        """Handle keys.
223
301
        This overrides the method from urwid.FlowWidget"""
224
 
        if key == u"e" or key == u"+":
225
 
            self.proxy.Enable()
226
 
        elif key == u"d" or key == u"-":
227
 
            self.proxy.Disable()
 
302
        if key == u"+":
 
303
            self.proxy.Enable(dbus_interface = client_interface)
 
304
        elif key == u"-":
 
305
            self.proxy.Disable(dbus_interface = client_interface)
 
306
        elif key == u"a":
 
307
            self.proxy.Approve(dbus.Boolean(True, variant_level=1),
 
308
                               dbus_interface = client_interface)
 
309
        elif key == u"d":
 
310
            self.proxy.Approve(dbus.Boolean(False, variant_level=1),
 
311
                                  dbus_interface = client_interface)
228
312
        elif key == u"r" or key == u"_" or key == u"ctrl k":
229
313
            self.server_proxy_object.RemoveClient(self.proxy
230
314
                                                  .object_path)
231
315
        elif key == u"s":
232
 
            self.proxy.StartChecker()
 
316
            self.proxy.StartChecker(dbus_interface = client_interface)
233
317
        elif key == u"S":
234
 
            self.proxy.StopChecker()
 
318
            self.proxy.StopChecker(dbus_interface = client_interface)
235
319
        elif key == u"C":
236
 
            self.proxy.CheckedOK()
 
320
            self.proxy.CheckedOK(dbus_interface = client_interface)
237
321
        # xxx
238
322
#         elif key == u"p" or key == "=":
239
323
#             self.proxy.pause()
241
325
#             self.proxy.unpause()
242
326
#         elif key == u"RET":
243
327
#             self.open()
244
 
        elif key == u"+":
245
 
            self.proxy.Approve(True)
246
 
        elif key == u"-":
247
 
            self.proxy.Approve(False)
 
328
#        elif key == u"+":
 
329
#            self.proxy.Approve(True)
 
330
#        elif key == u"-":
 
331
#            self.proxy.Approve(False)
248
332
        else:
249
333
            return key
250
334
    
266
350
    use them as an excuse to shift focus away from this widget.
267
351
    """
268
352
    def keypress(self, (maxcol, maxrow), key):
269
 
        ret = super(ConstrainedListBox, self).keypress((maxcol, maxrow), key)
 
353
        ret = super(ConstrainedListBox, self).keypress((maxcol,
 
354
                                                        maxrow), key)
270
355
        if ret in (u"up", u"down"):
271
356
            return
272
357
        return ret
389
474
        Call this when the widget layout needs to change"""
390
475
        self.uilist = []
391
476
        #self.uilist.append(urwid.ListBox(self.clients))
392
 
        self.uilist.append(urwid.Frame(ConstrainedListBox(self.clients),
 
477
        self.uilist.append(urwid.Frame(ConstrainedListBox(self.
 
478
                                                          clients),
393
479
                                       #header=urwid.Divider(),
394
480
                                       header=None,
395
 
                                       footer=urwid.Divider(div_char=self.divider)))
 
481
                                       footer=
 
482
                                       urwid.Divider(div_char=
 
483
                                                     self.divider)))
396
484
        if self.log_visible:
397
485
            self.uilist.append(self.logbox)
398
486
            pass
461
549
        if path is None:
462
550
            path = client.proxy.object_path
463
551
        self.clients_dict[path] = client
464
 
        self.clients.sort(None, lambda c: c.properties[u"name"])
 
552
        self.clients.sort(None, lambda c: c.properties[u"Name"])
465
553
        self.refresh()
466
554
    
467
555
    def remove_client(self, client, path=None):
542
630
                self.log_message_raw((u"bold",
543
631
                                      u"  "
544
632
                                      .join((u"Clients:",
545
 
                                             u"e: Enable",
546
 
                                             u"d: Disable",
 
633
                                             u"+: Enable",
 
634
                                             u"-: Disable",
547
635
                                             u"r: Remove",
548
636
                                             u"s: Start new checker",
549
637
                                             u"S: Stop checker",
550
 
                                             u"C: Checker OK"))))
 
638
                                             u"C: Checker OK",
 
639
                                             u"a: Approve",
 
640
                                             u"d: Deny"))))
551
641
                self.refresh()
552
642
            elif key == u"tab":
553
643
                if self.topwidget.get_focus() is self.logbox:
581
671
ui = UserInterface()
582
672
try:
583
673
    ui.run()
 
674
except KeyboardInterrupt:
 
675
    ui.screen.stop()
584
676
except Exception, e:
585
677
    ui.log_message(unicode(e))
586
678
    ui.screen.stop()