506
513
# Pretend that we have a GnuTLS module
507
class GnuTLS(object):
508
"""This isn't so much a class as it is a module-like namespace.
509
It is instantiated once, and simulates having a GnuTLS module."""
515
"""This isn't so much a class as it is a module-like namespace."""
511
517
library = ctypes.util.find_library("gnutls")
512
518
if library is None:
513
519
library = ctypes.util.find_library("gnutls-deb0")
514
520
_library = ctypes.cdll.LoadLibrary(library)
516
_need_version = b"3.3.0"
519
# Need to use "self" here, since this method is called before
520
# the assignment to the "gnutls" global variable happens.
521
if self.check_version(self._need_version) is None:
522
raise self.Error("Needs GnuTLS {} or later"
523
.format(self._need_version))
525
523
# Unless otherwise indicated, the constants and types below are
526
524
# all from the gnutls/gnutls.h C header file.
564
568
class Error(Exception):
565
# We need to use the class name "GnuTLS" here, since this
566
# exception might be raised from within GnuTLS.__init__,
567
# which is called before the assignment to the "gnutls"
568
# global variable has happened.
569
569
def __init__(self, message=None, code=None, args=()):
570
570
# Default usage is by a message string, but if a return
571
571
# code is passed, convert it to a string with
572
572
# gnutls.strerror()
574
574
if message is None and code is not None:
575
message = GnuTLS.strerror(code)
576
return super(GnuTLS.Error, self).__init__(
575
message = gnutls.strerror(code)
576
return super(gnutls.Error, self).__init__(
579
579
class CertificateSecurityError(Error):
583
class Credentials(object):
584
584
def __init__(self):
585
585
self._c_object = gnutls.certificate_credentials_t()
586
586
gnutls.certificate_allocate_credentials(
590
590
def __del__(self):
591
591
gnutls.certificate_free_credentials(self._c_object)
593
class ClientSession(object):
594
594
def __init__(self, socket, credentials=None):
595
595
self._c_object = gnutls.session_t()
596
gnutls.init(ctypes.byref(self._c_object), gnutls.CLIENT)
596
gnutls_flags = gnutls.CLIENT
597
if gnutls.check_version(b"3.5.6"):
598
gnutls_flags |= gnutls.NO_TICKETS
600
gnutls_flags |= gnutls.ENABLE_RAWPK
601
gnutls.init(ctypes.byref(self._c_object), gnutls_flags)
597
603
gnutls.set_default_priority(self._c_object)
598
604
gnutls.transport_set_ptr(self._c_object, socket.fileno())
599
605
gnutls.handshake_set_private_extensions(self._c_object,
731
737
check_version.argtypes = [ctypes.c_char_p]
732
738
check_version.restype = ctypes.c_char_p
734
# All the function declarations below are from gnutls/openpgp.h
736
openpgp_crt_init = _library.gnutls_openpgp_crt_init
737
openpgp_crt_init.argtypes = [ctypes.POINTER(openpgp_crt_t)]
738
openpgp_crt_init.restype = _error_code
740
openpgp_crt_import = _library.gnutls_openpgp_crt_import
741
openpgp_crt_import.argtypes = [openpgp_crt_t,
742
ctypes.POINTER(datum_t),
744
openpgp_crt_import.restype = _error_code
746
openpgp_crt_verify_self = _library.gnutls_openpgp_crt_verify_self
747
openpgp_crt_verify_self.argtypes = [openpgp_crt_t, ctypes.c_uint,
748
ctypes.POINTER(ctypes.c_uint)]
749
openpgp_crt_verify_self.restype = _error_code
751
openpgp_crt_deinit = _library.gnutls_openpgp_crt_deinit
752
openpgp_crt_deinit.argtypes = [openpgp_crt_t]
753
openpgp_crt_deinit.restype = None
755
openpgp_crt_get_fingerprint = (
756
_library.gnutls_openpgp_crt_get_fingerprint)
757
openpgp_crt_get_fingerprint.argtypes = [openpgp_crt_t,
761
openpgp_crt_get_fingerprint.restype = _error_code
740
_need_version = b"3.3.0"
741
if check_version(_need_version) is None:
742
raise self.Error("Needs GnuTLS {} or later"
743
.format(_need_version))
745
_tls_rawpk_version = b"3.6.6"
746
has_rawpk = bool(check_version(_tls_rawpk_version))
750
class pubkey_st(ctypes.Structure):
752
pubkey_t = ctypes.POINTER(pubkey_st)
754
x509_crt_fmt_t = ctypes.c_int
756
# All the function declarations below are from gnutls/abstract.h
757
pubkey_init = _library.gnutls_pubkey_init
758
pubkey_init.argtypes = [ctypes.POINTER(pubkey_t)]
759
pubkey_init.restype = _error_code
761
pubkey_import = _library.gnutls_pubkey_import
762
pubkey_import.argtypes = [pubkey_t, ctypes.POINTER(datum_t),
764
pubkey_import.restype = _error_code
766
pubkey_get_key_id = _library.gnutls_pubkey_get_key_id
767
pubkey_get_key_id.argtypes = [pubkey_t, ctypes.c_int,
768
ctypes.POINTER(ctypes.c_ubyte),
769
ctypes.POINTER(ctypes.c_size_t)]
770
pubkey_get_key_id.restype = _error_code
772
pubkey_deinit = _library.gnutls_pubkey_deinit
773
pubkey_deinit.argtypes = [pubkey_t]
774
pubkey_deinit.restype = None
776
# All the function declarations below are from gnutls/openpgp.h
778
openpgp_crt_init = _library.gnutls_openpgp_crt_init
779
openpgp_crt_init.argtypes = [ctypes.POINTER(openpgp_crt_t)]
780
openpgp_crt_init.restype = _error_code
782
openpgp_crt_import = _library.gnutls_openpgp_crt_import
783
openpgp_crt_import.argtypes = [openpgp_crt_t,
784
ctypes.POINTER(datum_t),
786
openpgp_crt_import.restype = _error_code
788
openpgp_crt_verify_self = _library.gnutls_openpgp_crt_verify_self
789
openpgp_crt_verify_self.argtypes = [openpgp_crt_t, ctypes.c_uint,
790
ctypes.POINTER(ctypes.c_uint)]
791
openpgp_crt_verify_self.restype = _error_code
793
openpgp_crt_deinit = _library.gnutls_openpgp_crt_deinit
794
openpgp_crt_deinit.argtypes = [openpgp_crt_t]
795
openpgp_crt_deinit.restype = None
797
openpgp_crt_get_fingerprint = (
798
_library.gnutls_openpgp_crt_get_fingerprint)
799
openpgp_crt_get_fingerprint.argtypes = [openpgp_crt_t,
803
openpgp_crt_get_fingerprint.restype = _error_code
805
if check_version(b"3.6.4"):
806
certificate_type_get2 = _library.gnutls_certificate_type_get2
807
certificate_type_get2.argtypes = [session_t, ctypes.c_int]
808
certificate_type_get2.restype = _error_code
763
810
# Remove non-public functions
764
811
del _error_code, _retry_on_error
765
# Create the global "gnutls" object, simulating a module
769
814
def call_pipe(connection, # : multiprocessing.Connection
777
822
connection.close()
780
class Client(object):
781
826
"""A representation of a client host served by this server.
784
829
approved: bool(); 'None' if not yet approved/disapproved
785
830
approval_delay: datetime.timedelta(); Time to wait for approval
786
831
approval_duration: datetime.timedelta(); Duration of one approval
787
checker: subprocess.Popen(); a running checker process used
788
to see if the client lives.
789
'None' if no process is running.
832
checker: multiprocessing.Process(); a running checker process used
833
to see if the client lives. 'None' if no process is
790
835
checker_callback_tag: a GLib event source tag, or None
791
836
checker_command: string; External command which is run to check
792
837
if client lives. %() expansions are done at
826
873
runtime_expansions = ("approval_delay", "approval_duration",
827
"created", "enabled", "expires",
874
"created", "enabled", "expires", "key_id",
828
875
"fingerprint", "host", "interval",
829
876
"last_approval_request", "last_checked_ok",
830
877
"last_enabled", "name", "timeout")
2162
class ProxyClient(object):
2163
def __init__(self, child_pipe, fpr, address):
2221
def __init__(self, child_pipe, key_id, fpr, address):
2164
2222
self._pipe = child_pipe
2165
self._pipe.send(('init', fpr, address))
2223
self._pipe.send(('init', key_id, fpr, address))
2166
2224
if not self._pipe.recv():
2225
raise KeyError(key_id or fpr)
2169
2227
def __getattribute__(self, name):
2170
2228
if name == '_pipe':
2238
2296
approval_required = False
2241
fpr = self.fingerprint(
2242
self.peer_certificate(session))
2243
except (TypeError, gnutls.Error) as error:
2244
logger.warning("Bad certificate: %s", error)
2246
logger.debug("Fingerprint: %s", fpr)
2249
client = ProxyClient(child_pipe, fpr,
2298
if gnutls.has_rawpk:
2301
key_id = self.key_id(
2302
self.peer_certificate(session))
2303
except (TypeError, gnutls.Error) as error:
2304
logger.warning("Bad certificate: %s", error)
2306
logger.debug("Key ID: %s", key_id)
2311
fpr = self.fingerprint(
2312
self.peer_certificate(session))
2313
except (TypeError, gnutls.Error) as error:
2314
logger.warning("Bad certificate: %s", error)
2316
logger.debug("Fingerprint: %s", fpr)
2319
client = ProxyClient(child_pipe, key_id, fpr,
2250
2320
self.client_address)
2251
2321
except KeyError:
2331
2401
def peer_certificate(session):
2332
"Return the peer's OpenPGP certificate as a bytestring"
2333
# If not an OpenPGP certificate...
2334
if (gnutls.certificate_type_get(session._c_object)
2335
!= gnutls.CRT_OPENPGP):
2402
"Return the peer's certificate as a bytestring"
2404
cert_type = gnutls.certificate_type_get2(session._c_object,
2406
except AttributeError:
2407
cert_type = gnutls.certificate_type_get(session._c_object)
2408
if gnutls.has_rawpk:
2409
valid_cert_types = frozenset((gnutls.CRT_RAWPK,))
2411
valid_cert_types = frozenset((gnutls.CRT_OPENPGP,))
2412
# If not a valid certificate type...
2413
if cert_type not in valid_cert_types:
2414
logger.info("Cert type %r not in %r", cert_type,
2336
2416
# ...return invalid data
2338
2418
list_size = ctypes.c_uint(1)
2346
2426
return ctypes.string_at(cert.data, cert.size)
2429
def key_id(certificate):
2430
"Convert a certificate bytestring to a hexdigit key ID"
2431
# New GnuTLS "datum" with the public key
2432
datum = gnutls.datum_t(
2433
ctypes.cast(ctypes.c_char_p(certificate),
2434
ctypes.POINTER(ctypes.c_ubyte)),
2435
ctypes.c_uint(len(certificate)))
2436
# XXX all these need to be created in the gnutls "module"
2437
# New empty GnuTLS certificate
2438
pubkey = gnutls.pubkey_t()
2439
gnutls.pubkey_init(ctypes.byref(pubkey))
2440
# Import the raw public key into the certificate
2441
gnutls.pubkey_import(pubkey,
2442
ctypes.byref(datum),
2443
gnutls.X509_FMT_DER)
2444
# New buffer for the key ID
2445
buf = ctypes.create_string_buffer(32)
2446
buf_len = ctypes.c_size_t(len(buf))
2447
# Get the key ID from the raw public key into the buffer
2448
gnutls.pubkey_get_key_id(pubkey,
2449
gnutls.KEYID_USE_SHA256,
2450
ctypes.cast(ctypes.byref(buf),
2451
ctypes.POINTER(ctypes.c_ubyte)),
2452
ctypes.byref(buf_len))
2453
# Deinit the certificate
2454
gnutls.pubkey_deinit(pubkey)
2456
# Convert the buffer to a Python bytestring
2457
key_id = ctypes.string_at(buf, buf_len.value)
2458
# Convert the bytestring to hexadecimal notation
2459
hex_key_id = binascii.hexlify(key_id).upper()
2349
2463
def fingerprint(openpgp):
2350
2464
"Convert an OpenPGP bytestring to a hexdigit fingerprint"
2351
2465
# New GnuTLS "datum" with the OpenPGP public key
2578
2695
command = request[0]
2580
2697
if command == 'init':
2582
address = request[2]
2698
key_id = request[1].decode("ascii")
2699
fpr = request[2].decode("ascii")
2700
address = request[3]
2584
2702
for c in self.clients.values():
2585
if c.fingerprint == fpr:
2703
if key_id == "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855":
2705
if key_id and c.key_id == key_id:
2708
if fpr and c.fingerprint == fpr:
2589
logger.info("Client not found for fingerprint: %s, ad"
2590
"dress: %s", fpr, address)
2712
logger.info("Client not found for key ID: %s, address"
2713
": %s", key_id or fpr, address)
2591
2714
if self.use_dbus:
2592
2715
# Emit D-Bus signal
2593
mandos_dbus_service.ClientNotFound(fpr,
2716
mandos_dbus_service.ClientNotFound(key_id or fpr,
2595
2718
parent_pipe.send(False)
3488
3615
# Must run before the D-Bus bus name gets deregistered
3619
def should_only_run_tests():
3620
parser = argparse.ArgumentParser(add_help=False)
3621
parser.add_argument("--check", action='store_true')
3622
args, unknown_args = parser.parse_known_args()
3623
run_tests = args.check
3625
# Remove --check argument from sys.argv
3626
sys.argv[1:] = unknown_args
3629
# Add all tests from doctest strings
3630
def load_tests(loader, tests, none):
3632
tests.addTests(doctest.DocTestSuite())
3492
3635
if __name__ == '__main__':
3637
if should_only_run_tests():
3638
# Call using ./mandos --check [--verbose]