150
151
self.group = None # our entry group
151
152
self.server = None
154
self.entry_group_state_changed_match = None
153
155
def rename(self):
154
156
"""Derived from the Avahi example code"""
155
157
if self.rename_count >= self.max_renames:
156
logger.critical(u"No suitable Zeroconf service name found"
157
u" after %i retries, exiting.",
158
logger.critical("No suitable Zeroconf service name found"
159
" after %i retries, exiting.",
158
160
self.rename_count)
159
raise AvahiServiceError(u"Too many renames")
161
raise AvahiServiceError("Too many renames")
160
162
self.name = unicode(self.server.GetAlternativeServiceName(self.name))
161
logger.info(u"Changing Zeroconf service name to %r ...",
163
logger.info("Changing Zeroconf service name to %r ...",
163
165
syslogger.setFormatter(logging.Formatter
164
(u'Mandos (%s) [%%(process)d]:'
165
u' %%(levelname)s: %%(message)s'
166
('Mandos (%s) [%%(process)d]:'
167
' %%(levelname)s: %%(message)s'
170
except dbus.exceptions.DBusException, error:
171
logger.critical(u"DBusException: %s", error)
172
except dbus.exceptions.DBusException as error:
173
logger.critical("DBusException: %s", error)
174
176
self.rename_count += 1
175
177
def remove(self):
176
178
"""Derived from the Avahi example code"""
179
if self.entry_group_state_changed_match is not None:
180
self.entry_group_state_changed_match.remove()
181
self.entry_group_state_changed_match = None
177
182
if self.group is not None:
178
183
self.group.Reset()
180
185
"""Derived from the Avahi example code"""
181
187
if self.group is None:
182
188
self.group = dbus.Interface(
183
189
self.bus.get_object(avahi.DBUS_NAME,
184
190
self.server.EntryGroupNew()),
185
191
avahi.DBUS_INTERFACE_ENTRY_GROUP)
186
self.group.connect_to_signal('StateChanged',
188
.entry_group_state_changed)
189
logger.debug(u"Adding Zeroconf service '%s' of type '%s' ...",
192
self.entry_group_state_changed_match = (
193
self.group.connect_to_signal(
194
'StateChanged', self .entry_group_state_changed))
195
logger.debug("Adding Zeroconf service '%s' of type '%s' ...",
190
196
self.name, self.type)
191
197
self.group.AddService(
199
205
self.group.Commit()
200
206
def entry_group_state_changed(self, state, error):
201
207
"""Derived from the Avahi example code"""
202
logger.debug(u"Avahi entry group state change: %i", state)
208
logger.debug("Avahi entry group state change: %i", state)
204
210
if state == avahi.ENTRY_GROUP_ESTABLISHED:
205
logger.debug(u"Zeroconf service established.")
211
logger.debug("Zeroconf service established.")
206
212
elif state == avahi.ENTRY_GROUP_COLLISION:
207
logger.warning(u"Zeroconf service name collision.")
213
logger.info("Zeroconf service name collision.")
209
215
elif state == avahi.ENTRY_GROUP_FAILURE:
210
logger.critical(u"Avahi: Error in group state changed %s",
216
logger.critical("Avahi: Error in group state changed %s",
212
raise AvahiGroupError(u"State changed: %s"
218
raise AvahiGroupError("State changed: %s"
213
219
% unicode(error))
214
220
def cleanup(self):
215
221
"""Derived from the Avahi example code"""
216
222
if self.group is not None:
225
except (dbus.exceptions.UnknownMethodException,
226
dbus.exceptions.DBusException) as e:
218
228
self.group = None
219
def server_state_changed(self, state):
230
def server_state_changed(self, state, error=None):
220
231
"""Derived from the Avahi example code"""
221
logger.debug(u"Avahi server state change: %i", state)
222
if state == avahi.SERVER_COLLISION:
223
logger.error(u"Zeroconf server name collision")
232
logger.debug("Avahi server state change: %i", state)
233
bad_states = { avahi.SERVER_INVALID:
234
"Zeroconf server invalid",
235
avahi.SERVER_REGISTERING: None,
236
avahi.SERVER_COLLISION:
237
"Zeroconf server name collision",
238
avahi.SERVER_FAILURE:
239
"Zeroconf server failure" }
240
if state in bad_states:
241
if bad_states[state] is not None:
243
logger.error(bad_states[state])
245
logger.error(bad_states[state] + ": %r", error)
225
247
elif state == avahi.SERVER_RUNNING:
251
logger.debug("Unknown state: %r", state)
253
logger.debug("Unknown state: %r: %r", state, error)
227
254
def activate(self):
228
255
"""Derived from the Avahi example code"""
229
256
if self.server is None:
230
257
self.server = dbus.Interface(
231
258
self.bus.get_object(avahi.DBUS_NAME,
232
avahi.DBUS_PATH_SERVER),
259
avahi.DBUS_PATH_SERVER,
260
follow_name_owner_changes=True),
233
261
avahi.DBUS_INTERFACE_SERVER)
234
self.server.connect_to_signal(u"StateChanged",
262
self.server.connect_to_signal("StateChanged",
235
263
self.server_state_changed)
236
264
self.server_state_changed(self.server.GetState())
240
268
"""A representation of a client host served by this server.
243
name: string; from the config file, used in log messages and
271
_approved: bool(); 'None' if not yet approved/disapproved
272
approval_delay: datetime.timedelta(); Time to wait for approval
273
approval_duration: datetime.timedelta(); Duration of one approval
274
checker: subprocess.Popen(); a running checker process used
275
to see if the client lives.
276
'None' if no process is running.
277
checker_callback_tag: a gobject event source tag, or None
278
checker_command: string; External command which is run to check
279
if client lives. %() expansions are done at
280
runtime with vars(self) as dict, so that for
281
instance %(name)s can be used in the command.
282
checker_initiator_tag: a gobject event source tag, or None
283
created: datetime.datetime(); (UTC) object creation
284
current_checker_command: string; current running checker_command
285
disable_hook: If set, called by disable() as disable_hook(self)
286
disable_initiator_tag: a gobject event source tag, or None
245
288
fingerprint: string (40 or 32 hexadecimal digits); used to
246
289
uniquely identify the client
247
secret: bytestring; sent verbatim (over TLS) to client
248
290
host: string; available for use by the checker command
249
created: datetime.datetime(); (UTC) object creation
291
interval: datetime.timedelta(); How often to start a new checker
292
last_approval_request: datetime.datetime(); (UTC) or None
293
last_checked_ok: datetime.datetime(); (UTC) or None
250
294
last_enabled: datetime.datetime(); (UTC)
252
last_checked_ok: datetime.datetime(); (UTC) or None
295
name: string; from the config file, used in log messages and
297
secret: bytestring; sent verbatim (over TLS) to client
253
298
timeout: datetime.timedelta(); How long from last_checked_ok
254
299
until this client is disabled
255
interval: datetime.timedelta(); How often to start a new checker
256
disable_hook: If set, called by disable() as disable_hook(self)
257
checker: subprocess.Popen(); a running checker process used
258
to see if the client lives.
259
'None' if no process is running.
260
checker_initiator_tag: a gobject event source tag, or None
261
disable_initiator_tag: - '' -
262
checker_callback_tag: - '' -
263
checker_command: string; External command which is run to check if
264
client lives. %() expansions are done at
265
runtime with vars(self) as dict, so that for
266
instance %(name)s can be used in the command.
267
current_checker_command: string; current running checker_command
268
approved_delay: datetime.timedelta(); Time to wait for approval
269
_approved: bool(); 'None' if not yet approved/disapproved
270
approved_duration: datetime.timedelta(); Duration of one approval
300
extended_timeout: extra long timeout when password has been sent
301
runtime_expansions: Allowed attributes for runtime expansion.
302
expires: datetime.datetime(); time (UTC) when a client will be
306
runtime_expansions = ("approval_delay", "approval_duration",
307
"created", "enabled", "fingerprint",
308
"host", "interval", "last_checked_ok",
309
"last_enabled", "name", "timeout")
274
312
def _timedelta_to_milliseconds(td):
275
313
"Convert a datetime.timedelta() to milliseconds"
296
338
if config is None:
298
logger.debug(u"Creating client %r", self.name)
340
logger.debug("Creating client %r", self.name)
299
341
# Uppercase and remove spaces from fingerprint for later
300
342
# comparison purposes with return value from the fingerprint()
302
self.fingerprint = (config[u"fingerprint"].upper()
304
logger.debug(u" Fingerprint: %s", self.fingerprint)
305
if u"secret" in config:
306
self.secret = config[u"secret"].decode(u"base64")
307
elif u"secfile" in config:
344
self.fingerprint = (config["fingerprint"].upper()
346
logger.debug(" Fingerprint: %s", self.fingerprint)
347
if "secret" in config:
348
self.secret = config["secret"].decode("base64")
349
elif "secfile" in config:
308
350
with open(os.path.expanduser(os.path.expandvars
309
(config[u"secfile"])),
351
(config["secfile"])),
310
352
"rb") as secfile:
311
353
self.secret = secfile.read()
313
raise TypeError(u"No secret or secfile for client %s"
355
raise TypeError("No secret or secfile for client %s"
315
self.host = config.get(u"host", u"")
357
self.host = config.get("host", "")
316
358
self.created = datetime.datetime.utcnow()
317
359
self.enabled = False
360
self.last_approval_request = None
318
361
self.last_enabled = None
319
362
self.last_checked_ok = None
320
self.timeout = string_to_delta(config[u"timeout"])
321
self.interval = string_to_delta(config[u"interval"])
363
self.timeout = string_to_delta(config["timeout"])
364
self.extended_timeout = string_to_delta(config["extended_timeout"])
365
self.interval = string_to_delta(config["interval"])
322
366
self.disable_hook = disable_hook
323
367
self.checker = None
324
368
self.checker_initiator_tag = None
325
369
self.disable_initiator_tag = None
326
371
self.checker_callback_tag = None
327
self.checker_command = config[u"checker"]
372
self.checker_command = config["checker"]
328
373
self.current_checker_command = None
329
374
self.last_connect = None
330
375
self._approved = None
331
self.approved_by_default = config.get(u"approved_by_default",
376
self.approved_by_default = config.get("approved_by_default",
333
378
self.approvals_pending = 0
334
self.approved_delay = string_to_delta(
335
config[u"approved_delay"])
336
self.approved_duration = string_to_delta(
337
config[u"approved_duration"])
379
self.approval_delay = string_to_delta(
380
config["approval_delay"])
381
self.approval_duration = string_to_delta(
382
config["approval_duration"])
338
383
self.changedstate = multiprocessing_manager.Condition(multiprocessing_manager.Lock())
340
385
def send_changedstate(self):
394
441
if os.WIFEXITED(condition):
395
442
exitstatus = os.WEXITSTATUS(condition)
396
443
if exitstatus == 0:
397
logger.info(u"Checker for %(name)s succeeded",
444
logger.info("Checker for %(name)s succeeded",
399
446
self.checked_ok()
401
logger.info(u"Checker for %(name)s failed",
448
logger.info("Checker for %(name)s failed",
404
logger.warning(u"Checker for %(name)s crashed?",
451
logger.warning("Checker for %(name)s crashed?",
407
def checked_ok(self):
454
def checked_ok(self, timeout=None):
408
455
"""Bump up the timeout for this client.
410
457
This should only be called when the client has been seen,
461
timeout = self.timeout
413
462
self.last_checked_ok = datetime.datetime.utcnow()
414
463
gobject.source_remove(self.disable_initiator_tag)
464
self.expires = datetime.datetime.utcnow() + timeout
415
465
self.disable_initiator_tag = (gobject.timeout_add
416
(self.timeout_milliseconds(),
466
(self._timedelta_to_milliseconds(timeout),
469
def need_approval(self):
470
self.last_approval_request = datetime.datetime.utcnow()
419
472
def start_checker(self):
420
473
"""Start a new checker subprocess if one is not running.
450
503
command = self.checker_command % self.host
451
504
except TypeError:
452
505
# Escape attributes for the shell
453
escaped_attrs = dict((key,
454
re.escape(unicode(str(val),
458
vars(self).iteritems())
506
escaped_attrs = dict(
508
re.escape(unicode(str(getattr(self, attr, "")),
512
self.runtime_expansions)
460
515
command = self.checker_command % escaped_attrs
461
except TypeError, error:
462
logger.error(u'Could not format string "%s":'
463
u' %s', self.checker_command, error)
516
except TypeError as error:
517
logger.error('Could not format string "%s":'
518
' %s', self.checker_command, error)
464
519
return True # Try again later
465
520
self.current_checker_command = command
467
logger.info(u"Starting checker %r for %s",
522
logger.info("Starting checker %r for %s",
468
523
command, self.name)
469
524
# We don't need to redirect stdout and stderr, since
470
525
# in normal mode, that is already done by daemon(),
494
549
if self.checker_callback_tag:
495
550
gobject.source_remove(self.checker_callback_tag)
496
551
self.checker_callback_tag = None
497
if getattr(self, u"checker", None) is None:
552
if getattr(self, "checker", None) is None:
499
logger.debug(u"Stopping checker for %(name)s", vars(self))
554
logger.debug("Stopping checker for %(name)s", vars(self))
501
556
os.kill(self.checker.pid, signal.SIGTERM)
503
558
#if self.checker.poll() is None:
504
559
# os.kill(self.checker.pid, signal.SIGKILL)
505
except OSError, error:
560
except OSError as error:
506
561
if error.errno != errno.ESRCH: # No such process
508
563
self.checker = None
510
def dbus_service_property(dbus_interface, signature=u"v",
511
access=u"readwrite", byte_arrays=False):
565
def dbus_service_property(dbus_interface, signature="v",
566
access="readwrite", byte_arrays=False):
512
567
"""Decorators for marking methods of a DBusObjectWithProperties to
513
568
become properties on the D-Bus.
592
647
# No such property
593
raise DBusPropertyNotFound(self.dbus_object_path + u":"
594
+ interface_name + u"."
648
raise DBusPropertyNotFound(self.dbus_object_path + ":"
649
+ interface_name + "."
597
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"ss",
652
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ss",
599
654
def Get(self, interface_name, property_name):
600
655
"""Standard D-Bus property Get() method, see D-Bus standard.
602
657
prop = self._get_dbus_property(interface_name, property_name)
603
if prop._dbus_access == u"write":
658
if prop._dbus_access == "write":
604
659
raise DBusPropertyAccessException(property_name)
606
if not hasattr(value, u"variant_level"):
661
if not hasattr(value, "variant_level"):
608
663
return type(value)(value, variant_level=value.variant_level+1)
610
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"ssv")
665
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ssv")
611
666
def Set(self, interface_name, property_name, value):
612
667
"""Standard D-Bus property Set() method, see D-Bus standard.
614
669
prop = self._get_dbus_property(interface_name, property_name)
615
if prop._dbus_access == u"read":
670
if prop._dbus_access == "read":
616
671
raise DBusPropertyAccessException(property_name)
617
if prop._dbus_get_args_options[u"byte_arrays"]:
672
if prop._dbus_get_args_options["byte_arrays"]:
618
673
# The byte_arrays option is not supported yet on
619
674
# signatures other than "ay".
620
if prop._dbus_signature != u"ay":
675
if prop._dbus_signature != "ay":
622
677
value = dbus.ByteArray(''.join(unichr(byte)
623
678
for byte in value))
626
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"s",
627
out_signature=u"a{sv}")
681
@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="s",
682
out_signature="a{sv}")
628
683
def GetAll(self, interface_name):
629
684
"""Standard D-Bus property GetAll() method, see D-Bus
661
716
document = xml.dom.minidom.parseString(xmlstring)
662
717
def make_tag(document, name, prop):
663
e = document.createElement(u"property")
664
e.setAttribute(u"name", name)
665
e.setAttribute(u"type", prop._dbus_signature)
666
e.setAttribute(u"access", prop._dbus_access)
718
e = document.createElement("property")
719
e.setAttribute("name", name)
720
e.setAttribute("type", prop._dbus_signature)
721
e.setAttribute("access", prop._dbus_access)
668
for if_tag in document.getElementsByTagName(u"interface"):
723
for if_tag in document.getElementsByTagName("interface"):
669
724
for tag in (make_tag(document, name, prop)
671
726
in self._get_all_dbus_properties()
672
727
if prop._dbus_interface
673
== if_tag.getAttribute(u"name")):
728
== if_tag.getAttribute("name")):
674
729
if_tag.appendChild(tag)
675
730
# Add the names to the return values for the
676
731
# "org.freedesktop.DBus.Properties" methods
677
if (if_tag.getAttribute(u"name")
678
== u"org.freedesktop.DBus.Properties"):
679
for cn in if_tag.getElementsByTagName(u"method"):
680
if cn.getAttribute(u"name") == u"Get":
681
for arg in cn.getElementsByTagName(u"arg"):
682
if (arg.getAttribute(u"direction")
684
arg.setAttribute(u"name", u"value")
685
elif cn.getAttribute(u"name") == u"GetAll":
686
for arg in cn.getElementsByTagName(u"arg"):
687
if (arg.getAttribute(u"direction")
689
arg.setAttribute(u"name", u"props")
690
xmlstring = document.toxml(u"utf-8")
732
if (if_tag.getAttribute("name")
733
== "org.freedesktop.DBus.Properties"):
734
for cn in if_tag.getElementsByTagName("method"):
735
if cn.getAttribute("name") == "Get":
736
for arg in cn.getElementsByTagName("arg"):
737
if (arg.getAttribute("direction")
739
arg.setAttribute("name", "value")
740
elif cn.getAttribute("name") == "GetAll":
741
for arg in cn.getElementsByTagName("arg"):
742
if (arg.getAttribute("direction")
744
arg.setAttribute("name", "props")
745
xmlstring = document.toxml("utf-8")
691
746
document.unlink()
692
747
except (AttributeError, xml.dom.DOMException,
693
xml.parsers.expat.ExpatError), error:
694
logger.error(u"Failed to override Introspection method",
748
xml.parsers.expat.ExpatError) as error:
749
logger.error("Failed to override Introspection method",
711
770
Client.__init__(self, *args, **kwargs)
712
771
# Only now, when this client is initialized, can it show up on
773
client_object_name = unicode(self.name).translate(
714
776
self.dbus_object_path = (dbus.ObjectPath
716
+ self.name.replace(u".", u"_")))
777
("/clients/" + client_object_name))
717
778
DBusObjectWithProperties.__init__(self, self.bus,
718
779
self.dbus_object_path)
780
def _set_expires(self, value):
781
old_value = getattr(self, "_expires", None)
782
self._expires = value
783
if hasattr(self, "dbus_object_path") and old_value != value:
784
dbus_time = (self._datetime_to_dbus(self._expires,
786
self.PropertyChanged(dbus.String("Expires"),
788
expires = property(lambda self: self._expires, _set_expires)
720
791
def _get_approvals_pending(self):
721
792
return self._approvals_pending
722
793
def _set_approvals_pending(self, value):
737
808
def _datetime_to_dbus(dt, variant_level=0):
738
809
"""Convert a UTC datetime.datetime() to a D-Bus type."""
811
return dbus.String("", variant_level = variant_level)
739
812
return dbus.String(dt.isoformat(),
740
813
variant_level=variant_level)
742
815
def enable(self):
743
oldstate = getattr(self, u"enabled", False)
816
oldstate = getattr(self, "enabled", False)
744
817
r = Client.enable(self)
745
818
if oldstate != self.enabled:
746
819
# Emit D-Bus signals
747
self.PropertyChanged(dbus.String(u"enabled"),
820
self.PropertyChanged(dbus.String("Enabled"),
748
821
dbus.Boolean(True, variant_level=1))
749
822
self.PropertyChanged(
750
dbus.String(u"last_enabled"),
823
dbus.String("LastEnabled"),
751
824
self._datetime_to_dbus(self.last_enabled,
752
825
variant_level=1))
755
828
def disable(self, quiet = False):
756
oldstate = getattr(self, u"enabled", False)
829
oldstate = getattr(self, "enabled", False)
757
830
r = Client.disable(self, quiet=quiet)
758
831
if not quiet and oldstate != self.enabled:
759
832
# Emit D-Bus signal
760
self.PropertyChanged(dbus.String(u"enabled"),
833
self.PropertyChanged(dbus.String("Enabled"),
761
834
dbus.Boolean(False, variant_level=1))
814
895
# Emit D-Bus signal
815
896
self.CheckerStarted(self.current_checker_command)
816
897
self.PropertyChanged(
817
dbus.String(u"checker_running"),
898
dbus.String("CheckerRunning"),
818
899
dbus.Boolean(True, variant_level=1))
821
902
def stop_checker(self, *args, **kwargs):
822
old_checker = getattr(self, u"checker", None)
903
old_checker = getattr(self, "checker", None)
823
904
r = Client.stop_checker(self, *args, **kwargs)
824
905
if (old_checker is not None
825
and getattr(self, u"checker", None) is None):
826
self.PropertyChanged(dbus.String(u"checker_running"),
906
and getattr(self, "checker", None) is None):
907
self.PropertyChanged(dbus.String("CheckerRunning"),
827
908
dbus.Boolean(False, variant_level=1))
834
915
def approve(self, value=True):
835
916
self.send_changedstate()
836
917
self._approved = value
837
gobject.timeout_add(self._timedelta_to_milliseconds(self.approved_duration),
918
gobject.timeout_add(self._timedelta_to_milliseconds
919
(self.approval_duration),
838
920
self._reset_approved)
841
923
## D-Bus methods, signals & properties
842
_interface = u"se.bsnet.fukt.Mandos.Client"
924
_interface = "se.bsnet.fukt.Mandos.Client"
846
928
# CheckerCompleted - signal
847
@dbus.service.signal(_interface, signature=u"nxs")
929
@dbus.service.signal(_interface, signature="nxs")
848
930
def CheckerCompleted(self, exitcode, waitstatus, command):
852
934
# CheckerStarted - signal
853
@dbus.service.signal(_interface, signature=u"s")
935
@dbus.service.signal(_interface, signature="s")
854
936
def CheckerStarted(self, command):
858
940
# PropertyChanged - signal
859
@dbus.service.signal(_interface, signature=u"sv")
941
@dbus.service.signal(_interface, signature="sv")
860
942
def PropertyChanged(self, property, value):
922
# approved_pending - property
923
@dbus_service_property(_interface, signature=u"b", access=u"read")
924
def approved_pending_dbus_property(self):
1004
# ApprovalPending - property
1005
@dbus_service_property(_interface, signature="b", access="read")
1006
def ApprovalPending_dbus_property(self):
925
1007
return dbus.Boolean(bool(self.approvals_pending))
927
# approved_by_default - property
928
@dbus_service_property(_interface, signature=u"b",
930
def approved_by_default_dbus_property(self):
931
return dbus.Boolean(self.approved_by_default)
933
# approved_delay - property
934
@dbus_service_property(_interface, signature=u"t",
936
def approved_delay_dbus_property(self):
937
return dbus.UInt64(self.approved_delay_milliseconds())
939
# approved_duration - property
940
@dbus_service_property(_interface, signature=u"t",
942
def approved_duration_dbus_property(self):
943
return dbus.UInt64(self._timedelta_to_milliseconds(
944
self.approved_duration))
947
@dbus_service_property(_interface, signature=u"s", access=u"read")
948
def name_dbus_property(self):
1009
# ApprovedByDefault - property
1010
@dbus_service_property(_interface, signature="b",
1012
def ApprovedByDefault_dbus_property(self, value=None):
1013
if value is None: # get
1014
return dbus.Boolean(self.approved_by_default)
1015
old_value = self.approved_by_default
1016
self.approved_by_default = bool(value)
1018
if old_value != self.approved_by_default:
1019
self.PropertyChanged(dbus.String("ApprovedByDefault"),
1020
dbus.Boolean(value, variant_level=1))
1022
# ApprovalDelay - property
1023
@dbus_service_property(_interface, signature="t",
1025
def ApprovalDelay_dbus_property(self, value=None):
1026
if value is None: # get
1027
return dbus.UInt64(self.approval_delay_milliseconds())
1028
old_value = self.approval_delay
1029
self.approval_delay = datetime.timedelta(0, 0, 0, value)
1031
if old_value != self.approval_delay:
1032
self.PropertyChanged(dbus.String("ApprovalDelay"),
1033
dbus.UInt64(value, variant_level=1))
1035
# ApprovalDuration - property
1036
@dbus_service_property(_interface, signature="t",
1038
def ApprovalDuration_dbus_property(self, value=None):
1039
if value is None: # get
1040
return dbus.UInt64(self._timedelta_to_milliseconds(
1041
self.approval_duration))
1042
old_value = self.approval_duration
1043
self.approval_duration = datetime.timedelta(0, 0, 0, value)
1045
if old_value != self.approval_duration:
1046
self.PropertyChanged(dbus.String("ApprovalDuration"),
1047
dbus.UInt64(value, variant_level=1))
1050
@dbus_service_property(_interface, signature="s", access="read")
1051
def Name_dbus_property(self):
949
1052
return dbus.String(self.name)
951
# fingerprint - property
952
@dbus_service_property(_interface, signature=u"s", access=u"read")
953
def fingerprint_dbus_property(self):
1054
# Fingerprint - property
1055
@dbus_service_property(_interface, signature="s", access="read")
1056
def Fingerprint_dbus_property(self):
954
1057
return dbus.String(self.fingerprint)
957
@dbus_service_property(_interface, signature=u"s",
959
def host_dbus_property(self, value=None):
1060
@dbus_service_property(_interface, signature="s",
1062
def Host_dbus_property(self, value=None):
960
1063
if value is None: # get
961
1064
return dbus.String(self.host)
1065
old_value = self.host
962
1066
self.host = value
963
1067
# Emit D-Bus signal
964
self.PropertyChanged(dbus.String(u"host"),
965
dbus.String(value, variant_level=1))
1068
if old_value != self.host:
1069
self.PropertyChanged(dbus.String("Host"),
1070
dbus.String(value, variant_level=1))
968
@dbus_service_property(_interface, signature=u"s", access=u"read")
969
def created_dbus_property(self):
1072
# Created - property
1073
@dbus_service_property(_interface, signature="s", access="read")
1074
def Created_dbus_property(self):
970
1075
return dbus.String(self._datetime_to_dbus(self.created))
972
# last_enabled - property
973
@dbus_service_property(_interface, signature=u"s", access=u"read")
974
def last_enabled_dbus_property(self):
975
if self.last_enabled is None:
976
return dbus.String(u"")
977
return dbus.String(self._datetime_to_dbus(self.last_enabled))
1077
# LastEnabled - property
1078
@dbus_service_property(_interface, signature="s", access="read")
1079
def LastEnabled_dbus_property(self):
1080
return self._datetime_to_dbus(self.last_enabled)
980
@dbus_service_property(_interface, signature=u"b",
982
def enabled_dbus_property(self, value=None):
1082
# Enabled - property
1083
@dbus_service_property(_interface, signature="b",
1085
def Enabled_dbus_property(self, value=None):
983
1086
if value is None: # get
984
1087
return dbus.Boolean(self.enabled)
990
# last_checked_ok - property
991
@dbus_service_property(_interface, signature=u"s",
993
def last_checked_ok_dbus_property(self, value=None):
1093
# LastCheckedOK - property
1094
@dbus_service_property(_interface, signature="s",
1096
def LastCheckedOK_dbus_property(self, value=None):
994
1097
if value is not None:
995
1098
self.checked_ok()
997
if self.last_checked_ok is None:
998
return dbus.String(u"")
999
return dbus.String(self._datetime_to_dbus(self
1002
# timeout - property
1003
@dbus_service_property(_interface, signature=u"t",
1004
access=u"readwrite")
1005
def timeout_dbus_property(self, value=None):
1100
return self._datetime_to_dbus(self.last_checked_ok)
1102
# Expires - property
1103
@dbus_service_property(_interface, signature="s", access="read")
1104
def Expires_dbus_property(self):
1105
return self._datetime_to_dbus(self.expires)
1107
# LastApprovalRequest - property
1108
@dbus_service_property(_interface, signature="s", access="read")
1109
def LastApprovalRequest_dbus_property(self):
1110
return self._datetime_to_dbus(self.last_approval_request)
1112
# Timeout - property
1113
@dbus_service_property(_interface, signature="t",
1115
def Timeout_dbus_property(self, value=None):
1006
1116
if value is None: # get
1007
1117
return dbus.UInt64(self.timeout_milliseconds())
1118
old_value = self.timeout
1008
1119
self.timeout = datetime.timedelta(0, 0, 0, value)
1009
1120
# Emit D-Bus signal
1010
self.PropertyChanged(dbus.String(u"timeout"),
1011
dbus.UInt64(value, variant_level=1))
1012
if getattr(self, u"disable_initiator_tag", None) is None:
1121
if old_value != self.timeout:
1122
self.PropertyChanged(dbus.String("Timeout"),
1123
dbus.UInt64(value, variant_level=1))
1124
if getattr(self, "disable_initiator_tag", None) is None:
1014
1126
# Reschedule timeout
1015
1127
gobject.source_remove(self.disable_initiator_tag)
1016
1128
self.disable_initiator_tag = None
1017
1130
time_to_die = (self.
1018
1131
_timedelta_to_milliseconds((self
1019
1132
.last_checked_ok
1024
1137
# The timeout has passed
1140
self.expires = (datetime.datetime.utcnow()
1141
+ datetime.timedelta(milliseconds = time_to_die))
1027
1142
self.disable_initiator_tag = (gobject.timeout_add
1028
1143
(time_to_die, self.disable))
1030
# interval - property
1031
@dbus_service_property(_interface, signature=u"t",
1032
access=u"readwrite")
1033
def interval_dbus_property(self, value=None):
1145
# ExtendedTimeout - property
1146
@dbus_service_property(_interface, signature="t",
1148
def ExtendedTimeout_dbus_property(self, value=None):
1149
if value is None: # get
1150
return dbus.UInt64(self.extended_timeout_milliseconds())
1151
old_value = self.extended_timeout
1152
self.extended_timeout = datetime.timedelta(0, 0, 0, value)
1154
if old_value != self.extended_timeout:
1155
self.PropertyChanged(dbus.String("ExtendedTimeout"),
1156
dbus.UInt64(value, variant_level=1))
1158
# Interval - property
1159
@dbus_service_property(_interface, signature="t",
1161
def Interval_dbus_property(self, value=None):
1034
1162
if value is None: # get
1035
1163
return dbus.UInt64(self.interval_milliseconds())
1164
old_value = self.interval
1036
1165
self.interval = datetime.timedelta(0, 0, 0, value)
1037
1166
# Emit D-Bus signal
1038
self.PropertyChanged(dbus.String(u"interval"),
1039
dbus.UInt64(value, variant_level=1))
1040
if getattr(self, u"checker_initiator_tag", None) is None:
1167
if old_value != self.interval:
1168
self.PropertyChanged(dbus.String("Interval"),
1169
dbus.UInt64(value, variant_level=1))
1170
if getattr(self, "checker_initiator_tag", None) is None:
1042
1172
# Reschedule checker run
1043
1173
gobject.source_remove(self.checker_initiator_tag)
1045
1175
(value, self.start_checker))
1046
1176
self.start_checker() # Start one now, too
1048
# checker - property
1049
@dbus_service_property(_interface, signature=u"s",
1050
access=u"readwrite")
1051
def checker_dbus_property(self, value=None):
1178
# Checker - property
1179
@dbus_service_property(_interface, signature="s",
1181
def Checker_dbus_property(self, value=None):
1052
1182
if value is None: # get
1053
1183
return dbus.String(self.checker_command)
1184
old_value = self.checker_command
1054
1185
self.checker_command = value
1055
1186
# Emit D-Bus signal
1056
self.PropertyChanged(dbus.String(u"checker"),
1057
dbus.String(self.checker_command,
1187
if old_value != self.checker_command:
1188
self.PropertyChanged(dbus.String("Checker"),
1189
dbus.String(self.checker_command,
1060
# checker_running - property
1061
@dbus_service_property(_interface, signature=u"b",
1062
access=u"readwrite")
1063
def checker_running_dbus_property(self, value=None):
1192
# CheckerRunning - property
1193
@dbus_service_property(_interface, signature="b",
1195
def CheckerRunning_dbus_property(self, value=None):
1064
1196
if value is None: # get
1065
1197
return dbus.Boolean(self.checker is not None)
1146
1278
# Start communication using the Mandos protocol
1147
1279
# Get protocol number
1148
1280
line = self.request.makefile().readline()
1149
logger.debug(u"Protocol version: %r", line)
1281
logger.debug("Protocol version: %r", line)
1151
1283
if int(line.strip().split()[0]) > 1:
1152
1284
raise RuntimeError
1153
except (ValueError, IndexError, RuntimeError), error:
1154
logger.error(u"Unknown protocol version: %s", error)
1285
except (ValueError, IndexError, RuntimeError) as error:
1286
logger.error("Unknown protocol version: %s", error)
1157
1289
# Start GnuTLS connection
1159
1291
session.handshake()
1160
except gnutls.errors.GNUTLSError, error:
1161
logger.warning(u"Handshake failed: %s", error)
1292
except gnutls.errors.GNUTLSError as error:
1293
logger.warning("Handshake failed: %s", error)
1162
1294
# Do not run session.bye() here: the session is not
1163
1295
# established. Just abandon the request.
1165
logger.debug(u"Handshake succeeded")
1297
logger.debug("Handshake succeeded")
1167
1299
approval_required = False
1170
1302
fpr = self.fingerprint(self.peer_certificate
1172
except (TypeError, gnutls.errors.GNUTLSError), error:
1173
logger.warning(u"Bad certificate: %s", error)
1305
gnutls.errors.GNUTLSError) as error:
1306
logger.warning("Bad certificate: %s", error)
1175
logger.debug(u"Fingerprint: %s", fpr)
1308
logger.debug("Fingerprint: %s", fpr)
1178
1311
client = ProxyClient(child_pipe, fpr,
1180
1313
except KeyError:
1183
if client.approved_delay:
1184
delay = client.approved_delay
1316
if client.approval_delay:
1317
delay = client.approval_delay
1185
1318
client.approvals_pending += 1
1186
1319
approval_required = True
1189
1322
if not client.enabled:
1190
logger.warning(u"Client %s is disabled",
1323
logger.info("Client %s is disabled",
1192
1325
if self.server.use_dbus:
1193
1326
# Emit D-Bus signal
1194
1327
client.Rejected("Disabled")
1197
if client._approved or not client.approved_delay:
1330
if client._approved or not client.approval_delay:
1198
1331
#We are approved or approval is disabled
1200
1333
elif client._approved is None:
1201
logger.info(u"Client %s need approval",
1334
logger.info("Client %s needs approval",
1203
1336
if self.server.use_dbus:
1204
1337
# Emit D-Bus signal
1205
1338
client.NeedApproval(
1206
client.approved_delay_milliseconds(),
1339
client.approval_delay_milliseconds(),
1207
1340
client.approved_by_default)
1209
logger.warning(u"Client %s was not approved",
1342
logger.warning("Client %s was not approved",
1211
1344
if self.server.use_dbus:
1212
1345
# Emit D-Bus signal
1213
client.Rejected("Disapproved")
1346
client.Rejected("Denied")
1216
1349
#wait until timeout or approved
1379
1512
bind to an address or port if they were not specified."""
1380
1513
if self.interface is not None:
1381
1514
if SO_BINDTODEVICE is None:
1382
logger.error(u"SO_BINDTODEVICE does not exist;"
1383
u" cannot bind to interface %s",
1515
logger.error("SO_BINDTODEVICE does not exist;"
1516
" cannot bind to interface %s",
1384
1517
self.interface)
1387
1520
self.socket.setsockopt(socket.SOL_SOCKET,
1388
1521
SO_BINDTODEVICE,
1389
1522
str(self.interface
1391
except socket.error, error:
1524
except socket.error as error:
1392
1525
if error[0] == errno.EPERM:
1393
logger.error(u"No permission to"
1394
u" bind to interface %s",
1526
logger.error("No permission to"
1527
" bind to interface %s",
1395
1528
self.interface)
1396
1529
elif error[0] == errno.ENOPROTOOPT:
1397
logger.error(u"SO_BINDTODEVICE not available;"
1398
u" cannot bind to interface %s",
1530
logger.error("SO_BINDTODEVICE not available;"
1531
" cannot bind to interface %s",
1399
1532
self.interface)
1576
1705
global if_nametoindex
1578
1707
if_nametoindex = (ctypes.cdll.LoadLibrary
1579
(ctypes.util.find_library(u"c"))
1708
(ctypes.util.find_library("c"))
1580
1709
.if_nametoindex)
1581
1710
except (OSError, AttributeError):
1582
logger.warning(u"Doing if_nametoindex the hard way")
1711
logger.warning("Doing if_nametoindex the hard way")
1583
1712
def if_nametoindex(interface):
1584
1713
"Get an interface index the hard way, i.e. using fcntl()"
1585
1714
SIOCGIFINDEX = 0x8933 # From /usr/include/linux/sockios.h
1586
1715
with contextlib.closing(socket.socket()) as s:
1587
1716
ifreq = fcntl.ioctl(s, SIOCGIFINDEX,
1588
struct.pack(str(u"16s16x"),
1717
struct.pack(str("16s16x"),
1590
interface_index = struct.unpack(str(u"I"),
1719
interface_index = struct.unpack(str("I"),
1591
1720
ifreq[16:20])[0]
1592
1721
return interface_index
1593
1722
return if_nametoindex(interface)
1623
1752
##################################################################
1624
1753
# Parsing of options, both command line and config file
1626
parser = optparse.OptionParser(version = "%%prog %s" % version)
1627
parser.add_option("-i", u"--interface", type=u"string",
1628
metavar="IF", help=u"Bind to interface IF")
1629
parser.add_option("-a", u"--address", type=u"string",
1630
help=u"Address to listen for requests on")
1631
parser.add_option("-p", u"--port", type=u"int",
1632
help=u"Port number to receive requests on")
1633
parser.add_option("--check", action=u"store_true",
1634
help=u"Run self-test")
1635
parser.add_option("--debug", action=u"store_true",
1636
help=u"Debug mode; run in foreground and log to"
1638
parser.add_option("--debuglevel", type=u"string", metavar="Level",
1639
help=u"Debug level for stdout output")
1640
parser.add_option("--priority", type=u"string", help=u"GnuTLS"
1641
u" priority string (see GnuTLS documentation)")
1642
parser.add_option("--servicename", type=u"string",
1643
metavar=u"NAME", help=u"Zeroconf service name")
1644
parser.add_option("--configdir", type=u"string",
1645
default=u"/etc/mandos", metavar=u"DIR",
1646
help=u"Directory to search for configuration"
1648
parser.add_option("--no-dbus", action=u"store_false",
1649
dest=u"use_dbus", help=u"Do not provide D-Bus"
1650
u" system bus interface")
1651
parser.add_option("--no-ipv6", action=u"store_false",
1652
dest=u"use_ipv6", help=u"Do not use IPv6")
1653
options = parser.parse_args()[0]
1755
parser = argparse.ArgumentParser()
1756
parser.add_argument("-v", "--version", action="version",
1757
version = "%%(prog)s %s" % version,
1758
help="show version number and exit")
1759
parser.add_argument("-i", "--interface", metavar="IF",
1760
help="Bind to interface IF")
1761
parser.add_argument("-a", "--address",
1762
help="Address to listen for requests on")
1763
parser.add_argument("-p", "--port", type=int,
1764
help="Port number to receive requests on")
1765
parser.add_argument("--check", action="store_true",
1766
help="Run self-test")
1767
parser.add_argument("--debug", action="store_true",
1768
help="Debug mode; run in foreground and log"
1770
parser.add_argument("--debuglevel", metavar="LEVEL",
1771
help="Debug level for stdout output")
1772
parser.add_argument("--priority", help="GnuTLS"
1773
" priority string (see GnuTLS documentation)")
1774
parser.add_argument("--servicename",
1775
metavar="NAME", help="Zeroconf service name")
1776
parser.add_argument("--configdir",
1777
default="/etc/mandos", metavar="DIR",
1778
help="Directory to search for configuration"
1780
parser.add_argument("--no-dbus", action="store_false",
1781
dest="use_dbus", help="Do not provide D-Bus"
1782
" system bus interface")
1783
parser.add_argument("--no-ipv6", action="store_false",
1784
dest="use_ipv6", help="Do not use IPv6")
1785
options = parser.parse_args()
1655
1787
if options.check:
1660
1792
# Default values for config file for server-global settings
1661
server_defaults = { u"interface": u"",
1666
u"SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP",
1667
u"servicename": u"Mandos",
1668
u"use_dbus": u"True",
1669
u"use_ipv6": u"True",
1793
server_defaults = { "interface": "",
1798
"SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP",
1799
"servicename": "Mandos",
1673
1805
# Parse config file for server-global settings
1674
1806
server_config = configparser.SafeConfigParser(server_defaults)
1675
1807
del server_defaults
1676
1808
server_config.read(os.path.join(options.configdir,
1678
1810
# Convert the SafeConfigParser object to a dict
1679
1811
server_settings = server_config.defaults()
1680
1812
# Use the appropriate methods on the non-string config options
1681
for option in (u"debug", u"use_dbus", u"use_ipv6"):
1682
server_settings[option] = server_config.getboolean(u"DEFAULT",
1813
for option in ("debug", "use_dbus", "use_ipv6"):
1814
server_settings[option] = server_config.getboolean("DEFAULT",
1684
1816
if server_settings["port"]:
1685
server_settings["port"] = server_config.getint(u"DEFAULT",
1817
server_settings["port"] = server_config.getint("DEFAULT",
1687
1819
del server_config
1689
1821
# Override the settings from the config file with command line
1690
1822
# options, if set.
1691
for option in (u"interface", u"address", u"port", u"debug",
1692
u"priority", u"servicename", u"configdir",
1693
u"use_dbus", u"use_ipv6", u"debuglevel"):
1823
for option in ("interface", "address", "port", "debug",
1824
"priority", "servicename", "configdir",
1825
"use_dbus", "use_ipv6", "debuglevel"):
1694
1826
value = getattr(options, option)
1695
1827
if value is not None:
1696
1828
server_settings[option] = value
1704
1836
##################################################################
1706
1838
# For convenience
1707
debug = server_settings[u"debug"]
1708
debuglevel = server_settings[u"debuglevel"]
1709
use_dbus = server_settings[u"use_dbus"]
1710
use_ipv6 = server_settings[u"use_ipv6"]
1839
debug = server_settings["debug"]
1840
debuglevel = server_settings["debuglevel"]
1841
use_dbus = server_settings["use_dbus"]
1842
use_ipv6 = server_settings["use_ipv6"]
1712
if server_settings[u"servicename"] != u"Mandos":
1844
if server_settings["servicename"] != "Mandos":
1713
1845
syslogger.setFormatter(logging.Formatter
1714
(u'Mandos (%s) [%%(process)d]:'
1715
u' %%(levelname)s: %%(message)s'
1716
% server_settings[u"servicename"]))
1846
('Mandos (%s) [%%(process)d]:'
1847
' %%(levelname)s: %%(message)s'
1848
% server_settings["servicename"]))
1718
1850
# Parse config file with clients
1719
client_defaults = { u"timeout": u"1h",
1721
u"checker": u"fping -q -- %%(host)s",
1723
u"approved_delay": u"0s",
1724
u"approved_duration": u"1s",
1851
client_defaults = { "timeout": "5m",
1852
"extended_timeout": "15m",
1854
"checker": "fping -q -- %%(host)s",
1856
"approval_delay": "0s",
1857
"approval_duration": "1s",
1726
1859
client_config = configparser.SafeConfigParser(client_defaults)
1727
client_config.read(os.path.join(server_settings[u"configdir"],
1860
client_config.read(os.path.join(server_settings["configdir"],
1730
1863
global mandos_dbus_service
1731
1864
mandos_dbus_service = None
1733
tcp_server = MandosServer((server_settings[u"address"],
1734
server_settings[u"port"]),
1866
tcp_server = MandosServer((server_settings["address"],
1867
server_settings["port"]),
1736
interface=server_settings[u"interface"],
1869
interface=(server_settings["interface"]
1737
1871
use_ipv6=use_ipv6,
1738
1872
gnutls_priority=
1739
server_settings[u"priority"],
1873
server_settings["priority"],
1740
1874
use_dbus=use_dbus)
1741
pidfilename = u"/var/run/mandos.pid"
1743
pidfile = open(pidfilename, u"w")
1745
logger.error(u"Could not open file %r", pidfilename)
1876
pidfilename = "/var/run/mandos.pid"
1878
pidfile = open(pidfilename, "w")
1880
logger.error("Could not open file %r", pidfilename)
1748
uid = pwd.getpwnam(u"_mandos").pw_uid
1749
gid = pwd.getpwnam(u"_mandos").pw_gid
1883
uid = pwd.getpwnam("_mandos").pw_uid
1884
gid = pwd.getpwnam("_mandos").pw_gid
1750
1885
except KeyError:
1752
uid = pwd.getpwnam(u"mandos").pw_uid
1753
gid = pwd.getpwnam(u"mandos").pw_gid
1887
uid = pwd.getpwnam("mandos").pw_uid
1888
gid = pwd.getpwnam("mandos").pw_gid
1754
1889
except KeyError:
1756
uid = pwd.getpwnam(u"nobody").pw_uid
1757
gid = pwd.getpwnam(u"nobody").pw_gid
1891
uid = pwd.getpwnam("nobody").pw_uid
1892
gid = pwd.getpwnam("nobody").pw_gid
1758
1893
except KeyError:
1764
except OSError, error:
1899
except OSError as error:
1765
1900
if error[0] != errno.EPERM:
1768
# Enable all possible GnuTLS debugging
1771
1903
if not debug and not debuglevel:
1772
1904
syslogger.setLevel(logging.WARNING)
1773
1905
console.setLevel(logging.WARNING)
1806
1944
# End of Avahi example code
1809
bus_name = dbus.service.BusName(u"se.bsnet.fukt.Mandos",
1947
bus_name = dbus.service.BusName("se.bsnet.fukt.Mandos",
1810
1948
bus, do_not_queue=True)
1811
except dbus.exceptions.NameExistsException, e:
1812
logger.error(unicode(e) + u", disabling D-Bus")
1949
except dbus.exceptions.NameExistsException as e:
1950
logger.error(unicode(e) + ", disabling D-Bus")
1813
1951
use_dbus = False
1814
server_settings[u"use_dbus"] = False
1952
server_settings["use_dbus"] = False
1815
1953
tcp_server.use_dbus = False
1816
1954
protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET
1817
service = AvahiService(name = server_settings[u"servicename"],
1818
servicetype = u"_mandos._tcp",
1955
service = AvahiService(name = server_settings["servicename"],
1956
servicetype = "_mandos._tcp",
1819
1957
protocol = protocol, bus = bus)
1820
1958
if server_settings["interface"]:
1821
1959
service.interface = (if_nametoindex
1822
(str(server_settings[u"interface"])))
1825
# Close all input and output, do double fork, etc.
1960
(str(server_settings["interface"])))
1828
1962
global multiprocessing_manager
1829
1963
multiprocessing_manager = multiprocessing.Manager()
1873
2008
class MandosDBusService(dbus.service.Object):
1874
2009
"""A D-Bus proxy object"""
1875
2010
def __init__(self):
1876
dbus.service.Object.__init__(self, bus, u"/")
1877
_interface = u"se.bsnet.fukt.Mandos"
2011
dbus.service.Object.__init__(self, bus, "/")
2012
_interface = "se.bsnet.fukt.Mandos"
1879
@dbus.service.signal(_interface, signature=u"o")
2014
@dbus.service.signal(_interface, signature="o")
1880
2015
def ClientAdded(self, objpath):
1884
@dbus.service.signal(_interface, signature=u"ss")
2019
@dbus.service.signal(_interface, signature="ss")
1885
2020
def ClientNotFound(self, fingerprint, address):
1889
@dbus.service.signal(_interface, signature=u"os")
2024
@dbus.service.signal(_interface, signature="os")
1890
2025
def ClientRemoved(self, objpath, name):
1894
@dbus.service.method(_interface, out_signature=u"ao")
2029
@dbus.service.method(_interface, out_signature="ao")
1895
2030
def GetAllClients(self):
1897
2032
return dbus.Array(c.dbus_object_path
1898
2033
for c in tcp_server.clients)
1900
2035
@dbus.service.method(_interface,
1901
out_signature=u"a{oa{sv}}")
2036
out_signature="a{oa{sv}}")
1902
2037
def GetAllClientsWithProperties(self):
1904
2039
return dbus.Dictionary(
1905
((c.dbus_object_path, c.GetAll(u""))
2040
((c.dbus_object_path, c.GetAll(""))
1906
2041
for c in tcp_server.clients),
1907
signature=u"oa{sv}")
1909
@dbus.service.method(_interface, in_signature=u"o")
2044
@dbus.service.method(_interface, in_signature="o")
1910
2045
def RemoveClient(self, object_path):
1912
2047
for c in tcp_server.clients: