/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

* mandos: Use all new builtins.
* mandos-ctl: - '' -
* mandos-monitor: - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
# This program is partly derived from an example program for an Avahi
7
7
# service publisher, downloaded from
8
8
# <http://avahi.org/wiki/PythonPublishExample>.  This includes the
9
 
# methods "add" and "remove" in the "AvahiService" class, the
10
 
# "server_state_changed" and "entry_group_state_changed" functions,
11
 
# and some lines in "main".
 
9
# methods "add", "remove", "server_state_changed",
 
10
# "entry_group_state_changed", "cleanup", and "activate" in the
 
11
# "AvahiService" class, and some lines in "main".
12
12
13
13
# Everything else is
14
 
# Copyright © 2007-2008 Teddy Hogeborn & Björn Påhlsson
 
14
# Copyright © 2008-2012 Teddy Hogeborn
 
15
# Copyright © 2008-2012 Björn Påhlsson
15
16
16
17
# This program is free software: you can redistribute it and/or modify
17
18
# it under the terms of the GNU General Public License as published by
27
28
# along with this program.  If not, see
28
29
# <http://www.gnu.org/licenses/>.
29
30
30
 
# Contact the authors at <mandos@fukt.bsnet.se>.
 
31
# Contact the authors at <mandos@recompile.se>.
31
32
32
33
 
33
 
from __future__ import division
34
 
 
35
 
import SocketServer
 
34
from __future__ import (division, absolute_import, print_function,
 
35
                        unicode_literals)
 
36
 
 
37
from future_builtins import *
 
38
 
 
39
import SocketServer as socketserver
36
40
import socket
37
 
import select
38
 
from optparse import OptionParser
 
41
import argparse
39
42
import datetime
40
43
import errno
41
44
import gnutls.crypto
44
47
import gnutls.library.functions
45
48
import gnutls.library.constants
46
49
import gnutls.library.types
47
 
import ConfigParser
 
50
import ConfigParser as configparser
48
51
import sys
49
52
import re
50
53
import os
51
54
import signal
52
 
from sets import Set
53
55
import subprocess
54
56
import atexit
55
57
import stat
56
58
import logging
57
59
import logging.handlers
 
60
import pwd
 
61
import contextlib
 
62
import struct
 
63
import fcntl
 
64
import functools
 
65
import cPickle as pickle
 
66
import multiprocessing
 
67
import types
 
68
import binascii
 
69
import tempfile
 
70
import itertools
58
71
 
59
72
import dbus
 
73
import dbus.service
60
74
import gobject
61
75
import avahi
62
76
from dbus.mainloop.glib import DBusGMainLoop
63
77
import ctypes
64
 
 
65
 
version = "1.0"
66
 
 
67
 
logger = logging.Logger('mandos')
68
 
syslogger = logging.handlers.SysLogHandler\
69
 
            (facility = logging.handlers.SysLogHandler.LOG_DAEMON,
70
 
             address = "/dev/log")
71
 
syslogger.setFormatter(logging.Formatter\
72
 
                        ('Mandos: %(levelname)s: %(message)s'))
73
 
logger.addHandler(syslogger)
74
 
 
75
 
console = logging.StreamHandler()
76
 
console.setFormatter(logging.Formatter('%(name)s: %(levelname)s:'
77
 
                                       ' %(message)s'))
78
 
logger.addHandler(console)
 
78
import ctypes.util
 
79
import xml.dom.minidom
 
80
import inspect
 
81
import GnuPGInterface
 
82
 
 
83
try:
 
84
    SO_BINDTODEVICE = socket.SO_BINDTODEVICE
 
85
except AttributeError:
 
86
    try:
 
87
        from IN import SO_BINDTODEVICE
 
88
    except ImportError:
 
89
        SO_BINDTODEVICE = None
 
90
 
 
91
version = "1.5.3"
 
92
stored_state_file = "clients.pickle"
 
93
 
 
94
logger = logging.getLogger()
 
95
syslogger = (logging.handlers.SysLogHandler
 
96
             (facility = logging.handlers.SysLogHandler.LOG_DAEMON,
 
97
              address = str("/dev/log")))
 
98
 
 
99
try:
 
100
    if_nametoindex = (ctypes.cdll.LoadLibrary
 
101
                      (ctypes.util.find_library("c"))
 
102
                      .if_nametoindex)
 
103
except (OSError, AttributeError):
 
104
    def if_nametoindex(interface):
 
105
        "Get an interface index the hard way, i.e. using fcntl()"
 
106
        SIOCGIFINDEX = 0x8933  # From /usr/include/linux/sockios.h
 
107
        with contextlib.closing(socket.socket()) as s:
 
108
            ifreq = fcntl.ioctl(s, SIOCGIFINDEX,
 
109
                                struct.pack(str("16s16x"),
 
110
                                            interface))
 
111
        interface_index = struct.unpack(str("I"),
 
112
                                        ifreq[16:20])[0]
 
113
        return interface_index
 
114
 
 
115
 
 
116
def initlogger(debug, level=logging.WARNING):
 
117
    """init logger and add loglevel"""
 
118
    
 
119
    syslogger.setFormatter(logging.Formatter
 
120
                           ('Mandos [%(process)d]: %(levelname)s:'
 
121
                            ' %(message)s'))
 
122
    logger.addHandler(syslogger)
 
123
    
 
124
    if debug:
 
125
        console = logging.StreamHandler()
 
126
        console.setFormatter(logging.Formatter('%(asctime)s %(name)s'
 
127
                                               ' [%(process)d]:'
 
128
                                               ' %(levelname)s:'
 
129
                                               ' %(message)s'))
 
130
        logger.addHandler(console)
 
131
    logger.setLevel(level)
 
132
 
 
133
 
 
134
class PGPError(Exception):
 
135
    """Exception if encryption/decryption fails"""
 
136
    pass
 
137
 
 
138
 
 
139
class PGPEngine(object):
 
140
    """A simple class for OpenPGP symmetric encryption & decryption"""
 
141
    def __init__(self):
 
142
        self.gnupg = GnuPGInterface.GnuPG()
 
143
        self.tempdir = tempfile.mkdtemp(prefix="mandos-")
 
144
        self.gnupg = GnuPGInterface.GnuPG()
 
145
        self.gnupg.options.meta_interactive = False
 
146
        self.gnupg.options.homedir = self.tempdir
 
147
        self.gnupg.options.extra_args.extend(['--force-mdc',
 
148
                                              '--quiet',
 
149
                                              '--no-use-agent'])
 
150
    
 
151
    def __enter__(self):
 
152
        return self
 
153
    
 
154
    def __exit__ (self, exc_type, exc_value, traceback):
 
155
        self._cleanup()
 
156
        return False
 
157
    
 
158
    def __del__(self):
 
159
        self._cleanup()
 
160
    
 
161
    def _cleanup(self):
 
162
        if self.tempdir is not None:
 
163
            # Delete contents of tempdir
 
164
            for root, dirs, files in os.walk(self.tempdir,
 
165
                                             topdown = False):
 
166
                for filename in files:
 
167
                    os.remove(os.path.join(root, filename))
 
168
                for dirname in dirs:
 
169
                    os.rmdir(os.path.join(root, dirname))
 
170
            # Remove tempdir
 
171
            os.rmdir(self.tempdir)
 
172
            self.tempdir = None
 
173
    
 
174
    def password_encode(self, password):
 
175
        # Passphrase can not be empty and can not contain newlines or
 
176
        # NUL bytes.  So we prefix it and hex encode it.
 
177
        return b"mandos" + binascii.hexlify(password)
 
178
    
 
179
    def encrypt(self, data, password):
 
180
        self.gnupg.passphrase = self.password_encode(password)
 
181
        with open(os.devnull, "w") as devnull:
 
182
            try:
 
183
                proc = self.gnupg.run(['--symmetric'],
 
184
                                      create_fhs=['stdin', 'stdout'],
 
185
                                      attach_fhs={'stderr': devnull})
 
186
                with contextlib.closing(proc.handles['stdin']) as f:
 
187
                    f.write(data)
 
188
                with contextlib.closing(proc.handles['stdout']) as f:
 
189
                    ciphertext = f.read()
 
190
                proc.wait()
 
191
            except IOError as e:
 
192
                raise PGPError(e)
 
193
        self.gnupg.passphrase = None
 
194
        return ciphertext
 
195
    
 
196
    def decrypt(self, data, password):
 
197
        self.gnupg.passphrase = self.password_encode(password)
 
198
        with open(os.devnull, "w") as devnull:
 
199
            try:
 
200
                proc = self.gnupg.run(['--decrypt'],
 
201
                                      create_fhs=['stdin', 'stdout'],
 
202
                                      attach_fhs={'stderr': devnull})
 
203
                with contextlib.closing(proc.handles['stdin']) as f:
 
204
                    f.write(data)
 
205
                with contextlib.closing(proc.handles['stdout']) as f:
 
206
                    decrypted_plaintext = f.read()
 
207
                proc.wait()
 
208
            except IOError as e:
 
209
                raise PGPError(e)
 
210
        self.gnupg.passphrase = None
 
211
        return decrypted_plaintext
 
212
 
79
213
 
80
214
class AvahiError(Exception):
81
 
    def __init__(self, value):
 
215
    def __init__(self, value, *args, **kwargs):
82
216
        self.value = value
83
 
    def __str__(self):
84
 
        return repr(self.value)
 
217
        super(AvahiError, self).__init__(value, *args, **kwargs)
 
218
    def __unicode__(self):
 
219
        return unicode(repr(self.value))
85
220
 
86
221
class AvahiServiceError(AvahiError):
87
222
    pass
92
227
 
93
228
class AvahiService(object):
94
229
    """An Avahi (Zeroconf) service.
 
230
    
95
231
    Attributes:
96
232
    interface: integer; avahi.IF_UNSPEC or an interface index.
97
233
               Used to optionally bind to the specified interface.
105
241
    max_renames: integer; maximum number of renames
106
242
    rename_count: integer; counter so we only rename after collisions
107
243
                  a sensible number of times
 
244
    group: D-Bus Entry Group
 
245
    server: D-Bus Server
 
246
    bus: dbus.SystemBus()
108
247
    """
 
248
    
109
249
    def __init__(self, interface = avahi.IF_UNSPEC, name = None,
110
 
                 type = None, port = None, TXT = None, domain = "",
111
 
                 host = "", max_renames = 32768):
 
250
                 servicetype = None, port = None, TXT = None,
 
251
                 domain = "", host = "", max_renames = 32768,
 
252
                 protocol = avahi.PROTO_UNSPEC, bus = None):
112
253
        self.interface = interface
113
254
        self.name = name
114
 
        self.type = type
 
255
        self.type = servicetype
115
256
        self.port = port
116
 
        if TXT is None:
117
 
            self.TXT = []
118
 
        else:
119
 
            self.TXT = TXT
 
257
        self.TXT = TXT if TXT is not None else []
120
258
        self.domain = domain
121
259
        self.host = host
122
260
        self.rename_count = 0
123
261
        self.max_renames = max_renames
 
262
        self.protocol = protocol
 
263
        self.group = None       # our entry group
 
264
        self.server = None
 
265
        self.bus = bus
 
266
        self.entry_group_state_changed_match = None
 
267
    
124
268
    def rename(self):
125
269
        """Derived from the Avahi example code"""
126
270
        if self.rename_count >= self.max_renames:
127
 
            logger.critical(u"No suitable Zeroconf service name found"
128
 
                            u" after %i retries, exiting.",
129
 
                            rename_count)
 
271
            logger.critical("No suitable Zeroconf service name found"
 
272
                            " after %i retries, exiting.",
 
273
                            self.rename_count)
130
274
            raise AvahiServiceError("Too many renames")
131
 
        self.name = server.GetAlternativeServiceName(self.name)
132
 
        logger.info(u"Changing Zeroconf service name to %r ...",
133
 
                    str(self.name))
134
 
        syslogger.setFormatter(logging.Formatter\
135
 
                               ('Mandos (%s): %%(levelname)s:'
136
 
                               ' %%(message)s' % self.name))
 
275
        self.name = unicode(self.server
 
276
                            .GetAlternativeServiceName(self.name))
 
277
        logger.info("Changing Zeroconf service name to %r ...",
 
278
                    self.name)
137
279
        self.remove()
138
 
        self.add()
 
280
        try:
 
281
            self.add()
 
282
        except dbus.exceptions.DBusException as error:
 
283
            logger.critical("D-Bus Exception", exc_info=error)
 
284
            self.cleanup()
 
285
            os._exit(1)
139
286
        self.rename_count += 1
 
287
    
140
288
    def remove(self):
141
289
        """Derived from the Avahi example code"""
142
 
        if group is not None:
143
 
            group.Reset()
 
290
        if self.entry_group_state_changed_match is not None:
 
291
            self.entry_group_state_changed_match.remove()
 
292
            self.entry_group_state_changed_match = None
 
293
        if self.group is not None:
 
294
            self.group.Reset()
 
295
    
144
296
    def add(self):
145
297
        """Derived from the Avahi example code"""
146
 
        global group
147
 
        if group is None:
148
 
            group = dbus.Interface\
149
 
                    (bus.get_object(avahi.DBUS_NAME,
150
 
                                    server.EntryGroupNew()),
151
 
                     avahi.DBUS_INTERFACE_ENTRY_GROUP)
152
 
            group.connect_to_signal('StateChanged',
153
 
                                    entry_group_state_changed)
154
 
        logger.debug(u"Adding Zeroconf service '%s' of type '%s' ...",
155
 
                     service.name, service.type)
156
 
        group.AddService(
157
 
                self.interface,         # interface
158
 
                avahi.PROTO_INET6,      # protocol
159
 
                dbus.UInt32(0),         # flags
160
 
                self.name, self.type,
161
 
                self.domain, self.host,
162
 
                dbus.UInt16(self.port),
163
 
                avahi.string_array_to_txt_array(self.TXT))
164
 
        group.Commit()
165
 
 
166
 
# From the Avahi example code:
167
 
group = None                            # our entry group
168
 
# End of Avahi example code
169
 
 
 
298
        self.remove()
 
299
        if self.group is None:
 
300
            self.group = dbus.Interface(
 
301
                self.bus.get_object(avahi.DBUS_NAME,
 
302
                                    self.server.EntryGroupNew()),
 
303
                avahi.DBUS_INTERFACE_ENTRY_GROUP)
 
304
        self.entry_group_state_changed_match = (
 
305
            self.group.connect_to_signal(
 
306
                'StateChanged', self.entry_group_state_changed))
 
307
        logger.debug("Adding Zeroconf service '%s' of type '%s' ...",
 
308
                     self.name, self.type)
 
309
        self.group.AddService(
 
310
            self.interface,
 
311
            self.protocol,
 
312
            dbus.UInt32(0),     # flags
 
313
            self.name, self.type,
 
314
            self.domain, self.host,
 
315
            dbus.UInt16(self.port),
 
316
            avahi.string_array_to_txt_array(self.TXT))
 
317
        self.group.Commit()
 
318
    
 
319
    def entry_group_state_changed(self, state, error):
 
320
        """Derived from the Avahi example code"""
 
321
        logger.debug("Avahi entry group state change: %i", state)
 
322
        
 
323
        if state == avahi.ENTRY_GROUP_ESTABLISHED:
 
324
            logger.debug("Zeroconf service established.")
 
325
        elif state == avahi.ENTRY_GROUP_COLLISION:
 
326
            logger.info("Zeroconf service name collision.")
 
327
            self.rename()
 
328
        elif state == avahi.ENTRY_GROUP_FAILURE:
 
329
            logger.critical("Avahi: Error in group state changed %s",
 
330
                            unicode(error))
 
331
            raise AvahiGroupError("State changed: {0!s}"
 
332
                                  .format(error))
 
333
    
 
334
    def cleanup(self):
 
335
        """Derived from the Avahi example code"""
 
336
        if self.group is not None:
 
337
            try:
 
338
                self.group.Free()
 
339
            except (dbus.exceptions.UnknownMethodException,
 
340
                    dbus.exceptions.DBusException):
 
341
                pass
 
342
            self.group = None
 
343
        self.remove()
 
344
    
 
345
    def server_state_changed(self, state, error=None):
 
346
        """Derived from the Avahi example code"""
 
347
        logger.debug("Avahi server state change: %i", state)
 
348
        bad_states = { avahi.SERVER_INVALID:
 
349
                           "Zeroconf server invalid",
 
350
                       avahi.SERVER_REGISTERING: None,
 
351
                       avahi.SERVER_COLLISION:
 
352
                           "Zeroconf server name collision",
 
353
                       avahi.SERVER_FAILURE:
 
354
                           "Zeroconf server failure" }
 
355
        if state in bad_states:
 
356
            if bad_states[state] is not None:
 
357
                if error is None:
 
358
                    logger.error(bad_states[state])
 
359
                else:
 
360
                    logger.error(bad_states[state] + ": %r", error)
 
361
            self.cleanup()
 
362
        elif state == avahi.SERVER_RUNNING:
 
363
            self.add()
 
364
        else:
 
365
            if error is None:
 
366
                logger.debug("Unknown state: %r", state)
 
367
            else:
 
368
                logger.debug("Unknown state: %r: %r", state, error)
 
369
    
 
370
    def activate(self):
 
371
        """Derived from the Avahi example code"""
 
372
        if self.server is None:
 
373
            self.server = dbus.Interface(
 
374
                self.bus.get_object(avahi.DBUS_NAME,
 
375
                                    avahi.DBUS_PATH_SERVER,
 
376
                                    follow_name_owner_changes=True),
 
377
                avahi.DBUS_INTERFACE_SERVER)
 
378
        self.server.connect_to_signal("StateChanged",
 
379
                                 self.server_state_changed)
 
380
        self.server_state_changed(self.server.GetState())
 
381
 
 
382
class AvahiServiceToSyslog(AvahiService):
 
383
    def rename(self):
 
384
        """Add the new name to the syslog messages"""
 
385
        ret = AvahiService.rename(self)
 
386
        syslogger.setFormatter(logging.Formatter
 
387
                               ('Mandos ({0}) [%(process)d]:'
 
388
                                ' %(levelname)s: %(message)s'
 
389
                                .format(self.name)))
 
390
        return ret
 
391
 
 
392
def timedelta_to_milliseconds(td):
 
393
    "Convert a datetime.timedelta() to milliseconds"
 
394
    return ((td.days * 24 * 60 * 60 * 1000)
 
395
            + (td.seconds * 1000)
 
396
            + (td.microseconds // 1000))
170
397
 
171
398
class Client(object):
172
399
    """A representation of a client host served by this server.
 
400
    
173
401
    Attributes:
174
 
    name:      string; from the config file, used in log messages
 
402
    approved:   bool(); 'None' if not yet approved/disapproved
 
403
    approval_delay: datetime.timedelta(); Time to wait for approval
 
404
    approval_duration: datetime.timedelta(); Duration of one approval
 
405
    checker:    subprocess.Popen(); a running checker process used
 
406
                                    to see if the client lives.
 
407
                                    'None' if no process is running.
 
408
    checker_callback_tag: a gobject event source tag, or None
 
409
    checker_command: string; External command which is run to check
 
410
                     if client lives.  %() expansions are done at
 
411
                     runtime with vars(self) as dict, so that for
 
412
                     instance %(name)s can be used in the command.
 
413
    checker_initiator_tag: a gobject event source tag, or None
 
414
    created:    datetime.datetime(); (UTC) object creation
 
415
    client_structure: Object describing what attributes a client has
 
416
                      and is used for storing the client at exit
 
417
    current_checker_command: string; current running checker_command
 
418
    disable_initiator_tag: a gobject event source tag, or None
 
419
    enabled:    bool()
175
420
    fingerprint: string (40 or 32 hexadecimal digits); used to
176
421
                 uniquely identify the client
177
 
    secret:    bytestring; sent verbatim (over TLS) to client
178
 
    host:      string; available for use by the checker command
179
 
    created:   datetime.datetime(); object creation, not client host
180
 
    last_checked_ok: datetime.datetime() or None if not yet checked OK
181
 
    timeout:   datetime.timedelta(); How long from last_checked_ok
182
 
                                     until this client is invalid
183
 
    interval:  datetime.timedelta(); How often to start a new checker
184
 
    stop_hook: If set, called by stop() as stop_hook(self)
185
 
    checker:   subprocess.Popen(); a running checker process used
186
 
                                   to see if the client lives.
187
 
                                   'None' if no process is running.
188
 
    checker_initiator_tag: a gobject event source tag, or None
189
 
    stop_initiator_tag:    - '' -
190
 
    checker_callback_tag:  - '' -
191
 
    checker_command: string; External command which is run to check if
192
 
                     client lives.  %() expansions are done at
193
 
                     runtime with vars(self) as dict, so that for
194
 
                     instance %(name)s can be used in the command.
195
 
    Private attibutes:
196
 
    _timeout: Real variable for 'timeout'
197
 
    _interval: Real variable for 'interval'
198
 
    _timeout_milliseconds: Used when calling gobject.timeout_add()
199
 
    _interval_milliseconds: - '' -
 
422
    host:       string; available for use by the checker command
 
423
    interval:   datetime.timedelta(); How often to start a new checker
 
424
    last_approval_request: datetime.datetime(); (UTC) or None
 
425
    last_checked_ok: datetime.datetime(); (UTC) or None
 
426
    last_checker_status: integer between 0 and 255 reflecting exit
 
427
                         status of last checker. -1 reflects crashed
 
428
                         checker, -2 means no checker completed yet.
 
429
    last_enabled: datetime.datetime(); (UTC) or None
 
430
    name:       string; from the config file, used in log messages and
 
431
                        D-Bus identifiers
 
432
    secret:     bytestring; sent verbatim (over TLS) to client
 
433
    timeout:    datetime.timedelta(); How long from last_checked_ok
 
434
                                      until this client is disabled
 
435
    extended_timeout:   extra long timeout when secret has been sent
 
436
    runtime_expansions: Allowed attributes for runtime expansion.
 
437
    expires:    datetime.datetime(); time (UTC) when a client will be
 
438
                disabled, or None
200
439
    """
201
 
    def _set_timeout(self, timeout):
202
 
        "Setter function for 'timeout' attribute"
203
 
        self._timeout = timeout
204
 
        self._timeout_milliseconds = ((self.timeout.days
205
 
                                       * 24 * 60 * 60 * 1000)
206
 
                                      + (self.timeout.seconds * 1000)
207
 
                                      + (self.timeout.microseconds
208
 
                                         // 1000))
209
 
    timeout = property(lambda self: self._timeout,
210
 
                       _set_timeout)
211
 
    del _set_timeout
212
 
    def _set_interval(self, interval):
213
 
        "Setter function for 'interval' attribute"
214
 
        self._interval = interval
215
 
        self._interval_milliseconds = ((self.interval.days
216
 
                                        * 24 * 60 * 60 * 1000)
217
 
                                       + (self.interval.seconds
218
 
                                          * 1000)
219
 
                                       + (self.interval.microseconds
220
 
                                          // 1000))
221
 
    interval = property(lambda self: self._interval,
222
 
                        _set_interval)
223
 
    del _set_interval
224
 
    def __init__(self, name = None, stop_hook=None, config={}):
225
 
        """Note: the 'checker' key in 'config' sets the
226
 
        'checker_command' attribute and *not* the 'checker'
227
 
        attribute."""
 
440
    
 
441
    runtime_expansions = ("approval_delay", "approval_duration",
 
442
                          "created", "enabled", "fingerprint",
 
443
                          "host", "interval", "last_checked_ok",
 
444
                          "last_enabled", "name", "timeout")
 
445
    client_defaults = { "timeout": "5m",
 
446
                        "extended_timeout": "15m",
 
447
                        "interval": "2m",
 
448
                        "checker": "fping -q -- %%(host)s",
 
449
                        "host": "",
 
450
                        "approval_delay": "0s",
 
451
                        "approval_duration": "1s",
 
452
                        "approved_by_default": "True",
 
453
                        "enabled": "True",
 
454
                        }
 
455
    
 
456
    def timeout_milliseconds(self):
 
457
        "Return the 'timeout' attribute in milliseconds"
 
458
        return timedelta_to_milliseconds(self.timeout)
 
459
    
 
460
    def extended_timeout_milliseconds(self):
 
461
        "Return the 'extended_timeout' attribute in milliseconds"
 
462
        return timedelta_to_milliseconds(self.extended_timeout)
 
463
    
 
464
    def interval_milliseconds(self):
 
465
        "Return the 'interval' attribute in milliseconds"
 
466
        return timedelta_to_milliseconds(self.interval)
 
467
    
 
468
    def approval_delay_milliseconds(self):
 
469
        return timedelta_to_milliseconds(self.approval_delay)
 
470
    
 
471
    @staticmethod
 
472
    def config_parser(config):
 
473
        """Construct a new dict of client settings of this form:
 
474
        { client_name: {setting_name: value, ...}, ...}
 
475
        with exceptions for any special settings as defined above.
 
476
        NOTE: Must be a pure function. Must return the same result
 
477
        value given the same arguments.
 
478
        """
 
479
        settings = {}
 
480
        for client_name in config.sections():
 
481
            section = dict(config.items(client_name))
 
482
            client = settings[client_name] = {}
 
483
            
 
484
            client["host"] = section["host"]
 
485
            # Reformat values from string types to Python types
 
486
            client["approved_by_default"] = config.getboolean(
 
487
                client_name, "approved_by_default")
 
488
            client["enabled"] = config.getboolean(client_name,
 
489
                                                  "enabled")
 
490
            
 
491
            client["fingerprint"] = (section["fingerprint"].upper()
 
492
                                     .replace(" ", ""))
 
493
            if "secret" in section:
 
494
                client["secret"] = section["secret"].decode("base64")
 
495
            elif "secfile" in section:
 
496
                with open(os.path.expanduser(os.path.expandvars
 
497
                                             (section["secfile"])),
 
498
                          "rb") as secfile:
 
499
                    client["secret"] = secfile.read()
 
500
            else:
 
501
                raise TypeError("No secret or secfile for section {0}"
 
502
                                .format(section))
 
503
            client["timeout"] = string_to_delta(section["timeout"])
 
504
            client["extended_timeout"] = string_to_delta(
 
505
                section["extended_timeout"])
 
506
            client["interval"] = string_to_delta(section["interval"])
 
507
            client["approval_delay"] = string_to_delta(
 
508
                section["approval_delay"])
 
509
            client["approval_duration"] = string_to_delta(
 
510
                section["approval_duration"])
 
511
            client["checker_command"] = section["checker"]
 
512
            client["last_approval_request"] = None
 
513
            client["last_checked_ok"] = None
 
514
            client["last_checker_status"] = -2
 
515
        
 
516
        return settings
 
517
    
 
518
    def __init__(self, settings, name = None):
228
519
        self.name = name
229
 
        logger.debug(u"Creating client %r", self.name)
 
520
        # adding all client settings
 
521
        for setting, value in settings.iteritems():
 
522
            setattr(self, setting, value)
 
523
        
 
524
        if self.enabled:
 
525
            if not hasattr(self, "last_enabled"):
 
526
                self.last_enabled = datetime.datetime.utcnow()
 
527
            if not hasattr(self, "expires"):
 
528
                self.expires = (datetime.datetime.utcnow()
 
529
                                + self.timeout)
 
530
        else:
 
531
            self.last_enabled = None
 
532
            self.expires = None
 
533
        
 
534
        logger.debug("Creating client %r", self.name)
230
535
        # Uppercase and remove spaces from fingerprint for later
231
536
        # comparison purposes with return value from the fingerprint()
232
537
        # function
233
 
        self.fingerprint = config["fingerprint"].upper()\
234
 
                           .replace(u" ", u"")
235
 
        logger.debug(u"  Fingerprint: %s", self.fingerprint)
236
 
        if "secret" in config:
237
 
            self.secret = config["secret"].decode(u"base64")
238
 
        elif "secfile" in config:
239
 
            sf = open(config["secfile"])
240
 
            self.secret = sf.read()
241
 
            sf.close()
242
 
        else:
243
 
            raise TypeError(u"No secret or secfile for client %s"
244
 
                            % self.name)
245
 
        self.host = config.get("host", "")
246
 
        self.created = datetime.datetime.now()
247
 
        self.last_checked_ok = None
248
 
        self.timeout = string_to_delta(config["timeout"])
249
 
        self.interval = string_to_delta(config["interval"])
250
 
        self.stop_hook = stop_hook
 
538
        logger.debug("  Fingerprint: %s", self.fingerprint)
 
539
        self.created = settings.get("created",
 
540
                                    datetime.datetime.utcnow())
 
541
        
 
542
        # attributes specific for this server instance
251
543
        self.checker = None
252
544
        self.checker_initiator_tag = None
253
 
        self.stop_initiator_tag = None
 
545
        self.disable_initiator_tag = None
254
546
        self.checker_callback_tag = None
255
 
        self.check_command = config["checker"]
256
 
    def start(self):
 
547
        self.current_checker_command = None
 
548
        self.approved = None
 
549
        self.approvals_pending = 0
 
550
        self.changedstate = (multiprocessing_manager
 
551
                             .Condition(multiprocessing_manager
 
552
                                        .Lock()))
 
553
        self.client_structure = [attr for attr in
 
554
                                 self.__dict__.iterkeys()
 
555
                                 if not attr.startswith("_")]
 
556
        self.client_structure.append("client_structure")
 
557
        
 
558
        for name, t in inspect.getmembers(type(self),
 
559
                                          lambda obj:
 
560
                                              isinstance(obj,
 
561
                                                         property)):
 
562
            if not name.startswith("_"):
 
563
                self.client_structure.append(name)
 
564
    
 
565
    # Send notice to process children that client state has changed
 
566
    def send_changedstate(self):
 
567
        with self.changedstate:
 
568
            self.changedstate.notify_all()
 
569
    
 
570
    def enable(self):
257
571
        """Start this client's checker and timeout hooks"""
 
572
        if getattr(self, "enabled", False):
 
573
            # Already enabled
 
574
            return
 
575
        self.send_changedstate()
 
576
        self.expires = datetime.datetime.utcnow() + self.timeout
 
577
        self.enabled = True
 
578
        self.last_enabled = datetime.datetime.utcnow()
 
579
        self.init_checker()
 
580
    
 
581
    def disable(self, quiet=True):
 
582
        """Disable this client."""
 
583
        if not getattr(self, "enabled", False):
 
584
            return False
 
585
        if not quiet:
 
586
            self.send_changedstate()
 
587
        if not quiet:
 
588
            logger.info("Disabling client %s", self.name)
 
589
        if getattr(self, "disable_initiator_tag", False):
 
590
            gobject.source_remove(self.disable_initiator_tag)
 
591
            self.disable_initiator_tag = None
 
592
        self.expires = None
 
593
        if getattr(self, "checker_initiator_tag", False):
 
594
            gobject.source_remove(self.checker_initiator_tag)
 
595
            self.checker_initiator_tag = None
 
596
        self.stop_checker()
 
597
        self.enabled = False
 
598
        # Do not run this again if called by a gobject.timeout_add
 
599
        return False
 
600
    
 
601
    def __del__(self):
 
602
        self.disable()
 
603
    
 
604
    def init_checker(self):
258
605
        # Schedule a new checker to be started an 'interval' from now,
259
606
        # and every interval from then on.
260
 
        self.checker_initiator_tag = gobject.timeout_add\
261
 
                                     (self._interval_milliseconds,
262
 
                                      self.start_checker)
 
607
        self.checker_initiator_tag = (gobject.timeout_add
 
608
                                      (self.interval_milliseconds(),
 
609
                                       self.start_checker))
 
610
        # Schedule a disable() when 'timeout' has passed
 
611
        self.disable_initiator_tag = (gobject.timeout_add
 
612
                                   (self.timeout_milliseconds(),
 
613
                                    self.disable))
263
614
        # Also start a new checker *right now*.
264
615
        self.start_checker()
265
 
        # Schedule a stop() when 'timeout' has passed
266
 
        self.stop_initiator_tag = gobject.timeout_add\
267
 
                                  (self._timeout_milliseconds,
268
 
                                   self.stop)
269
 
    def stop(self):
270
 
        """Stop this client.
271
 
        The possibility that a client might be restarted is left open,
272
 
        but not currently used."""
273
 
        # If this client doesn't have a secret, it is already stopped.
274
 
        if hasattr(self, "secret") and self.secret:
275
 
            logger.info(u"Stopping client %s", self.name)
276
 
            self.secret = None
277
 
        else:
278
 
            return False
279
 
        if getattr(self, "stop_initiator_tag", False):
280
 
            gobject.source_remove(self.stop_initiator_tag)
281
 
            self.stop_initiator_tag = None
282
 
        if getattr(self, "checker_initiator_tag", False):
283
 
            gobject.source_remove(self.checker_initiator_tag)
284
 
            self.checker_initiator_tag = None
285
 
        self.stop_checker()
286
 
        if self.stop_hook:
287
 
            self.stop_hook(self)
288
 
        # Do not run this again if called by a gobject.timeout_add
289
 
        return False
290
 
    def __del__(self):
291
 
        self.stop_hook = None
292
 
        self.stop()
293
 
    def checker_callback(self, pid, condition):
 
616
    
 
617
    def checker_callback(self, pid, condition, command):
294
618
        """The checker has completed, so take appropriate actions."""
295
 
        now = datetime.datetime.now()
296
619
        self.checker_callback_tag = None
297
620
        self.checker = None
298
 
        if os.WIFEXITED(condition) \
299
 
               and (os.WEXITSTATUS(condition) == 0):
300
 
            logger.info(u"Checker for %(name)s succeeded",
301
 
                        vars(self))
302
 
            self.last_checked_ok = now
303
 
            gobject.source_remove(self.stop_initiator_tag)
304
 
            self.stop_initiator_tag = gobject.timeout_add\
305
 
                                      (self._timeout_milliseconds,
306
 
                                       self.stop)
307
 
        elif not os.WIFEXITED(condition):
308
 
            logger.warning(u"Checker for %(name)s crashed?",
 
621
        if os.WIFEXITED(condition):
 
622
            self.last_checker_status = os.WEXITSTATUS(condition)
 
623
            if self.last_checker_status == 0:
 
624
                logger.info("Checker for %(name)s succeeded",
 
625
                            vars(self))
 
626
                self.checked_ok()
 
627
            else:
 
628
                logger.info("Checker for %(name)s failed",
 
629
                            vars(self))
 
630
        else:
 
631
            self.last_checker_status = -1
 
632
            logger.warning("Checker for %(name)s crashed?",
309
633
                           vars(self))
310
 
        else:
311
 
            logger.info(u"Checker for %(name)s failed",
312
 
                        vars(self))
 
634
    
 
635
    def checked_ok(self):
 
636
        """Assert that the client has been seen, alive and well."""
 
637
        self.last_checked_ok = datetime.datetime.utcnow()
 
638
        self.last_checker_status = 0
 
639
        self.bump_timeout()
 
640
    
 
641
    def bump_timeout(self, timeout=None):
 
642
        """Bump up the timeout for this client."""
 
643
        if timeout is None:
 
644
            timeout = self.timeout
 
645
        if self.disable_initiator_tag is not None:
 
646
            gobject.source_remove(self.disable_initiator_tag)
 
647
        if getattr(self, "enabled", False):
 
648
            self.disable_initiator_tag = (gobject.timeout_add
 
649
                                          (timedelta_to_milliseconds
 
650
                                           (timeout), self.disable))
 
651
            self.expires = datetime.datetime.utcnow() + timeout
 
652
    
 
653
    def need_approval(self):
 
654
        self.last_approval_request = datetime.datetime.utcnow()
 
655
    
313
656
    def start_checker(self):
314
657
        """Start a new checker subprocess if one is not running.
 
658
        
315
659
        If a checker already exists, leave it running and do
316
660
        nothing."""
317
661
        # The reason for not killing a running checker is that if we
318
 
        # did that, then if a checker (for some reason) started
319
 
        # running slowly and taking more than 'interval' time, the
320
 
        # client would inevitably timeout, since no checker would get
321
 
        # a chance to run to completion.  If we instead leave running
 
662
        # did that, and if a checker (for some reason) started running
 
663
        # slowly and taking more than 'interval' time, then the client
 
664
        # would inevitably timeout, since no checker would get a
 
665
        # chance to run to completion.  If we instead leave running
322
666
        # checkers alone, the checker would have to take more time
323
 
        # than 'timeout' for the client to be declared invalid, which
324
 
        # is as it should be.
 
667
        # than 'timeout' for the client to be disabled, which is as it
 
668
        # should be.
 
669
        
 
670
        # If a checker exists, make sure it is not a zombie
 
671
        try:
 
672
            pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
 
673
        except (AttributeError, OSError) as error:
 
674
            if (isinstance(error, OSError)
 
675
                and error.errno != errno.ECHILD):
 
676
                raise error
 
677
        else:
 
678
            if pid:
 
679
                logger.warning("Checker was a zombie")
 
680
                gobject.source_remove(self.checker_callback_tag)
 
681
                self.checker_callback(pid, status,
 
682
                                      self.current_checker_command)
 
683
        # Start a new checker if needed
325
684
        if self.checker is None:
326
685
            try:
327
 
                # In case check_command has exactly one % operator
328
 
                command = self.check_command % self.host
 
686
                # In case checker_command has exactly one % operator
 
687
                command = self.checker_command % self.host
329
688
            except TypeError:
330
689
                # Escape attributes for the shell
331
 
                escaped_attrs = dict((key, re.escape(str(val)))
332
 
                                     for key, val in
333
 
                                     vars(self).iteritems())
 
690
                escaped_attrs = dict(
 
691
                    (attr,
 
692
                     re.escape(unicode(str(getattr(self, attr, "")),
 
693
                                       errors=
 
694
                                       'replace')))
 
695
                    for attr in
 
696
                    self.runtime_expansions)
 
697
                
334
698
                try:
335
 
                    command = self.check_command % escaped_attrs
336
 
                except TypeError, error:
337
 
                    logger.error(u'Could not format string "%s":'
338
 
                                 u' %s', self.check_command, error)
 
699
                    command = self.checker_command % escaped_attrs
 
700
                except TypeError as error:
 
701
                    logger.error('Could not format string "%s"',
 
702
                                 self.checker_command, exc_info=error)
339
703
                    return True # Try again later
 
704
            self.current_checker_command = command
340
705
            try:
341
 
                logger.info(u"Starting checker %r for %s",
 
706
                logger.info("Starting checker %r for %s",
342
707
                            command, self.name)
343
708
                # We don't need to redirect stdout and stderr, since
344
709
                # in normal mode, that is already done by daemon(),
347
712
                self.checker = subprocess.Popen(command,
348
713
                                                close_fds=True,
349
714
                                                shell=True, cwd="/")
350
 
                self.checker_callback_tag = gobject.child_watch_add\
351
 
                                            (self.checker.pid,
352
 
                                             self.checker_callback)
353
 
            except OSError, error:
354
 
                logger.error(u"Failed to start subprocess: %s",
355
 
                             error)
 
715
                self.checker_callback_tag = (gobject.child_watch_add
 
716
                                             (self.checker.pid,
 
717
                                              self.checker_callback,
 
718
                                              data=command))
 
719
                # The checker may have completed before the gobject
 
720
                # watch was added.  Check for this.
 
721
                pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
 
722
                if pid:
 
723
                    gobject.source_remove(self.checker_callback_tag)
 
724
                    self.checker_callback(pid, status, command)
 
725
            except OSError as error:
 
726
                logger.error("Failed to start subprocess",
 
727
                             exc_info=error)
356
728
        # Re-run this periodically if run by gobject.timeout_add
357
729
        return True
 
730
    
358
731
    def stop_checker(self):
359
732
        """Force the checker process, if any, to stop."""
360
733
        if self.checker_callback_tag:
362
735
            self.checker_callback_tag = None
363
736
        if getattr(self, "checker", None) is None:
364
737
            return
365
 
        logger.debug(u"Stopping checker for %(name)s", vars(self))
 
738
        logger.debug("Stopping checker for %(name)s", vars(self))
366
739
        try:
367
 
            os.kill(self.checker.pid, signal.SIGTERM)
368
 
            #os.sleep(0.5)
 
740
            self.checker.terminate()
 
741
            #time.sleep(0.5)
369
742
            #if self.checker.poll() is None:
370
 
            #    os.kill(self.checker.pid, signal.SIGKILL)
371
 
        except OSError, error:
 
743
            #    self.checker.kill()
 
744
        except OSError as error:
372
745
            if error.errno != errno.ESRCH: # No such process
373
746
                raise
374
747
        self.checker = None
375
 
    def still_valid(self):
376
 
        """Has the timeout not yet passed for this client?"""
377
 
        now = datetime.datetime.now()
378
 
        if self.last_checked_ok is None:
379
 
            return now < (self.created + self.timeout)
380
 
        else:
381
 
            return now < (self.last_checked_ok + self.timeout)
382
 
 
383
 
 
384
 
def peer_certificate(session):
385
 
    "Return the peer's OpenPGP certificate as a bytestring"
386
 
    # If not an OpenPGP certificate...
387
 
    if gnutls.library.functions.gnutls_certificate_type_get\
388
 
            (session._c_object) \
389
 
           != gnutls.library.constants.GNUTLS_CRT_OPENPGP:
390
 
        # ...do the normal thing
391
 
        return session.peer_certificate
392
 
    list_size = ctypes.c_uint()
393
 
    cert_list = gnutls.library.functions.gnutls_certificate_get_peers\
394
 
        (session._c_object, ctypes.byref(list_size))
395
 
    if list_size.value == 0:
396
 
        return None
397
 
    cert = cert_list[0]
398
 
    return ctypes.string_at(cert.data, cert.size)
399
 
 
400
 
 
401
 
def fingerprint(openpgp):
402
 
    "Convert an OpenPGP bytestring to a hexdigit fingerprint string"
403
 
    # New GnuTLS "datum" with the OpenPGP public key
404
 
    datum = gnutls.library.types.gnutls_datum_t\
405
 
        (ctypes.cast(ctypes.c_char_p(openpgp),
406
 
                     ctypes.POINTER(ctypes.c_ubyte)),
407
 
         ctypes.c_uint(len(openpgp)))
408
 
    # New empty GnuTLS certificate
409
 
    crt = gnutls.library.types.gnutls_openpgp_crt_t()
410
 
    gnutls.library.functions.gnutls_openpgp_crt_init\
411
 
        (ctypes.byref(crt))
412
 
    # Import the OpenPGP public key into the certificate
413
 
    gnutls.library.functions.gnutls_openpgp_crt_import\
414
 
                    (crt, ctypes.byref(datum),
415
 
                     gnutls.library.constants.GNUTLS_OPENPGP_FMT_RAW)
416
 
    # Verify the self signature in the key
417
 
    crtverify = ctypes.c_uint();
418
 
    gnutls.library.functions.gnutls_openpgp_crt_verify_self\
419
 
        (crt, 0, ctypes.byref(crtverify))
420
 
    if crtverify.value != 0:
421
 
        gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
422
 
        raise gnutls.errors.CertificateSecurityError("Verify failed")
423
 
    # New buffer for the fingerprint
424
 
    buffer = ctypes.create_string_buffer(20)
425
 
    buffer_length = ctypes.c_size_t()
426
 
    # Get the fingerprint from the certificate into the buffer
427
 
    gnutls.library.functions.gnutls_openpgp_crt_get_fingerprint\
428
 
        (crt, ctypes.byref(buffer), ctypes.byref(buffer_length))
429
 
    # Deinit the certificate
430
 
    gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
431
 
    # Convert the buffer to a Python bytestring
432
 
    fpr = ctypes.string_at(buffer, buffer_length.value)
433
 
    # Convert the bytestring to hexadecimal notation
434
 
    hex_fpr = u''.join(u"%02X" % ord(char) for char in fpr)
435
 
    return hex_fpr
436
 
 
437
 
 
438
 
class tcp_handler(SocketServer.BaseRequestHandler, object):
439
 
    """A TCP request handler class.
440
 
    Instantiated by IPv6_TCPServer for each request to handle it.
 
748
 
 
749
 
 
750
def dbus_service_property(dbus_interface, signature="v",
 
751
                          access="readwrite", byte_arrays=False):
 
752
    """Decorators for marking methods of a DBusObjectWithProperties to
 
753
    become properties on the D-Bus.
 
754
    
 
755
    The decorated method will be called with no arguments by "Get"
 
756
    and with one argument by "Set".
 
757
    
 
758
    The parameters, where they are supported, are the same as
 
759
    dbus.service.method, except there is only "signature", since the
 
760
    type from Get() and the type sent to Set() is the same.
 
761
    """
 
762
    # Encoding deeply encoded byte arrays is not supported yet by the
 
763
    # "Set" method, so we fail early here:
 
764
    if byte_arrays and signature != "ay":
 
765
        raise ValueError("Byte arrays not supported for non-'ay'"
 
766
                         " signature {0!r}".format(signature))
 
767
    def decorator(func):
 
768
        func._dbus_is_property = True
 
769
        func._dbus_interface = dbus_interface
 
770
        func._dbus_signature = signature
 
771
        func._dbus_access = access
 
772
        func._dbus_name = func.__name__
 
773
        if func._dbus_name.endswith("_dbus_property"):
 
774
            func._dbus_name = func._dbus_name[:-14]
 
775
        func._dbus_get_args_options = {'byte_arrays': byte_arrays }
 
776
        return func
 
777
    return decorator
 
778
 
 
779
 
 
780
def dbus_interface_annotations(dbus_interface):
 
781
    """Decorator for marking functions returning interface annotations
 
782
    
 
783
    Usage:
 
784
    
 
785
    @dbus_interface_annotations("org.example.Interface")
 
786
    def _foo(self):  # Function name does not matter
 
787
        return {"org.freedesktop.DBus.Deprecated": "true",
 
788
                "org.freedesktop.DBus.Property.EmitsChangedSignal":
 
789
                    "false"}
 
790
    """
 
791
    def decorator(func):
 
792
        func._dbus_is_interface = True
 
793
        func._dbus_interface = dbus_interface
 
794
        func._dbus_name = dbus_interface
 
795
        return func
 
796
    return decorator
 
797
 
 
798
 
 
799
def dbus_annotations(annotations):
 
800
    """Decorator to annotate D-Bus methods, signals or properties
 
801
    Usage:
 
802
    
 
803
    @dbus_service_property("org.example.Interface", signature="b",
 
804
                           access="r")
 
805
    @dbus_annotations({{"org.freedesktop.DBus.Deprecated": "true",
 
806
                        "org.freedesktop.DBus.Property."
 
807
                        "EmitsChangedSignal": "false"})
 
808
    def Property_dbus_property(self):
 
809
        return dbus.Boolean(False)
 
810
    """
 
811
    def decorator(func):
 
812
        func._dbus_annotations = annotations
 
813
        return func
 
814
    return decorator
 
815
 
 
816
 
 
817
class DBusPropertyException(dbus.exceptions.DBusException):
 
818
    """A base class for D-Bus property-related exceptions
 
819
    """
 
820
    def __unicode__(self):
 
821
        return unicode(str(self))
 
822
 
 
823
 
 
824
class DBusPropertyAccessException(DBusPropertyException):
 
825
    """A property's access permissions disallows an operation.
 
826
    """
 
827
    pass
 
828
 
 
829
 
 
830
class DBusPropertyNotFound(DBusPropertyException):
 
831
    """An attempt was made to access a non-existing property.
 
832
    """
 
833
    pass
 
834
 
 
835
 
 
836
class DBusObjectWithProperties(dbus.service.Object):
 
837
    """A D-Bus object with properties.
 
838
    
 
839
    Classes inheriting from this can use the dbus_service_property
 
840
    decorator to expose methods as D-Bus properties.  It exposes the
 
841
    standard Get(), Set(), and GetAll() methods on the D-Bus.
 
842
    """
 
843
    
 
844
    @staticmethod
 
845
    def _is_dbus_thing(thing):
 
846
        """Returns a function testing if an attribute is a D-Bus thing
 
847
        
 
848
        If called like _is_dbus_thing("method") it returns a function
 
849
        suitable for use as predicate to inspect.getmembers().
 
850
        """
 
851
        return lambda obj: getattr(obj, "_dbus_is_{0}".format(thing),
 
852
                                   False)
 
853
    
 
854
    def _get_all_dbus_things(self, thing):
 
855
        """Returns a generator of (name, attribute) pairs
 
856
        """
 
857
        return ((getattr(athing.__get__(self), "_dbus_name",
 
858
                         name),
 
859
                 athing.__get__(self))
 
860
                for cls in self.__class__.__mro__
 
861
                for name, athing in
 
862
                inspect.getmembers(cls,
 
863
                                   self._is_dbus_thing(thing)))
 
864
    
 
865
    def _get_dbus_property(self, interface_name, property_name):
 
866
        """Returns a bound method if one exists which is a D-Bus
 
867
        property with the specified name and interface.
 
868
        """
 
869
        for cls in  self.__class__.__mro__:
 
870
            for name, value in (inspect.getmembers
 
871
                                (cls,
 
872
                                 self._is_dbus_thing("property"))):
 
873
                if (value._dbus_name == property_name
 
874
                    and value._dbus_interface == interface_name):
 
875
                    return value.__get__(self)
 
876
        
 
877
        # No such property
 
878
        raise DBusPropertyNotFound(self.dbus_object_path + ":"
 
879
                                   + interface_name + "."
 
880
                                   + property_name)
 
881
    
 
882
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ss",
 
883
                         out_signature="v")
 
884
    def Get(self, interface_name, property_name):
 
885
        """Standard D-Bus property Get() method, see D-Bus standard.
 
886
        """
 
887
        prop = self._get_dbus_property(interface_name, property_name)
 
888
        if prop._dbus_access == "write":
 
889
            raise DBusPropertyAccessException(property_name)
 
890
        value = prop()
 
891
        if not hasattr(value, "variant_level"):
 
892
            return value
 
893
        return type(value)(value, variant_level=value.variant_level+1)
 
894
    
 
895
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ssv")
 
896
    def Set(self, interface_name, property_name, value):
 
897
        """Standard D-Bus property Set() method, see D-Bus standard.
 
898
        """
 
899
        prop = self._get_dbus_property(interface_name, property_name)
 
900
        if prop._dbus_access == "read":
 
901
            raise DBusPropertyAccessException(property_name)
 
902
        if prop._dbus_get_args_options["byte_arrays"]:
 
903
            # The byte_arrays option is not supported yet on
 
904
            # signatures other than "ay".
 
905
            if prop._dbus_signature != "ay":
 
906
                raise ValueError
 
907
            value = dbus.ByteArray(b''.join(chr(byte)
 
908
                                            for byte in value))
 
909
        prop(value)
 
910
    
 
911
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="s",
 
912
                         out_signature="a{sv}")
 
913
    def GetAll(self, interface_name):
 
914
        """Standard D-Bus property GetAll() method, see D-Bus
 
915
        standard.
 
916
        
 
917
        Note: Will not include properties with access="write".
 
918
        """
 
919
        properties = {}
 
920
        for name, prop in self._get_all_dbus_things("property"):
 
921
            if (interface_name
 
922
                and interface_name != prop._dbus_interface):
 
923
                # Interface non-empty but did not match
 
924
                continue
 
925
            # Ignore write-only properties
 
926
            if prop._dbus_access == "write":
 
927
                continue
 
928
            value = prop()
 
929
            if not hasattr(value, "variant_level"):
 
930
                properties[name] = value
 
931
                continue
 
932
            properties[name] = type(value)(value, variant_level=
 
933
                                           value.variant_level+1)
 
934
        return dbus.Dictionary(properties, signature="sv")
 
935
    
 
936
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
 
937
                         out_signature="s",
 
938
                         path_keyword='object_path',
 
939
                         connection_keyword='connection')
 
940
    def Introspect(self, object_path, connection):
 
941
        """Overloading of standard D-Bus method.
 
942
        
 
943
        Inserts property tags and interface annotation tags.
 
944
        """
 
945
        xmlstring = dbus.service.Object.Introspect(self, object_path,
 
946
                                                   connection)
 
947
        try:
 
948
            document = xml.dom.minidom.parseString(xmlstring)
 
949
            def make_tag(document, name, prop):
 
950
                e = document.createElement("property")
 
951
                e.setAttribute("name", name)
 
952
                e.setAttribute("type", prop._dbus_signature)
 
953
                e.setAttribute("access", prop._dbus_access)
 
954
                return e
 
955
            for if_tag in document.getElementsByTagName("interface"):
 
956
                # Add property tags
 
957
                for tag in (make_tag(document, name, prop)
 
958
                            for name, prop
 
959
                            in self._get_all_dbus_things("property")
 
960
                            if prop._dbus_interface
 
961
                            == if_tag.getAttribute("name")):
 
962
                    if_tag.appendChild(tag)
 
963
                # Add annotation tags
 
964
                for typ in ("method", "signal", "property"):
 
965
                    for tag in if_tag.getElementsByTagName(typ):
 
966
                        annots = dict()
 
967
                        for name, prop in (self.
 
968
                                           _get_all_dbus_things(typ)):
 
969
                            if (name == tag.getAttribute("name")
 
970
                                and prop._dbus_interface
 
971
                                == if_tag.getAttribute("name")):
 
972
                                annots.update(getattr
 
973
                                              (prop,
 
974
                                               "_dbus_annotations",
 
975
                                               {}))
 
976
                        for name, value in annots.iteritems():
 
977
                            ann_tag = document.createElement(
 
978
                                "annotation")
 
979
                            ann_tag.setAttribute("name", name)
 
980
                            ann_tag.setAttribute("value", value)
 
981
                            tag.appendChild(ann_tag)
 
982
                # Add interface annotation tags
 
983
                for annotation, value in dict(
 
984
                    itertools.chain.from_iterable(
 
985
                        annotations().iteritems()
 
986
                        for name, annotations in
 
987
                        self._get_all_dbus_things("interface")
 
988
                        if name == if_tag.getAttribute("name")
 
989
                        )).iteritems():
 
990
                    ann_tag = document.createElement("annotation")
 
991
                    ann_tag.setAttribute("name", annotation)
 
992
                    ann_tag.setAttribute("value", value)
 
993
                    if_tag.appendChild(ann_tag)
 
994
                # Add the names to the return values for the
 
995
                # "org.freedesktop.DBus.Properties" methods
 
996
                if (if_tag.getAttribute("name")
 
997
                    == "org.freedesktop.DBus.Properties"):
 
998
                    for cn in if_tag.getElementsByTagName("method"):
 
999
                        if cn.getAttribute("name") == "Get":
 
1000
                            for arg in cn.getElementsByTagName("arg"):
 
1001
                                if (arg.getAttribute("direction")
 
1002
                                    == "out"):
 
1003
                                    arg.setAttribute("name", "value")
 
1004
                        elif cn.getAttribute("name") == "GetAll":
 
1005
                            for arg in cn.getElementsByTagName("arg"):
 
1006
                                if (arg.getAttribute("direction")
 
1007
                                    == "out"):
 
1008
                                    arg.setAttribute("name", "props")
 
1009
            xmlstring = document.toxml("utf-8")
 
1010
            document.unlink()
 
1011
        except (AttributeError, xml.dom.DOMException,
 
1012
                xml.parsers.expat.ExpatError) as error:
 
1013
            logger.error("Failed to override Introspection method",
 
1014
                         exc_info=error)
 
1015
        return xmlstring
 
1016
 
 
1017
 
 
1018
def datetime_to_dbus (dt, variant_level=0):
 
1019
    """Convert a UTC datetime.datetime() to a D-Bus type."""
 
1020
    if dt is None:
 
1021
        return dbus.String("", variant_level = variant_level)
 
1022
    return dbus.String(dt.isoformat(),
 
1023
                       variant_level=variant_level)
 
1024
 
 
1025
 
 
1026
def alternate_dbus_interfaces(alt_interface_names, deprecate=True):
 
1027
    """A class decorator; applied to a subclass of
 
1028
    dbus.service.Object, it will add alternate D-Bus attributes with
 
1029
    interface names according to the "alt_interface_names" mapping.
 
1030
    Usage:
 
1031
    
 
1032
    @alternate_dbus_names({"org.example.Interface":
 
1033
                               "net.example.AlternateInterface"})
 
1034
    class SampleDBusObject(dbus.service.Object):
 
1035
        @dbus.service.method("org.example.Interface")
 
1036
        def SampleDBusMethod():
 
1037
            pass
 
1038
    
 
1039
    The above "SampleDBusMethod" on "SampleDBusObject" will be
 
1040
    reachable via two interfaces: "org.example.Interface" and
 
1041
    "net.example.AlternateInterface", the latter of which will have
 
1042
    its D-Bus annotation "org.freedesktop.DBus.Deprecated" set to
 
1043
    "true", unless "deprecate" is passed with a False value.
 
1044
    
 
1045
    This works for methods and signals, and also for D-Bus properties
 
1046
    (from DBusObjectWithProperties) and interfaces (from the
 
1047
    dbus_interface_annotations decorator).
 
1048
    """
 
1049
    def wrapper(cls):
 
1050
        for orig_interface_name, alt_interface_name in (
 
1051
            alt_interface_names.iteritems()):
 
1052
            attr = {}
 
1053
            interface_names = set()
 
1054
            # Go though all attributes of the class
 
1055
            for attrname, attribute in inspect.getmembers(cls):
 
1056
                # Ignore non-D-Bus attributes, and D-Bus attributes
 
1057
                # with the wrong interface name
 
1058
                if (not hasattr(attribute, "_dbus_interface")
 
1059
                    or not attribute._dbus_interface
 
1060
                    .startswith(orig_interface_name)):
 
1061
                    continue
 
1062
                # Create an alternate D-Bus interface name based on
 
1063
                # the current name
 
1064
                alt_interface = (attribute._dbus_interface
 
1065
                                 .replace(orig_interface_name,
 
1066
                                          alt_interface_name))
 
1067
                interface_names.add(alt_interface)
 
1068
                # Is this a D-Bus signal?
 
1069
                if getattr(attribute, "_dbus_is_signal", False):
 
1070
                    # Extract the original non-method function by
 
1071
                    # black magic
 
1072
                    nonmethod_func = (dict(
 
1073
                            zip(attribute.func_code.co_freevars,
 
1074
                                attribute.__closure__))["func"]
 
1075
                                      .cell_contents)
 
1076
                    # Create a new, but exactly alike, function
 
1077
                    # object, and decorate it to be a new D-Bus signal
 
1078
                    # with the alternate D-Bus interface name
 
1079
                    new_function = (dbus.service.signal
 
1080
                                    (alt_interface,
 
1081
                                     attribute._dbus_signature)
 
1082
                                    (types.FunctionType(
 
1083
                                nonmethod_func.func_code,
 
1084
                                nonmethod_func.func_globals,
 
1085
                                nonmethod_func.func_name,
 
1086
                                nonmethod_func.func_defaults,
 
1087
                                nonmethod_func.func_closure)))
 
1088
                    # Copy annotations, if any
 
1089
                    try:
 
1090
                        new_function._dbus_annotations = (
 
1091
                            dict(attribute._dbus_annotations))
 
1092
                    except AttributeError:
 
1093
                        pass
 
1094
                    # Define a creator of a function to call both the
 
1095
                    # original and alternate functions, so both the
 
1096
                    # original and alternate signals gets sent when
 
1097
                    # the function is called
 
1098
                    def fixscope(func1, func2):
 
1099
                        """This function is a scope container to pass
 
1100
                        func1 and func2 to the "call_both" function
 
1101
                        outside of its arguments"""
 
1102
                        def call_both(*args, **kwargs):
 
1103
                            """This function will emit two D-Bus
 
1104
                            signals by calling func1 and func2"""
 
1105
                            func1(*args, **kwargs)
 
1106
                            func2(*args, **kwargs)
 
1107
                        return call_both
 
1108
                    # Create the "call_both" function and add it to
 
1109
                    # the class
 
1110
                    attr[attrname] = fixscope(attribute, new_function)
 
1111
                # Is this a D-Bus method?
 
1112
                elif getattr(attribute, "_dbus_is_method", False):
 
1113
                    # Create a new, but exactly alike, function
 
1114
                    # object.  Decorate it to be a new D-Bus method
 
1115
                    # with the alternate D-Bus interface name.  Add it
 
1116
                    # to the class.
 
1117
                    attr[attrname] = (dbus.service.method
 
1118
                                      (alt_interface,
 
1119
                                       attribute._dbus_in_signature,
 
1120
                                       attribute._dbus_out_signature)
 
1121
                                      (types.FunctionType
 
1122
                                       (attribute.func_code,
 
1123
                                        attribute.func_globals,
 
1124
                                        attribute.func_name,
 
1125
                                        attribute.func_defaults,
 
1126
                                        attribute.func_closure)))
 
1127
                    # Copy annotations, if any
 
1128
                    try:
 
1129
                        attr[attrname]._dbus_annotations = (
 
1130
                            dict(attribute._dbus_annotations))
 
1131
                    except AttributeError:
 
1132
                        pass
 
1133
                # Is this a D-Bus property?
 
1134
                elif getattr(attribute, "_dbus_is_property", False):
 
1135
                    # Create a new, but exactly alike, function
 
1136
                    # object, and decorate it to be a new D-Bus
 
1137
                    # property with the alternate D-Bus interface
 
1138
                    # name.  Add it to the class.
 
1139
                    attr[attrname] = (dbus_service_property
 
1140
                                      (alt_interface,
 
1141
                                       attribute._dbus_signature,
 
1142
                                       attribute._dbus_access,
 
1143
                                       attribute
 
1144
                                       ._dbus_get_args_options
 
1145
                                       ["byte_arrays"])
 
1146
                                      (types.FunctionType
 
1147
                                       (attribute.func_code,
 
1148
                                        attribute.func_globals,
 
1149
                                        attribute.func_name,
 
1150
                                        attribute.func_defaults,
 
1151
                                        attribute.func_closure)))
 
1152
                    # Copy annotations, if any
 
1153
                    try:
 
1154
                        attr[attrname]._dbus_annotations = (
 
1155
                            dict(attribute._dbus_annotations))
 
1156
                    except AttributeError:
 
1157
                        pass
 
1158
                # Is this a D-Bus interface?
 
1159
                elif getattr(attribute, "_dbus_is_interface", False):
 
1160
                    # Create a new, but exactly alike, function
 
1161
                    # object.  Decorate it to be a new D-Bus interface
 
1162
                    # with the alternate D-Bus interface name.  Add it
 
1163
                    # to the class.
 
1164
                    attr[attrname] = (dbus_interface_annotations
 
1165
                                      (alt_interface)
 
1166
                                      (types.FunctionType
 
1167
                                       (attribute.func_code,
 
1168
                                        attribute.func_globals,
 
1169
                                        attribute.func_name,
 
1170
                                        attribute.func_defaults,
 
1171
                                        attribute.func_closure)))
 
1172
            if deprecate:
 
1173
                # Deprecate all alternate interfaces
 
1174
                iname="_AlternateDBusNames_interface_annotation{0}"
 
1175
                for interface_name in interface_names:
 
1176
                    @dbus_interface_annotations(interface_name)
 
1177
                    def func(self):
 
1178
                        return { "org.freedesktop.DBus.Deprecated":
 
1179
                                     "true" }
 
1180
                    # Find an unused name
 
1181
                    for aname in (iname.format(i)
 
1182
                                  for i in itertools.count()):
 
1183
                        if aname not in attr:
 
1184
                            attr[aname] = func
 
1185
                            break
 
1186
            if interface_names:
 
1187
                # Replace the class with a new subclass of it with
 
1188
                # methods, signals, etc. as created above.
 
1189
                cls = type(b"{0}Alternate".format(cls.__name__),
 
1190
                           (cls,), attr)
 
1191
        return cls
 
1192
    return wrapper
 
1193
 
 
1194
 
 
1195
@alternate_dbus_interfaces({"se.recompile.Mandos":
 
1196
                                "se.bsnet.fukt.Mandos"})
 
1197
class ClientDBus(Client, DBusObjectWithProperties):
 
1198
    """A Client class using D-Bus
 
1199
    
 
1200
    Attributes:
 
1201
    dbus_object_path: dbus.ObjectPath
 
1202
    bus: dbus.SystemBus()
 
1203
    """
 
1204
    
 
1205
    runtime_expansions = (Client.runtime_expansions
 
1206
                          + ("dbus_object_path",))
 
1207
    
 
1208
    # dbus.service.Object doesn't use super(), so we can't either.
 
1209
    
 
1210
    def __init__(self, bus = None, *args, **kwargs):
 
1211
        self.bus = bus
 
1212
        Client.__init__(self, *args, **kwargs)
 
1213
        # Only now, when this client is initialized, can it show up on
 
1214
        # the D-Bus
 
1215
        client_object_name = unicode(self.name).translate(
 
1216
            {ord("."): ord("_"),
 
1217
             ord("-"): ord("_")})
 
1218
        self.dbus_object_path = (dbus.ObjectPath
 
1219
                                 ("/clients/" + client_object_name))
 
1220
        DBusObjectWithProperties.__init__(self, self.bus,
 
1221
                                          self.dbus_object_path)
 
1222
    
 
1223
    def notifychangeproperty(transform_func,
 
1224
                             dbus_name, type_func=lambda x: x,
 
1225
                             variant_level=1):
 
1226
        """ Modify a variable so that it's a property which announces
 
1227
        its changes to DBus.
 
1228
        
 
1229
        transform_fun: Function that takes a value and a variant_level
 
1230
                       and transforms it to a D-Bus type.
 
1231
        dbus_name: D-Bus name of the variable
 
1232
        type_func: Function that transform the value before sending it
 
1233
                   to the D-Bus.  Default: no transform
 
1234
        variant_level: D-Bus variant level.  Default: 1
 
1235
        """
 
1236
        attrname = "_{0}".format(dbus_name)
 
1237
        def setter(self, value):
 
1238
            if hasattr(self, "dbus_object_path"):
 
1239
                if (not hasattr(self, attrname) or
 
1240
                    type_func(getattr(self, attrname, None))
 
1241
                    != type_func(value)):
 
1242
                    dbus_value = transform_func(type_func(value),
 
1243
                                                variant_level
 
1244
                                                =variant_level)
 
1245
                    self.PropertyChanged(dbus.String(dbus_name),
 
1246
                                         dbus_value)
 
1247
            setattr(self, attrname, value)
 
1248
        
 
1249
        return property(lambda self: getattr(self, attrname), setter)
 
1250
    
 
1251
    expires = notifychangeproperty(datetime_to_dbus, "Expires")
 
1252
    approvals_pending = notifychangeproperty(dbus.Boolean,
 
1253
                                             "ApprovalPending",
 
1254
                                             type_func = bool)
 
1255
    enabled = notifychangeproperty(dbus.Boolean, "Enabled")
 
1256
    last_enabled = notifychangeproperty(datetime_to_dbus,
 
1257
                                        "LastEnabled")
 
1258
    checker = notifychangeproperty(dbus.Boolean, "CheckerRunning",
 
1259
                                   type_func = lambda checker:
 
1260
                                       checker is not None)
 
1261
    last_checked_ok = notifychangeproperty(datetime_to_dbus,
 
1262
                                           "LastCheckedOK")
 
1263
    last_checker_status = notifychangeproperty(dbus.Int16,
 
1264
                                               "LastCheckerStatus")
 
1265
    last_approval_request = notifychangeproperty(
 
1266
        datetime_to_dbus, "LastApprovalRequest")
 
1267
    approved_by_default = notifychangeproperty(dbus.Boolean,
 
1268
                                               "ApprovedByDefault")
 
1269
    approval_delay = notifychangeproperty(dbus.UInt64,
 
1270
                                          "ApprovalDelay",
 
1271
                                          type_func =
 
1272
                                          timedelta_to_milliseconds)
 
1273
    approval_duration = notifychangeproperty(
 
1274
        dbus.UInt64, "ApprovalDuration",
 
1275
        type_func = timedelta_to_milliseconds)
 
1276
    host = notifychangeproperty(dbus.String, "Host")
 
1277
    timeout = notifychangeproperty(dbus.UInt64, "Timeout",
 
1278
                                   type_func =
 
1279
                                   timedelta_to_milliseconds)
 
1280
    extended_timeout = notifychangeproperty(
 
1281
        dbus.UInt64, "ExtendedTimeout",
 
1282
        type_func = timedelta_to_milliseconds)
 
1283
    interval = notifychangeproperty(dbus.UInt64,
 
1284
                                    "Interval",
 
1285
                                    type_func =
 
1286
                                    timedelta_to_milliseconds)
 
1287
    checker_command = notifychangeproperty(dbus.String, "Checker")
 
1288
    
 
1289
    del notifychangeproperty
 
1290
    
 
1291
    def __del__(self, *args, **kwargs):
 
1292
        try:
 
1293
            self.remove_from_connection()
 
1294
        except LookupError:
 
1295
            pass
 
1296
        if hasattr(DBusObjectWithProperties, "__del__"):
 
1297
            DBusObjectWithProperties.__del__(self, *args, **kwargs)
 
1298
        Client.__del__(self, *args, **kwargs)
 
1299
    
 
1300
    def checker_callback(self, pid, condition, command,
 
1301
                         *args, **kwargs):
 
1302
        self.checker_callback_tag = None
 
1303
        self.checker = None
 
1304
        if os.WIFEXITED(condition):
 
1305
            exitstatus = os.WEXITSTATUS(condition)
 
1306
            # Emit D-Bus signal
 
1307
            self.CheckerCompleted(dbus.Int16(exitstatus),
 
1308
                                  dbus.Int64(condition),
 
1309
                                  dbus.String(command))
 
1310
        else:
 
1311
            # Emit D-Bus signal
 
1312
            self.CheckerCompleted(dbus.Int16(-1),
 
1313
                                  dbus.Int64(condition),
 
1314
                                  dbus.String(command))
 
1315
        
 
1316
        return Client.checker_callback(self, pid, condition, command,
 
1317
                                       *args, **kwargs)
 
1318
    
 
1319
    def start_checker(self, *args, **kwargs):
 
1320
        old_checker = self.checker
 
1321
        if self.checker is not None:
 
1322
            old_checker_pid = self.checker.pid
 
1323
        else:
 
1324
            old_checker_pid = None
 
1325
        r = Client.start_checker(self, *args, **kwargs)
 
1326
        # Only if new checker process was started
 
1327
        if (self.checker is not None
 
1328
            and old_checker_pid != self.checker.pid):
 
1329
            # Emit D-Bus signal
 
1330
            self.CheckerStarted(self.current_checker_command)
 
1331
        return r
 
1332
    
 
1333
    def _reset_approved(self):
 
1334
        self.approved = None
 
1335
        return False
 
1336
    
 
1337
    def approve(self, value=True):
 
1338
        self.send_changedstate()
 
1339
        self.approved = value
 
1340
        gobject.timeout_add(timedelta_to_milliseconds
 
1341
                            (self.approval_duration),
 
1342
                            self._reset_approved)
 
1343
    
 
1344
    ## D-Bus methods, signals & properties
 
1345
    _interface = "se.recompile.Mandos.Client"
 
1346
    
 
1347
    ## Interfaces
 
1348
    
 
1349
    @dbus_interface_annotations(_interface)
 
1350
    def _foo(self):
 
1351
        return { "org.freedesktop.DBus.Property.EmitsChangedSignal":
 
1352
                     "false"}
 
1353
    
 
1354
    ## Signals
 
1355
    
 
1356
    # CheckerCompleted - signal
 
1357
    @dbus.service.signal(_interface, signature="nxs")
 
1358
    def CheckerCompleted(self, exitcode, waitstatus, command):
 
1359
        "D-Bus signal"
 
1360
        pass
 
1361
    
 
1362
    # CheckerStarted - signal
 
1363
    @dbus.service.signal(_interface, signature="s")
 
1364
    def CheckerStarted(self, command):
 
1365
        "D-Bus signal"
 
1366
        pass
 
1367
    
 
1368
    # PropertyChanged - signal
 
1369
    @dbus.service.signal(_interface, signature="sv")
 
1370
    def PropertyChanged(self, property, value):
 
1371
        "D-Bus signal"
 
1372
        pass
 
1373
    
 
1374
    # GotSecret - signal
 
1375
    @dbus.service.signal(_interface)
 
1376
    def GotSecret(self):
 
1377
        """D-Bus signal
 
1378
        Is sent after a successful transfer of secret from the Mandos
 
1379
        server to mandos-client
 
1380
        """
 
1381
        pass
 
1382
    
 
1383
    # Rejected - signal
 
1384
    @dbus.service.signal(_interface, signature="s")
 
1385
    def Rejected(self, reason):
 
1386
        "D-Bus signal"
 
1387
        pass
 
1388
    
 
1389
    # NeedApproval - signal
 
1390
    @dbus.service.signal(_interface, signature="tb")
 
1391
    def NeedApproval(self, timeout, default):
 
1392
        "D-Bus signal"
 
1393
        return self.need_approval()
 
1394
    
 
1395
    ## Methods
 
1396
    
 
1397
    # Approve - method
 
1398
    @dbus.service.method(_interface, in_signature="b")
 
1399
    def Approve(self, value):
 
1400
        self.approve(value)
 
1401
    
 
1402
    # CheckedOK - method
 
1403
    @dbus.service.method(_interface)
 
1404
    def CheckedOK(self):
 
1405
        self.checked_ok()
 
1406
    
 
1407
    # Enable - method
 
1408
    @dbus.service.method(_interface)
 
1409
    def Enable(self):
 
1410
        "D-Bus method"
 
1411
        self.enable()
 
1412
    
 
1413
    # StartChecker - method
 
1414
    @dbus.service.method(_interface)
 
1415
    def StartChecker(self):
 
1416
        "D-Bus method"
 
1417
        self.start_checker()
 
1418
    
 
1419
    # Disable - method
 
1420
    @dbus.service.method(_interface)
 
1421
    def Disable(self):
 
1422
        "D-Bus method"
 
1423
        self.disable()
 
1424
    
 
1425
    # StopChecker - method
 
1426
    @dbus.service.method(_interface)
 
1427
    def StopChecker(self):
 
1428
        self.stop_checker()
 
1429
    
 
1430
    ## Properties
 
1431
    
 
1432
    # ApprovalPending - property
 
1433
    @dbus_service_property(_interface, signature="b", access="read")
 
1434
    def ApprovalPending_dbus_property(self):
 
1435
        return dbus.Boolean(bool(self.approvals_pending))
 
1436
    
 
1437
    # ApprovedByDefault - property
 
1438
    @dbus_service_property(_interface, signature="b",
 
1439
                           access="readwrite")
 
1440
    def ApprovedByDefault_dbus_property(self, value=None):
 
1441
        if value is None:       # get
 
1442
            return dbus.Boolean(self.approved_by_default)
 
1443
        self.approved_by_default = bool(value)
 
1444
    
 
1445
    # ApprovalDelay - property
 
1446
    @dbus_service_property(_interface, signature="t",
 
1447
                           access="readwrite")
 
1448
    def ApprovalDelay_dbus_property(self, value=None):
 
1449
        if value is None:       # get
 
1450
            return dbus.UInt64(self.approval_delay_milliseconds())
 
1451
        self.approval_delay = datetime.timedelta(0, 0, 0, value)
 
1452
    
 
1453
    # ApprovalDuration - property
 
1454
    @dbus_service_property(_interface, signature="t",
 
1455
                           access="readwrite")
 
1456
    def ApprovalDuration_dbus_property(self, value=None):
 
1457
        if value is None:       # get
 
1458
            return dbus.UInt64(timedelta_to_milliseconds(
 
1459
                    self.approval_duration))
 
1460
        self.approval_duration = datetime.timedelta(0, 0, 0, value)
 
1461
    
 
1462
    # Name - property
 
1463
    @dbus_service_property(_interface, signature="s", access="read")
 
1464
    def Name_dbus_property(self):
 
1465
        return dbus.String(self.name)
 
1466
    
 
1467
    # Fingerprint - property
 
1468
    @dbus_service_property(_interface, signature="s", access="read")
 
1469
    def Fingerprint_dbus_property(self):
 
1470
        return dbus.String(self.fingerprint)
 
1471
    
 
1472
    # Host - property
 
1473
    @dbus_service_property(_interface, signature="s",
 
1474
                           access="readwrite")
 
1475
    def Host_dbus_property(self, value=None):
 
1476
        if value is None:       # get
 
1477
            return dbus.String(self.host)
 
1478
        self.host = unicode(value)
 
1479
    
 
1480
    # Created - property
 
1481
    @dbus_service_property(_interface, signature="s", access="read")
 
1482
    def Created_dbus_property(self):
 
1483
        return datetime_to_dbus(self.created)
 
1484
    
 
1485
    # LastEnabled - property
 
1486
    @dbus_service_property(_interface, signature="s", access="read")
 
1487
    def LastEnabled_dbus_property(self):
 
1488
        return datetime_to_dbus(self.last_enabled)
 
1489
    
 
1490
    # Enabled - property
 
1491
    @dbus_service_property(_interface, signature="b",
 
1492
                           access="readwrite")
 
1493
    def Enabled_dbus_property(self, value=None):
 
1494
        if value is None:       # get
 
1495
            return dbus.Boolean(self.enabled)
 
1496
        if value:
 
1497
            self.enable()
 
1498
        else:
 
1499
            self.disable()
 
1500
    
 
1501
    # LastCheckedOK - property
 
1502
    @dbus_service_property(_interface, signature="s",
 
1503
                           access="readwrite")
 
1504
    def LastCheckedOK_dbus_property(self, value=None):
 
1505
        if value is not None:
 
1506
            self.checked_ok()
 
1507
            return
 
1508
        return datetime_to_dbus(self.last_checked_ok)
 
1509
    
 
1510
    # LastCheckerStatus - property
 
1511
    @dbus_service_property(_interface, signature="n",
 
1512
                           access="read")
 
1513
    def LastCheckerStatus_dbus_property(self):
 
1514
        return dbus.Int16(self.last_checker_status)
 
1515
    
 
1516
    # Expires - property
 
1517
    @dbus_service_property(_interface, signature="s", access="read")
 
1518
    def Expires_dbus_property(self):
 
1519
        return datetime_to_dbus(self.expires)
 
1520
    
 
1521
    # LastApprovalRequest - property
 
1522
    @dbus_service_property(_interface, signature="s", access="read")
 
1523
    def LastApprovalRequest_dbus_property(self):
 
1524
        return datetime_to_dbus(self.last_approval_request)
 
1525
    
 
1526
    # Timeout - property
 
1527
    @dbus_service_property(_interface, signature="t",
 
1528
                           access="readwrite")
 
1529
    def Timeout_dbus_property(self, value=None):
 
1530
        if value is None:       # get
 
1531
            return dbus.UInt64(self.timeout_milliseconds())
 
1532
        self.timeout = datetime.timedelta(0, 0, 0, value)
 
1533
        # Reschedule timeout
 
1534
        if self.enabled:
 
1535
            now = datetime.datetime.utcnow()
 
1536
            time_to_die = timedelta_to_milliseconds(
 
1537
                (self.last_checked_ok + self.timeout) - now)
 
1538
            if time_to_die <= 0:
 
1539
                # The timeout has passed
 
1540
                self.disable()
 
1541
            else:
 
1542
                self.expires = (now +
 
1543
                                datetime.timedelta(milliseconds =
 
1544
                                                   time_to_die))
 
1545
                if (getattr(self, "disable_initiator_tag", None)
 
1546
                    is None):
 
1547
                    return
 
1548
                gobject.source_remove(self.disable_initiator_tag)
 
1549
                self.disable_initiator_tag = (gobject.timeout_add
 
1550
                                              (time_to_die,
 
1551
                                               self.disable))
 
1552
    
 
1553
    # ExtendedTimeout - property
 
1554
    @dbus_service_property(_interface, signature="t",
 
1555
                           access="readwrite")
 
1556
    def ExtendedTimeout_dbus_property(self, value=None):
 
1557
        if value is None:       # get
 
1558
            return dbus.UInt64(self.extended_timeout_milliseconds())
 
1559
        self.extended_timeout = datetime.timedelta(0, 0, 0, value)
 
1560
    
 
1561
    # Interval - property
 
1562
    @dbus_service_property(_interface, signature="t",
 
1563
                           access="readwrite")
 
1564
    def Interval_dbus_property(self, value=None):
 
1565
        if value is None:       # get
 
1566
            return dbus.UInt64(self.interval_milliseconds())
 
1567
        self.interval = datetime.timedelta(0, 0, 0, value)
 
1568
        if getattr(self, "checker_initiator_tag", None) is None:
 
1569
            return
 
1570
        if self.enabled:
 
1571
            # Reschedule checker run
 
1572
            gobject.source_remove(self.checker_initiator_tag)
 
1573
            self.checker_initiator_tag = (gobject.timeout_add
 
1574
                                          (value, self.start_checker))
 
1575
            self.start_checker()    # Start one now, too
 
1576
    
 
1577
    # Checker - property
 
1578
    @dbus_service_property(_interface, signature="s",
 
1579
                           access="readwrite")
 
1580
    def Checker_dbus_property(self, value=None):
 
1581
        if value is None:       # get
 
1582
            return dbus.String(self.checker_command)
 
1583
        self.checker_command = unicode(value)
 
1584
    
 
1585
    # CheckerRunning - property
 
1586
    @dbus_service_property(_interface, signature="b",
 
1587
                           access="readwrite")
 
1588
    def CheckerRunning_dbus_property(self, value=None):
 
1589
        if value is None:       # get
 
1590
            return dbus.Boolean(self.checker is not None)
 
1591
        if value:
 
1592
            self.start_checker()
 
1593
        else:
 
1594
            self.stop_checker()
 
1595
    
 
1596
    # ObjectPath - property
 
1597
    @dbus_service_property(_interface, signature="o", access="read")
 
1598
    def ObjectPath_dbus_property(self):
 
1599
        return self.dbus_object_path # is already a dbus.ObjectPath
 
1600
    
 
1601
    # Secret = property
 
1602
    @dbus_service_property(_interface, signature="ay",
 
1603
                           access="write", byte_arrays=True)
 
1604
    def Secret_dbus_property(self, value):
 
1605
        self.secret = str(value)
 
1606
    
 
1607
    del _interface
 
1608
 
 
1609
 
 
1610
class ProxyClient(object):
 
1611
    def __init__(self, child_pipe, fpr, address):
 
1612
        self._pipe = child_pipe
 
1613
        self._pipe.send(('init', fpr, address))
 
1614
        if not self._pipe.recv():
 
1615
            raise KeyError()
 
1616
    
 
1617
    def __getattribute__(self, name):
 
1618
        if name == '_pipe':
 
1619
            return super(ProxyClient, self).__getattribute__(name)
 
1620
        self._pipe.send(('getattr', name))
 
1621
        data = self._pipe.recv()
 
1622
        if data[0] == 'data':
 
1623
            return data[1]
 
1624
        if data[0] == 'function':
 
1625
            def func(*args, **kwargs):
 
1626
                self._pipe.send(('funcall', name, args, kwargs))
 
1627
                return self._pipe.recv()[1]
 
1628
            return func
 
1629
    
 
1630
    def __setattr__(self, name, value):
 
1631
        if name == '_pipe':
 
1632
            return super(ProxyClient, self).__setattr__(name, value)
 
1633
        self._pipe.send(('setattr', name, value))
 
1634
 
 
1635
 
 
1636
class ClientHandler(socketserver.BaseRequestHandler, object):
 
1637
    """A class to handle client connections.
 
1638
    
 
1639
    Instantiated once for each connection to handle it.
441
1640
    Note: This will run in its own forked process."""
442
1641
    
443
1642
    def handle(self):
444
 
        logger.info(u"TCP connection from: %s",
445
 
                     unicode(self.client_address))
446
 
        session = gnutls.connection.ClientSession\
447
 
                  (self.request, gnutls.connection.X509Credentials())
448
 
        
449
 
        line = self.request.makefile().readline()
450
 
        logger.debug(u"Protocol version: %r", line)
451
 
        try:
452
 
            if int(line.strip().split()[0]) > 1:
453
 
                raise RuntimeError
454
 
        except (ValueError, IndexError, RuntimeError), error:
455
 
            logger.error(u"Unknown protocol version: %s", error)
456
 
            return
457
 
        
458
 
        # Note: gnutls.connection.X509Credentials is really a generic
459
 
        # GnuTLS certificate credentials object so long as no X.509
460
 
        # keys are added to it.  Therefore, we can use it here despite
461
 
        # using OpenPGP certificates.
462
 
        
463
 
        #priority = ':'.join(("NONE", "+VERS-TLS1.1", "+AES-256-CBC",
464
 
        #                "+SHA1", "+COMP-NULL", "+CTYPE-OPENPGP",
465
 
        #                "+DHE-DSS"))
466
 
        priority = "NORMAL"             # Fallback default, since this
467
 
                                        # MUST be set.
468
 
        if self.server.settings["priority"]:
469
 
            priority = self.server.settings["priority"]
470
 
        gnutls.library.functions.gnutls_priority_set_direct\
471
 
            (session._c_object, priority, None);
472
 
        
473
 
        try:
474
 
            session.handshake()
475
 
        except gnutls.errors.GNUTLSError, error:
476
 
            logger.warning(u"Handshake failed: %s", error)
477
 
            # Do not run session.bye() here: the session is not
478
 
            # established.  Just abandon the request.
479
 
            return
480
 
        try:
481
 
            fpr = fingerprint(peer_certificate(session))
482
 
        except (TypeError, gnutls.errors.GNUTLSError), error:
483
 
            logger.warning(u"Bad certificate: %s", error)
484
 
            session.bye()
485
 
            return
486
 
        logger.debug(u"Fingerprint: %s", fpr)
487
 
        client = None
488
 
        for c in self.server.clients:
489
 
            if c.fingerprint == fpr:
490
 
                client = c
491
 
                break
492
 
        if not client:
493
 
            logger.warning(u"Client not found for fingerprint: %s",
494
 
                           fpr)
495
 
            session.bye()
496
 
            return
497
 
        # Have to check if client.still_valid(), since it is possible
498
 
        # that the client timed out while establishing the GnuTLS
499
 
        # session.
500
 
        if not client.still_valid():
501
 
            logger.warning(u"Client %(name)s is invalid",
502
 
                           vars(client))
503
 
            session.bye()
504
 
            return
505
 
        sent_size = 0
506
 
        while sent_size < len(client.secret):
507
 
            sent = session.send(client.secret[sent_size:])
508
 
            logger.debug(u"Sent: %d, remaining: %d",
509
 
                         sent, len(client.secret)
510
 
                         - (sent_size + sent))
511
 
            sent_size += sent
512
 
        session.bye()
513
 
 
514
 
 
515
 
class IPv6_TCPServer(SocketServer.ForkingTCPServer, object):
516
 
    """IPv6 TCP server.  Accepts 'None' as address and/or port.
 
1643
        with contextlib.closing(self.server.child_pipe) as child_pipe:
 
1644
            logger.info("TCP connection from: %s",
 
1645
                        unicode(self.client_address))
 
1646
            logger.debug("Pipe FD: %d",
 
1647
                         self.server.child_pipe.fileno())
 
1648
            
 
1649
            session = (gnutls.connection
 
1650
                       .ClientSession(self.request,
 
1651
                                      gnutls.connection
 
1652
                                      .X509Credentials()))
 
1653
            
 
1654
            # Note: gnutls.connection.X509Credentials is really a
 
1655
            # generic GnuTLS certificate credentials object so long as
 
1656
            # no X.509 keys are added to it.  Therefore, we can use it
 
1657
            # here despite using OpenPGP certificates.
 
1658
            
 
1659
            #priority = ':'.join(("NONE", "+VERS-TLS1.1",
 
1660
            #                      "+AES-256-CBC", "+SHA1",
 
1661
            #                      "+COMP-NULL", "+CTYPE-OPENPGP",
 
1662
            #                      "+DHE-DSS"))
 
1663
            # Use a fallback default, since this MUST be set.
 
1664
            priority = self.server.gnutls_priority
 
1665
            if priority is None:
 
1666
                priority = "NORMAL"
 
1667
            (gnutls.library.functions
 
1668
             .gnutls_priority_set_direct(session._c_object,
 
1669
                                         priority, None))
 
1670
            
 
1671
            # Start communication using the Mandos protocol
 
1672
            # Get protocol number
 
1673
            line = self.request.makefile().readline()
 
1674
            logger.debug("Protocol version: %r", line)
 
1675
            try:
 
1676
                if int(line.strip().split()[0]) > 1:
 
1677
                    raise RuntimeError
 
1678
            except (ValueError, IndexError, RuntimeError) as error:
 
1679
                logger.error("Unknown protocol version: %s", error)
 
1680
                return
 
1681
            
 
1682
            # Start GnuTLS connection
 
1683
            try:
 
1684
                session.handshake()
 
1685
            except gnutls.errors.GNUTLSError as error:
 
1686
                logger.warning("Handshake failed: %s", error)
 
1687
                # Do not run session.bye() here: the session is not
 
1688
                # established.  Just abandon the request.
 
1689
                return
 
1690
            logger.debug("Handshake succeeded")
 
1691
            
 
1692
            approval_required = False
 
1693
            try:
 
1694
                try:
 
1695
                    fpr = self.fingerprint(self.peer_certificate
 
1696
                                           (session))
 
1697
                except (TypeError,
 
1698
                        gnutls.errors.GNUTLSError) as error:
 
1699
                    logger.warning("Bad certificate: %s", error)
 
1700
                    return
 
1701
                logger.debug("Fingerprint: %s", fpr)
 
1702
                
 
1703
                try:
 
1704
                    client = ProxyClient(child_pipe, fpr,
 
1705
                                         self.client_address)
 
1706
                except KeyError:
 
1707
                    return
 
1708
                
 
1709
                if client.approval_delay:
 
1710
                    delay = client.approval_delay
 
1711
                    client.approvals_pending += 1
 
1712
                    approval_required = True
 
1713
                
 
1714
                while True:
 
1715
                    if not client.enabled:
 
1716
                        logger.info("Client %s is disabled",
 
1717
                                       client.name)
 
1718
                        if self.server.use_dbus:
 
1719
                            # Emit D-Bus signal
 
1720
                            client.Rejected("Disabled")
 
1721
                        return
 
1722
                    
 
1723
                    if client.approved or not client.approval_delay:
 
1724
                        #We are approved or approval is disabled
 
1725
                        break
 
1726
                    elif client.approved is None:
 
1727
                        logger.info("Client %s needs approval",
 
1728
                                    client.name)
 
1729
                        if self.server.use_dbus:
 
1730
                            # Emit D-Bus signal
 
1731
                            client.NeedApproval(
 
1732
                                client.approval_delay_milliseconds(),
 
1733
                                client.approved_by_default)
 
1734
                    else:
 
1735
                        logger.warning("Client %s was not approved",
 
1736
                                       client.name)
 
1737
                        if self.server.use_dbus:
 
1738
                            # Emit D-Bus signal
 
1739
                            client.Rejected("Denied")
 
1740
                        return
 
1741
                    
 
1742
                    #wait until timeout or approved
 
1743
                    time = datetime.datetime.now()
 
1744
                    client.changedstate.acquire()
 
1745
                    (client.changedstate.wait
 
1746
                     (float(client.timedelta_to_milliseconds(delay)
 
1747
                            / 1000)))
 
1748
                    client.changedstate.release()
 
1749
                    time2 = datetime.datetime.now()
 
1750
                    if (time2 - time) >= delay:
 
1751
                        if not client.approved_by_default:
 
1752
                            logger.warning("Client %s timed out while"
 
1753
                                           " waiting for approval",
 
1754
                                           client.name)
 
1755
                            if self.server.use_dbus:
 
1756
                                # Emit D-Bus signal
 
1757
                                client.Rejected("Approval timed out")
 
1758
                            return
 
1759
                        else:
 
1760
                            break
 
1761
                    else:
 
1762
                        delay -= time2 - time
 
1763
                
 
1764
                sent_size = 0
 
1765
                while sent_size < len(client.secret):
 
1766
                    try:
 
1767
                        sent = session.send(client.secret[sent_size:])
 
1768
                    except gnutls.errors.GNUTLSError as error:
 
1769
                        logger.warning("gnutls send failed",
 
1770
                                       exc_info=error)
 
1771
                        return
 
1772
                    logger.debug("Sent: %d, remaining: %d",
 
1773
                                 sent, len(client.secret)
 
1774
                                 - (sent_size + sent))
 
1775
                    sent_size += sent
 
1776
                
 
1777
                logger.info("Sending secret to %s", client.name)
 
1778
                # bump the timeout using extended_timeout
 
1779
                client.bump_timeout(client.extended_timeout)
 
1780
                if self.server.use_dbus:
 
1781
                    # Emit D-Bus signal
 
1782
                    client.GotSecret()
 
1783
            
 
1784
            finally:
 
1785
                if approval_required:
 
1786
                    client.approvals_pending -= 1
 
1787
                try:
 
1788
                    session.bye()
 
1789
                except gnutls.errors.GNUTLSError as error:
 
1790
                    logger.warning("GnuTLS bye failed",
 
1791
                                   exc_info=error)
 
1792
    
 
1793
    @staticmethod
 
1794
    def peer_certificate(session):
 
1795
        "Return the peer's OpenPGP certificate as a bytestring"
 
1796
        # If not an OpenPGP certificate...
 
1797
        if (gnutls.library.functions
 
1798
            .gnutls_certificate_type_get(session._c_object)
 
1799
            != gnutls.library.constants.GNUTLS_CRT_OPENPGP):
 
1800
            # ...do the normal thing
 
1801
            return session.peer_certificate
 
1802
        list_size = ctypes.c_uint(1)
 
1803
        cert_list = (gnutls.library.functions
 
1804
                     .gnutls_certificate_get_peers
 
1805
                     (session._c_object, ctypes.byref(list_size)))
 
1806
        if not bool(cert_list) and list_size.value != 0:
 
1807
            raise gnutls.errors.GNUTLSError("error getting peer"
 
1808
                                            " certificate")
 
1809
        if list_size.value == 0:
 
1810
            return None
 
1811
        cert = cert_list[0]
 
1812
        return ctypes.string_at(cert.data, cert.size)
 
1813
    
 
1814
    @staticmethod
 
1815
    def fingerprint(openpgp):
 
1816
        "Convert an OpenPGP bytestring to a hexdigit fingerprint"
 
1817
        # New GnuTLS "datum" with the OpenPGP public key
 
1818
        datum = (gnutls.library.types
 
1819
                 .gnutls_datum_t(ctypes.cast(ctypes.c_char_p(openpgp),
 
1820
                                             ctypes.POINTER
 
1821
                                             (ctypes.c_ubyte)),
 
1822
                                 ctypes.c_uint(len(openpgp))))
 
1823
        # New empty GnuTLS certificate
 
1824
        crt = gnutls.library.types.gnutls_openpgp_crt_t()
 
1825
        (gnutls.library.functions
 
1826
         .gnutls_openpgp_crt_init(ctypes.byref(crt)))
 
1827
        # Import the OpenPGP public key into the certificate
 
1828
        (gnutls.library.functions
 
1829
         .gnutls_openpgp_crt_import(crt, ctypes.byref(datum),
 
1830
                                    gnutls.library.constants
 
1831
                                    .GNUTLS_OPENPGP_FMT_RAW))
 
1832
        # Verify the self signature in the key
 
1833
        crtverify = ctypes.c_uint()
 
1834
        (gnutls.library.functions
 
1835
         .gnutls_openpgp_crt_verify_self(crt, 0,
 
1836
                                         ctypes.byref(crtverify)))
 
1837
        if crtverify.value != 0:
 
1838
            gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
 
1839
            raise (gnutls.errors.CertificateSecurityError
 
1840
                   ("Verify failed"))
 
1841
        # New buffer for the fingerprint
 
1842
        buf = ctypes.create_string_buffer(20)
 
1843
        buf_len = ctypes.c_size_t()
 
1844
        # Get the fingerprint from the certificate into the buffer
 
1845
        (gnutls.library.functions
 
1846
         .gnutls_openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),
 
1847
                                             ctypes.byref(buf_len)))
 
1848
        # Deinit the certificate
 
1849
        gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
 
1850
        # Convert the buffer to a Python bytestring
 
1851
        fpr = ctypes.string_at(buf, buf_len.value)
 
1852
        # Convert the bytestring to hexadecimal notation
 
1853
        hex_fpr = binascii.hexlify(fpr).upper()
 
1854
        return hex_fpr
 
1855
 
 
1856
 
 
1857
class MultiprocessingMixIn(object):
 
1858
    """Like socketserver.ThreadingMixIn, but with multiprocessing"""
 
1859
    def sub_process_main(self, request, address):
 
1860
        try:
 
1861
            self.finish_request(request, address)
 
1862
        except Exception:
 
1863
            self.handle_error(request, address)
 
1864
        self.close_request(request)
 
1865
    
 
1866
    def process_request(self, request, address):
 
1867
        """Start a new process to process the request."""
 
1868
        proc = multiprocessing.Process(target = self.sub_process_main,
 
1869
                                       args = (request, address))
 
1870
        proc.start()
 
1871
        return proc
 
1872
 
 
1873
 
 
1874
class MultiprocessingMixInWithPipe(MultiprocessingMixIn, object):
 
1875
    """ adds a pipe to the MixIn """
 
1876
    def process_request(self, request, client_address):
 
1877
        """Overrides and wraps the original process_request().
 
1878
        
 
1879
        This function creates a new pipe in self.pipe
 
1880
        """
 
1881
        parent_pipe, self.child_pipe = multiprocessing.Pipe()
 
1882
        
 
1883
        proc = MultiprocessingMixIn.process_request(self, request,
 
1884
                                                    client_address)
 
1885
        self.child_pipe.close()
 
1886
        self.add_pipe(parent_pipe, proc)
 
1887
    
 
1888
    def add_pipe(self, parent_pipe, proc):
 
1889
        """Dummy function; override as necessary"""
 
1890
        raise NotImplementedError
 
1891
 
 
1892
 
 
1893
class IPv6_TCPServer(MultiprocessingMixInWithPipe,
 
1894
                     socketserver.TCPServer, object):
 
1895
    """IPv6-capable TCP server.  Accepts 'None' as address and/or port
 
1896
    
517
1897
    Attributes:
518
 
        settings:       Server settings
519
 
        clients:        Set() of Client objects
 
1898
        enabled:        Boolean; whether this server is activated yet
 
1899
        interface:      None or a network interface name (string)
 
1900
        use_ipv6:       Boolean; to use IPv6 or not
520
1901
    """
521
 
    address_family = socket.AF_INET6
522
 
    def __init__(self, *args, **kwargs):
523
 
        if "settings" in kwargs:
524
 
            self.settings = kwargs["settings"]
525
 
            del kwargs["settings"]
526
 
        if "clients" in kwargs:
527
 
            self.clients = kwargs["clients"]
528
 
            del kwargs["clients"]
529
 
        return super(type(self), self).__init__(*args, **kwargs)
 
1902
    def __init__(self, server_address, RequestHandlerClass,
 
1903
                 interface=None, use_ipv6=True):
 
1904
        self.interface = interface
 
1905
        if use_ipv6:
 
1906
            self.address_family = socket.AF_INET6
 
1907
        socketserver.TCPServer.__init__(self, server_address,
 
1908
                                        RequestHandlerClass)
530
1909
    def server_bind(self):
531
1910
        """This overrides the normal server_bind() function
532
1911
        to bind to an interface if one was specified, and also NOT to
533
1912
        bind to an address or port if they were not specified."""
534
 
        if self.settings["interface"]:
535
 
            # 25 is from /usr/include/asm-i486/socket.h
536
 
            SO_BINDTODEVICE = getattr(socket, "SO_BINDTODEVICE", 25)
537
 
            try:
538
 
                self.socket.setsockopt(socket.SOL_SOCKET,
539
 
                                       SO_BINDTODEVICE,
540
 
                                       self.settings["interface"])
541
 
            except socket.error, error:
542
 
                if error[0] == errno.EPERM:
543
 
                    logger.error(u"No permission to"
544
 
                                 u" bind to interface %s",
545
 
                                 self.settings["interface"])
546
 
                else:
547
 
                    raise error
 
1913
        if self.interface is not None:
 
1914
            if SO_BINDTODEVICE is None:
 
1915
                logger.error("SO_BINDTODEVICE does not exist;"
 
1916
                             " cannot bind to interface %s",
 
1917
                             self.interface)
 
1918
            else:
 
1919
                try:
 
1920
                    self.socket.setsockopt(socket.SOL_SOCKET,
 
1921
                                           SO_BINDTODEVICE,
 
1922
                                           str(self.interface
 
1923
                                               + '\0'))
 
1924
                except socket.error as error:
 
1925
                    if error[0] == errno.EPERM:
 
1926
                        logger.error("No permission to"
 
1927
                                     " bind to interface %s",
 
1928
                                     self.interface)
 
1929
                    elif error[0] == errno.ENOPROTOOPT:
 
1930
                        logger.error("SO_BINDTODEVICE not available;"
 
1931
                                     " cannot bind to interface %s",
 
1932
                                     self.interface)
 
1933
                    else:
 
1934
                        raise
548
1935
        # Only bind(2) the socket if we really need to.
549
1936
        if self.server_address[0] or self.server_address[1]:
550
1937
            if not self.server_address[0]:
551
 
                in6addr_any = "::"
552
 
                self.server_address = (in6addr_any,
 
1938
                if self.address_family == socket.AF_INET6:
 
1939
                    any_address = "::" # in6addr_any
 
1940
                else:
 
1941
                    any_address = socket.INADDR_ANY
 
1942
                self.server_address = (any_address,
553
1943
                                       self.server_address[1])
554
1944
            elif not self.server_address[1]:
555
1945
                self.server_address = (self.server_address[0],
556
1946
                                       0)
557
 
#                 if self.settings["interface"]:
 
1947
#                 if self.interface:
558
1948
#                     self.server_address = (self.server_address[0],
559
1949
#                                            0, # port
560
1950
#                                            0, # flowinfo
561
1951
#                                            if_nametoindex
562
 
#                                            (self.settings
563
 
#                                             ["interface"]))
564
 
            return super(type(self), self).server_bind()
 
1952
#                                            (self.interface))
 
1953
            return socketserver.TCPServer.server_bind(self)
 
1954
 
 
1955
 
 
1956
class MandosServer(IPv6_TCPServer):
 
1957
    """Mandos server.
 
1958
    
 
1959
    Attributes:
 
1960
        clients:        set of Client objects
 
1961
        gnutls_priority GnuTLS priority string
 
1962
        use_dbus:       Boolean; to emit D-Bus signals or not
 
1963
    
 
1964
    Assumes a gobject.MainLoop event loop.
 
1965
    """
 
1966
    def __init__(self, server_address, RequestHandlerClass,
 
1967
                 interface=None, use_ipv6=True, clients=None,
 
1968
                 gnutls_priority=None, use_dbus=True):
 
1969
        self.enabled = False
 
1970
        self.clients = clients
 
1971
        if self.clients is None:
 
1972
            self.clients = {}
 
1973
        self.use_dbus = use_dbus
 
1974
        self.gnutls_priority = gnutls_priority
 
1975
        IPv6_TCPServer.__init__(self, server_address,
 
1976
                                RequestHandlerClass,
 
1977
                                interface = interface,
 
1978
                                use_ipv6 = use_ipv6)
 
1979
    def server_activate(self):
 
1980
        if self.enabled:
 
1981
            return socketserver.TCPServer.server_activate(self)
 
1982
    
 
1983
    def enable(self):
 
1984
        self.enabled = True
 
1985
    
 
1986
    def add_pipe(self, parent_pipe, proc):
 
1987
        # Call "handle_ipc" for both data and EOF events
 
1988
        gobject.io_add_watch(parent_pipe.fileno(),
 
1989
                             gobject.IO_IN | gobject.IO_HUP,
 
1990
                             functools.partial(self.handle_ipc,
 
1991
                                               parent_pipe =
 
1992
                                               parent_pipe,
 
1993
                                               proc = proc))
 
1994
    
 
1995
    def handle_ipc(self, source, condition, parent_pipe=None,
 
1996
                   proc = None, client_object=None):
 
1997
        # error, or the other end of multiprocessing.Pipe has closed
 
1998
        if condition & (gobject.IO_ERR | gobject.IO_HUP):
 
1999
            # Wait for other process to exit
 
2000
            proc.join()
 
2001
            return False
 
2002
        
 
2003
        # Read a request from the child
 
2004
        request = parent_pipe.recv()
 
2005
        command = request[0]
 
2006
        
 
2007
        if command == 'init':
 
2008
            fpr = request[1]
 
2009
            address = request[2]
 
2010
            
 
2011
            for c in self.clients.itervalues():
 
2012
                if c.fingerprint == fpr:
 
2013
                    client = c
 
2014
                    break
 
2015
            else:
 
2016
                logger.info("Client not found for fingerprint: %s, ad"
 
2017
                            "dress: %s", fpr, address)
 
2018
                if self.use_dbus:
 
2019
                    # Emit D-Bus signal
 
2020
                    mandos_dbus_service.ClientNotFound(fpr,
 
2021
                                                       address[0])
 
2022
                parent_pipe.send(False)
 
2023
                return False
 
2024
            
 
2025
            gobject.io_add_watch(parent_pipe.fileno(),
 
2026
                                 gobject.IO_IN | gobject.IO_HUP,
 
2027
                                 functools.partial(self.handle_ipc,
 
2028
                                                   parent_pipe =
 
2029
                                                   parent_pipe,
 
2030
                                                   proc = proc,
 
2031
                                                   client_object =
 
2032
                                                   client))
 
2033
            parent_pipe.send(True)
 
2034
            # remove the old hook in favor of the new above hook on
 
2035
            # same fileno
 
2036
            return False
 
2037
        if command == 'funcall':
 
2038
            funcname = request[1]
 
2039
            args = request[2]
 
2040
            kwargs = request[3]
 
2041
            
 
2042
            parent_pipe.send(('data', getattr(client_object,
 
2043
                                              funcname)(*args,
 
2044
                                                         **kwargs)))
 
2045
        
 
2046
        if command == 'getattr':
 
2047
            attrname = request[1]
 
2048
            if callable(client_object.__getattribute__(attrname)):
 
2049
                parent_pipe.send(('function',))
 
2050
            else:
 
2051
                parent_pipe.send(('data', client_object
 
2052
                                  .__getattribute__(attrname)))
 
2053
        
 
2054
        if command == 'setattr':
 
2055
            attrname = request[1]
 
2056
            value = request[2]
 
2057
            setattr(client_object, attrname, value)
 
2058
        
 
2059
        return True
565
2060
 
566
2061
 
567
2062
def string_to_delta(interval):
568
2063
    """Parse a string and return a datetime.timedelta
569
 
 
 
2064
    
570
2065
    >>> string_to_delta('7d')
571
2066
    datetime.timedelta(7)
572
2067
    >>> string_to_delta('60s')
575
2070
    datetime.timedelta(0, 3600)
576
2071
    >>> string_to_delta('24h')
577
2072
    datetime.timedelta(1)
578
 
    >>> string_to_delta(u'1w')
 
2073
    >>> string_to_delta('1w')
579
2074
    datetime.timedelta(7)
580
2075
    >>> string_to_delta('5m 30s')
581
2076
    datetime.timedelta(0, 330)
583
2078
    timevalue = datetime.timedelta(0)
584
2079
    for s in interval.split():
585
2080
        try:
586
 
            suffix=unicode(s[-1])
587
 
            value=int(s[:-1])
588
 
            if suffix == u"d":
 
2081
            suffix = unicode(s[-1])
 
2082
            value = int(s[:-1])
 
2083
            if suffix == "d":
589
2084
                delta = datetime.timedelta(value)
590
 
            elif suffix == u"s":
 
2085
            elif suffix == "s":
591
2086
                delta = datetime.timedelta(0, value)
592
 
            elif suffix == u"m":
 
2087
            elif suffix == "m":
593
2088
                delta = datetime.timedelta(0, 0, 0, 0, value)
594
 
            elif suffix == u"h":
 
2089
            elif suffix == "h":
595
2090
                delta = datetime.timedelta(0, 0, 0, 0, 0, value)
596
 
            elif suffix == u"w":
 
2091
            elif suffix == "w":
597
2092
                delta = datetime.timedelta(0, 0, 0, 0, 0, 0, value)
598
2093
            else:
599
 
                raise ValueError
600
 
        except (ValueError, IndexError):
601
 
            raise ValueError
 
2094
                raise ValueError("Unknown suffix {0!r}"
 
2095
                                 .format(suffix))
 
2096
        except (ValueError, IndexError) as e:
 
2097
            raise ValueError(*(e.args))
602
2098
        timevalue += delta
603
2099
    return timevalue
604
2100
 
605
2101
 
606
 
def server_state_changed(state):
607
 
    """Derived from the Avahi example code"""
608
 
    if state == avahi.SERVER_COLLISION:
609
 
        logger.error(u"Zeroconf server name collision")
610
 
        service.remove()
611
 
    elif state == avahi.SERVER_RUNNING:
612
 
        service.add()
613
 
 
614
 
 
615
 
def entry_group_state_changed(state, error):
616
 
    """Derived from the Avahi example code"""
617
 
    logger.debug(u"Avahi state change: %i", state)
618
 
    
619
 
    if state == avahi.ENTRY_GROUP_ESTABLISHED:
620
 
        logger.debug(u"Zeroconf service established.")
621
 
    elif state == avahi.ENTRY_GROUP_COLLISION:
622
 
        logger.warning(u"Zeroconf service name collision.")
623
 
        service.rename()
624
 
    elif state == avahi.ENTRY_GROUP_FAILURE:
625
 
        logger.critical(u"Avahi: Error in group state changed %s",
626
 
                        unicode(error))
627
 
        raise AvahiGroupError("State changed: %s", str(error))
628
 
 
629
 
def if_nametoindex(interface):
630
 
    """Call the C function if_nametoindex(), or equivalent"""
631
 
    global if_nametoindex
632
 
    try:
633
 
        if "ctypes.util" not in sys.modules:
634
 
            import ctypes.util
635
 
        if_nametoindex = ctypes.cdll.LoadLibrary\
636
 
            (ctypes.util.find_library("c")).if_nametoindex
637
 
    except (OSError, AttributeError):
638
 
        if "struct" not in sys.modules:
639
 
            import struct
640
 
        if "fcntl" not in sys.modules:
641
 
            import fcntl
642
 
        def if_nametoindex(interface):
643
 
            "Get an interface index the hard way, i.e. using fcntl()"
644
 
            SIOCGIFINDEX = 0x8933  # From /usr/include/linux/sockios.h
645
 
            s = socket.socket()
646
 
            ifreq = fcntl.ioctl(s, SIOCGIFINDEX,
647
 
                                struct.pack("16s16x", interface))
648
 
            s.close()
649
 
            interface_index = struct.unpack("I", ifreq[16:20])[0]
650
 
            return interface_index
651
 
    return if_nametoindex(interface)
652
 
 
653
 
 
654
2102
def daemon(nochdir = False, noclose = False):
655
2103
    """See daemon(3).  Standard BSD Unix function.
 
2104
    
656
2105
    This should really exist as os.daemon, but it doesn't (yet)."""
657
2106
    if os.fork():
658
2107
        sys.exit()
663
2112
        sys.exit()
664
2113
    if not noclose:
665
2114
        # Close all standard open file descriptors
666
 
        null = os.open(os.path.devnull, os.O_NOCTTY | os.O_RDWR)
 
2115
        null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)
667
2116
        if not stat.S_ISCHR(os.fstat(null).st_mode):
668
2117
            raise OSError(errno.ENODEV,
669
 
                          "/dev/null not a character device")
 
2118
                          "{0} not a character device"
 
2119
                          .format(os.devnull))
670
2120
        os.dup2(null, sys.stdin.fileno())
671
2121
        os.dup2(null, sys.stdout.fileno())
672
2122
        os.dup2(null, sys.stderr.fileno())
675
2125
 
676
2126
 
677
2127
def main():
678
 
    global main_loop_started
679
 
    main_loop_started = False
680
 
    
681
 
    parser = OptionParser(version = "%%prog %s" % version)
682
 
    parser.add_option("-i", "--interface", type="string",
683
 
                      metavar="IF", help="Bind to interface IF")
684
 
    parser.add_option("-a", "--address", type="string",
685
 
                      help="Address to listen for requests on")
686
 
    parser.add_option("-p", "--port", type="int",
687
 
                      help="Port number to receive requests on")
688
 
    parser.add_option("--check", action="store_true", default=False,
689
 
                      help="Run self-test")
690
 
    parser.add_option("--debug", action="store_true",
691
 
                      help="Debug mode; run in foreground and log to"
692
 
                      " terminal")
693
 
    parser.add_option("--priority", type="string", help="GnuTLS"
694
 
                      " priority string (see GnuTLS documentation)")
695
 
    parser.add_option("--servicename", type="string", metavar="NAME",
696
 
                      help="Zeroconf service name")
697
 
    parser.add_option("--configdir", type="string",
698
 
                      default="/etc/mandos", metavar="DIR",
699
 
                      help="Directory to search for configuration"
700
 
                      " files")
701
 
    (options, args) = parser.parse_args()
 
2128
    
 
2129
    ##################################################################
 
2130
    # Parsing of options, both command line and config file
 
2131
    
 
2132
    parser = argparse.ArgumentParser()
 
2133
    parser.add_argument("-v", "--version", action="version",
 
2134
                        version = "%(prog)s {0}".format(version),
 
2135
                        help="show version number and exit")
 
2136
    parser.add_argument("-i", "--interface", metavar="IF",
 
2137
                        help="Bind to interface IF")
 
2138
    parser.add_argument("-a", "--address",
 
2139
                        help="Address to listen for requests on")
 
2140
    parser.add_argument("-p", "--port", type=int,
 
2141
                        help="Port number to receive requests on")
 
2142
    parser.add_argument("--check", action="store_true",
 
2143
                        help="Run self-test")
 
2144
    parser.add_argument("--debug", action="store_true",
 
2145
                        help="Debug mode; run in foreground and log"
 
2146
                        " to terminal")
 
2147
    parser.add_argument("--debuglevel", metavar="LEVEL",
 
2148
                        help="Debug level for stdout output")
 
2149
    parser.add_argument("--priority", help="GnuTLS"
 
2150
                        " priority string (see GnuTLS documentation)")
 
2151
    parser.add_argument("--servicename",
 
2152
                        metavar="NAME", help="Zeroconf service name")
 
2153
    parser.add_argument("--configdir",
 
2154
                        default="/etc/mandos", metavar="DIR",
 
2155
                        help="Directory to search for configuration"
 
2156
                        " files")
 
2157
    parser.add_argument("--no-dbus", action="store_false",
 
2158
                        dest="use_dbus", help="Do not provide D-Bus"
 
2159
                        " system bus interface")
 
2160
    parser.add_argument("--no-ipv6", action="store_false",
 
2161
                        dest="use_ipv6", help="Do not use IPv6")
 
2162
    parser.add_argument("--no-restore", action="store_false",
 
2163
                        dest="restore", help="Do not restore stored"
 
2164
                        " state")
 
2165
    parser.add_argument("--statedir", metavar="DIR",
 
2166
                        help="Directory to save/restore state in")
 
2167
    
 
2168
    options = parser.parse_args()
702
2169
    
703
2170
    if options.check:
704
2171
        import doctest
713
2180
                        "priority":
714
2181
                        "SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP",
715
2182
                        "servicename": "Mandos",
 
2183
                        "use_dbus": "True",
 
2184
                        "use_ipv6": "True",
 
2185
                        "debuglevel": "",
 
2186
                        "restore": "True",
 
2187
                        "statedir": "/var/lib/mandos"
716
2188
                        }
717
2189
    
718
2190
    # Parse config file for server-global settings
719
 
    server_config = ConfigParser.SafeConfigParser(server_defaults)
 
2191
    server_config = configparser.SafeConfigParser(server_defaults)
720
2192
    del server_defaults
721
 
    server_config.read(os.path.join(options.configdir, "mandos.conf"))
 
2193
    server_config.read(os.path.join(options.configdir,
 
2194
                                    "mandos.conf"))
722
2195
    # Convert the SafeConfigParser object to a dict
723
2196
    server_settings = server_config.defaults()
724
 
    # Use getboolean on the boolean config option
725
 
    server_settings["debug"] = server_config.getboolean\
726
 
                               ("DEFAULT", "debug")
 
2197
    # Use the appropriate methods on the non-string config options
 
2198
    for option in ("debug", "use_dbus", "use_ipv6"):
 
2199
        server_settings[option] = server_config.getboolean("DEFAULT",
 
2200
                                                           option)
 
2201
    if server_settings["port"]:
 
2202
        server_settings["port"] = server_config.getint("DEFAULT",
 
2203
                                                       "port")
727
2204
    del server_config
728
2205
    
729
2206
    # Override the settings from the config file with command line
730
2207
    # options, if set.
731
2208
    for option in ("interface", "address", "port", "debug",
732
 
                   "priority", "servicename", "configdir"):
 
2209
                   "priority", "servicename", "configdir",
 
2210
                   "use_dbus", "use_ipv6", "debuglevel", "restore",
 
2211
                   "statedir"):
733
2212
        value = getattr(options, option)
734
2213
        if value is not None:
735
2214
            server_settings[option] = value
736
2215
    del options
 
2216
    # Force all strings to be unicode
 
2217
    for option in server_settings.keys():
 
2218
        if type(server_settings[option]) is str:
 
2219
            server_settings[option] = unicode(server_settings[option])
737
2220
    # Now we have our good server settings in "server_settings"
738
2221
    
 
2222
    ##################################################################
 
2223
    
 
2224
    # For convenience
739
2225
    debug = server_settings["debug"]
 
2226
    debuglevel = server_settings["debuglevel"]
 
2227
    use_dbus = server_settings["use_dbus"]
 
2228
    use_ipv6 = server_settings["use_ipv6"]
 
2229
    stored_state_path = os.path.join(server_settings["statedir"],
 
2230
                                     stored_state_file)
740
2231
    
741
 
    if not debug:
742
 
        syslogger.setLevel(logging.WARNING)
743
 
        console.setLevel(logging.WARNING)
 
2232
    if debug:
 
2233
        initlogger(debug, logging.DEBUG)
 
2234
    else:
 
2235
        if not debuglevel:
 
2236
            initlogger(debug)
 
2237
        else:
 
2238
            level = getattr(logging, debuglevel.upper())
 
2239
            initlogger(debug, level)
744
2240
    
745
2241
    if server_settings["servicename"] != "Mandos":
746
 
        syslogger.setFormatter(logging.Formatter\
747
 
                               ('Mandos (%s): %%(levelname)s:'
748
 
                                ' %%(message)s'
749
 
                                % server_settings["servicename"]))
 
2242
        syslogger.setFormatter(logging.Formatter
 
2243
                               ('Mandos ({0}) [%(process)d]:'
 
2244
                                ' %(levelname)s: %(message)s'
 
2245
                                .format(server_settings
 
2246
                                        ["servicename"])))
750
2247
    
751
2248
    # Parse config file with clients
752
 
    client_defaults = { "timeout": "1h",
753
 
                        "interval": "5m",
754
 
                        "checker": "fping -q -- %(host)s",
755
 
                        "host": "",
756
 
                        }
757
 
    client_config = ConfigParser.SafeConfigParser(client_defaults)
 
2249
    client_config = configparser.SafeConfigParser(Client
 
2250
                                                  .client_defaults)
758
2251
    client_config.read(os.path.join(server_settings["configdir"],
759
2252
                                    "clients.conf"))
760
2253
    
761
 
    global service
762
 
    service = AvahiService(name = server_settings["servicename"],
763
 
                           type = "_mandos._tcp", );
764
 
    if server_settings["interface"]:
765
 
        service.interface = if_nametoindex\
766
 
                            (server_settings["interface"])
 
2254
    global mandos_dbus_service
 
2255
    mandos_dbus_service = None
 
2256
    
 
2257
    tcp_server = MandosServer((server_settings["address"],
 
2258
                               server_settings["port"]),
 
2259
                              ClientHandler,
 
2260
                              interface=(server_settings["interface"]
 
2261
                                         or None),
 
2262
                              use_ipv6=use_ipv6,
 
2263
                              gnutls_priority=
 
2264
                              server_settings["priority"],
 
2265
                              use_dbus=use_dbus)
 
2266
    if not debug:
 
2267
        pidfilename = "/var/run/mandos.pid"
 
2268
        try:
 
2269
            pidfile = open(pidfilename, "w")
 
2270
        except IOError as e:
 
2271
            logger.error("Could not open file %r", pidfilename,
 
2272
                         exc_info=e)
 
2273
    
 
2274
    for name in ("_mandos", "mandos", "nobody"):
 
2275
        try:
 
2276
            uid = pwd.getpwnam(name).pw_uid
 
2277
            gid = pwd.getpwnam(name).pw_gid
 
2278
            break
 
2279
        except KeyError:
 
2280
            continue
 
2281
    else:
 
2282
        uid = 65534
 
2283
        gid = 65534
 
2284
    try:
 
2285
        os.setgid(gid)
 
2286
        os.setuid(uid)
 
2287
    except OSError as error:
 
2288
        if error[0] != errno.EPERM:
 
2289
            raise error
 
2290
    
 
2291
    if debug:
 
2292
        # Enable all possible GnuTLS debugging
 
2293
        
 
2294
        # "Use a log level over 10 to enable all debugging options."
 
2295
        # - GnuTLS manual
 
2296
        gnutls.library.functions.gnutls_global_set_log_level(11)
 
2297
        
 
2298
        @gnutls.library.types.gnutls_log_func
 
2299
        def debug_gnutls(level, string):
 
2300
            logger.debug("GnuTLS: %s", string[:-1])
 
2301
        
 
2302
        (gnutls.library.functions
 
2303
         .gnutls_global_set_log_function(debug_gnutls))
 
2304
        
 
2305
        # Redirect stdin so all checkers get /dev/null
 
2306
        null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)
 
2307
        os.dup2(null, sys.stdin.fileno())
 
2308
        if null > 2:
 
2309
            os.close(null)
 
2310
    
 
2311
    # Need to fork before connecting to D-Bus
 
2312
    if not debug:
 
2313
        # Close all input and output, do double fork, etc.
 
2314
        daemon()
 
2315
    
 
2316
    gobject.threads_init()
767
2317
    
768
2318
    global main_loop
769
 
    global bus
770
 
    global server
771
2319
    # From the Avahi example code
772
 
    DBusGMainLoop(set_as_default=True )
 
2320
    DBusGMainLoop(set_as_default=True)
773
2321
    main_loop = gobject.MainLoop()
774
2322
    bus = dbus.SystemBus()
775
 
    server = dbus.Interface(bus.get_object(avahi.DBUS_NAME,
776
 
                                           avahi.DBUS_PATH_SERVER),
777
 
                            avahi.DBUS_INTERFACE_SERVER)
778
2323
    # End of Avahi example code
779
 
    
780
 
    clients = Set()
781
 
    def remove_from_clients(client):
782
 
        clients.remove(client)
783
 
        if not clients:
784
 
            logger.critical(u"No clients left, exiting")
785
 
            sys.exit()
786
 
    
787
 
    clients.update(Set(Client(name = section,
788
 
                              stop_hook = remove_from_clients,
789
 
                              config
790
 
                              = dict(client_config.items(section)))
791
 
                       for section in client_config.sections()))
792
 
    if not clients:
793
 
        logger.critical(u"No clients defined")
794
 
        sys.exit(1)
795
 
    
796
 
    if debug:
797
 
        # Redirect stdin so all checkers get /dev/null
798
 
        null = os.open(os.path.devnull, os.O_NOCTTY | os.O_RDWR)
799
 
        os.dup2(null, sys.stdin.fileno())
800
 
        if null > 2:
801
 
            os.close(null)
802
 
    else:
803
 
        # No console logging
804
 
        logger.removeHandler(console)
805
 
        # Close all input and output, do double fork, etc.
806
 
        daemon()
807
 
    
808
 
    pidfilename = "/var/run/mandos/mandos.pid"
809
 
    pid = os.getpid()
810
 
    try:
811
 
        pidfile = open(pidfilename, "w")
812
 
        pidfile.write(str(pid) + "\n")
813
 
        pidfile.close()
814
 
        del pidfile
815
 
    except IOError, err:
816
 
        logger.error(u"Could not write %s file with PID %d",
817
 
                     pidfilename, os.getpid())
 
2324
    if use_dbus:
 
2325
        try:
 
2326
            bus_name = dbus.service.BusName("se.recompile.Mandos",
 
2327
                                            bus, do_not_queue=True)
 
2328
            old_bus_name = (dbus.service.BusName
 
2329
                            ("se.bsnet.fukt.Mandos", bus,
 
2330
                             do_not_queue=True))
 
2331
        except dbus.exceptions.NameExistsException as e:
 
2332
            logger.error("Disabling D-Bus:", exc_info=e)
 
2333
            use_dbus = False
 
2334
            server_settings["use_dbus"] = False
 
2335
            tcp_server.use_dbus = False
 
2336
    protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET
 
2337
    service = AvahiServiceToSyslog(name =
 
2338
                                   server_settings["servicename"],
 
2339
                                   servicetype = "_mandos._tcp",
 
2340
                                   protocol = protocol, bus = bus)
 
2341
    if server_settings["interface"]:
 
2342
        service.interface = (if_nametoindex
 
2343
                             (str(server_settings["interface"])))
 
2344
    
 
2345
    global multiprocessing_manager
 
2346
    multiprocessing_manager = multiprocessing.Manager()
 
2347
    
 
2348
    client_class = Client
 
2349
    if use_dbus:
 
2350
        client_class = functools.partial(ClientDBus, bus = bus)
 
2351
    
 
2352
    client_settings = Client.config_parser(client_config)
 
2353
    old_client_settings = {}
 
2354
    clients_data = {}
 
2355
    
 
2356
    # Get client data and settings from last running state.
 
2357
    if server_settings["restore"]:
 
2358
        try:
 
2359
            with open(stored_state_path, "rb") as stored_state:
 
2360
                clients_data, old_client_settings = (pickle.load
 
2361
                                                     (stored_state))
 
2362
            os.remove(stored_state_path)
 
2363
        except IOError as e:
 
2364
            if e.errno == errno.ENOENT:
 
2365
                logger.warning("Could not load persistent state: {0}"
 
2366
                                .format(os.strerror(e.errno)))
 
2367
            else:
 
2368
                logger.critical("Could not load persistent state:",
 
2369
                                exc_info=e)
 
2370
                raise
 
2371
        except EOFError as e:
 
2372
            logger.warning("Could not load persistent state: "
 
2373
                           "EOFError:", exc_info=e)
 
2374
    
 
2375
    with PGPEngine() as pgp:
 
2376
        for client_name, client in clients_data.iteritems():
 
2377
            # Decide which value to use after restoring saved state.
 
2378
            # We have three different values: Old config file,
 
2379
            # new config file, and saved state.
 
2380
            # New config value takes precedence if it differs from old
 
2381
            # config value, otherwise use saved state.
 
2382
            for name, value in client_settings[client_name].items():
 
2383
                try:
 
2384
                    # For each value in new config, check if it
 
2385
                    # differs from the old config value (Except for
 
2386
                    # the "secret" attribute)
 
2387
                    if (name != "secret" and
 
2388
                        value != old_client_settings[client_name]
 
2389
                        [name]):
 
2390
                        client[name] = value
 
2391
                except KeyError:
 
2392
                    pass
 
2393
            
 
2394
            # Clients who has passed its expire date can still be
 
2395
            # enabled if its last checker was successful.  Clients
 
2396
            # whose checker succeeded before we stored its state is
 
2397
            # assumed to have successfully run all checkers during
 
2398
            # downtime.
 
2399
            if client["enabled"]:
 
2400
                if datetime.datetime.utcnow() >= client["expires"]:
 
2401
                    if not client["last_checked_ok"]:
 
2402
                        logger.warning(
 
2403
                            "disabling client {0} - Client never "
 
2404
                            "performed a successful checker"
 
2405
                            .format(client_name))
 
2406
                        client["enabled"] = False
 
2407
                    elif client["last_checker_status"] != 0:
 
2408
                        logger.warning(
 
2409
                            "disabling client {0} - Client "
 
2410
                            "last checker failed with error code {1}"
 
2411
                            .format(client_name,
 
2412
                                    client["last_checker_status"]))
 
2413
                        client["enabled"] = False
 
2414
                    else:
 
2415
                        client["expires"] = (datetime.datetime
 
2416
                                             .utcnow()
 
2417
                                             + client["timeout"])
 
2418
                        logger.debug("Last checker succeeded,"
 
2419
                                     " keeping {0} enabled"
 
2420
                                     .format(client_name))
 
2421
            try:
 
2422
                client["secret"] = (
 
2423
                    pgp.decrypt(client["encrypted_secret"],
 
2424
                                client_settings[client_name]
 
2425
                                ["secret"]))
 
2426
            except PGPError:
 
2427
                # If decryption fails, we use secret from new settings
 
2428
                logger.debug("Failed to decrypt {0} old secret"
 
2429
                             .format(client_name))
 
2430
                client["secret"] = (
 
2431
                    client_settings[client_name]["secret"])
 
2432
    
 
2433
    # Add/remove clients based on new changes made to config
 
2434
    for client_name in (set(old_client_settings)
 
2435
                        - set(client_settings)):
 
2436
        del clients_data[client_name]
 
2437
    for client_name in (set(client_settings)
 
2438
                        - set(old_client_settings)):
 
2439
        clients_data[client_name] = client_settings[client_name]
 
2440
    
 
2441
    # Create all client objects
 
2442
    for client_name, client in clients_data.iteritems():
 
2443
        tcp_server.clients[client_name] = client_class(
 
2444
            name = client_name, settings = client)
 
2445
    
 
2446
    if not tcp_server.clients:
 
2447
        logger.warning("No clients defined")
 
2448
    
 
2449
    if not debug:
 
2450
        try:
 
2451
            with pidfile:
 
2452
                pid = os.getpid()
 
2453
                pidfile.write(str(pid) + "\n".encode("utf-8"))
 
2454
            del pidfile
 
2455
        except IOError:
 
2456
            logger.error("Could not write to file %r with PID %d",
 
2457
                         pidfilename, pid)
 
2458
        except NameError:
 
2459
            # "pidfile" was never created
 
2460
            pass
 
2461
        del pidfilename
 
2462
        signal.signal(signal.SIGINT, signal.SIG_IGN)
 
2463
    
 
2464
    signal.signal(signal.SIGHUP, lambda signum, frame: sys.exit())
 
2465
    signal.signal(signal.SIGTERM, lambda signum, frame: sys.exit())
 
2466
    
 
2467
    if use_dbus:
 
2468
        @alternate_dbus_interfaces({"se.recompile.Mandos":
 
2469
                                        "se.bsnet.fukt.Mandos"})
 
2470
        class MandosDBusService(DBusObjectWithProperties):
 
2471
            """A D-Bus proxy object"""
 
2472
            def __init__(self):
 
2473
                dbus.service.Object.__init__(self, bus, "/")
 
2474
            _interface = "se.recompile.Mandos"
 
2475
            
 
2476
            @dbus_interface_annotations(_interface)
 
2477
            def _foo(self):
 
2478
                return { "org.freedesktop.DBus.Property"
 
2479
                         ".EmitsChangedSignal":
 
2480
                             "false"}
 
2481
            
 
2482
            @dbus.service.signal(_interface, signature="o")
 
2483
            def ClientAdded(self, objpath):
 
2484
                "D-Bus signal"
 
2485
                pass
 
2486
            
 
2487
            @dbus.service.signal(_interface, signature="ss")
 
2488
            def ClientNotFound(self, fingerprint, address):
 
2489
                "D-Bus signal"
 
2490
                pass
 
2491
            
 
2492
            @dbus.service.signal(_interface, signature="os")
 
2493
            def ClientRemoved(self, objpath, name):
 
2494
                "D-Bus signal"
 
2495
                pass
 
2496
            
 
2497
            @dbus.service.method(_interface, out_signature="ao")
 
2498
            def GetAllClients(self):
 
2499
                "D-Bus method"
 
2500
                return dbus.Array(c.dbus_object_path
 
2501
                                  for c in
 
2502
                                  tcp_server.clients.itervalues())
 
2503
            
 
2504
            @dbus.service.method(_interface,
 
2505
                                 out_signature="a{oa{sv}}")
 
2506
            def GetAllClientsWithProperties(self):
 
2507
                "D-Bus method"
 
2508
                return dbus.Dictionary(
 
2509
                    ((c.dbus_object_path, c.GetAll(""))
 
2510
                     for c in tcp_server.clients.itervalues()),
 
2511
                    signature="oa{sv}")
 
2512
            
 
2513
            @dbus.service.method(_interface, in_signature="o")
 
2514
            def RemoveClient(self, object_path):
 
2515
                "D-Bus method"
 
2516
                for c in tcp_server.clients.itervalues():
 
2517
                    if c.dbus_object_path == object_path:
 
2518
                        del tcp_server.clients[c.name]
 
2519
                        c.remove_from_connection()
 
2520
                        # Don't signal anything except ClientRemoved
 
2521
                        c.disable(quiet=True)
 
2522
                        # Emit D-Bus signal
 
2523
                        self.ClientRemoved(object_path, c.name)
 
2524
                        return
 
2525
                raise KeyError(object_path)
 
2526
            
 
2527
            del _interface
 
2528
        
 
2529
        mandos_dbus_service = MandosDBusService()
818
2530
    
819
2531
    def cleanup():
820
2532
        "Cleanup function; run on exit"
821
 
        global group
822
 
        # From the Avahi example code
823
 
        if not group is None:
824
 
            group.Free()
825
 
            group = None
826
 
        # End of Avahi example code
827
 
        
828
 
        while clients:
829
 
            client = clients.pop()
830
 
            client.stop_hook = None
831
 
            client.stop()
 
2533
        service.cleanup()
 
2534
        
 
2535
        multiprocessing.active_children()
 
2536
        if not (tcp_server.clients or client_settings):
 
2537
            return
 
2538
        
 
2539
        # Store client before exiting. Secrets are encrypted with key
 
2540
        # based on what config file has. If config file is
 
2541
        # removed/edited, old secret will thus be unrecovable.
 
2542
        clients = {}
 
2543
        with PGPEngine() as pgp:
 
2544
            for client in tcp_server.clients.itervalues():
 
2545
                key = client_settings[client.name]["secret"]
 
2546
                client.encrypted_secret = pgp.encrypt(client.secret,
 
2547
                                                      key)
 
2548
                client_dict = {}
 
2549
                
 
2550
                # A list of attributes that can not be pickled
 
2551
                # + secret.
 
2552
                exclude = set(("bus", "changedstate", "secret",
 
2553
                               "checker"))
 
2554
                for name, typ in (inspect.getmembers
 
2555
                                  (dbus.service.Object)):
 
2556
                    exclude.add(name)
 
2557
                
 
2558
                client_dict["encrypted_secret"] = (client
 
2559
                                                   .encrypted_secret)
 
2560
                for attr in client.client_structure:
 
2561
                    if attr not in exclude:
 
2562
                        client_dict[attr] = getattr(client, attr)
 
2563
                
 
2564
                clients[client.name] = client_dict
 
2565
                del client_settings[client.name]["secret"]
 
2566
        
 
2567
        try:
 
2568
            with (tempfile.NamedTemporaryFile
 
2569
                  (mode='wb', suffix=".pickle", prefix='clients-',
 
2570
                   dir=os.path.dirname(stored_state_path),
 
2571
                   delete=False)) as stored_state:
 
2572
                pickle.dump((clients, client_settings), stored_state)
 
2573
                tempname=stored_state.name
 
2574
            os.rename(tempname, stored_state_path)
 
2575
        except (IOError, OSError) as e:
 
2576
            if not debug:
 
2577
                try:
 
2578
                    os.remove(tempname)
 
2579
                except NameError:
 
2580
                    pass
 
2581
            if e.errno in (errno.ENOENT, errno.EACCES, errno.EEXIST):
 
2582
                logger.warning("Could not save persistent state: {0}"
 
2583
                               .format(os.strerror(e.errno)))
 
2584
            else:
 
2585
                logger.warning("Could not save persistent state:",
 
2586
                               exc_info=e)
 
2587
                raise e
 
2588
        
 
2589
        # Delete all clients, and settings from config
 
2590
        while tcp_server.clients:
 
2591
            name, client = tcp_server.clients.popitem()
 
2592
            if use_dbus:
 
2593
                client.remove_from_connection()
 
2594
            # Don't signal anything except ClientRemoved
 
2595
            client.disable(quiet=True)
 
2596
            if use_dbus:
 
2597
                # Emit D-Bus signal
 
2598
                mandos_dbus_service.ClientRemoved(client
 
2599
                                                  .dbus_object_path,
 
2600
                                                  client.name)
 
2601
        client_settings.clear()
832
2602
    
833
2603
    atexit.register(cleanup)
834
2604
    
835
 
    if not debug:
836
 
        signal.signal(signal.SIGINT, signal.SIG_IGN)
837
 
    signal.signal(signal.SIGHUP, lambda signum, frame: sys.exit())
838
 
    signal.signal(signal.SIGTERM, lambda signum, frame: sys.exit())
839
 
    
840
 
    for client in clients:
841
 
        client.start()
842
 
    
843
 
    tcp_server = IPv6_TCPServer((server_settings["address"],
844
 
                                 server_settings["port"]),
845
 
                                tcp_handler,
846
 
                                settings=server_settings,
847
 
                                clients=clients)
 
2605
    for client in tcp_server.clients.itervalues():
 
2606
        if use_dbus:
 
2607
            # Emit D-Bus signal
 
2608
            mandos_dbus_service.ClientAdded(client.dbus_object_path)
 
2609
        # Need to initiate checking of clients
 
2610
        if client.enabled:
 
2611
            client.init_checker()
 
2612
    
 
2613
    tcp_server.enable()
 
2614
    tcp_server.server_activate()
 
2615
    
848
2616
    # Find out what port we got
849
2617
    service.port = tcp_server.socket.getsockname()[1]
850
 
    logger.info(u"Now listening on address %r, port %d, flowinfo %d,"
851
 
                u" scope_id %d" % tcp_server.socket.getsockname())
 
2618
    if use_ipv6:
 
2619
        logger.info("Now listening on address %r, port %d,"
 
2620
                    " flowinfo %d, scope_id %d",
 
2621
                    *tcp_server.socket.getsockname())
 
2622
    else:                       # IPv4
 
2623
        logger.info("Now listening on address %r, port %d",
 
2624
                    *tcp_server.socket.getsockname())
852
2625
    
853
2626
    #service.interface = tcp_server.socket.getsockname()[3]
854
2627
    
855
2628
    try:
856
2629
        # From the Avahi example code
857
 
        server.connect_to_signal("StateChanged", server_state_changed)
858
2630
        try:
859
 
            server_state_changed(server.GetState())
860
 
        except dbus.exceptions.DBusException, error:
861
 
            logger.critical(u"DBusException: %s", error)
 
2631
            service.activate()
 
2632
        except dbus.exceptions.DBusException as error:
 
2633
            logger.critical("D-Bus Exception", exc_info=error)
 
2634
            cleanup()
862
2635
            sys.exit(1)
863
2636
        # End of Avahi example code
864
2637
        
865
2638
        gobject.io_add_watch(tcp_server.fileno(), gobject.IO_IN,
866
2639
                             lambda *args, **kwargs:
867
 
                             tcp_server.handle_request\
868
 
                             (*args[2:], **kwargs) or True)
 
2640
                             (tcp_server.handle_request
 
2641
                              (*args[2:], **kwargs) or True))
869
2642
        
870
 
        logger.debug(u"Starting main loop")
871
 
        main_loop_started = True
 
2643
        logger.debug("Starting main loop")
872
2644
        main_loop.run()
873
 
    except AvahiError, error:
874
 
        logger.critical(u"AvahiError: %s" + unicode(error))
 
2645
    except AvahiError as error:
 
2646
        logger.critical("Avahi Error", exc_info=error)
 
2647
        cleanup()
875
2648
        sys.exit(1)
876
2649
    except KeyboardInterrupt:
877
2650
        if debug:
878
 
            print
 
2651
            print("", file=sys.stderr)
 
2652
        logger.debug("Server received KeyboardInterrupt")
 
2653
    logger.debug("Server exiting")
 
2654
    # Must run before the D-Bus bus name gets deregistered
 
2655
    cleanup()
879
2656
 
880
2657
if __name__ == '__main__':
881
2658
    main()