/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to mandos-ctl

  • Committer: Teddy Hogeborn
  • Date: 2019-03-10 03:33:46 UTC
  • Revision ID: teddy@recompile.se-20190310033346-be20o4gcr3sjkr91
mandos-ctl: Refactor

* mandos-ctl (ValueArgumentMixIn): Remove.
  (PropertyValueCmd): New proper subclass of PropertyCmd; replaces
                      ValueArgumentMixIn.
  (MillisecondsValueArgumentMixIn): Remove.
  (MillisecondsPropertyValueArgumentCmd): New subclass of
            PropertyValueCmd; replaces MillisecondsValueArgumentMixIn.
  (TestValueArgumentPropertyCmd): Rename to "TestPropertyValueCmd".  All users changed.

Show diffs side-by-side

added added

removed removed

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