/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-ctl

  • Committer: Teddy Hogeborn
  • Date: 2019-03-06 22:21:51 UTC
  • mto: (237.7.594 trunk)
  • mto: This revision was merged to the branch mainline in revision 382.
  • Revision ID: teddy@recompile.se-20190306222151-cp303jcuqhast6nu
mandos-ctl: Refactor tests and add more tests

* mandos-ctl (TestOptions): Rename to "Test_command_from_options".
  (Test_command_from_options.test_default_is_show_table): Rename to
                         "Test_command_from_options.test_print_table".
  (Test_command_from_options.test_show_table_verbose): Rename to
                 "Test_command_from_options.test_print_table_verbose".
  (Test_command_from_options.test_bump_timeout): New.
  (Test_command_from_options.test_start_checker): - '' -
  (Test_command_from_options.test_stop_checker): - '' -
  (Test_command_from_options.test_remove): - '' -
  (Test_command_from_options.test_checker): - '' -
  (Test_command_from_options.test_timeout): - '' -
  (Test_command_from_options.test_extended_timeout): - '' -
  (Test_command_from_options.test_interval): - '' -
  (Test_command_from_options.test_approve_by_default): - '' -
  (Test_command_from_options.test_deny_by_default): - '' -
  (Test_command_from_options.test_approval_delay): - '' -
  (Test_command_from_options.test_approval_duration): - '' -
  (Test_command_from_options.test_host): - '' -
  (Test_command_from_options.test_secret_devnull): - '' -
  (Test_command_from_options.test_secret_tempfile): - '' -
  (Test_command_from_options.test_approve): - '' -
  (Test_command_from_options.test_deny): - '' -
  (Test_command_from_options.test_dump_json): - '' -
  (Test_command_from_options.test_is_enabled): - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
44
44
import logging
45
45
import io
46
46
import tempfile
47
 
import contextlib
48
47
 
49
48
import dbus
50
49
 
64
63
 
65
64
locale.setlocale(locale.LC_ALL, "")
66
65
 
67
 
dbus_busname_domain = "se.recompile"
68
 
dbus_busname = dbus_busname_domain + ".Mandos"
69
 
server_dbus_path = "/"
70
 
server_dbus_interface = dbus_busname_domain + ".Mandos"
71
 
client_dbus_interface = dbus_busname_domain + ".Mandos.Client"
72
 
del dbus_busname_domain
 
66
domain = "se.recompile"
 
67
busname = domain + ".Mandos"
 
68
server_path = "/"
 
69
server_interface = domain + ".Mandos"
 
70
client_interface = domain + ".Mandos.Client"
73
71
version = "1.8.3"
74
72
 
75
73
 
79
77
    dbus.OBJECT_MANAGER_IFACE = "org.freedesktop.DBus.ObjectManager"
80
78
 
81
79
 
82
 
def main():
83
 
    parser = argparse.ArgumentParser()
84
 
 
85
 
    add_command_line_options(parser)
86
 
 
87
 
    options = parser.parse_args()
88
 
 
89
 
    check_option_syntax(parser, options)
90
 
 
91
 
    clientnames = options.client
92
 
 
93
 
    if options.debug:
94
 
        log.setLevel(logging.DEBUG)
95
 
 
96
 
    bus = dbus.SystemBus()
97
 
 
98
 
    mandos_dbus_object = get_mandos_dbus_object(bus)
99
 
 
100
 
    mandos_serv = dbus.Interface(
101
 
        mandos_dbus_object, dbus_interface=server_dbus_interface)
102
 
    mandos_serv_object_manager = dbus.Interface(
103
 
        mandos_dbus_object, dbus_interface=dbus.OBJECT_MANAGER_IFACE)
104
 
 
105
 
    try:
106
 
        log.debug("D-Bus: %s:%s:%s.GetManagedObjects()", dbus_busname,
107
 
                  server_dbus_path, dbus.OBJECT_MANAGER_IFACE)
108
 
        with SilenceLogger("dbus.proxies"):
109
 
            all_clients = {path: ifs_and_props[client_dbus_interface]
110
 
                              for path, ifs_and_props in
111
 
                              mandos_serv_object_manager
112
 
                              .GetManagedObjects().items()
113
 
                              if client_dbus_interface in ifs_and_props}
114
 
    except dbus.exceptions.DBusException as e:
115
 
        log.critical("Failed to access Mandos server through D-Bus:"
116
 
                     "\n%s", e)
117
 
        sys.exit(1)
118
 
 
119
 
    # Compile dict of (clients: properties) to process
120
 
    clients = {}
121
 
 
122
 
    if not clientnames:
123
 
        clients = all_clients
124
 
    else:
125
 
        for name in clientnames:
126
 
            for objpath, properties in all_clients.items():
127
 
                if properties["Name"] == name:
128
 
                    clients[objpath] = properties
129
 
                    break
130
 
            else:
131
 
                log.critical("Client not found on server: %r", name)
132
 
                sys.exit(1)
133
 
 
134
 
    # Run all commands on clients
135
 
    commands = commands_from_options(options)
136
 
    for command in commands:
137
 
        command.run(clients, bus, mandos_serv)
138
 
 
139
 
 
140
 
def add_command_line_options(parser):
141
 
    parser.add_argument("--version", action="version",
142
 
                        version="%(prog)s {}".format(version),
143
 
                        help="show version number and exit")
144
 
    parser.add_argument("-a", "--all", action="store_true",
145
 
                        help="Select all clients")
146
 
    parser.add_argument("-v", "--verbose", action="store_true",
147
 
                        help="Print all fields")
148
 
    parser.add_argument("-j", "--dump-json", action="store_true",
149
 
                        help="Dump client data in JSON format")
150
 
    enable_disable = parser.add_mutually_exclusive_group()
151
 
    enable_disable.add_argument("-e", "--enable", action="store_true",
152
 
                                help="Enable client")
153
 
    enable_disable.add_argument("-d", "--disable",
154
 
                                action="store_true",
155
 
                                help="disable client")
156
 
    parser.add_argument("-b", "--bump-timeout", action="store_true",
157
 
                        help="Bump timeout for client")
158
 
    start_stop_checker = parser.add_mutually_exclusive_group()
159
 
    start_stop_checker.add_argument("--start-checker",
160
 
                                    action="store_true",
161
 
                                    help="Start checker for client")
162
 
    start_stop_checker.add_argument("--stop-checker",
163
 
                                    action="store_true",
164
 
                                    help="Stop checker for client")
165
 
    parser.add_argument("-V", "--is-enabled", action="store_true",
166
 
                        help="Check if client is enabled")
167
 
    parser.add_argument("-r", "--remove", action="store_true",
168
 
                        help="Remove client")
169
 
    parser.add_argument("-c", "--checker",
170
 
                        help="Set checker command for client")
171
 
    parser.add_argument("-t", "--timeout", type=string_to_delta,
172
 
                        help="Set timeout for client")
173
 
    parser.add_argument("--extended-timeout", type=string_to_delta,
174
 
                        help="Set extended timeout for client")
175
 
    parser.add_argument("-i", "--interval", type=string_to_delta,
176
 
                        help="Set checker interval for client")
177
 
    approve_deny_default = parser.add_mutually_exclusive_group()
178
 
    approve_deny_default.add_argument(
179
 
        "--approve-by-default", action="store_true",
180
 
        default=None, dest="approved_by_default",
181
 
        help="Set client to be approved by default")
182
 
    approve_deny_default.add_argument(
183
 
        "--deny-by-default", action="store_false",
184
 
        dest="approved_by_default",
185
 
        help="Set client to be denied by default")
186
 
    parser.add_argument("--approval-delay", type=string_to_delta,
187
 
                        help="Set delay before client approve/deny")
188
 
    parser.add_argument("--approval-duration", type=string_to_delta,
189
 
                        help="Set duration of one client approval")
190
 
    parser.add_argument("-H", "--host", help="Set host for client")
191
 
    parser.add_argument("-s", "--secret",
192
 
                        type=argparse.FileType(mode="rb"),
193
 
                        help="Set password blob (file) for client")
194
 
    approve_deny = parser.add_mutually_exclusive_group()
195
 
    approve_deny.add_argument(
196
 
        "-A", "--approve", action="store_true",
197
 
        help="Approve any current client request")
198
 
    approve_deny.add_argument("-D", "--deny", action="store_true",
199
 
                              help="Deny any current client request")
200
 
    parser.add_argument("--debug", action="store_true",
201
 
                        help="Debug mode (show D-Bus commands)")
202
 
    parser.add_argument("--check", action="store_true",
203
 
                        help="Run self-test")
204
 
    parser.add_argument("client", nargs="*", help="Client name")
205
 
 
206
 
 
207
 
def string_to_delta(interval):
208
 
    """Parse a string and return a datetime.timedelta"""
209
 
 
210
 
    try:
211
 
        return rfc3339_duration_to_delta(interval)
212
 
    except ValueError as e:
213
 
        log.warning("%s - Parsing as pre-1.6.1 interval instead",
214
 
                    ' '.join(e.args))
215
 
    return parse_pre_1_6_1_interval(interval)
 
80
def milliseconds_to_string(ms):
 
81
    td = datetime.timedelta(0, 0, 0, ms)
 
82
    return ("{days}{hours:02}:{minutes:02}:{seconds:02}"
 
83
            .format(days="{}T".format(td.days) if td.days else "",
 
84
                    hours=td.seconds // 3600,
 
85
                    minutes=(td.seconds % 3600) // 60,
 
86
                    seconds=td.seconds % 60))
216
87
 
217
88
 
218
89
def rfc3339_duration_to_delta(duration):
345
216
    return value
346
217
 
347
218
 
 
219
def string_to_delta(interval):
 
220
    """Parse a string and return a datetime.timedelta"""
 
221
 
 
222
    try:
 
223
        return rfc3339_duration_to_delta(interval)
 
224
    except ValueError as e:
 
225
        log.warning("%s - Parsing as pre-1.6.1 interval instead",
 
226
                    ' '.join(e.args))
 
227
    return parse_pre_1_6_1_interval(interval)
 
228
 
 
229
 
348
230
def parse_pre_1_6_1_interval(interval):
349
231
    """Parse an interval string as documented by Mandos before 1.6.1,
350
232
    and return a datetime.timedelta
388
270
    return value
389
271
 
390
272
 
391
 
def check_option_syntax(parser, options):
392
 
    """Apply additional restrictions on options, not expressible in
393
 
argparse"""
394
 
 
395
 
    def has_actions(options):
396
 
        return any((options.enable,
397
 
                    options.disable,
398
 
                    options.bump_timeout,
399
 
                    options.start_checker,
400
 
                    options.stop_checker,
401
 
                    options.is_enabled,
402
 
                    options.remove,
403
 
                    options.checker is not None,
404
 
                    options.timeout is not None,
405
 
                    options.extended_timeout is not None,
406
 
                    options.interval is not None,
407
 
                    options.approved_by_default is not None,
408
 
                    options.approval_delay is not None,
409
 
                    options.approval_duration is not None,
410
 
                    options.host is not None,
411
 
                    options.secret is not None,
412
 
                    options.approve,
413
 
                    options.deny))
414
 
 
415
 
    if has_actions(options) and not (options.client or options.all):
416
 
        parser.error("Options require clients names or --all.")
417
 
    if options.verbose and has_actions(options):
418
 
        parser.error("--verbose can only be used alone.")
419
 
    if options.dump_json and (options.verbose
420
 
                              or has_actions(options)):
421
 
        parser.error("--dump-json can only be used alone.")
422
 
    if options.all and not has_actions(options):
423
 
        parser.error("--all requires an action.")
424
 
    if options.is_enabled and len(options.client) > 1:
425
 
        parser.error("--is-enabled requires exactly one client")
426
 
    if options.remove:
427
 
        options.remove = False
428
 
        if has_actions(options) and not options.deny:
429
 
            parser.error("--remove can only be combined with --deny")
430
 
        options.remove = True
431
 
 
432
 
 
433
 
def get_mandos_dbus_object(bus):
434
 
    try:
435
 
        log.debug("D-Bus: Connect to: (busname=%r, path=%r)",
436
 
                  dbus_busname, server_dbus_path)
437
 
        mandos_dbus_object = bus.get_object(dbus_busname,
438
 
                                            server_dbus_path)
439
 
    except dbus.exceptions.DBusException:
440
 
        log.critical("Could not connect to Mandos server")
441
 
        sys.exit(1)
442
 
 
443
 
    return mandos_dbus_object
444
 
 
445
 
 
446
 
class SilenceLogger(object):
447
 
    "Simple context manager to silence a particular logger"
448
 
    def __init__(self, loggername):
449
 
        self.logger = logging.getLogger(loggername)
450
 
 
451
 
    def __enter__(self):
452
 
        self.logger.addFilter(self.nullfilter)
453
 
        return self
454
 
 
455
 
    class NullFilter(logging.Filter):
456
 
        def filter(self, record):
457
 
            return False
458
 
 
459
 
    nullfilter = NullFilter()
460
 
 
461
 
    def __exit__(self, exc_type, exc_val, exc_tb):
462
 
        self.logger.removeFilter(self.nullfilter)
463
 
 
464
 
 
465
 
def commands_from_options(options):
466
 
 
467
 
    commands = []
468
 
 
469
 
    if options.is_enabled:
470
 
        commands.append(IsEnabledCmd())
471
 
 
472
 
    if options.approve:
473
 
        commands.append(ApproveCmd())
474
 
 
475
 
    if options.deny:
476
 
        commands.append(DenyCmd())
477
 
 
478
 
    if options.remove:
479
 
        commands.append(RemoveCmd())
480
 
 
481
 
    if options.dump_json:
482
 
        commands.append(DumpJSONCmd())
483
 
 
484
 
    if options.enable:
485
 
        commands.append(EnableCmd())
486
 
 
487
 
    if options.disable:
488
 
        commands.append(DisableCmd())
489
 
 
490
 
    if options.bump_timeout:
491
 
        commands.append(BumpTimeoutCmd())
492
 
 
493
 
    if options.start_checker:
494
 
        commands.append(StartCheckerCmd())
495
 
 
496
 
    if options.stop_checker:
497
 
        commands.append(StopCheckerCmd())
498
 
 
499
 
    if options.approved_by_default is not None:
500
 
        if options.approved_by_default:
501
 
            commands.append(ApproveByDefaultCmd())
502
 
        else:
503
 
            commands.append(DenyByDefaultCmd())
504
 
 
505
 
    if options.checker is not None:
506
 
        commands.append(SetCheckerCmd(options.checker))
507
 
 
508
 
    if options.host is not None:
509
 
        commands.append(SetHostCmd(options.host))
510
 
 
511
 
    if options.secret is not None:
512
 
        commands.append(SetSecretCmd(options.secret))
513
 
 
514
 
    if options.timeout is not None:
515
 
        commands.append(SetTimeoutCmd(options.timeout))
516
 
 
517
 
    if options.extended_timeout:
518
 
        commands.append(
519
 
            SetExtendedTimeoutCmd(options.extended_timeout))
520
 
 
521
 
    if options.interval is not None:
522
 
        commands.append(SetIntervalCmd(options.interval))
523
 
 
524
 
    if options.approval_delay is not None:
525
 
        commands.append(SetApprovalDelayCmd(options.approval_delay))
526
 
 
527
 
    if options.approval_duration is not None:
528
 
        commands.append(
529
 
            SetApprovalDurationCmd(options.approval_duration))
530
 
 
531
 
    # If no command option has been given, show table of clients,
532
 
    # optionally verbosely
533
 
    if not commands:
534
 
        commands.append(PrintTableCmd(verbose=options.verbose))
535
 
 
536
 
    return commands
537
 
 
538
 
 
 
273
## Classes for commands.
 
274
 
 
275
# Abstract classes first
539
276
class Command(object):
540
277
    """Abstract class for commands"""
541
 
    def run(self, clients, bus=None, mandos=None):
 
278
    def run(self, mandos, clients):
542
279
        """Normal commands should implement run_on_one_client(), but
543
280
        commands which want to operate on all clients at the same time
544
281
        can override this run() method instead."""
545
282
        self.mandos = mandos
546
 
        for clientpath, properties in clients.items():
547
 
            log.debug("D-Bus: Connect to: (busname=%r, path=%r)",
548
 
                      dbus_busname, str(clientpath))
549
 
            client = bus.get_object(dbus_busname, clientpath)
 
283
        for client, properties in clients.items():
550
284
            self.run_on_one_client(client, properties)
551
285
 
552
 
 
553
 
class IsEnabledCmd(Command):
554
 
    def run(self, clients, bus=None, mandos=None):
555
 
        client, properties = next(iter(clients.items()))
556
 
        if self.is_enabled(client, properties):
557
 
            sys.exit(0)
558
 
        sys.exit(1)
559
 
    def is_enabled(self, client, properties):
560
 
        return properties["Enabled"]
561
 
 
562
 
 
563
 
class ApproveCmd(Command):
564
 
    def run_on_one_client(self, client, properties):
565
 
        log.debug("D-Bus: %s:%s:%s.Approve(True)", dbus_busname,
566
 
                  client.__dbus_object_path__, client_dbus_interface)
567
 
        client.Approve(dbus.Boolean(True),
568
 
                       dbus_interface=client_dbus_interface)
569
 
 
570
 
 
571
 
class DenyCmd(Command):
572
 
    def run_on_one_client(self, client, properties):
573
 
        log.debug("D-Bus: %s:%s:%s.Approve(False)", dbus_busname,
574
 
                  client.__dbus_object_path__, client_dbus_interface)
575
 
        client.Approve(dbus.Boolean(False),
576
 
                       dbus_interface=client_dbus_interface)
577
 
 
578
 
 
579
 
class RemoveCmd(Command):
580
 
    def run_on_one_client(self, client, properties):
581
 
        log.debug("D-Bus: %s:%s:%s.RemoveClient(%r)", dbus_busname,
582
 
                  server_dbus_path, server_dbus_interface,
583
 
                  str(client.__dbus_object_path__))
584
 
        self.mandos.RemoveClient(client.__dbus_object_path__)
585
 
 
586
 
 
587
 
class OutputCmd(Command):
588
 
    """Abstract class for commands outputting client details"""
 
286
class PrintCmd(Command):
 
287
    """Abstract class for commands printing client details"""
589
288
    all_keywords = ("Name", "Enabled", "Timeout", "LastCheckedOK",
590
289
                    "Created", "Interval", "Host", "KeyID",
591
290
                    "Fingerprint", "CheckerRunning", "LastEnabled",
593
292
                    "LastApprovalRequest", "ApprovalDelay",
594
293
                    "ApprovalDuration", "Checker", "ExtendedTimeout",
595
294
                    "Expires", "LastCheckerStatus")
596
 
 
597
 
    def run(self, clients, bus=None, mandos=None):
598
 
        print(self.output(clients.values()))
599
 
 
600
 
    def output(self, clients):
601
 
        raise NotImplementedError()
602
 
 
603
 
 
604
 
class DumpJSONCmd(OutputCmd):
605
 
    def output(self, clients):
606
 
        data = {client["Name"]:
607
 
                {key: self.dbus_boolean_to_bool(client[key])
608
 
                 for key in self.all_keywords}
609
 
                for client in clients}
610
 
        return json.dumps(data, indent=4, separators=(',', ': '))
611
 
 
612
 
    @staticmethod
613
 
    def dbus_boolean_to_bool(value):
614
 
        if isinstance(value, dbus.Boolean):
615
 
            value = bool(value)
616
 
        return value
617
 
 
618
 
 
619
 
class PrintTableCmd(OutputCmd):
 
295
    def run(self, mandos, clients):
 
296
        print(self.output(clients))
 
297
 
 
298
class PropertyCmd(Command):
 
299
    """Abstract class for Actions for setting one client property"""
 
300
    def run_on_one_client(self, client, properties):
 
301
        """Set the Client's D-Bus property"""
 
302
        client.Set(client_interface, self.property, self.value_to_set,
 
303
                   dbus_interface=dbus.PROPERTIES_IFACE)
 
304
 
 
305
class ValueArgumentMixIn(object):
 
306
    """Mixin class for commands taking a value as argument"""
 
307
    def __init__(self, value):
 
308
        self.value_to_set = value
 
309
 
 
310
class MillisecondsValueArgumentMixIn(ValueArgumentMixIn):
 
311
    """Mixin class for commands taking a value argument as
 
312
    milliseconds."""
 
313
    @property
 
314
    def value_to_set(self):
 
315
        return self._vts
 
316
    @value_to_set.setter
 
317
    def value_to_set(self, value):
 
318
        """When setting, convert value to a datetime.timedelta"""
 
319
        self._vts = string_to_delta(value).total_seconds() * 1000
 
320
 
 
321
# Actual (non-abstract) command classes
 
322
 
 
323
class PrintTableCmd(PrintCmd):
620
324
    def __init__(self, verbose=False):
621
325
        self.verbose = verbose
622
326
 
623
327
    def output(self, clients):
624
 
        default_keywords = ("Name", "Enabled", "Timeout",
625
 
                            "LastCheckedOK")
 
328
        default_keywords = ("Name", "Enabled", "Timeout", "LastCheckedOK")
626
329
        keywords = default_keywords
627
330
        if self.verbose:
628
331
            keywords = self.all_keywords
629
 
        return str(self.TableOfClients(clients, keywords))
 
332
        return str(self.TableOfClients(clients.values(), keywords))
630
333
 
631
334
    class TableOfClients(object):
632
335
        tableheaders = {
652
355
            "LastCheckerStatus": "Last Checker Status",
653
356
        }
654
357
 
655
 
        def __init__(self, clients, keywords):
 
358
        def __init__(self, clients, keywords, tableheaders=None):
656
359
            self.clients = clients
657
360
            self.keywords = keywords
 
361
            if tableheaders is not None:
 
362
                self.tableheaders = tableheaders
658
363
 
659
364
        def __str__(self):
660
365
            return "\n".join(self.rows())
683
388
        def string_from_client(self, client, key):
684
389
            return self.valuetostring(client[key], key)
685
390
 
686
 
        @classmethod
687
 
        def valuetostring(cls, value, keyword):
 
391
        @staticmethod
 
392
        def valuetostring(value, keyword):
688
393
            if isinstance(value, dbus.Boolean):
689
394
                return "Yes" if value else "No"
690
395
            if keyword in ("Timeout", "Interval", "ApprovalDelay",
691
396
                           "ApprovalDuration", "ExtendedTimeout"):
692
 
                return cls.milliseconds_to_string(value)
 
397
                return milliseconds_to_string(value)
693
398
            return str(value)
694
399
 
695
400
        def header_line(self, format_string):
700
405
                **{key: self.string_from_client(client, key)
701
406
                   for key in self.keywords})
702
407
 
703
 
        @staticmethod
704
 
        def milliseconds_to_string(ms):
705
 
            td = datetime.timedelta(0, 0, 0, ms)
706
 
            return ("{days}{hours:02}:{minutes:02}:{seconds:02}"
707
 
                    .format(days="{}T".format(td.days)
708
 
                            if td.days else "",
709
 
                            hours=td.seconds // 3600,
710
 
                            minutes=(td.seconds % 3600) // 60,
711
 
                            seconds=td.seconds % 60))
712
 
 
713
 
 
714
 
class PropertyCmd(Command):
715
 
    """Abstract class for Actions for setting one client property"""
716
 
 
717
 
    def run_on_one_client(self, client, properties):
718
 
        """Set the Client's D-Bus property"""
719
 
        log.debug("D-Bus: %s:%s:%s.Set(%r, %r, %r)", dbus_busname,
720
 
                  client.__dbus_object_path__,
721
 
                  dbus.PROPERTIES_IFACE, client_dbus_interface,
722
 
                  self.propname, self.value_to_set
723
 
                  if not isinstance(self.value_to_set, dbus.Boolean)
724
 
                  else bool(self.value_to_set))
725
 
        client.Set(client_dbus_interface, self.propname,
726
 
                   self.value_to_set,
727
 
                   dbus_interface=dbus.PROPERTIES_IFACE)
728
 
 
729
 
    @property
730
 
    def propname(self):
731
 
        raise NotImplementedError()
732
 
 
 
408
 
 
409
 
 
410
class DumpJSONCmd(PrintCmd):
 
411
    def output(self, clients):
 
412
        data = {client["Name"]:
 
413
                {key: self.dbus_boolean_to_bool(client[key])
 
414
                 for key in self.all_keywords}
 
415
                for client in clients.values()}
 
416
        return json.dumps(data, indent=4, separators=(',', ': '))
 
417
    @staticmethod
 
418
    def dbus_boolean_to_bool(value):
 
419
        if isinstance(value, dbus.Boolean):
 
420
            value = bool(value)
 
421
        return value
 
422
 
 
423
class IsEnabledCmd(Command):
 
424
    def run_on_one_client(self, client, properties):
 
425
        if self.is_enabled(client, properties):
 
426
            sys.exit(0)
 
427
        sys.exit(1)
 
428
    def is_enabled(self, client, properties):
 
429
        return bool(properties["Enabled"])
 
430
 
 
431
class RemoveCmd(Command):
 
432
    def run_on_one_client(self, client, properties):
 
433
        self.mandos.RemoveClient(client.__dbus_object_path__)
 
434
 
 
435
class ApproveCmd(Command):
 
436
    def run_on_one_client(self, client, properties):
 
437
        client.Approve(dbus.Boolean(True),
 
438
                       dbus_interface=client_interface)
 
439
 
 
440
class DenyCmd(Command):
 
441
    def run_on_one_client(self, client, properties):
 
442
        client.Approve(dbus.Boolean(False),
 
443
                       dbus_interface=client_interface)
733
444
 
734
445
class EnableCmd(PropertyCmd):
735
 
    propname = "Enabled"
 
446
    property = "Enabled"
736
447
    value_to_set = dbus.Boolean(True)
737
448
 
738
 
 
739
449
class DisableCmd(PropertyCmd):
740
 
    propname = "Enabled"
 
450
    property = "Enabled"
741
451
    value_to_set = dbus.Boolean(False)
742
452
 
743
 
 
744
453
class BumpTimeoutCmd(PropertyCmd):
745
 
    propname = "LastCheckedOK"
 
454
    property = "LastCheckedOK"
746
455
    value_to_set = ""
747
456
 
748
 
 
749
457
class StartCheckerCmd(PropertyCmd):
750
 
    propname = "CheckerRunning"
 
458
    property = "CheckerRunning"
751
459
    value_to_set = dbus.Boolean(True)
752
460
 
753
 
 
754
461
class StopCheckerCmd(PropertyCmd):
755
 
    propname = "CheckerRunning"
 
462
    property = "CheckerRunning"
756
463
    value_to_set = dbus.Boolean(False)
757
464
 
758
 
 
759
465
class ApproveByDefaultCmd(PropertyCmd):
760
 
    propname = "ApprovedByDefault"
 
466
    property = "ApprovedByDefault"
761
467
    value_to_set = dbus.Boolean(True)
762
468
 
763
 
 
764
469
class DenyByDefaultCmd(PropertyCmd):
765
 
    propname = "ApprovedByDefault"
 
470
    property = "ApprovedByDefault"
766
471
    value_to_set = dbus.Boolean(False)
767
472
 
768
 
 
769
 
class PropertyValueCmd(PropertyCmd):
770
 
    """Abstract class for PropertyCmd recieving a value as argument"""
771
 
    def __init__(self, value):
772
 
        self.value_to_set = value
773
 
 
774
 
 
775
 
class SetCheckerCmd(PropertyValueCmd):
776
 
    propname = "Checker"
777
 
 
778
 
 
779
 
class SetHostCmd(PropertyValueCmd):
780
 
    propname = "Host"
781
 
 
782
 
 
783
 
class SetSecretCmd(PropertyValueCmd):
784
 
    propname = "Secret"
785
 
 
 
473
class SetCheckerCmd(PropertyCmd, ValueArgumentMixIn):
 
474
    property = "Checker"
 
475
 
 
476
class SetHostCmd(PropertyCmd, ValueArgumentMixIn):
 
477
    property = "Host"
 
478
 
 
479
class SetSecretCmd(PropertyCmd, ValueArgumentMixIn):
786
480
    @property
787
481
    def value_to_set(self):
788
482
        return self._vts
789
 
 
790
483
    @value_to_set.setter
791
484
    def value_to_set(self, value):
792
485
        """When setting, read data from supplied file object"""
793
486
        self._vts = value.read()
794
487
        value.close()
795
 
 
796
 
 
797
 
class MillisecondsPropertyValueArgumentCmd(PropertyValueCmd):
798
 
    """Abstract class for PropertyValueCmd taking a value argument as
799
 
a datetime.timedelta() but should store it as milliseconds."""
800
 
 
801
 
    @property
802
 
    def value_to_set(self):
803
 
        return self._vts
804
 
 
805
 
    @value_to_set.setter
806
 
    def value_to_set(self, value):
807
 
        """When setting, convert value from a datetime.timedelta"""
808
 
        self._vts = int(round(value.total_seconds() * 1000))
809
 
 
810
 
 
811
 
class SetTimeoutCmd(MillisecondsPropertyValueArgumentCmd):
812
 
    propname = "Timeout"
813
 
 
814
 
 
815
 
class SetExtendedTimeoutCmd(MillisecondsPropertyValueArgumentCmd):
816
 
    propname = "ExtendedTimeout"
817
 
 
818
 
 
819
 
class SetIntervalCmd(MillisecondsPropertyValueArgumentCmd):
820
 
    propname = "Interval"
821
 
 
822
 
 
823
 
class SetApprovalDelayCmd(MillisecondsPropertyValueArgumentCmd):
824
 
    propname = "ApprovalDelay"
825
 
 
826
 
 
827
 
class SetApprovalDurationCmd(MillisecondsPropertyValueArgumentCmd):
828
 
    propname = "ApprovalDuration"
829
 
 
 
488
    property = "Secret"
 
489
 
 
490
class SetTimeoutCmd(PropertyCmd, MillisecondsValueArgumentMixIn):
 
491
    property = "Timeout"
 
492
 
 
493
class SetExtendedTimeoutCmd(PropertyCmd,
 
494
                            MillisecondsValueArgumentMixIn):
 
495
    property = "ExtendedTimeout"
 
496
 
 
497
class SetIntervalCmd(PropertyCmd, MillisecondsValueArgumentMixIn):
 
498
    property = "Interval"
 
499
 
 
500
class SetApprovalDelayCmd(PropertyCmd,
 
501
                          MillisecondsValueArgumentMixIn):
 
502
    property = "ApprovalDelay"
 
503
 
 
504
class SetApprovalDurationCmd(PropertyCmd,
 
505
                             MillisecondsValueArgumentMixIn):
 
506
    property = "ApprovalDuration"
 
507
 
 
508
def has_actions(options):
 
509
    return any((options.enable,
 
510
                options.disable,
 
511
                options.bump_timeout,
 
512
                options.start_checker,
 
513
                options.stop_checker,
 
514
                options.is_enabled,
 
515
                options.remove,
 
516
                options.checker is not None,
 
517
                options.timeout is not None,
 
518
                options.extended_timeout is not None,
 
519
                options.interval is not None,
 
520
                options.approved_by_default is not None,
 
521
                options.approval_delay is not None,
 
522
                options.approval_duration is not None,
 
523
                options.host is not None,
 
524
                options.secret is not None,
 
525
                options.approve,
 
526
                options.deny))
 
527
 
 
528
def add_command_line_options(parser):
 
529
    parser.add_argument("--version", action="version",
 
530
                        version="%(prog)s {}".format(version),
 
531
                        help="show version number and exit")
 
532
    parser.add_argument("-a", "--all", action="store_true",
 
533
                        help="Select all clients")
 
534
    parser.add_argument("-v", "--verbose", action="store_true",
 
535
                        help="Print all fields")
 
536
    parser.add_argument("-j", "--dump-json", action="store_true",
 
537
                        help="Dump client data in JSON format")
 
538
    enable_disable = parser.add_mutually_exclusive_group()
 
539
    enable_disable.add_argument("-e", "--enable", action="store_true",
 
540
                                help="Enable client")
 
541
    enable_disable.add_argument("-d", "--disable",
 
542
                                action="store_true",
 
543
                                help="disable client")
 
544
    parser.add_argument("-b", "--bump-timeout", action="store_true",
 
545
                        help="Bump timeout for client")
 
546
    start_stop_checker = parser.add_mutually_exclusive_group()
 
547
    start_stop_checker.add_argument("--start-checker",
 
548
                                    action="store_true",
 
549
                                    help="Start checker for client")
 
550
    start_stop_checker.add_argument("--stop-checker",
 
551
                                    action="store_true",
 
552
                                    help="Stop checker for client")
 
553
    parser.add_argument("-V", "--is-enabled", action="store_true",
 
554
                        help="Check if client is enabled")
 
555
    parser.add_argument("-r", "--remove", action="store_true",
 
556
                        help="Remove client")
 
557
    parser.add_argument("-c", "--checker",
 
558
                        help="Set checker command for client")
 
559
    parser.add_argument("-t", "--timeout",
 
560
                        help="Set timeout for client")
 
561
    parser.add_argument("--extended-timeout",
 
562
                        help="Set extended timeout for client")
 
563
    parser.add_argument("-i", "--interval",
 
564
                        help="Set checker interval for client")
 
565
    approve_deny_default = parser.add_mutually_exclusive_group()
 
566
    approve_deny_default.add_argument(
 
567
        "--approve-by-default", action="store_true",
 
568
        default=None, dest="approved_by_default",
 
569
        help="Set client to be approved by default")
 
570
    approve_deny_default.add_argument(
 
571
        "--deny-by-default", action="store_false",
 
572
        dest="approved_by_default",
 
573
        help="Set client to be denied by default")
 
574
    parser.add_argument("--approval-delay",
 
575
                        help="Set delay before client approve/deny")
 
576
    parser.add_argument("--approval-duration",
 
577
                        help="Set duration of one client approval")
 
578
    parser.add_argument("-H", "--host", help="Set host for client")
 
579
    parser.add_argument("-s", "--secret",
 
580
                        type=argparse.FileType(mode="rb"),
 
581
                        help="Set password blob (file) for client")
 
582
    approve_deny = parser.add_mutually_exclusive_group()
 
583
    approve_deny.add_argument(
 
584
        "-A", "--approve", action="store_true",
 
585
        help="Approve any current client request")
 
586
    approve_deny.add_argument("-D", "--deny", action="store_true",
 
587
                              help="Deny any current client request")
 
588
    parser.add_argument("--check", action="store_true",
 
589
                        help="Run self-test")
 
590
    parser.add_argument("client", nargs="*", help="Client name")
 
591
 
 
592
 
 
593
def commands_from_options(options):
 
594
 
 
595
    commands = []
 
596
 
 
597
    if options.dump_json:
 
598
        commands.append(DumpJSONCmd())
 
599
 
 
600
    if options.enable:
 
601
        commands.append(EnableCmd())
 
602
 
 
603
    if options.disable:
 
604
        commands.append(DisableCmd())
 
605
 
 
606
    if options.bump_timeout:
 
607
        commands.append(BumpTimeoutCmd())
 
608
 
 
609
    if options.start_checker:
 
610
        commands.append(StartCheckerCmd())
 
611
 
 
612
    if options.stop_checker:
 
613
        commands.append(StopCheckerCmd())
 
614
 
 
615
    if options.is_enabled:
 
616
        commands.append(IsEnabledCmd())
 
617
 
 
618
    if options.remove:
 
619
        commands.append(RemoveCmd())
 
620
 
 
621
    if options.checker is not None:
 
622
        commands.append(SetCheckerCmd(options.checker))
 
623
 
 
624
    if options.timeout is not None:
 
625
        commands.append(SetTimeoutCmd(options.timeout))
 
626
 
 
627
    if options.extended_timeout:
 
628
        commands.append(
 
629
            SetExtendedTimeoutCmd(options.extended_timeout))
 
630
 
 
631
    if options.interval is not None:
 
632
        commands.append(SetIntervalCmd(options.interval))
 
633
 
 
634
    if options.approved_by_default is not None:
 
635
        if options.approved_by_default:
 
636
            commands.append(ApproveByDefaultCmd())
 
637
        else:
 
638
            commands.append(DenyByDefaultCmd())
 
639
 
 
640
    if options.approval_delay is not None:
 
641
        commands.append(SetApprovalDelayCmd(options.approval_delay))
 
642
 
 
643
    if options.approval_duration is not None:
 
644
        commands.append(
 
645
            SetApprovalDurationCmd(options.approval_duration))
 
646
 
 
647
    if options.host is not None:
 
648
        commands.append(SetHostCmd(options.host))
 
649
 
 
650
    if options.secret is not None:
 
651
        commands.append(SetSecretCmd(options.secret))
 
652
 
 
653
    if options.approve:
 
654
        commands.append(ApproveCmd())
 
655
 
 
656
    if options.deny:
 
657
        commands.append(DenyCmd())
 
658
 
 
659
    # If no command option has been given, show table of clients,
 
660
    # optionally verbosely
 
661
    if not commands:
 
662
        commands.append(PrintTableCmd(verbose=options.verbose))
 
663
 
 
664
    return commands
 
665
 
 
666
 
 
667
def main():
 
668
    parser = argparse.ArgumentParser()
 
669
 
 
670
    add_command_line_options(parser)
 
671
 
 
672
    options = parser.parse_args()
 
673
 
 
674
    if has_actions(options) and not (options.client or options.all):
 
675
        parser.error("Options require clients names or --all.")
 
676
    if options.verbose and has_actions(options):
 
677
        parser.error("--verbose can only be used alone.")
 
678
    if options.dump_json and (options.verbose
 
679
                              or has_actions(options)):
 
680
        parser.error("--dump-json can only be used alone.")
 
681
    if options.all and not has_actions(options):
 
682
        parser.error("--all requires an action.")
 
683
    if options.is_enabled and len(options.client) > 1:
 
684
        parser.error("--is-enabled requires exactly one client")
 
685
 
 
686
    clientnames = options.client
 
687
 
 
688
    try:
 
689
        bus = dbus.SystemBus()
 
690
        mandos_dbus_objc = bus.get_object(busname, server_path)
 
691
    except dbus.exceptions.DBusException:
 
692
        log.critical("Could not connect to Mandos server")
 
693
        sys.exit(1)
 
694
 
 
695
    mandos_serv = dbus.Interface(mandos_dbus_objc,
 
696
                                 dbus_interface=server_interface)
 
697
    mandos_serv_object_manager = dbus.Interface(
 
698
        mandos_dbus_objc, dbus_interface=dbus.OBJECT_MANAGER_IFACE)
 
699
 
 
700
    # Filter out log message from dbus module
 
701
    dbus_logger = logging.getLogger("dbus.proxies")
 
702
    class NullFilter(logging.Filter):
 
703
        def filter(self, record):
 
704
            return False
 
705
    dbus_filter = NullFilter()
 
706
    try:
 
707
        dbus_logger.addFilter(dbus_filter)
 
708
        mandos_clients = {path: ifs_and_props[client_interface]
 
709
                          for path, ifs_and_props in
 
710
                          mandos_serv_object_manager
 
711
                          .GetManagedObjects().items()
 
712
                          if client_interface in ifs_and_props}
 
713
    except dbus.exceptions.DBusException as e:
 
714
        log.critical("Failed to access Mandos server through D-Bus:"
 
715
                     "\n%s", e)
 
716
        sys.exit(1)
 
717
    finally:
 
718
        # restore dbus logger
 
719
        dbus_logger.removeFilter(dbus_filter)
 
720
 
 
721
    # Compile dict of (clients: properties) to process
 
722
    clients = {}
 
723
 
 
724
    if not clientnames:
 
725
        clients = {bus.get_object(busname, path): properties
 
726
                   for path, properties in mandos_clients.items()}
 
727
    else:
 
728
        for name in clientnames:
 
729
            for path, client in mandos_clients.items():
 
730
                if client["Name"] == name:
 
731
                    client_objc = bus.get_object(busname, path)
 
732
                    clients[client_objc] = client
 
733
                    break
 
734
            else:
 
735
                log.critical("Client not found on server: %r", name)
 
736
                sys.exit(1)
 
737
 
 
738
    # Run all commands on clients
 
739
    commands = commands_from_options(options)
 
740
    for command in commands:
 
741
        command.run(mandos_serv, clients)
830
742
 
831
743
 
 
744
class Test_milliseconds_to_string(unittest.TestCase):
 
745
    def test_all(self):
 
746
        self.assertEqual(milliseconds_to_string(93785000),
 
747
                         "1T02:03:05")
 
748
    def test_no_days(self):
 
749
        self.assertEqual(milliseconds_to_string(7385000), "02:03:05")
 
750
    def test_all_zero(self):
 
751
        self.assertEqual(milliseconds_to_string(0), "00:00:00")
 
752
    def test_no_fractional_seconds(self):
 
753
        self.assertEqual(milliseconds_to_string(400), "00:00:00")
 
754
        self.assertEqual(milliseconds_to_string(900), "00:00:00")
 
755
        self.assertEqual(milliseconds_to_string(1900), "00:00:01")
 
756
 
832
757
class Test_string_to_delta(unittest.TestCase):
833
758
    def test_handles_basic_rfc3339(self):
834
759
        self.assertEqual(string_to_delta("PT0S"),
839
764
                         datetime.timedelta(0, 1))
840
765
        self.assertEqual(string_to_delta("PT2H"),
841
766
                         datetime.timedelta(0, 7200))
842
 
 
843
767
    def test_falls_back_to_pre_1_6_1_with_warning(self):
844
768
        # assertLogs only exists in Python 3.4
845
769
        if hasattr(self, "assertLogs"):
863
787
        self.assertEqual(value, datetime.timedelta(0, 7200))
864
788
 
865
789
 
866
 
class Test_check_option_syntax(unittest.TestCase):
867
 
    def setUp(self):
868
 
        self.parser = argparse.ArgumentParser()
869
 
        add_command_line_options(self.parser)
870
 
 
871
 
    def test_actions_requires_client_or_all(self):
872
 
        for action, value in self.actions.items():
873
 
            options = self.parser.parse_args()
874
 
            setattr(options, action, value)
875
 
            with self.assertParseError():
876
 
                self.check_option_syntax(options)
877
 
 
878
 
    # This mostly corresponds to the definition from has_actions() in
879
 
    # check_option_syntax()
880
 
    actions = {
881
 
        # The actual values set here are not that important, but we do
882
 
        # at least stick to the correct types, even though they are
883
 
        # never used
884
 
        "enable": True,
885
 
        "disable": True,
886
 
        "bump_timeout": True,
887
 
        "start_checker": True,
888
 
        "stop_checker": True,
889
 
        "is_enabled": True,
890
 
        "remove": True,
891
 
        "checker": "x",
892
 
        "timeout": datetime.timedelta(),
893
 
        "extended_timeout": datetime.timedelta(),
894
 
        "interval": datetime.timedelta(),
895
 
        "approved_by_default": True,
896
 
        "approval_delay": datetime.timedelta(),
897
 
        "approval_duration": datetime.timedelta(),
898
 
        "host": "x",
899
 
        "secret": io.BytesIO(b"x"),
900
 
        "approve": True,
901
 
        "deny": True,
902
 
    }
903
 
 
904
 
    @contextlib.contextmanager
905
 
    def assertParseError(self):
906
 
        with self.assertRaises(SystemExit) as e:
907
 
            with self.temporarily_suppress_stderr():
908
 
                yield
909
 
        # Exit code from argparse is guaranteed to be "2".  Reference:
910
 
        # https://docs.python.org/3/library
911
 
        # /argparse.html#exiting-methods
912
 
        self.assertEqual(e.exception.code, 2)
913
 
 
914
 
    @staticmethod
915
 
    @contextlib.contextmanager
916
 
    def temporarily_suppress_stderr():
917
 
        null = os.open(os.path.devnull, os.O_RDWR)
918
 
        stderrcopy = os.dup(sys.stderr.fileno())
919
 
        os.dup2(null, sys.stderr.fileno())
920
 
        os.close(null)
921
 
        try:
922
 
            yield
923
 
        finally:
924
 
            # restore stderr
925
 
            os.dup2(stderrcopy, sys.stderr.fileno())
926
 
            os.close(stderrcopy)
927
 
 
928
 
    def check_option_syntax(self, options):
929
 
        check_option_syntax(self.parser, options)
930
 
 
931
 
    def test_actions_conflicts_with_verbose(self):
932
 
        for action, value in self.actions.items():
933
 
            options = self.parser.parse_args()
934
 
            setattr(options, action, value)
935
 
            options.verbose = True
936
 
            with self.assertParseError():
937
 
                self.check_option_syntax(options)
938
 
 
939
 
    def test_dump_json_conflicts_with_verbose(self):
940
 
        options = self.parser.parse_args()
941
 
        options.dump_json = True
942
 
        options.verbose = True
943
 
        with self.assertParseError():
944
 
            self.check_option_syntax(options)
945
 
 
946
 
    def test_dump_json_conflicts_with_action(self):
947
 
        for action, value in self.actions.items():
948
 
            options = self.parser.parse_args()
949
 
            setattr(options, action, value)
950
 
            options.dump_json = True
951
 
            with self.assertParseError():
952
 
                self.check_option_syntax(options)
953
 
 
954
 
    def test_all_can_not_be_alone(self):
955
 
        options = self.parser.parse_args()
956
 
        options.all = True
957
 
        with self.assertParseError():
958
 
            self.check_option_syntax(options)
959
 
 
960
 
    def test_all_is_ok_with_any_action(self):
961
 
        for action, value in self.actions.items():
962
 
            options = self.parser.parse_args()
963
 
            setattr(options, action, value)
964
 
            options.all = True
965
 
            self.check_option_syntax(options)
966
 
 
967
 
    def test_is_enabled_fails_without_client(self):
968
 
        options = self.parser.parse_args()
969
 
        options.is_enabled = True
970
 
        with self.assertParseError():
971
 
            self.check_option_syntax(options)
972
 
 
973
 
    def test_is_enabled_works_with_one_client(self):
974
 
        options = self.parser.parse_args()
975
 
        options.is_enabled = True
976
 
        options.client = ["foo"]
977
 
        self.check_option_syntax(options)
978
 
 
979
 
    def test_is_enabled_fails_with_two_clients(self):
980
 
        options = self.parser.parse_args()
981
 
        options.is_enabled = True
982
 
        options.client = ["foo", "barbar"]
983
 
        with self.assertParseError():
984
 
            self.check_option_syntax(options)
985
 
 
986
 
    def test_remove_can_only_be_combined_with_action_deny(self):
987
 
        for action, value in self.actions.items():
988
 
            if action in {"remove", "deny"}:
989
 
                continue
990
 
            options = self.parser.parse_args()
991
 
            setattr(options, action, value)
992
 
            options.all = True
993
 
            options.remove = True
994
 
            with self.assertParseError():
995
 
                self.check_option_syntax(options)
996
 
 
997
 
 
998
 
class Test_get_mandos_dbus_object(unittest.TestCase):
999
 
    def test_calls_and_returns_get_object_on_bus(self):
1000
 
        class MockBus(object):
1001
 
            called = False
1002
 
            def get_object(mockbus_self, busname, dbus_path):
1003
 
                # Note that "self" is still the testcase instance,
1004
 
                # this MockBus instance is in "mockbus_self".
1005
 
                self.assertEqual(busname, dbus_busname)
1006
 
                self.assertEqual(dbus_path, server_dbus_path)
1007
 
                mockbus_self.called = True
1008
 
                return mockbus_self
1009
 
 
1010
 
        mockbus = get_mandos_dbus_object(bus=MockBus())
1011
 
        self.assertIsInstance(mockbus, MockBus)
1012
 
        self.assertTrue(mockbus.called)
1013
 
 
1014
 
    def test_logs_and_exits_on_dbus_error(self):
1015
 
        class MockBusFailing(object):
1016
 
            def get_object(self, busname, dbus_path):
1017
 
                raise dbus.exceptions.DBusException("Test")
1018
 
 
1019
 
        # assertLogs only exists in Python 3.4
1020
 
        if hasattr(self, "assertLogs"):
1021
 
            with self.assertLogs(log, logging.CRITICAL):
1022
 
                with self.assertRaises(SystemExit) as e:
1023
 
                    bus = get_mandos_dbus_object(bus=MockBus())
1024
 
        else:
1025
 
            critical_filter = self.CriticalFilter()
1026
 
            log.addFilter(critical_filter)
1027
 
            try:
1028
 
                with self.assertRaises(SystemExit) as e:
1029
 
                    get_mandos_dbus_object(bus=MockBusFailing())
1030
 
            finally:
1031
 
                log.removeFilter(critical_filter)
1032
 
            self.assertTrue(critical_filter.found)
1033
 
        if isinstance(e.exception.code, int):
1034
 
            self.assertNotEqual(e.exception.code, 0)
1035
 
        else:
1036
 
            self.assertIsNotNone(e.exception.code)
1037
 
 
1038
 
    class CriticalFilter(logging.Filter):
1039
 
        """Don't show, but register, critical messages"""
1040
 
        found = False
1041
 
        def filter(self, record):
1042
 
            is_critical = record.levelno >= logging.CRITICAL
1043
 
            self.found = is_critical or self.found
1044
 
            return not is_critical
1045
 
 
1046
 
 
1047
 
class Test_SilenceLogger(unittest.TestCase):
1048
 
    loggername = "mandos-ctl.Test_SilenceLogger"
1049
 
    log = logging.getLogger(loggername)
1050
 
    log.propagate = False
1051
 
    log.addHandler(logging.NullHandler())
1052
 
 
1053
 
    def setUp(self):
1054
 
        self.counting_filter = self.CountingFilter()
1055
 
 
1056
 
    class CountingFilter(logging.Filter):
1057
 
        "Count number of records"
1058
 
        count = 0
1059
 
        def filter(self, record):
1060
 
            self.count += 1
1061
 
            return True
1062
 
 
1063
 
    def test_should_filter_records_only_when_active(self):
1064
 
        try:
1065
 
            with SilenceLogger(self.loggername):
1066
 
                self.log.addFilter(self.counting_filter)
1067
 
                self.log.info("Filtered log message 1")
1068
 
            self.log.info("Non-filtered message 2")
1069
 
            self.log.info("Non-filtered message 3")
1070
 
        finally:
1071
 
            self.log.removeFilter(self.counting_filter)
1072
 
        self.assertEqual(self.counting_filter.count, 2)
1073
 
 
1074
 
 
1075
 
class Test_commands_from_options(unittest.TestCase):
1076
 
    def setUp(self):
1077
 
        self.parser = argparse.ArgumentParser()
1078
 
        add_command_line_options(self.parser)
1079
 
 
1080
 
    def test_is_enabled(self):
1081
 
        self.assert_command_from_args(["--is-enabled", "foo"],
1082
 
                                      IsEnabledCmd)
1083
 
 
1084
 
    def assert_command_from_args(self, args, command_cls,
1085
 
                                 **cmd_attrs):
1086
 
        """Assert that parsing ARGS should result in an instance of
1087
 
COMMAND_CLS with (optionally) all supplied attributes (CMD_ATTRS)."""
1088
 
        options = self.parser.parse_args(args)
1089
 
        check_option_syntax(self.parser, options)
1090
 
        commands = commands_from_options(options)
1091
 
        self.assertEqual(len(commands), 1)
1092
 
        command = commands[0]
1093
 
        self.assertIsInstance(command, command_cls)
1094
 
        for key, value in cmd_attrs.items():
1095
 
            self.assertEqual(getattr(command, key), value)
1096
 
 
1097
 
    def test_is_enabled_short(self):
1098
 
        self.assert_command_from_args(["-V", "foo"], IsEnabledCmd)
1099
 
 
1100
 
    def test_approve(self):
1101
 
        self.assert_command_from_args(["--approve", "foo"],
1102
 
                                      ApproveCmd)
1103
 
 
1104
 
    def test_approve_short(self):
1105
 
        self.assert_command_from_args(["-A", "foo"], ApproveCmd)
1106
 
 
1107
 
    def test_deny(self):
1108
 
        self.assert_command_from_args(["--deny", "foo"], DenyCmd)
1109
 
 
1110
 
    def test_deny_short(self):
1111
 
        self.assert_command_from_args(["-D", "foo"], DenyCmd)
1112
 
 
1113
 
    def test_remove(self):
1114
 
        self.assert_command_from_args(["--remove", "foo"],
1115
 
                                      RemoveCmd)
1116
 
 
1117
 
    def test_deny_before_remove(self):
1118
 
        options = self.parser.parse_args(["--deny", "--remove",
1119
 
                                          "foo"])
1120
 
        check_option_syntax(self.parser, options)
1121
 
        commands = commands_from_options(options)
1122
 
        self.assertEqual(len(commands), 2)
1123
 
        self.assertIsInstance(commands[0], DenyCmd)
1124
 
        self.assertIsInstance(commands[1], RemoveCmd)
1125
 
 
1126
 
    def test_deny_before_remove_reversed(self):
1127
 
        options = self.parser.parse_args(["--remove", "--deny",
1128
 
                                          "--all"])
1129
 
        check_option_syntax(self.parser, options)
1130
 
        commands = commands_from_options(options)
1131
 
        self.assertEqual(len(commands), 2)
1132
 
        self.assertIsInstance(commands[0], DenyCmd)
1133
 
        self.assertIsInstance(commands[1], RemoveCmd)
1134
 
 
1135
 
    def test_remove_short(self):
1136
 
        self.assert_command_from_args(["-r", "foo"], RemoveCmd)
1137
 
 
1138
 
    def test_dump_json(self):
1139
 
        self.assert_command_from_args(["--dump-json"], DumpJSONCmd)
1140
 
 
1141
 
    def test_enable(self):
1142
 
        self.assert_command_from_args(["--enable", "foo"], EnableCmd)
1143
 
 
1144
 
    def test_enable_short(self):
1145
 
        self.assert_command_from_args(["-e", "foo"], EnableCmd)
1146
 
 
1147
 
    def test_disable(self):
1148
 
        self.assert_command_from_args(["--disable", "foo"],
1149
 
                                      DisableCmd)
1150
 
 
1151
 
    def test_disable_short(self):
1152
 
        self.assert_command_from_args(["-d", "foo"], DisableCmd)
1153
 
 
1154
 
    def test_bump_timeout(self):
1155
 
        self.assert_command_from_args(["--bump-timeout", "foo"],
1156
 
                                      BumpTimeoutCmd)
1157
 
 
1158
 
    def test_bump_timeout_short(self):
1159
 
        self.assert_command_from_args(["-b", "foo"], BumpTimeoutCmd)
1160
 
 
1161
 
    def test_start_checker(self):
1162
 
        self.assert_command_from_args(["--start-checker", "foo"],
1163
 
                                      StartCheckerCmd)
1164
 
 
1165
 
    def test_stop_checker(self):
1166
 
        self.assert_command_from_args(["--stop-checker", "foo"],
1167
 
                                      StopCheckerCmd)
1168
 
 
1169
 
    def test_approve_by_default(self):
1170
 
        self.assert_command_from_args(["--approve-by-default", "foo"],
1171
 
                                      ApproveByDefaultCmd)
1172
 
 
1173
 
    def test_deny_by_default(self):
1174
 
        self.assert_command_from_args(["--deny-by-default", "foo"],
1175
 
                                      DenyByDefaultCmd)
1176
 
 
1177
 
    def test_checker(self):
1178
 
        self.assert_command_from_args(["--checker", ":", "foo"],
1179
 
                                      SetCheckerCmd, value_to_set=":")
1180
 
 
1181
 
    def test_checker_empty(self):
1182
 
        self.assert_command_from_args(["--checker", "", "foo"],
1183
 
                                      SetCheckerCmd, value_to_set="")
1184
 
 
1185
 
    def test_checker_short(self):
1186
 
        self.assert_command_from_args(["-c", ":", "foo"],
1187
 
                                      SetCheckerCmd, value_to_set=":")
1188
 
 
1189
 
    def test_host(self):
1190
 
        self.assert_command_from_args(["--host", "foo.example.org",
1191
 
                                       "foo"], SetHostCmd,
1192
 
                                      value_to_set="foo.example.org")
1193
 
 
1194
 
    def test_host_short(self):
1195
 
        self.assert_command_from_args(["-H", "foo.example.org",
1196
 
                                       "foo"], SetHostCmd,
1197
 
                                      value_to_set="foo.example.org")
1198
 
 
1199
 
    def test_secret_devnull(self):
1200
 
        self.assert_command_from_args(["--secret", os.path.devnull,
1201
 
                                       "foo"], SetSecretCmd,
1202
 
                                      value_to_set=b"")
1203
 
 
1204
 
    def test_secret_tempfile(self):
1205
 
        with tempfile.NamedTemporaryFile(mode="r+b") as f:
1206
 
            value = b"secret\0xyzzy\nbar"
1207
 
            f.write(value)
1208
 
            f.seek(0)
1209
 
            self.assert_command_from_args(["--secret", f.name,
1210
 
                                           "foo"], SetSecretCmd,
1211
 
                                          value_to_set=value)
1212
 
 
1213
 
    def test_secret_devnull_short(self):
1214
 
        self.assert_command_from_args(["-s", os.path.devnull, "foo"],
1215
 
                                      SetSecretCmd, value_to_set=b"")
1216
 
 
1217
 
    def test_secret_tempfile_short(self):
1218
 
        with tempfile.NamedTemporaryFile(mode="r+b") as f:
1219
 
            value = b"secret\0xyzzy\nbar"
1220
 
            f.write(value)
1221
 
            f.seek(0)
1222
 
            self.assert_command_from_args(["-s", f.name, "foo"],
1223
 
                                          SetSecretCmd,
1224
 
                                          value_to_set=value)
1225
 
 
1226
 
    def test_timeout(self):
1227
 
        self.assert_command_from_args(["--timeout", "PT5M", "foo"],
1228
 
                                      SetTimeoutCmd,
1229
 
                                      value_to_set=300000)
1230
 
 
1231
 
    def test_timeout_short(self):
1232
 
        self.assert_command_from_args(["-t", "PT5M", "foo"],
1233
 
                                      SetTimeoutCmd,
1234
 
                                      value_to_set=300000)
1235
 
 
1236
 
    def test_extended_timeout(self):
1237
 
        self.assert_command_from_args(["--extended-timeout", "PT15M",
1238
 
                                       "foo"],
1239
 
                                      SetExtendedTimeoutCmd,
1240
 
                                      value_to_set=900000)
1241
 
 
1242
 
    def test_interval(self):
1243
 
        self.assert_command_from_args(["--interval", "PT2M", "foo"],
1244
 
                                      SetIntervalCmd,
1245
 
                                      value_to_set=120000)
1246
 
 
1247
 
    def test_interval_short(self):
1248
 
        self.assert_command_from_args(["-i", "PT2M", "foo"],
1249
 
                                      SetIntervalCmd,
1250
 
                                      value_to_set=120000)
1251
 
 
1252
 
    def test_approval_delay(self):
1253
 
        self.assert_command_from_args(["--approval-delay", "PT30S",
1254
 
                                       "foo"], SetApprovalDelayCmd,
1255
 
                                      value_to_set=30000)
1256
 
 
1257
 
    def test_approval_duration(self):
1258
 
        self.assert_command_from_args(["--approval-duration", "PT1S",
1259
 
                                       "foo"], SetApprovalDurationCmd,
1260
 
                                      value_to_set=1000)
1261
 
 
1262
 
    def test_print_table(self):
1263
 
        self.assert_command_from_args([], PrintTableCmd,
1264
 
                                      verbose=False)
1265
 
 
1266
 
    def test_print_table_verbose(self):
1267
 
        self.assert_command_from_args(["--verbose"], PrintTableCmd,
1268
 
                                      verbose=True)
1269
 
 
1270
 
    def test_print_table_verbose_short(self):
1271
 
        self.assert_command_from_args(["-v"], PrintTableCmd,
1272
 
                                      verbose=True)
1273
 
 
1274
 
 
1275
790
class TestCmd(unittest.TestCase):
1276
791
    """Abstract class for tests of command classes"""
1277
 
 
1278
792
    def setUp(self):
1279
793
        testcase = self
1280
794
        class MockClient(object):
1281
795
            def __init__(self, name, **attributes):
1282
 
                self.__dbus_object_path__ = "/clients/{}".format(name)
 
796
                self.__dbus_object_path__ = "objpath_{}".format(name)
1283
797
                self.attributes = attributes
1284
798
                self.attributes["Name"] = name
1285
799
                self.calls = []
1286
 
            def Set(self, interface, propname, value, dbus_interface):
1287
 
                testcase.assertEqual(interface, client_dbus_interface)
1288
 
                testcase.assertEqual(dbus_interface,
1289
 
                                     dbus.PROPERTIES_IFACE)
1290
 
                self.attributes[propname] = value
1291
 
            def Get(self, interface, propname, dbus_interface):
1292
 
                testcase.assertEqual(interface, client_dbus_interface)
1293
 
                testcase.assertEqual(dbus_interface,
1294
 
                                     dbus.PROPERTIES_IFACE)
1295
 
                return self.attributes[propname]
 
800
            def Set(self, interface, property, value, dbus_interface):
 
801
                testcase.assertEqual(interface, client_interface)
 
802
                testcase.assertEqual(dbus_interface,
 
803
                                     dbus.PROPERTIES_IFACE)
 
804
                self.attributes[property] = value
 
805
            def Get(self, interface, property, dbus_interface):
 
806
                testcase.assertEqual(interface, client_interface)
 
807
                testcase.assertEqual(dbus_interface,
 
808
                                     dbus.PROPERTIES_IFACE)
 
809
                return self.attributes[property]
1296
810
            def Approve(self, approve, dbus_interface):
1297
 
                testcase.assertEqual(dbus_interface,
1298
 
                                     client_dbus_interface)
 
811
                testcase.assertEqual(dbus_interface, client_interface)
1299
812
                self.calls.append(("Approve", (approve,
1300
813
                                               dbus_interface)))
1301
814
        self.client = MockClient(
1341
854
            ApprovedByDefault=dbus.Boolean(False),
1342
855
            LastApprovalRequest="2019-01-03T00:00:00",
1343
856
            ApprovalDelay=30000,
1344
 
            ApprovalDuration=93785000,
 
857
            ApprovalDuration=1000,
1345
858
            Checker=":",
1346
859
            ExtendedTimeout=900000,
1347
860
            Expires="2019-02-05T00:00:00",
1348
861
            LastCheckerStatus=-2)
1349
862
        self.clients =  collections.OrderedDict(
1350
863
            [
1351
 
                ("/clients/foo", self.client.attributes),
1352
 
                ("/clients/barbar", self.other_client.attributes),
 
864
                (self.client, self.client.attributes),
 
865
                (self.other_client, self.other_client.attributes),
1353
866
            ])
1354
 
        self.one_client = {"/clients/foo": self.client.attributes}
1355
 
 
1356
 
    @property
1357
 
    def bus(self):
1358
 
        class Bus(object):
1359
 
            @staticmethod
1360
 
            def get_object(client_bus_name, path):
1361
 
                self.assertEqual(client_bus_name, dbus_busname)
1362
 
                return {
1363
 
                    # Note: "self" here is the TestCmd instance, not
1364
 
                    # the Bus instance, since this is a static method!
1365
 
                    "/clients/foo": self.client,
1366
 
                    "/clients/barbar": self.other_client,
1367
 
                }[path]
1368
 
        return Bus()
1369
 
 
1370
 
 
1371
 
class TestIsEnabledCmd(TestCmd):
1372
 
    def test_is_enabled(self):
1373
 
        self.assertTrue(all(IsEnabledCmd().is_enabled(client,
1374
 
                                                      properties)
1375
 
                            for client, properties
1376
 
                            in self.clients.items()))
1377
 
 
1378
 
    def test_is_enabled_run_exits_successfully(self):
1379
 
        with self.assertRaises(SystemExit) as e:
1380
 
            IsEnabledCmd().run(self.one_client)
1381
 
        if e.exception.code is not None:
1382
 
            self.assertEqual(e.exception.code, 0)
1383
 
        else:
1384
 
            self.assertIsNone(e.exception.code)
1385
 
 
1386
 
    def test_is_enabled_run_exits_with_failure(self):
1387
 
        self.client.attributes["Enabled"] = dbus.Boolean(False)
1388
 
        with self.assertRaises(SystemExit) as e:
1389
 
            IsEnabledCmd().run(self.one_client)
1390
 
        if isinstance(e.exception.code, int):
1391
 
            self.assertNotEqual(e.exception.code, 0)
1392
 
        else:
1393
 
            self.assertIsNotNone(e.exception.code)
1394
 
 
1395
 
 
1396
 
class TestApproveCmd(TestCmd):
1397
 
    def test_approve(self):
1398
 
        ApproveCmd().run(self.clients, self.bus)
1399
 
        for clientpath in self.clients:
1400
 
            client = self.bus.get_object(dbus_busname, clientpath)
1401
 
            self.assertIn(("Approve", (True, client_dbus_interface)),
1402
 
                          client.calls)
1403
 
 
1404
 
 
1405
 
class TestDenyCmd(TestCmd):
1406
 
    def test_deny(self):
1407
 
        DenyCmd().run(self.clients, self.bus)
1408
 
        for clientpath in self.clients:
1409
 
            client = self.bus.get_object(dbus_busname, clientpath)
1410
 
            self.assertIn(("Approve", (False, client_dbus_interface)),
1411
 
                          client.calls)
1412
 
 
1413
 
 
1414
 
class TestRemoveCmd(TestCmd):
1415
 
    def test_remove(self):
1416
 
        class MockMandos(object):
1417
 
            def __init__(self):
1418
 
                self.calls = []
1419
 
            def RemoveClient(self, dbus_path):
1420
 
                self.calls.append(("RemoveClient", (dbus_path,)))
1421
 
        mandos = MockMandos()
1422
 
        super(TestRemoveCmd, self).setUp()
1423
 
        RemoveCmd().run(self.clients, self.bus, mandos)
1424
 
        self.assertEqual(len(mandos.calls), 2)
1425
 
        for clientpath in self.clients:
1426
 
            self.assertIn(("RemoveClient", (clientpath,)),
1427
 
                          mandos.calls)
1428
 
 
 
867
        self.one_client = {self.client: self.client.attributes}
 
868
 
 
869
class TestPrintTableCmd(TestCmd):
 
870
    def test_normal(self):
 
871
        output = PrintTableCmd().output(self.clients)
 
872
        expected_output = """
 
873
Name   Enabled Timeout  Last Successful Check
 
874
foo    Yes     00:05:00 2019-02-03T00:00:00  
 
875
barbar Yes     00:05:00 2019-02-04T00:00:00  
 
876
"""[1:-1]
 
877
        self.assertEqual(output, expected_output)
 
878
    def test_verbose(self):
 
879
        output = PrintTableCmd(verbose=True).output(self.clients)
 
880
        expected_output = """
 
881
Name   Enabled Timeout  Last Successful Check Created             Interval Host            Key ID                                                           Fingerprint                              Check Is Running Last Enabled        Approval Is Pending Approved By Default Last Approval Request Approval Delay Approval Duration Checker              Extended Timeout Expires             Last Checker Status
 
882
foo    Yes     00:05:00 2019-02-03T00:00:00   2019-01-02T00:00:00 00:02:00 foo.example.org 92ed150794387c03ce684574b1139a6594a34f895daaaf09fd8ea90a27cddb12 778827225BA7DE539C5A7CFA59CFF7CDBD9A5920 No               2019-01-03T00:00:00 No                  Yes                                       00:00:00       00:00:01          fping -q -- %(host)s 00:15:00         2019-02-04T00:00:00 0                  
 
883
barbar Yes     00:05:00 2019-02-04T00:00:00   2019-01-03T00:00:00 00:02:00 192.0.2.3       0558568eedd67d622f5c83b35a115f796ab612cff5ad227247e46c2b020f441c 3E393AEAEFB84C7E89E2F547B3A107558FCA3A27 Yes              2019-01-04T00:00:00 No                  No                  2019-01-03T00:00:00   00:00:30       00:00:01          :                    00:15:00         2019-02-05T00:00:00 -2                 
 
884
"""[1:-1]
 
885
        self.assertEqual(output, expected_output)
 
886
    def test_one_client(self):
 
887
        output = PrintTableCmd().output(self.one_client)
 
888
        expected_output = """
 
889
Name Enabled Timeout  Last Successful Check
 
890
foo  Yes     00:05:00 2019-02-03T00:00:00  
 
891
"""[1:-1]
 
892
        self.assertEqual(output, expected_output)
1429
893
 
1430
894
class TestDumpJSONCmd(TestCmd):
1431
895
    def setUp(self):
1472
936
                "ApprovedByDefault": False,
1473
937
                "LastApprovalRequest": "2019-01-03T00:00:00",
1474
938
                "ApprovalDelay": 30000,
1475
 
                "ApprovalDuration": 93785000,
 
939
                "ApprovalDuration": 1000,
1476
940
                "Checker": ":",
1477
941
                "ExtendedTimeout": 900000,
1478
942
                "Expires": "2019-02-05T00:00:00",
1480
944
            },
1481
945
        }
1482
946
        return super(TestDumpJSONCmd, self).setUp()
1483
 
 
1484
947
    def test_normal(self):
1485
 
        output = DumpJSONCmd().output(self.clients.values())
1486
 
        json_data = json.loads(output)
 
948
        json_data = json.loads(DumpJSONCmd().output(self.clients))
1487
949
        self.assertDictEqual(json_data, self.expected_json)
1488
 
 
1489
950
    def test_one_client(self):
1490
 
        output = DumpJSONCmd().output(self.one_client.values())
1491
 
        json_data = json.loads(output)
 
951
        clients = self.one_client
 
952
        json_data = json.loads(DumpJSONCmd().output(clients))
1492
953
        expected_json = {"foo": self.expected_json["foo"]}
1493
954
        self.assertDictEqual(json_data, expected_json)
1494
955
 
1495
 
 
1496
 
class TestPrintTableCmd(TestCmd):
1497
 
    def test_normal(self):
1498
 
        output = PrintTableCmd().output(self.clients.values())
1499
 
        expected_output = "\n".join((
1500
 
            "Name   Enabled Timeout  Last Successful Check",
1501
 
            "foo    Yes     00:05:00 2019-02-03T00:00:00  ",
1502
 
            "barbar Yes     00:05:00 2019-02-04T00:00:00  ",
1503
 
        ))
1504
 
        self.assertEqual(output, expected_output)
1505
 
 
1506
 
    def test_verbose(self):
1507
 
        output = PrintTableCmd(verbose=True).output(
1508
 
            self.clients.values())
1509
 
        columns = (
1510
 
            (
1511
 
                "Name   ",
1512
 
                "foo    ",
1513
 
                "barbar ",
1514
 
            ),(
1515
 
                "Enabled ",
1516
 
                "Yes     ",
1517
 
                "Yes     ",
1518
 
            ),(
1519
 
                "Timeout  ",
1520
 
                "00:05:00 ",
1521
 
                "00:05:00 ",
1522
 
            ),(
1523
 
                "Last Successful Check ",
1524
 
                "2019-02-03T00:00:00   ",
1525
 
                "2019-02-04T00:00:00   ",
1526
 
            ),(
1527
 
                "Created             ",
1528
 
                "2019-01-02T00:00:00 ",
1529
 
                "2019-01-03T00:00:00 ",
1530
 
            ),(
1531
 
                "Interval ",
1532
 
                "00:02:00 ",
1533
 
                "00:02:00 ",
1534
 
            ),(
1535
 
                "Host            ",
1536
 
                "foo.example.org ",
1537
 
                "192.0.2.3       ",
1538
 
            ),(
1539
 
                ("Key ID                                             "
1540
 
                 "              "),
1541
 
                ("92ed150794387c03ce684574b1139a6594a34f895daaaf09fd8"
1542
 
                 "ea90a27cddb12 "),
1543
 
                ("0558568eedd67d622f5c83b35a115f796ab612cff5ad227247e"
1544
 
                 "46c2b020f441c "),
1545
 
            ),(
1546
 
                "Fingerprint                              ",
1547
 
                "778827225BA7DE539C5A7CFA59CFF7CDBD9A5920 ",
1548
 
                "3E393AEAEFB84C7E89E2F547B3A107558FCA3A27 ",
1549
 
            ),(
1550
 
                "Check Is Running ",
1551
 
                "No               ",
1552
 
                "Yes              ",
1553
 
            ),(
1554
 
                "Last Enabled        ",
1555
 
                "2019-01-03T00:00:00 ",
1556
 
                "2019-01-04T00:00:00 ",
1557
 
            ),(
1558
 
                "Approval Is Pending ",
1559
 
                "No                  ",
1560
 
                "No                  ",
1561
 
            ),(
1562
 
                "Approved By Default ",
1563
 
                "Yes                 ",
1564
 
                "No                  ",
1565
 
            ),(
1566
 
                "Last Approval Request ",
1567
 
                "                      ",
1568
 
                "2019-01-03T00:00:00   ",
1569
 
            ),(
1570
 
                "Approval Delay ",
1571
 
                "00:00:00       ",
1572
 
                "00:00:30       ",
1573
 
            ),(
1574
 
                "Approval Duration ",
1575
 
                "00:00:01          ",
1576
 
                "1T02:03:05        ",
1577
 
            ),(
1578
 
                "Checker              ",
1579
 
                "fping -q -- %(host)s ",
1580
 
                ":                    ",
1581
 
            ),(
1582
 
                "Extended Timeout ",
1583
 
                "00:15:00         ",
1584
 
                "00:15:00         ",
1585
 
            ),(
1586
 
                "Expires             ",
1587
 
                "2019-02-04T00:00:00 ",
1588
 
                "2019-02-05T00:00:00 ",
1589
 
            ),(
1590
 
                "Last Checker Status",
1591
 
                "0                  ",
1592
 
                "-2                 ",
1593
 
            )
1594
 
        )
1595
 
        num_lines = max(len(rows) for rows in columns)
1596
 
        expected_output = "\n".join("".join(rows[line]
1597
 
                                            for rows in columns)
1598
 
                                    for line in range(num_lines))
1599
 
        self.assertEqual(output, expected_output)
1600
 
 
1601
 
    def test_one_client(self):
1602
 
        output = PrintTableCmd().output(self.one_client.values())
1603
 
        expected_output = "\n".join((
1604
 
            "Name Enabled Timeout  Last Successful Check",
1605
 
            "foo  Yes     00:05:00 2019-02-03T00:00:00  ",
1606
 
        ))
1607
 
        self.assertEqual(output, expected_output)
1608
 
 
 
956
class TestIsEnabledCmd(TestCmd):
 
957
    def test_is_enabled(self):
 
958
        self.assertTrue(all(IsEnabledCmd().is_enabled(client, properties)
 
959
                            for client, properties in self.clients.items()))
 
960
    def test_is_enabled_run_exits_successfully(self):
 
961
        with self.assertRaises(SystemExit) as e:
 
962
            IsEnabledCmd().run(None, self.one_client)
 
963
        if e.exception.code is not None:
 
964
            self.assertEqual(e.exception.code, 0)
 
965
        else:
 
966
            self.assertIsNone(e.exception.code)
 
967
    def test_is_enabled_run_exits_with_failure(self):
 
968
        self.client.attributes["Enabled"] = dbus.Boolean(False)
 
969
        with self.assertRaises(SystemExit) as e:
 
970
            IsEnabledCmd().run(None, self.one_client)
 
971
        if isinstance(e.exception.code, int):
 
972
            self.assertNotEqual(e.exception.code, 0)
 
973
        else:
 
974
            self.assertIsNotNone(e.exception.code)
 
975
 
 
976
class TestRemoveCmd(TestCmd):
 
977
    def test_remove(self):
 
978
        class MockMandos(object):
 
979
            def __init__(self):
 
980
                self.calls = []
 
981
            def RemoveClient(self, dbus_path):
 
982
                self.calls.append(("RemoveClient", (dbus_path,)))
 
983
        mandos = MockMandos()
 
984
        super(TestRemoveCmd, self).setUp()
 
985
        RemoveCmd().run(mandos, self.clients)
 
986
        self.assertEqual(len(mandos.calls), 2)
 
987
        for client in self.clients:
 
988
            self.assertIn(("RemoveClient",
 
989
                           (client.__dbus_object_path__,)),
 
990
                          mandos.calls)
 
991
 
 
992
class TestApproveCmd(TestCmd):
 
993
    def test_approve(self):
 
994
        ApproveCmd().run(None, self.clients)
 
995
        for client in self.clients:
 
996
            self.assertIn(("Approve", (True, client_interface)),
 
997
                          client.calls)
 
998
 
 
999
class TestDenyCmd(TestCmd):
 
1000
    def test_deny(self):
 
1001
        DenyCmd().run(None, self.clients)
 
1002
        for client in self.clients:
 
1003
            self.assertIn(("Approve", (False, client_interface)),
 
1004
                          client.calls)
 
1005
 
 
1006
class TestEnableCmd(TestCmd):
 
1007
    def test_enable(self):
 
1008
        for client in self.clients:
 
1009
            client.attributes["Enabled"] = False
 
1010
 
 
1011
        EnableCmd().run(None, self.clients)
 
1012
 
 
1013
        for client in self.clients:
 
1014
            self.assertTrue(client.attributes["Enabled"])
 
1015
 
 
1016
class TestDisableCmd(TestCmd):
 
1017
    def test_disable(self):
 
1018
        DisableCmd().run(None, self.clients)
 
1019
 
 
1020
        for client in self.clients:
 
1021
            self.assertFalse(client.attributes["Enabled"])
 
1022
 
 
1023
class Unique(object):
 
1024
    """Class for objects which exist only to be unique objects, since
 
1025
unittest.mock.sentinel only exists in Python 3.3"""
1609
1026
 
1610
1027
class TestPropertyCmd(TestCmd):
1611
1028
    """Abstract class for tests of PropertyCmd classes"""
1616
1033
                                self.values_to_set)
1617
1034
        for value_to_set, value_to_get in zip(self.values_to_set,
1618
1035
                                              values_to_get):
1619
 
            for clientpath in self.clients:
1620
 
                client = self.bus.get_object(dbus_busname, clientpath)
1621
 
                old_value = client.attributes[self.propname]
1622
 
                self.assertNotIsInstance(old_value, self.Unique)
1623
 
                client.attributes[self.propname] = self.Unique()
 
1036
            for client in self.clients:
 
1037
                old_value = client.attributes[self.property]
 
1038
                self.assertNotIsInstance(old_value, Unique)
 
1039
                client.attributes[self.property] = Unique()
1624
1040
            self.run_command(value_to_set, self.clients)
1625
 
            for clientpath in self.clients:
1626
 
                client = self.bus.get_object(dbus_busname, clientpath)
1627
 
                value = client.attributes[self.propname]
1628
 
                self.assertNotIsInstance(value, self.Unique)
 
1041
            for client in self.clients:
 
1042
                value = client.attributes[self.property]
 
1043
                self.assertNotIsInstance(value, Unique)
1629
1044
                self.assertEqual(value, value_to_get)
1630
 
 
1631
 
    class Unique(object):
1632
 
        """Class for objects which exist only to be unique objects,
1633
 
since unittest.mock.sentinel only exists in Python 3.3"""
1634
 
 
1635
1045
    def run_command(self, value, clients):
1636
 
        self.command().run(clients, self.bus)
1637
 
 
1638
 
 
1639
 
class TestEnableCmd(TestPropertyCmd):
1640
 
    command = EnableCmd
1641
 
    propname = "Enabled"
1642
 
    values_to_set = [dbus.Boolean(True)]
1643
 
 
1644
 
 
1645
 
class TestDisableCmd(TestPropertyCmd):
1646
 
    command = DisableCmd
1647
 
    propname = "Enabled"
1648
 
    values_to_set = [dbus.Boolean(False)]
1649
 
 
 
1046
        self.command().run(None, clients)
1650
1047
 
1651
1048
class TestBumpTimeoutCmd(TestPropertyCmd):
1652
1049
    command = BumpTimeoutCmd
1653
 
    propname = "LastCheckedOK"
 
1050
    property = "LastCheckedOK"
1654
1051
    values_to_set = [""]
1655
1052
 
1656
 
 
1657
1053
class TestStartCheckerCmd(TestPropertyCmd):
1658
1054
    command = StartCheckerCmd
1659
 
    propname = "CheckerRunning"
 
1055
    property = "CheckerRunning"
1660
1056
    values_to_set = [dbus.Boolean(True)]
1661
1057
 
1662
 
 
1663
1058
class TestStopCheckerCmd(TestPropertyCmd):
1664
1059
    command = StopCheckerCmd
1665
 
    propname = "CheckerRunning"
 
1060
    property = "CheckerRunning"
1666
1061
    values_to_set = [dbus.Boolean(False)]
1667
1062
 
1668
 
 
1669
1063
class TestApproveByDefaultCmd(TestPropertyCmd):
1670
1064
    command = ApproveByDefaultCmd
1671
 
    propname = "ApprovedByDefault"
 
1065
    property = "ApprovedByDefault"
1672
1066
    values_to_set = [dbus.Boolean(True)]
1673
1067
 
1674
 
 
1675
1068
class TestDenyByDefaultCmd(TestPropertyCmd):
1676
1069
    command = DenyByDefaultCmd
1677
 
    propname = "ApprovedByDefault"
 
1070
    property = "ApprovedByDefault"
1678
1071
    values_to_set = [dbus.Boolean(False)]
1679
1072
 
1680
 
 
1681
 
class TestPropertyValueCmd(TestPropertyCmd):
1682
 
    """Abstract class for tests of PropertyValueCmd classes"""
1683
 
 
 
1073
class TestValueArgumentPropertyCmd(TestPropertyCmd):
 
1074
    """Abstract class for tests of PropertyCmd classes using the
 
1075
ValueArgumentMixIn"""
1684
1076
    def runTest(self):
1685
 
        if type(self) is TestPropertyValueCmd:
 
1077
        if type(self) is TestValueArgumentPropertyCmd:
1686
1078
            return
1687
 
        return super(TestPropertyValueCmd, self).runTest()
1688
 
 
 
1079
        return super(TestValueArgumentPropertyCmd, self).runTest()
1689
1080
    def run_command(self, value, clients):
1690
 
        self.command(value).run(clients, self.bus)
1691
 
 
1692
 
 
1693
 
class TestSetCheckerCmd(TestPropertyValueCmd):
 
1081
        self.command(value).run(None, clients)
 
1082
 
 
1083
class TestSetCheckerCmd(TestValueArgumentPropertyCmd):
1694
1084
    command = SetCheckerCmd
1695
 
    propname = "Checker"
 
1085
    property = "Checker"
1696
1086
    values_to_set = ["", ":", "fping -q -- %s"]
1697
1087
 
1698
 
 
1699
 
class TestSetHostCmd(TestPropertyValueCmd):
 
1088
class TestSetHostCmd(TestValueArgumentPropertyCmd):
1700
1089
    command = SetHostCmd
1701
 
    propname = "Host"
 
1090
    property = "Host"
1702
1091
    values_to_set = ["192.0.2.3", "foo.example.org"]
1703
1092
 
1704
 
 
1705
 
class TestSetSecretCmd(TestPropertyValueCmd):
 
1093
class TestSetSecretCmd(TestValueArgumentPropertyCmd):
1706
1094
    command = SetSecretCmd
1707
 
    propname = "Secret"
1708
 
    values_to_set = [io.BytesIO(b""),
 
1095
    property = "Secret"
 
1096
    values_to_set = [open("/dev/null", "rb"),
1709
1097
                     io.BytesIO(b"secret\0xyzzy\nbar")]
1710
1098
    values_to_get = [b"", b"secret\0xyzzy\nbar"]
1711
1099
 
1712
 
 
1713
 
class TestSetTimeoutCmd(TestPropertyValueCmd):
 
1100
class TestSetTimeoutCmd(TestValueArgumentPropertyCmd):
1714
1101
    command = SetTimeoutCmd
1715
 
    propname = "Timeout"
1716
 
    values_to_set = [datetime.timedelta(),
1717
 
                     datetime.timedelta(minutes=5),
1718
 
                     datetime.timedelta(seconds=1),
1719
 
                     datetime.timedelta(weeks=1),
1720
 
                     datetime.timedelta(weeks=52)]
1721
 
    values_to_get = [0, 300000, 1000, 604800000, 31449600000]
1722
 
 
1723
 
 
1724
 
class TestSetExtendedTimeoutCmd(TestPropertyValueCmd):
 
1102
    property = "Timeout"
 
1103
    values_to_set = ["P0D", "PT5M", "PT1S", "PT120S", "P1Y"]
 
1104
    values_to_get = [0, 300000, 1000, 120000, 31449600000]
 
1105
 
 
1106
class TestSetExtendedTimeoutCmd(TestValueArgumentPropertyCmd):
1725
1107
    command = SetExtendedTimeoutCmd
1726
 
    propname = "ExtendedTimeout"
1727
 
    values_to_set = [datetime.timedelta(),
1728
 
                     datetime.timedelta(minutes=5),
1729
 
                     datetime.timedelta(seconds=1),
1730
 
                     datetime.timedelta(weeks=1),
1731
 
                     datetime.timedelta(weeks=52)]
1732
 
    values_to_get = [0, 300000, 1000, 604800000, 31449600000]
1733
 
 
1734
 
 
1735
 
class TestSetIntervalCmd(TestPropertyValueCmd):
 
1108
    property = "ExtendedTimeout"
 
1109
    values_to_set = ["P0D", "PT5M", "PT1S", "PT120S", "P1Y"]
 
1110
    values_to_get = [0, 300000, 1000, 120000, 31449600000]
 
1111
 
 
1112
class TestSetIntervalCmd(TestValueArgumentPropertyCmd):
1736
1113
    command = SetIntervalCmd
1737
 
    propname = "Interval"
1738
 
    values_to_set = [datetime.timedelta(),
1739
 
                     datetime.timedelta(minutes=5),
1740
 
                     datetime.timedelta(seconds=1),
1741
 
                     datetime.timedelta(weeks=1),
1742
 
                     datetime.timedelta(weeks=52)]
1743
 
    values_to_get = [0, 300000, 1000, 604800000, 31449600000]
1744
 
 
1745
 
 
1746
 
class TestSetApprovalDelayCmd(TestPropertyValueCmd):
 
1114
    property = "Interval"
 
1115
    values_to_set = ["P0D", "PT5M", "PT1S", "PT120S", "P1Y"]
 
1116
    values_to_get = [0, 300000, 1000, 120000, 31449600000]
 
1117
 
 
1118
class TestSetApprovalDelayCmd(TestValueArgumentPropertyCmd):
1747
1119
    command = SetApprovalDelayCmd
1748
 
    propname = "ApprovalDelay"
1749
 
    values_to_set = [datetime.timedelta(),
1750
 
                     datetime.timedelta(minutes=5),
1751
 
                     datetime.timedelta(seconds=1),
1752
 
                     datetime.timedelta(weeks=1),
1753
 
                     datetime.timedelta(weeks=52)]
1754
 
    values_to_get = [0, 300000, 1000, 604800000, 31449600000]
1755
 
 
1756
 
 
1757
 
class TestSetApprovalDurationCmd(TestPropertyValueCmd):
 
1120
    property = "ApprovalDelay"
 
1121
    values_to_set = ["P0D", "PT5M", "PT1S", "PT120S", "P1Y"]
 
1122
    values_to_get = [0, 300000, 1000, 120000, 31449600000]
 
1123
 
 
1124
class TestSetApprovalDurationCmd(TestValueArgumentPropertyCmd):
1758
1125
    command = SetApprovalDurationCmd
1759
 
    propname = "ApprovalDuration"
1760
 
    values_to_set = [datetime.timedelta(),
1761
 
                     datetime.timedelta(minutes=5),
1762
 
                     datetime.timedelta(seconds=1),
1763
 
                     datetime.timedelta(weeks=1),
1764
 
                     datetime.timedelta(weeks=52)]
1765
 
    values_to_get = [0, 300000, 1000, 604800000, 31449600000]
 
1126
    property = "ApprovalDuration"
 
1127
    values_to_set = ["P0D", "PT5M", "PT1S", "PT120S", "P1Y"]
 
1128
    values_to_get = [0, 300000, 1000, 120000, 31449600000]
 
1129
 
 
1130
class Test_command_from_options(unittest.TestCase):
 
1131
    def setUp(self):
 
1132
        self.parser = argparse.ArgumentParser()
 
1133
        add_command_line_options(self.parser)
 
1134
    def assert_command_from_args(self, args, command_cls, **cmd_attrs):
 
1135
        """Assert that parsing ARGS should result in an instance of
 
1136
COMMAND_CLS with (optionally) all supplied attributes (CMD_ATTRS)."""
 
1137
        options = self.parser.parse_args(args)
 
1138
        commands = commands_from_options(options)
 
1139
        self.assertEqual(len(commands), 1)
 
1140
        command = commands[0]
 
1141
        self.assertIsInstance(command, command_cls)
 
1142
        for key, value in cmd_attrs.items():
 
1143
            self.assertEqual(getattr(command, key), value)
 
1144
    def test_print_table(self):
 
1145
        self.assert_command_from_args([], PrintTableCmd,
 
1146
                                      verbose=False)
 
1147
 
 
1148
    def test_print_table_verbose(self):
 
1149
        self.assert_command_from_args(["--verbose"], PrintTableCmd,
 
1150
                                      verbose=True)
 
1151
 
 
1152
    def test_enable(self):
 
1153
        self.assert_command_from_args(["--enable", "foo"], EnableCmd)
 
1154
 
 
1155
    def test_disable(self):
 
1156
        self.assert_command_from_args(["--disable", "foo"],
 
1157
                                      DisableCmd)
 
1158
 
 
1159
    def test_bump_timeout(self):
 
1160
        self.assert_command_from_args(["--bump-timeout", "foo"],
 
1161
                                      BumpTimeoutCmd)
 
1162
 
 
1163
    def test_start_checker(self):
 
1164
        self.assert_command_from_args(["--start-checker", "foo"],
 
1165
                                      StartCheckerCmd)
 
1166
 
 
1167
    def test_stop_checker(self):
 
1168
        self.assert_command_from_args(["--stop-checker", "foo"],
 
1169
                                      StopCheckerCmd)
 
1170
 
 
1171
    def test_remove(self):
 
1172
        self.assert_command_from_args(["--remove", "foo"],
 
1173
                                      RemoveCmd)
 
1174
 
 
1175
    def test_checker(self):
 
1176
        self.assert_command_from_args(["--checker", ":", "foo"],
 
1177
                                      SetCheckerCmd, value_to_set=":")
 
1178
 
 
1179
    def test_timeout(self):
 
1180
        self.assert_command_from_args(["--timeout", "PT5M", "foo"],
 
1181
                                      SetTimeoutCmd,
 
1182
                                      value_to_set=300000)
 
1183
 
 
1184
    def test_extended_timeout(self):
 
1185
        self.assert_command_from_args(["--extended-timeout", "PT15M",
 
1186
                                       "foo"],
 
1187
                                      SetExtendedTimeoutCmd,
 
1188
                                      value_to_set=900000)
 
1189
 
 
1190
    def test_interval(self):
 
1191
        self.assert_command_from_args(["--interval", "PT2M", "foo"],
 
1192
                                      SetIntervalCmd,
 
1193
                                      value_to_set=120000)
 
1194
 
 
1195
    def test_approve_by_default(self):
 
1196
        self.assert_command_from_args(["--approve-by-default", "foo"],
 
1197
                                      ApproveByDefaultCmd)
 
1198
 
 
1199
    def test_deny_by_default(self):
 
1200
        self.assert_command_from_args(["--deny-by-default", "foo"],
 
1201
                                      DenyByDefaultCmd)
 
1202
 
 
1203
    def test_approval_delay(self):
 
1204
        self.assert_command_from_args(["--approval-delay", "PT30S",
 
1205
                                       "foo"], SetApprovalDelayCmd,
 
1206
                                      value_to_set=30000)
 
1207
 
 
1208
    def test_approval_duration(self):
 
1209
        self.assert_command_from_args(["--approval-duration", "PT1S",
 
1210
                                       "foo"], SetApprovalDurationCmd,
 
1211
                                      value_to_set=1000)
 
1212
 
 
1213
    def test_host(self):
 
1214
        self.assert_command_from_args(["--host", "foo.example.org",
 
1215
                                       "foo"], SetHostCmd,
 
1216
                                      value_to_set="foo.example.org")
 
1217
 
 
1218
    def test_secret_devnull(self):
 
1219
        self.assert_command_from_args(["--secret", os.path.devnull,
 
1220
                                       "foo"], SetSecretCmd,
 
1221
                                      value_to_set=b"")
 
1222
 
 
1223
    def test_secret_tempfile(self):
 
1224
        with tempfile.NamedTemporaryFile(mode="r+b") as f:
 
1225
            value = b"secret\0xyzzy\nbar"
 
1226
            f.write(value)
 
1227
            f.seek(0)
 
1228
            self.assert_command_from_args(["--secret", f.name,
 
1229
                                           "foo"], SetSecretCmd,
 
1230
                                          value_to_set=value)
 
1231
 
 
1232
    def test_approve(self):
 
1233
        self.assert_command_from_args(["--approve", "foo"],
 
1234
                                      ApproveCmd)
 
1235
 
 
1236
    def test_deny(self):
 
1237
        self.assert_command_from_args(["--deny", "foo"], DenyCmd)
 
1238
 
 
1239
    def test_dump_json(self):
 
1240
        self.assert_command_from_args(["--dump-json"], DumpJSONCmd)
 
1241
 
 
1242
    def test_is_enabled(self):
 
1243
        self.assert_command_from_args(["--is-enabled", "foo"],
 
1244
                                      IsEnabledCmd)
1766
1245
 
1767
1246
 
1768
1247
 
1783
1262
    return tests
1784
1263
 
1785
1264
if __name__ == "__main__":
1786
 
    try:
1787
 
        if should_only_run_tests():
1788
 
            # Call using ./tdd-python-script --check [--verbose]
1789
 
            unittest.main()
1790
 
        else:
1791
 
            main()
1792
 
    finally:
1793
 
        logging.shutdown()
 
1265
    if should_only_run_tests():
 
1266
        # Call using ./tdd-python-script --check [--verbose]
 
1267
        unittest.main()
 
1268
    else:
 
1269
        main()