/mandos/trunk : revision 609

1

#!/usr/bin/python3 -b

2

# -*- mode: python; after-save-hook: (lambda () (let ((command (if (fboundp 'file-local-name) (file-local-name (buffer-file-name)) (or (file-remote-p (buffer-file-name) 'localname) (buffer-file-name))))) (if (= (progn (if (get-buffer "*Test*") (kill-buffer "*Test*")) (process-file-shell-command (format "%s --check" (shell-quote-argument command)) nil "*Test*")) 0) (let ((w (get-buffer-window "*Test*"))) (if w (delete-window w))) (progn (with-current-buffer "*Test*" (compilation-mode)) (display-buffer "*Test*" '(display-buffer-in-side-window)))))); coding: utf-8 -*-

3

#

1

#!/usr/bin/python

2

# -*- mode: python; coding: utf-8 -*-

3

#

4

# Mandos server - give out binary blobs to connecting clients.

5

#

5

#

6

# This program is partly derived from an example program for an Avahi

7

# service publisher, downloaded from

8

# <http://avahi.org/wiki/PythonPublishExample>. This includes the

9

# methods "add", "remove", "server_state_changed",

10

# "entry_group_state_changed", "cleanup", and "activate" in the

11

# "AvahiService" class, and some lines in "main".

12

#

12

#

13

# Everything else is

14

15

16

#

17

# This file is part of Mandos.

18

#

19

# Mandos is free software: you can redistribute it and/or modify it

20

# under the terms of the GNU General Public License as published by

14

15

16

#

17

# This program is free software: you can redistribute it and/or modify

18

# it under the terms of the GNU General Public License as published by

21

19

# the Free Software Foundation, either version 3 of the License, or

22

20

# (at your option) any later version.

23

21

#

24

# Mandos is distributed in the hope that it will be useful, but

25

# WITHOUT ANY WARRANTY; without even the implied warranty of

22

# This program is distributed in the hope that it will be useful,

23

# but WITHOUT ANY WARRANTY; without even the implied warranty of

26

24

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

27

25

# GNU General Public License for more details.

28

#

26

#

29

27

# You should have received a copy of the GNU General Public License

30

# along with Mandos. If not, see <http://www.gnu.org/licenses/>.

31

#

28

# along with this program. If not, see

29

# <http://www.gnu.org/licenses/>.

30

#

32

31

# Contact the authors at <mandos@recompile.se>.

33

#

32

#

34

33

35

34

from __future__ import (division, absolute_import, print_function,

36

35

unicode_literals)

37

36

38

try:

39

from future_builtins import *

40

except ImportError:

41

pass

37

from future_builtins import *

42

38

43

try:

44

import SocketServer as socketserver

45

except ImportError:

46

import socketserver

39

import SocketServer as socketserver

47

40

import socket

48

41

import argparse

49

42

import datetime

50

43

import errno

51

try:

52

import ConfigParser as configparser

53

except ImportError:

54

import configparser

44

import gnutls.crypto

45

import gnutls.connection

46

import gnutls.errors

47

import gnutls.library.functions

48

import gnutls.library.constants

49

import gnutls.library.types

50

import ConfigParser as configparser

55

51

import sys

56

52

import re

57

53

import os

66

62

import struct

67

63

import fcntl

68

64

import functools

69

try:

70

import cPickle as pickle

71

except ImportError:

72

import pickle

65

import cPickle as pickle

73

66

import multiprocessing

74

67

import types

75

68

import binascii

76

69

import tempfile

77

70

import itertools

78

71

import collections

79

import codecs

80

import unittest

81

72

82

73

import dbus

83

74

import dbus.service

84

import gi

85

from gi.repository import GLib

75

import gobject

76

import avahi

86

77

from dbus.mainloop.glib import DBusGMainLoop

87

78

import ctypes

88

79

import ctypes.util

89

80

import xml.dom.minidom

90

81

import inspect

91

92

if sys.version_info.major == 2:

93

__metaclass__ = type

94

95

# Show warnings by default

96

if not sys.warnoptions:

97

import warnings

98

warnings.simplefilter("default")

99

100

# Try to find the value of SO_BINDTODEVICE:

82

import GnuPGInterface

83

101

84

try:

102

# This is where SO_BINDTODEVICE is in Python 3.3 (or 3.4?) and

103

# newer, and it is also the most natural place for it:

104

85

SO_BINDTODEVICE = socket.SO_BINDTODEVICE

105

86

except AttributeError:

106

87

try:

107

# This is where SO_BINDTODEVICE was up to and including Python

108

# 2.6, and also 3.2:

109

88

from IN import SO_BINDTODEVICE

110

89

except ImportError:

111

# In Python 2.7 it seems to have been removed entirely.

112

# Try running the C preprocessor:

113

try:

114

cc = subprocess.Popen(["cc", "--language=c", "-E",

115

"/dev/stdin"],

116

stdin=subprocess.PIPE,

117

stdout=subprocess.PIPE)

118

stdout = cc.communicate(

119

"#include <sys/socket.h>\nSO_BINDTODEVICE\n")[0]

120

SO_BINDTODEVICE = int(stdout.splitlines()[-1])

121

except (OSError, ValueError, IndexError):

122

# No value found

123

SO_BINDTODEVICE = None

124

125

if sys.version_info.major == 2:

126

str = unicode

127

128

if sys.version_info < (3, 2):

129

configparser.Configparser = configparser.SafeConfigParser

130

131

version = "1.8.8"

90

SO_BINDTODEVICE = None

91

92

version = "1.6.0"

132

93

stored_state_file = "clients.pickle"

133

94

134

95

logger = logging.getLogger()

135

logging.captureWarnings(True) # Show warnings via the logging system

136

syslogger = None

96

syslogger = (logging.handlers.SysLogHandler

97

(facility = logging.handlers.SysLogHandler.LOG_DAEMON,

98

address = str("/dev/log")))

137

99

138

100

try:

139

if_nametoindex = ctypes.cdll.LoadLibrary(

140

ctypes.util.find_library("c")).if_nametoindex

101

if_nametoindex = (ctypes.cdll.LoadLibrary

102

(ctypes.util.find_library("c"))

103

.if_nametoindex)

141

104

except (OSError, AttributeError):

142

143

105

def if_nametoindex(interface):

144

106

"Get an interface index the hard way, i.e. using fcntl()"

145

107

SIOCGIFINDEX = 0x8933 # From /usr/include/linux/sockios.h

146

108

with contextlib.closing(socket.socket()) as s:

147

109

ifreq = fcntl.ioctl(s, SIOCGIFINDEX,

148

struct.pack(b"16s16x", interface))

149

interface_index = struct.unpack("I", ifreq[16:20])[0]

110

struct.pack(str("16s16x"),

111

interface))

112

interface_index = struct.unpack(str("I"),

113

ifreq[16:20])[0]

150

114

return interface_index

151

115

152

116

153

def copy_function(func):

154

"""Make a copy of a function"""

155

if sys.version_info.major == 2:

156

return types.FunctionType(func.func_code,

157

func.func_globals,

158

func.func_name,

159

func.func_defaults,

160

func.func_closure)

161

else:

162

return types.FunctionType(func.__code__,

163

func.__globals__,

164

func.__name__,

165

func.__defaults__,

166

func.__closure__)

167

168

169

117

def initlogger(debug, level=logging.WARNING):

170

118

"""init logger and add loglevel"""

171

172

global syslogger

173

syslogger = (logging.handlers.SysLogHandler(

174

facility=logging.handlers.SysLogHandler.LOG_DAEMON,

175

address="/dev/log"))

119

176

120

syslogger.setFormatter(logging.Formatter

177

121

('Mandos [%(process)d]: %(levelname)s:'

178

122

' %(message)s'))

179

123

logger.addHandler(syslogger)

180

124

181

125

if debug:

182

126

console = logging.StreamHandler()

183

127

console.setFormatter(logging.Formatter('%(asctime)s %(name)s'

193

137

pass

194

138

195

139

196

class PGPEngine:

140

class PGPEngine(object):

197

141

"""A simple class for OpenPGP symmetric encryption & decryption"""

198

199

142

def __init__(self):

143

self.gnupg = GnuPGInterface.GnuPG()

200

144

self.tempdir = tempfile.mkdtemp(prefix="mandos-")

201

self.gpg = "gpg"

202

try:

203

output = subprocess.check_output(["gpgconf"])

204

for line in output.splitlines():

205

name, text, path = line.split(b":")

206

if name == "gpg":

207

self.gpg = path

208

break

209

except OSError as e:

210

if e.errno != errno.ENOENT:

211

raise

212

self.gnupgargs = ['--batch',

213

'--homedir', self.tempdir,

214

'--force-mdc',

215

'--quiet']

216

# Only GPG version 1 has the --no-use-agent option.

217

if self.gpg == "gpg" or self.gpg.endswith("/gpg"):

218

self.gnupgargs.append("--no-use-agent")

219

145

self.gnupg = GnuPGInterface.GnuPG()

146

self.gnupg.options.meta_interactive = False

147

self.gnupg.options.homedir = self.tempdir

148

self.gnupg.options.extra_args.extend(['--force-mdc',

149

'--quiet',

150

'--no-use-agent'])

151

220

152

def __enter__(self):

221

153

return self

222

154

223

155

def __exit__(self, exc_type, exc_value, traceback):

224

156

self._cleanup()

225

157

return False

226

158

227

159

def __del__(self):

228

160

self._cleanup()

229

161

230

162

def _cleanup(self):

231

163

if self.tempdir is not None:

232

164

# Delete contents of tempdir

233

165

for root, dirs, files in os.walk(self.tempdir,

234

topdown=False):

166

topdown = False):

235

167

for filename in files:

236

168

os.remove(os.path.join(root, filename))

237

169

for dirname in dirs:

239

171

# Remove tempdir

240

172

os.rmdir(self.tempdir)

241

173

self.tempdir = None

242

174

243

175

def password_encode(self, password):

244

176

# Passphrase can not be empty and can not contain newlines or

245

177

# NUL bytes. So we prefix it and hex encode it.

246

encoded = b"mandos" + binascii.hexlify(password)

247

if len(encoded) > 2048:

248

# GnuPG can't handle long passwords, so encode differently

249

encoded = (b"mandos" + password.replace(b"\\", b"\\\\")

250

.replace(b"\n", b"\\n")

251

.replace(b"\0", b"\\x00"))

252

return encoded

253

178

return b"mandos" + binascii.hexlify(password)

179

254

180

def encrypt(self, data, password):

255

passphrase = self.password_encode(password)

256

with tempfile.NamedTemporaryFile(

257

dir=self.tempdir) as passfile:

258

passfile.write(passphrase)

259

passfile.flush()

260

proc = subprocess.Popen([self.gpg, '--symmetric',

261

'--passphrase-file',

262

passfile.name]

263

+ self.gnupgargs,

264

stdin=subprocess.PIPE,

265

stdout=subprocess.PIPE,

266

stderr=subprocess.PIPE)

267

ciphertext, err = proc.communicate(input=data)

268

if proc.returncode != 0:

269

raise PGPError(err)

181

self.gnupg.passphrase = self.password_encode(password)

182

with open(os.devnull, "w") as devnull:

183

try:

184

proc = self.gnupg.run(['--symmetric'],

185

create_fhs=['stdin', 'stdout'],

186

attach_fhs={'stderr': devnull})

187

with contextlib.closing(proc.handles['stdin']) as f:

188

f.write(data)

189

with contextlib.closing(proc.handles['stdout']) as f:

190

ciphertext = f.read()

191

proc.wait()

192

except IOError as e:

193

raise PGPError(e)

194

self.gnupg.passphrase = None

270

195

return ciphertext

271

196

272

197

def decrypt(self, data, password):

273

passphrase = self.password_encode(password)

274

with tempfile.NamedTemporaryFile(

275

dir=self.tempdir) as passfile:

276

passfile.write(passphrase)

277

passfile.flush()

278

proc = subprocess.Popen([self.gpg, '--decrypt',

279

'--passphrase-file',

280

passfile.name]

281

+ self.gnupgargs,

282

stdin=subprocess.PIPE,

283

stdout=subprocess.PIPE,

284

stderr=subprocess.PIPE)

285

decrypted_plaintext, err = proc.communicate(input=data)

286

if proc.returncode != 0:

287

raise PGPError(err)

198

self.gnupg.passphrase = self.password_encode(password)

199

with open(os.devnull, "w") as devnull:

200

try:

201

proc = self.gnupg.run(['--decrypt'],

202

create_fhs=['stdin', 'stdout'],

203

attach_fhs={'stderr': devnull})

204

with contextlib.closing(proc.handles['stdin']) as f:

205

f.write(data)

206

with contextlib.closing(proc.handles['stdout']) as f:

207

decrypted_plaintext = f.read()

208

proc.wait()

209

except IOError as e:

210

raise PGPError(e)

211

self.gnupg.passphrase = None

288

212

return decrypted_plaintext

289

213

290

214

291

# Pretend that we have an Avahi module

292

class avahi:

293

"""This isn't so much a class as it is a module-like namespace."""

294

IF_UNSPEC = -1 # avahi-common/address.h

295

PROTO_UNSPEC = -1 # avahi-common/address.h

296

PROTO_INET = 0 # avahi-common/address.h

297

PROTO_INET6 = 1 # avahi-common/address.h

298

DBUS_NAME = "org.freedesktop.Avahi"

299

DBUS_INTERFACE_ENTRY_GROUP = DBUS_NAME + ".EntryGroup"

300

DBUS_INTERFACE_SERVER = DBUS_NAME + ".Server"

301

DBUS_PATH_SERVER = "/"

302

303

@staticmethod

304

def string_array_to_txt_array(t):

305

return dbus.Array((dbus.ByteArray(s.encode("utf-8"))

306

for s in t), signature="ay")

307

ENTRY_GROUP_ESTABLISHED = 2 # avahi-common/defs.h

308

ENTRY_GROUP_COLLISION = 3 # avahi-common/defs.h

309

ENTRY_GROUP_FAILURE = 4 # avahi-common/defs.h

310

SERVER_INVALID = 0 # avahi-common/defs.h

311

SERVER_REGISTERING = 1 # avahi-common/defs.h

312

SERVER_RUNNING = 2 # avahi-common/defs.h

313

SERVER_COLLISION = 3 # avahi-common/defs.h

314

SERVER_FAILURE = 4 # avahi-common/defs.h

315

316

317

215

class AvahiError(Exception):

318

216

def __init__(self, value, *args, **kwargs):

319

217

self.value = value

320

return super(AvahiError, self).__init__(value, *args,

321

**kwargs)

322

218

super(AvahiError, self).__init__(value, *args, **kwargs)

219

def __unicode__(self):

220

return unicode(repr(self.value))

323

221

324

222

class AvahiServiceError(AvahiError):

325

223

pass

326

224

327

328

225

class AvahiGroupError(AvahiError):

329

226

pass

330

227

331

228

332

class AvahiService:

229

class AvahiService(object):

333

230

"""An Avahi (Zeroconf) service.

334

231

335

232

Attributes:

336

233

interface: integer; avahi.IF_UNSPEC or an interface index.

337

234

Used to optionally bind to the specified interface.

338

235

name: string; Example: 'Mandos'

339

236

type: string; Example: '_mandos._tcp'.

340

See <https://www.iana.org/assignments/service-names-port-numbers>

237

See <http://www.dns-sd.org/ServiceTypes.html>

341

238

port: integer; what port to announce

342

239

TXT: list of strings; TXT record for the service

343

240

domain: string; Domain to publish on, default to .local if empty.

349

246

server: D-Bus Server

350

247

bus: dbus.SystemBus()

351

248

"""

352

353

def __init__(self,

354

interface=avahi.IF_UNSPEC,

355

name=None,

356

servicetype=None,

357

port=None,

358

TXT=None,

359

domain="",

360

host="",

361

max_renames=32768,

362

protocol=avahi.PROTO_UNSPEC,

363

bus=None):

249

250

def __init__(self, interface = avahi.IF_UNSPEC, name = None,

251

servicetype = None, port = None, TXT = None,

252

domain = "", host = "", max_renames = 32768,

253

protocol = avahi.PROTO_UNSPEC, bus = None):

364

254

self.interface = interface

365

255

self.name = name

366

256

self.type = servicetype

375

265

self.server = None

376

266

self.bus = bus

377

267

self.entry_group_state_changed_match = None

378

379

def rename(self, remove=True):

268

269

def rename(self):

380

270

"""Derived from the Avahi example code"""

381

271

if self.rename_count >= self.max_renames:

382

272

logger.critical("No suitable Zeroconf service name found"

383

273

" after %i retries, exiting.",

384

274

self.rename_count)

385

275

raise AvahiServiceError("Too many renames")

386

self.name = str(

387

self.server.GetAlternativeServiceName(self.name))

388

self.rename_count += 1

276

self.name = unicode(self.server

277

.GetAlternativeServiceName(self.name))

389

278

logger.info("Changing Zeroconf service name to %r ...",

390

279

self.name)

391

if remove:

392

self.remove()

280

self.remove()

393

281

try:

394

282

self.add()

395

283

except dbus.exceptions.DBusException as error:

396

if (error.get_dbus_name()

397

== "org.freedesktop.Avahi.CollisionError"):

398

logger.info("Local Zeroconf service name collision.")

399

return self.rename(remove=False)

400

else:

401

logger.critical("D-Bus Exception", exc_info=error)

402

self.cleanup()

403

os._exit(1)

404

284

logger.critical("D-Bus Exception", exc_info=error)

285

self.cleanup()

286

os._exit(1)

287

self.rename_count += 1

288

405

289

def remove(self):

406

290

"""Derived from the Avahi example code"""

407

291

if self.entry_group_state_changed_match is not None:

409

293

self.entry_group_state_changed_match = None

410

294

if self.group is not None:

411

295

self.group.Reset()

412

296

413

297

def add(self):

414

298

"""Derived from the Avahi example code"""

415

299

self.remove()

432

316

dbus.UInt16(self.port),

433

317

avahi.string_array_to_txt_array(self.TXT))

434

318

self.group.Commit()

435

319

436

320

def entry_group_state_changed(self, state, error):

437

321

"""Derived from the Avahi example code"""

438

322

logger.debug("Avahi entry group state change: %i", state)

439

323

440

324

if state == avahi.ENTRY_GROUP_ESTABLISHED:

441

325

logger.debug("Zeroconf service established.")

442

326

elif state == avahi.ENTRY_GROUP_COLLISION:

444

328

self.rename()

445

329

elif state == avahi.ENTRY_GROUP_FAILURE:

446

330

logger.critical("Avahi: Error in group state changed %s",

447

str(error))

448

raise AvahiGroupError("State changed: {!s}".format(error))

449

331

unicode(error))

332

raise AvahiGroupError("State changed: {0!s}"

333

.format(error))

334

450

335

def cleanup(self):

451

336

"""Derived from the Avahi example code"""

452

337

if self.group is not None:

457

342

pass

458

343

self.group = None

459

344

self.remove()

460

345

461

346

def server_state_changed(self, state, error=None):

462

347

"""Derived from the Avahi example code"""

463

348

logger.debug("Avahi server state change: %i", state)

464

bad_states = {

465

avahi.SERVER_INVALID: "Zeroconf server invalid",

466

avahi.SERVER_REGISTERING: None,

467

avahi.SERVER_COLLISION: "Zeroconf server name collision",

468

avahi.SERVER_FAILURE: "Zeroconf server failure",

469

}

349

bad_states = { avahi.SERVER_INVALID:

350

"Zeroconf server invalid",

351

avahi.SERVER_REGISTERING: None,

352

avahi.SERVER_COLLISION:

353

"Zeroconf server name collision",

354

avahi.SERVER_FAILURE:

355

"Zeroconf server failure" }

470

356

if state in bad_states:

471

357

if bad_states[state] is not None:

472

358

if error is None:

475

361

logger.error(bad_states[state] + ": %r", error)

476

362

self.cleanup()

477

363

elif state == avahi.SERVER_RUNNING:

478

try:

479

self.add()

480

except dbus.exceptions.DBusException as error:

481

if (error.get_dbus_name()

482

== "org.freedesktop.Avahi.CollisionError"):

483

logger.info("Local Zeroconf service name"

484

" collision.")

485

return self.rename(remove=False)

486

else:

487

logger.critical("D-Bus Exception", exc_info=error)

488

self.cleanup()

489

os._exit(1)

364

self.add()

490

365

else:

491

366

if error is None:

492

367

logger.debug("Unknown state: %r", state)

493

368

else:

494

369

logger.debug("Unknown state: %r: %r", state, error)

495

370

496

371

def activate(self):

497

372

"""Derived from the Avahi example code"""

498

373

if self.server is None:

502

377

follow_name_owner_changes=True),

503

378

avahi.DBUS_INTERFACE_SERVER)

504

379

self.server.connect_to_signal("StateChanged",

505

self.server_state_changed)

380

self.server_state_changed)

506

381

self.server_state_changed(self.server.GetState())

507

382

508

383

509

384

class AvahiServiceToSyslog(AvahiService):

510

def rename(self, *args, **kwargs):

385

def rename(self):

511

386

"""Add the new name to the syslog messages"""

512

ret = super(AvahiServiceToSyslog, self).rename(*args, **kwargs)

513

syslogger.setFormatter(logging.Formatter(

514

'Mandos ({}) [%(process)d]: %(levelname)s: %(message)s'

515

.format(self.name)))

387

ret = AvahiService.rename(self)

388

syslogger.setFormatter(logging.Formatter

389

('Mandos ({0}) [%(process)d]:'

390

' %(levelname)s: %(message)s'

391

.format(self.name)))

516

392

return ret

517

393

518

394

519

# Pretend that we have a GnuTLS module

520

class gnutls:

521

"""This isn't so much a class as it is a module-like namespace."""

522

523

library = ctypes.util.find_library("gnutls")

524

if library is None:

525

library = ctypes.util.find_library("gnutls-deb0")

526

_library = ctypes.cdll.LoadLibrary(library)

527

del library

528

529

# Unless otherwise indicated, the constants and types below are

530

# all from the gnutls/gnutls.h C header file.

531

532

# Constants

533

E_SUCCESS = 0

534

E_INTERRUPTED = -52

535

E_AGAIN = -28

536

CRT_OPENPGP = 2

537

CRT_RAWPK = 3

538

CLIENT = 2

539

SHUT_RDWR = 0

540

CRD_CERTIFICATE = 1

541

E_NO_CERTIFICATE_FOUND = -49

542

X509_FMT_DER = 0

543

NO_TICKETS = 1<<10

544

ENABLE_RAWPK = 1<<18

545

CTYPE_PEERS = 3

546

KEYID_USE_SHA256 = 1 # gnutls/x509.h

547

OPENPGP_FMT_RAW = 0 # gnutls/openpgp.h

548

549

# Types

550

class session_int(ctypes.Structure):

551

_fields_ = []

552

session_t = ctypes.POINTER(session_int)

553

554

class certificate_credentials_st(ctypes.Structure):

555

_fields_ = []

556

certificate_credentials_t = ctypes.POINTER(

557

certificate_credentials_st)

558

certificate_type_t = ctypes.c_int

559

560

class datum_t(ctypes.Structure):

561

_fields_ = [('data', ctypes.POINTER(ctypes.c_ubyte)),

562

('size', ctypes.c_uint)]

563

564

class openpgp_crt_int(ctypes.Structure):

565

_fields_ = []

566

openpgp_crt_t = ctypes.POINTER(openpgp_crt_int)

567

openpgp_crt_fmt_t = ctypes.c_int # gnutls/openpgp.h

568

log_func = ctypes.CFUNCTYPE(None, ctypes.c_int, ctypes.c_char_p)

569

credentials_type_t = ctypes.c_int

570

transport_ptr_t = ctypes.c_void_p

571

close_request_t = ctypes.c_int

572

573

# Exceptions

574

class Error(Exception):

575

def __init__(self, message=None, code=None, args=()):

576

# Default usage is by a message string, but if a return

577

# code is passed, convert it to a string with

578

# gnutls.strerror()

579

self.code = code

580

if message is None and code is not None:

581

message = gnutls.strerror(code)

582

return super(gnutls.Error, self).__init__(

583

message, *args)

584

585

class CertificateSecurityError(Error):

586

pass

587

588

# Classes

589

class Credentials:

590

def __init__(self):

591

self._c_object = gnutls.certificate_credentials_t()

592

gnutls.certificate_allocate_credentials(

593

ctypes.byref(self._c_object))

594

self.type = gnutls.CRD_CERTIFICATE

595

596

def __del__(self):

597

gnutls.certificate_free_credentials(self._c_object)

598

599

class ClientSession:

600

def __init__(self, socket, credentials=None):

601

self._c_object = gnutls.session_t()

602

gnutls_flags = gnutls.CLIENT

603

if gnutls.check_version(b"3.5.6"):

604

gnutls_flags |= gnutls.NO_TICKETS

605

if gnutls.has_rawpk:

606

gnutls_flags |= gnutls.ENABLE_RAWPK

607

gnutls.init(ctypes.byref(self._c_object), gnutls_flags)

608

del gnutls_flags

609

gnutls.set_default_priority(self._c_object)

610

gnutls.transport_set_ptr(self._c_object, socket.fileno())

611

gnutls.handshake_set_private_extensions(self._c_object,

612

True)

613

self.socket = socket

614

if credentials is None:

615

credentials = gnutls.Credentials()

616

gnutls.credentials_set(self._c_object, credentials.type,

617

ctypes.cast(credentials._c_object,

618

ctypes.c_void_p))

619

self.credentials = credentials

620

621

def __del__(self):

622

gnutls.deinit(self._c_object)

623

624

def handshake(self):

625

return gnutls.handshake(self._c_object)

626

627

def send(self, data):

628

data = bytes(data)

629

data_len = len(data)

630

while data_len > 0:

631

data_len -= gnutls.record_send(self._c_object,

632

data[-data_len:],

633

data_len)

634

635

def bye(self):

636

return gnutls.bye(self._c_object, gnutls.SHUT_RDWR)

637

638

# Error handling functions

639

def _error_code(result):

640

"""A function to raise exceptions on errors, suitable

641

for the 'restype' attribute on ctypes functions"""

642

if result >= 0:

643

return result

644

if result == gnutls.E_NO_CERTIFICATE_FOUND:

645

raise gnutls.CertificateSecurityError(code=result)

646

raise gnutls.Error(code=result)

647

648

def _retry_on_error(result, func, arguments):

649

"""A function to retry on some errors, suitable

650

for the 'errcheck' attribute on ctypes functions"""

651

while result < 0:

652

if result not in (gnutls.E_INTERRUPTED, gnutls.E_AGAIN):

653

return _error_code(result)

654

result = func(*arguments)

655

return result

656

657

# Unless otherwise indicated, the function declarations below are

658

# all from the gnutls/gnutls.h C header file.

659

660

# Functions

661

priority_set_direct = _library.gnutls_priority_set_direct

662

priority_set_direct.argtypes = [session_t, ctypes.c_char_p,

663

ctypes.POINTER(ctypes.c_char_p)]

664

priority_set_direct.restype = _error_code

665

666

init = _library.gnutls_init

667

init.argtypes = [ctypes.POINTER(session_t), ctypes.c_int]

668

init.restype = _error_code

669

670

set_default_priority = _library.gnutls_set_default_priority

671

set_default_priority.argtypes = [session_t]

672

set_default_priority.restype = _error_code

673

674

record_send = _library.gnutls_record_send

675

record_send.argtypes = [session_t, ctypes.c_void_p,

676

ctypes.c_size_t]

677

record_send.restype = ctypes.c_ssize_t

678

record_send.errcheck = _retry_on_error

679

680

certificate_allocate_credentials = (

681

_library.gnutls_certificate_allocate_credentials)

682

certificate_allocate_credentials.argtypes = [

683

ctypes.POINTER(certificate_credentials_t)]

684

certificate_allocate_credentials.restype = _error_code

685

686

certificate_free_credentials = (

687

_library.gnutls_certificate_free_credentials)

688

certificate_free_credentials.argtypes = [

689

certificate_credentials_t]

690

certificate_free_credentials.restype = None

691

692

handshake_set_private_extensions = (

693

_library.gnutls_handshake_set_private_extensions)

694

handshake_set_private_extensions.argtypes = [session_t,

695

ctypes.c_int]

696

handshake_set_private_extensions.restype = None

697

698

credentials_set = _library.gnutls_credentials_set

699

credentials_set.argtypes = [session_t, credentials_type_t,

700

ctypes.c_void_p]

701

credentials_set.restype = _error_code

702

703

strerror = _library.gnutls_strerror

704

strerror.argtypes = [ctypes.c_int]

705

strerror.restype = ctypes.c_char_p

706

707

certificate_type_get = _library.gnutls_certificate_type_get

708

certificate_type_get.argtypes = [session_t]

709

certificate_type_get.restype = _error_code

710

711

certificate_get_peers = _library.gnutls_certificate_get_peers

712

certificate_get_peers.argtypes = [session_t,

713

ctypes.POINTER(ctypes.c_uint)]

714

certificate_get_peers.restype = ctypes.POINTER(datum_t)

715

716

global_set_log_level = _library.gnutls_global_set_log_level

717

global_set_log_level.argtypes = [ctypes.c_int]

718

global_set_log_level.restype = None

719

720

global_set_log_function = _library.gnutls_global_set_log_function

721

global_set_log_function.argtypes = [log_func]

722

global_set_log_function.restype = None

723

724

deinit = _library.gnutls_deinit

725

deinit.argtypes = [session_t]

726

deinit.restype = None

727

728

handshake = _library.gnutls_handshake

729

handshake.argtypes = [session_t]

730

handshake.restype = _error_code

731

handshake.errcheck = _retry_on_error

732

733

transport_set_ptr = _library.gnutls_transport_set_ptr

734

transport_set_ptr.argtypes = [session_t, transport_ptr_t]

735

transport_set_ptr.restype = None

736

737

bye = _library.gnutls_bye

738

bye.argtypes = [session_t, close_request_t]

739

bye.restype = _error_code

740

bye.errcheck = _retry_on_error

741

742

check_version = _library.gnutls_check_version

743

check_version.argtypes = [ctypes.c_char_p]

744

check_version.restype = ctypes.c_char_p

745

746

_need_version = b"3.3.0"

747

if check_version(_need_version) is None:

748

raise self.Error("Needs GnuTLS {} or later"

749

.format(_need_version))

750

751

_tls_rawpk_version = b"3.6.6"

752

has_rawpk = bool(check_version(_tls_rawpk_version))

753

754

if has_rawpk:

755

# Types

756

class pubkey_st(ctypes.Structure):

757

_fields = []

758

pubkey_t = ctypes.POINTER(pubkey_st)

759

760

x509_crt_fmt_t = ctypes.c_int

761

762

# All the function declarations below are from gnutls/abstract.h

763

pubkey_init = _library.gnutls_pubkey_init

764

pubkey_init.argtypes = [ctypes.POINTER(pubkey_t)]

765

pubkey_init.restype = _error_code

766

767

pubkey_import = _library.gnutls_pubkey_import

768

pubkey_import.argtypes = [pubkey_t, ctypes.POINTER(datum_t),

769

x509_crt_fmt_t]

770

pubkey_import.restype = _error_code

771

772

pubkey_get_key_id = _library.gnutls_pubkey_get_key_id

773

pubkey_get_key_id.argtypes = [pubkey_t, ctypes.c_int,

774

ctypes.POINTER(ctypes.c_ubyte),

775

ctypes.POINTER(ctypes.c_size_t)]

776

pubkey_get_key_id.restype = _error_code

777

778

pubkey_deinit = _library.gnutls_pubkey_deinit

779

pubkey_deinit.argtypes = [pubkey_t]

780

pubkey_deinit.restype = None

781

else:

782

# All the function declarations below are from gnutls/openpgp.h

783

784

openpgp_crt_init = _library.gnutls_openpgp_crt_init

785

openpgp_crt_init.argtypes = [ctypes.POINTER(openpgp_crt_t)]

786

openpgp_crt_init.restype = _error_code

787

788

openpgp_crt_import = _library.gnutls_openpgp_crt_import

789

openpgp_crt_import.argtypes = [openpgp_crt_t,

790

ctypes.POINTER(datum_t),

791

openpgp_crt_fmt_t]

792

openpgp_crt_import.restype = _error_code

793

794

openpgp_crt_verify_self = _library.gnutls_openpgp_crt_verify_self

795

openpgp_crt_verify_self.argtypes = [openpgp_crt_t, ctypes.c_uint,

796

ctypes.POINTER(ctypes.c_uint)]

797

openpgp_crt_verify_self.restype = _error_code

798

799

openpgp_crt_deinit = _library.gnutls_openpgp_crt_deinit

800

openpgp_crt_deinit.argtypes = [openpgp_crt_t]

801

openpgp_crt_deinit.restype = None

802

803

openpgp_crt_get_fingerprint = (

804

_library.gnutls_openpgp_crt_get_fingerprint)

805

openpgp_crt_get_fingerprint.argtypes = [openpgp_crt_t,

806

ctypes.c_void_p,

807

ctypes.POINTER(

808

ctypes.c_size_t)]

809

openpgp_crt_get_fingerprint.restype = _error_code

810

811

if check_version(b"3.6.4"):

812

certificate_type_get2 = _library.gnutls_certificate_type_get2

813

certificate_type_get2.argtypes = [session_t, ctypes.c_int]

814

certificate_type_get2.restype = _error_code

815

816

# Remove non-public functions

817

del _error_code, _retry_on_error

818

819

820

def call_pipe(connection, # : multiprocessing.Connection

821

func, *args, **kwargs):

822

"""This function is meant to be called by multiprocessing.Process

823

824

This function runs func(*args, **kwargs), and writes the resulting

825

return value on the provided multiprocessing.Connection.

826

"""

827

connection.send(func(*args, **kwargs))

828

connection.close()

829

830

831

class Client:

395

def timedelta_to_milliseconds(td):

396

"Convert a datetime.timedelta() to milliseconds"

397

return ((td.days * 24 * 60 * 60 * 1000)

398

+ (td.seconds * 1000)

399

+ (td.microseconds // 1000))

400

401

402

class Client(object):

832

403

"""A representation of a client host served by this server.

833

404

834

405

Attributes:

835

406

approved: bool(); 'None' if not yet approved/disapproved

836

407

approval_delay: datetime.timedelta(); Time to wait for approval

837

408

approval_duration: datetime.timedelta(); Duration of one approval

838

checker: multiprocessing.Process(); a running checker process used

839

to see if the client lives. 'None' if no process is

840

running.

841

checker_callback_tag: a GLib event source tag, or None

409

checker: subprocess.Popen(); a running checker process used

410

to see if the client lives.

411

'None' if no process is running.

412

checker_callback_tag: a gobject event source tag, or None

842

413

checker_command: string; External command which is run to check

843

414

if client lives. %() expansions are done at

844

415

runtime with vars(self) as dict, so that for

845

416

instance %(name)s can be used in the command.

846

checker_initiator_tag: a GLib event source tag, or None

417

checker_initiator_tag: a gobject event source tag, or None

847

418

created: datetime.datetime(); (UTC) object creation

848

419

client_structure: Object describing what attributes a client has

849

420

and is used for storing the client at exit

850

421

current_checker_command: string; current running checker_command

851

disable_initiator_tag: a GLib event source tag, or None

422

disable_initiator_tag: a gobject event source tag, or None

852

423

enabled: bool()

853

424

fingerprint: string (40 or 32 hexadecimal digits); used to

854

uniquely identify an OpenPGP client

855

key_id: string (64 hexadecimal digits); used to uniquely identify

856

a client using raw public keys

425

uniquely identify the client

857

426

host: string; available for use by the checker command

858

427

interval: datetime.timedelta(); How often to start a new checker

859

428

last_approval_request: datetime.datetime(); (UTC) or None

861

430

last_checker_status: integer between 0 and 255 reflecting exit

862

431

status of last checker. -1 reflects crashed

863

432

checker, -2 means no checker completed yet.

864

last_checker_signal: The signal which killed the last checker, if

865

last_checker_status is -1

866

433

last_enabled: datetime.datetime(); (UTC) or None

867

434

name: string; from the config file, used in log messages and

868

435

D-Bus identifiers

873

440

runtime_expansions: Allowed attributes for runtime expansion.

874

441

expires: datetime.datetime(); time (UTC) when a client will be

875

442

disabled, or None

876

server_settings: The server_settings dict from main()

877

443

"""

878

444

879

445

runtime_expansions = ("approval_delay", "approval_duration",

880

"created", "enabled", "expires", "key_id",

446

"created", "enabled", "expires",

881

447

"fingerprint", "host", "interval",

882

448

"last_approval_request", "last_checked_ok",

883

449

"last_enabled", "name", "timeout")

884

client_defaults = {

885

"timeout": "PT5M",

886

"extended_timeout": "PT15M",

887

"interval": "PT2M",

888

"checker": "fping -q -- %%(host)s",

889

"host": "",

890

"approval_delay": "PT0S",

891

"approval_duration": "PT1S",

892

"approved_by_default": "True",

893

"enabled": "True",

894

}

895

450

client_defaults = { "timeout": "PT5M",

451

"extended_timeout": "PT15M",

452

"interval": "PT2M",

453

"checker": "fping -q -- %%(host)s",

454

"host": "",

455

"approval_delay": "PT0S",

456

"approval_duration": "PT1S",

457

"approved_by_default": "True",

458

"enabled": "True",

459

}

460

461

def timeout_milliseconds(self):

462

"Return the 'timeout' attribute in milliseconds"

463

return timedelta_to_milliseconds(self.timeout)

464

465

def extended_timeout_milliseconds(self):

466

"Return the 'extended_timeout' attribute in milliseconds"

467

return timedelta_to_milliseconds(self.extended_timeout)

468

469

def interval_milliseconds(self):

470

"Return the 'interval' attribute in milliseconds"

471

return timedelta_to_milliseconds(self.interval)

472

473

def approval_delay_milliseconds(self):

474

return timedelta_to_milliseconds(self.approval_delay)

475

896

476

@staticmethod

897

477

def config_parser(config):

898

478

"""Construct a new dict of client settings of this form:

905

485

for client_name in config.sections():

906

486

section = dict(config.items(client_name))

907

487

client = settings[client_name] = {}

908

488

909

489

client["host"] = section["host"]

910

490

# Reformat values from string types to Python types

911

491

client["approved_by_default"] = config.getboolean(

912

492

client_name, "approved_by_default")

913

493

client["enabled"] = config.getboolean(client_name,

914

494

"enabled")

915

916

# Uppercase and remove spaces from key_id and fingerprint

917

# for later comparison purposes with return value from the

918

# key_id() and fingerprint() functions

919

client["key_id"] = (section.get("key_id", "").upper()

920

.replace(" ", ""))

495

921

496

client["fingerprint"] = (section["fingerprint"].upper()

922

497

.replace(" ", ""))

923

498

if "secret" in section:

924

client["secret"] = codecs.decode(section["secret"]

925

.encode("utf-8"),

926

"base64")

499

client["secret"] = section["secret"].decode("base64")

927

500

elif "secfile" in section:

928

501

with open(os.path.expanduser(os.path.expandvars

929

502

(section["secfile"])),

930

503

"rb") as secfile:

931

504

client["secret"] = secfile.read()

932

505

else:

933

raise TypeError("No secret or secfile for section {}"

506

raise TypeError("No secret or secfile for section {0}"

934

507

.format(section))

935

508

client["timeout"] = string_to_delta(section["timeout"])

936

509

client["extended_timeout"] = string_to_delta(

944

517

client["last_approval_request"] = None

945

518

client["last_checked_ok"] = None

946

519

client["last_checker_status"] = -2

947

520

948

521

return settings

949

950

def __init__(self, settings, name=None, server_settings=None):

522

523

def __init__(self, settings, name = None):

951

524

self.name = name

952

if server_settings is None:

953

server_settings = {}

954

self.server_settings = server_settings

955

525

# adding all client settings

956

for setting, value in settings.items():

526

for setting, value in settings.iteritems():

957

527

setattr(self, setting, value)

958

528

959

529

if self.enabled:

960

530

if not hasattr(self, "last_enabled"):

961

531

self.last_enabled = datetime.datetime.utcnow()

965

535

else:

966

536

self.last_enabled = None

967

537

self.expires = None

968

538

969

539

logger.debug("Creating client %r", self.name)

970

logger.debug(" Key ID: %s", self.key_id)

540

# Uppercase and remove spaces from fingerprint for later

541

# comparison purposes with return value from the fingerprint()

542

# function

971

543

logger.debug(" Fingerprint: %s", self.fingerprint)

972

544

self.created = settings.get("created",

973

545

datetime.datetime.utcnow())

974

546

975

547

# attributes specific for this server instance

976

548

self.checker = None

977

549

self.checker_initiator_tag = None

980

552

self.current_checker_command = None

981

553

self.approved = None

982

554

self.approvals_pending = 0

983

self.changedstate = multiprocessing_manager.Condition(

984

multiprocessing_manager.Lock())

985

self.client_structure = [attr

986

for attr in self.__dict__.keys()

555

self.changedstate = (multiprocessing_manager

556

.Condition(multiprocessing_manager

557

.Lock()))

558

self.client_structure = [attr for attr in

559

self.__dict__.iterkeys()

987

560

if not attr.startswith("_")]

988

561

self.client_structure.append("client_structure")

989

990

for name, t in inspect.getmembers(

991

type(self), lambda obj: isinstance(obj, property)):

562

563

for name, t in inspect.getmembers(type(self),

564

lambda obj:

565

isinstance(obj,

566

property)):

992

567

if not name.startswith("_"):

993

568

self.client_structure.append(name)

994

569

995

570

# Send notice to process children that client state has changed

996

571

def send_changedstate(self):

997

572

with self.changedstate:

998

573

self.changedstate.notify_all()

999

574

1000

575

def enable(self):

1001

576

"""Start this client's checker and timeout hooks"""

1002

577

if getattr(self, "enabled", False):

1007

582

self.last_enabled = datetime.datetime.utcnow()

1008

583

self.init_checker()

1009

584

self.send_changedstate()

1010

585

1011

586

def disable(self, quiet=True):

1012

587

"""Disable this client."""

1013

588

if not getattr(self, "enabled", False):

1015

590

if not quiet:

1016

591

logger.info("Disabling client %s", self.name)

1017

592

if getattr(self, "disable_initiator_tag", None) is not None:

1018

GLib.source_remove(self.disable_initiator_tag)

593

gobject.source_remove(self.disable_initiator_tag)

1019

594

self.disable_initiator_tag = None

1020

595

self.expires = None

1021

596

if getattr(self, "checker_initiator_tag", None) is not None:

1022

GLib.source_remove(self.checker_initiator_tag)

597

gobject.source_remove(self.checker_initiator_tag)

1023

598

self.checker_initiator_tag = None

1024

599

self.stop_checker()

1025

600

self.enabled = False

1026

601

if not quiet:

1027

602

self.send_changedstate()

1028

# Do not run this again if called by a GLib.timeout_add

603

# Do not run this again if called by a gobject.timeout_add

1029

604

return False

1030

605

1031

606

def __del__(self):

1032

607

self.disable()

1033

608

1034

609

def init_checker(self):

1035

610

# Schedule a new checker to be started an 'interval' from now,

1036

611

# and every interval from then on.

1037

612

if self.checker_initiator_tag is not None:

1038

GLib.source_remove(self.checker_initiator_tag)

1039

self.checker_initiator_tag = GLib.timeout_add(

1040

int(self.interval.total_seconds() * 1000),

1041

self.start_checker)

613

gobject.source_remove(self.checker_initiator_tag)

614

self.checker_initiator_tag = (gobject.timeout_add

615

(self.interval_milliseconds(),

616

self.start_checker))

1042

617

# Schedule a disable() when 'timeout' has passed

1043

618

if self.disable_initiator_tag is not None:

1044

GLib.source_remove(self.disable_initiator_tag)

1045

self.disable_initiator_tag = GLib.timeout_add(

1046

int(self.timeout.total_seconds() * 1000), self.disable)

619

gobject.source_remove(self.disable_initiator_tag)

620

self.disable_initiator_tag = (gobject.timeout_add

621

(self.timeout_milliseconds(),

622

self.disable))

1047

623

# Also start a new checker *right now*.

1048

624

self.start_checker()

1049

1050

def checker_callback(self, source, condition, connection,

1051

command):

625

626

def checker_callback(self, pid, condition, command):

1052

627

"""The checker has completed, so take appropriate actions."""

1053

# Read return code from connection (see call_pipe)

1054

returncode = connection.recv()

1055

connection.close()

1056

self.checker.join()

1057

628

self.checker_callback_tag = None

1058

629

self.checker = None

1059

1060

if returncode >= 0:

1061

self.last_checker_status = returncode

1062

self.last_checker_signal = None

630

if os.WIFEXITED(condition):

631

self.last_checker_status = os.WEXITSTATUS(condition)

1063

632

if self.last_checker_status == 0:

1064

633

logger.info("Checker for %(name)s succeeded",

1065

634

vars(self))

1066

635

self.checked_ok()

1067

636

else:

1068

logger.info("Checker for %(name)s failed", vars(self))

637

logger.info("Checker for %(name)s failed",

638

vars(self))

1069

639

else:

1070

640

self.last_checker_status = -1

1071

self.last_checker_signal = -returncode

1072

641

logger.warning("Checker for %(name)s crashed?",

1073

642

vars(self))

1074

return False

1075

643

1076

644

def checked_ok(self):

1077

645

"""Assert that the client has been seen, alive and well."""

1078

646

self.last_checked_ok = datetime.datetime.utcnow()

1079

647

self.last_checker_status = 0

1080

self.last_checker_signal = None

1081

648

self.bump_timeout()

1082

649

1083

650

def bump_timeout(self, timeout=None):

1084

651

"""Bump up the timeout for this client."""

1085

652

if timeout is None:

1086

653

timeout = self.timeout

1087

654

if self.disable_initiator_tag is not None:

1088

GLib.source_remove(self.disable_initiator_tag)

655

gobject.source_remove(self.disable_initiator_tag)

1089

656

self.disable_initiator_tag = None

1090

657

if getattr(self, "enabled", False):

1091

self.disable_initiator_tag = GLib.timeout_add(

1092

int(timeout.total_seconds() * 1000), self.disable)

658

self.disable_initiator_tag = (gobject.timeout_add

659

(timedelta_to_milliseconds

660

(timeout), self.disable))

1093

661

self.expires = datetime.datetime.utcnow() + timeout

1094

662

1095

663

def need_approval(self):

1096

664

self.last_approval_request = datetime.datetime.utcnow()

1097

665

1098

666

def start_checker(self):

1099

667

"""Start a new checker subprocess if one is not running.

1100

668

1101

669

If a checker already exists, leave it running and do

1102

670

nothing."""

1103

671

# The reason for not killing a running checker is that if we

1108

676

# checkers alone, the checker would have to take more time

1109

677

# than 'timeout' for the client to be disabled, which is as it

1110

678

# should be.

1111

1112

if self.checker is not None and not self.checker.is_alive():

1113

logger.warning("Checker was not alive; joining")

1114

self.checker.join()

1115

self.checker = None

679

680

# If a checker exists, make sure it is not a zombie

681

try:

682

pid, status = os.waitpid(self.checker.pid, os.WNOHANG)

683

except (AttributeError, OSError) as error:

684

if (isinstance(error, OSError)

685

and error.errno != errno.ECHILD):

686

raise error

687

else:

688

if pid:

689

logger.warning("Checker was a zombie")

690

gobject.source_remove(self.checker_callback_tag)

691

self.checker_callback(pid, status,

692

self.current_checker_command)

1116

693

# Start a new checker if needed

1117

694

if self.checker is None:

1118

695

# Escape attributes for the shell

1119

escaped_attrs = {

1120

attr: re.escape(str(getattr(self, attr)))

1121

for attr in self.runtime_expansions}

696

escaped_attrs = dict(

697

(attr, re.escape(unicode(getattr(self, attr))))

698

for attr in

699

self.runtime_expansions)

1122

700

try:

1123

701

command = self.checker_command % escaped_attrs

1124

702

except TypeError as error:

1125

703

logger.error('Could not format string "%s"',

1126

self.checker_command,

704

self.checker_command, exc_info=error)

705

return True # Try again later

706

self.current_checker_command = command

707

try:

708

logger.info("Starting checker %r for %s",

709

command, self.name)

710

# We don't need to redirect stdout and stderr, since

711

# in normal mode, that is already done by daemon(),

712

# and in debug mode we don't want to. (Stdin is

713

# always replaced by /dev/null.)

714

self.checker = subprocess.Popen(command,

715

close_fds=True,

716

shell=True, cwd="/")

717

except OSError as error:

718

logger.error("Failed to start subprocess",

1127

719

exc_info=error)

1128

return True # Try again later

1129

self.current_checker_command = command

1130

logger.info("Starting checker %r for %s", command,

1131

self.name)

1132

# We don't need to redirect stdout and stderr, since

1133

# in normal mode, that is already done by daemon(),

1134

# and in debug mode we don't want to. (Stdin is

1135

# always replaced by /dev/null.)

1136

# The exception is when not debugging but nevertheless

1137

# running in the foreground; use the previously

1138

# created wnull.

1139

popen_args = {"close_fds": True,

1140

"shell": True,

1141

"cwd": "/"}

1142

if (not self.server_settings["debug"]

1143

and self.server_settings["foreground"]):

1144

popen_args.update({"stdout": wnull,

1145

"stderr": wnull})

1146

pipe = multiprocessing.Pipe(duplex=False)

1147

self.checker = multiprocessing.Process(

1148

target=call_pipe,

1149

args=(pipe[1], subprocess.call, command),

1150

kwargs=popen_args)

1151

self.checker.start()

1152

self.checker_callback_tag = GLib.io_add_watch(

1153

GLib.IOChannel.unix_new(pipe[0].fileno()),

1154

GLib.PRIORITY_DEFAULT, GLib.IO_IN,

1155

self.checker_callback, pipe[0], command)

1156

# Re-run this periodically if run by GLib.timeout_add

720

self.checker_callback_tag = (gobject.child_watch_add

721

(self.checker.pid,

722

self.checker_callback,

723

data=command))

724

# The checker may have completed before the gobject

725

# watch was added. Check for this.

726

pid, status = os.waitpid(self.checker.pid, os.WNOHANG)

727

if pid:

728

gobject.source_remove(self.checker_callback_tag)

729

self.checker_callback(pid, status, command)

730

# Re-run this periodically if run by gobject.timeout_add

1157

731

return True

1158

732

1159

733

def stop_checker(self):

1160

734

"""Force the checker process, if any, to stop."""

1161

735

if self.checker_callback_tag:

1162

GLib.source_remove(self.checker_callback_tag)

736

gobject.source_remove(self.checker_callback_tag)

1163

737

self.checker_callback_tag = None

1164

738

if getattr(self, "checker", None) is None:

1165

739

return

1166

740

logger.debug("Stopping checker for %(name)s", vars(self))

1167

self.checker.terminate()

741

try:

742

self.checker.terminate()

743

#time.sleep(0.5)

744

#if self.checker.poll() is None:

745

# self.checker.kill()

746

except OSError as error:

747

if error.errno != errno.ESRCH: # No such process

748

raise

1168

749

self.checker = None

1169

750

1170

751

1171

def dbus_service_property(dbus_interface,

1172

signature="v",

1173

access="readwrite",

1174

byte_arrays=False):

752

def dbus_service_property(dbus_interface, signature="v",

753

access="readwrite", byte_arrays=False):

1175

754

"""Decorators for marking methods of a DBusObjectWithProperties to

1176

755

become properties on the D-Bus.

1177

756

1178

757

The decorated method will be called with no arguments by "Get"

1179

758

and with one argument by "Set".

1180

759

1181

760

The parameters, where they are supported, are the same as

1182

761

dbus.service.method, except there is only "signature", since the

1183

762

type from Get() and the type sent to Set() is the same.

1186

765

# "Set" method, so we fail early here:

1187

766

if byte_arrays and signature != "ay":

1188

767

raise ValueError("Byte arrays not supported for non-'ay'"

1189

" signature {!r}".format(signature))

1190

768

" signature {0!r}".format(signature))

1191

769

def decorator(func):

1192

770

func._dbus_is_property = True

1193

771

func._dbus_interface = dbus_interface

1196

774

func._dbus_name = func.__name__

1197

775

if func._dbus_name.endswith("_dbus_property"):

1198

776

func._dbus_name = func._dbus_name[:-14]

1199

func._dbus_get_args_options = {'byte_arrays': byte_arrays}

777

func._dbus_get_args_options = {'byte_arrays': byte_arrays }

1200

778

return func

1201

1202

779

return decorator

1203

780

1204

781

1205

782

def dbus_interface_annotations(dbus_interface):

1206

783

"""Decorator for marking functions returning interface annotations

1207

784

1208

785

Usage:

1209

786

1210

787

@dbus_interface_annotations("org.example.Interface")

1211

788

def _foo(self): # Function name does not matter

1212

789

return {"org.freedesktop.DBus.Deprecated": "true",

1213

790

"org.freedesktop.DBus.Property.EmitsChangedSignal":

1214

791

"false"}

1215

792

"""

1216

1217

793

def decorator(func):

1218

794

func._dbus_is_interface = True

1219

795

func._dbus_interface = dbus_interface

1220

796

func._dbus_name = dbus_interface

1221

797

return func

1222

1223

798

return decorator

1224

799

1225

800

1226

801

def dbus_annotations(annotations):

1227

802

"""Decorator to annotate D-Bus methods, signals or properties

1228

803

Usage:

1229

1230

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true",

1231

"org.freedesktop.DBus.Property."

1232

"EmitsChangedSignal": "false"})

804

1233

805

@dbus_service_property("org.example.Interface", signature="b",

1234

806

access="r")

807

@dbus_annotations({{"org.freedesktop.DBus.Deprecated": "true",

808

"org.freedesktop.DBus.Property."

809

"EmitsChangedSignal": "false"})

1235

810

def Property_dbus_property(self):

1236

811

return dbus.Boolean(False)

1237

1238

See also the DBusObjectWithAnnotations class.

1239

812

"""

1240

1241

813

def decorator(func):

1242

814

func._dbus_annotations = annotations

1243

815

return func

1244

1245

816

return decorator

1246

817

1247

818

1248

819

class DBusPropertyException(dbus.exceptions.DBusException):

1249

820

"""A base class for D-Bus property-related exceptions

1250

821

"""

1251

pass

822

def __unicode__(self):

823

return unicode(str(self))

1252

824

1253

825

1254

826

class DBusPropertyAccessException(DBusPropertyException):

1263

835

pass

1264

836

1265

837

1266

class DBusObjectWithAnnotations(dbus.service.Object):

1267

"""A D-Bus object with annotations.

1268

1269

Classes inheriting from this can use the dbus_annotations

1270

decorator to add annotations to methods or signals.

838

class DBusObjectWithProperties(dbus.service.Object):

839

"""A D-Bus object with properties.

840

841

Classes inheriting from this can use the dbus_service_property

842

decorator to expose methods as D-Bus properties. It exposes the

843

standard Get(), Set(), and GetAll() methods on the D-Bus.

1271

844

"""

1272

845

1273

846

@staticmethod

1274

847

def _is_dbus_thing(thing):

1275

848

"""Returns a function testing if an attribute is a D-Bus thing

1276

849

1277

850

If called like _is_dbus_thing("method") it returns a function

1278

851

suitable for use as predicate to inspect.getmembers().

1279

852

"""

1280

return lambda obj: getattr(obj, "_dbus_is_{}".format(thing),

853

return lambda obj: getattr(obj, "_dbus_is_{0}".format(thing),

1281

854

False)

1282

855

1283

856

def _get_all_dbus_things(self, thing):

1284

857

"""Returns a generator of (name, attribute) pairs

1285

858

"""

1286

return ((getattr(athing.__get__(self), "_dbus_name", name),

859

return ((getattr(athing.__get__(self), "_dbus_name",

860

name),

1287

861

athing.__get__(self))

1288

862

for cls in self.__class__.__mro__

1289

863

for name, athing in

1290

inspect.getmembers(cls, self._is_dbus_thing(thing)))

1291

1292

@dbus.service.method(dbus.INTROSPECTABLE_IFACE,

1293

out_signature="s",

1294

path_keyword='object_path',

1295

connection_keyword='connection')

1296

def Introspect(self, object_path, connection):

1297

"""Overloading of standard D-Bus method.

1298

1299

Inserts annotation tags on methods and signals.

1300

"""

1301

xmlstring = dbus.service.Object.Introspect(self, object_path,

1302

connection)

1303

try:

1304

document = xml.dom.minidom.parseString(xmlstring)

1305

1306

for if_tag in document.getElementsByTagName("interface"):

1307

# Add annotation tags

1308

for typ in ("method", "signal"):

1309

for tag in if_tag.getElementsByTagName(typ):

1310

annots = dict()

1311

for name, prop in (self.

1312

_get_all_dbus_things(typ)):

1313

if (name == tag.getAttribute("name")

1314

and prop._dbus_interface

1315

== if_tag.getAttribute("name")):

1316

annots.update(getattr(

1317

prop, "_dbus_annotations", {}))

1318

for name, value in annots.items():

1319

ann_tag = document.createElement(

1320

"annotation")

1321

ann_tag.setAttribute("name", name)

1322

ann_tag.setAttribute("value", value)

1323

tag.appendChild(ann_tag)

1324

# Add interface annotation tags

1325

for annotation, value in dict(

1326

itertools.chain.from_iterable(

1327

annotations().items()

1328

for name, annotations

1329

in self._get_all_dbus_things("interface")

1330

if name == if_tag.getAttribute("name")

1331

)).items():

1332

ann_tag = document.createElement("annotation")

1333

ann_tag.setAttribute("name", annotation)

1334

ann_tag.setAttribute("value", value)

1335

if_tag.appendChild(ann_tag)

1336

# Fix argument name for the Introspect method itself

1337

if (if_tag.getAttribute("name")

1338

== dbus.INTROSPECTABLE_IFACE):

1339

for cn in if_tag.getElementsByTagName("method"):

1340

if cn.getAttribute("name") == "Introspect":

1341

for arg in cn.getElementsByTagName("arg"):

1342

if (arg.getAttribute("direction")

1343

== "out"):

1344

arg.setAttribute("name",

1345

"xml_data")

1346

xmlstring = document.toxml("utf-8")

1347

document.unlink()

1348

except (AttributeError, xml.dom.DOMException,

1349

xml.parsers.expat.ExpatError) as error:

1350

logger.error("Failed to override Introspection method",

1351

exc_info=error)

1352

return xmlstring

1353

1354

1355

class DBusObjectWithProperties(DBusObjectWithAnnotations):

1356

"""A D-Bus object with properties.

1357

1358

Classes inheriting from this can use the dbus_service_property

1359

decorator to expose methods as D-Bus properties. It exposes the

1360

standard Get(), Set(), and GetAll() methods on the D-Bus.

1361

"""

1362

864

inspect.getmembers(cls,

865

self._is_dbus_thing(thing)))

866

1363

867

def _get_dbus_property(self, interface_name, property_name):

1364

868

"""Returns a bound method if one exists which is a D-Bus

1365

869

property with the specified name and interface.

1366

870

"""

1367

for cls in self.__class__.__mro__:

1368

for name, value in inspect.getmembers(

1369

cls, self._is_dbus_thing("property")):

871

for cls in self.__class__.__mro__:

872

for name, value in (inspect.getmembers

873

(cls,

874

self._is_dbus_thing("property"))):

1370

875

if (value._dbus_name == property_name

1371

876

and value._dbus_interface == interface_name):

1372

877

return value.__get__(self)

1373

878

1374

879

# No such property

1375

raise DBusPropertyNotFound("{}:{}.{}".format(

1376

self.dbus_object_path, interface_name, property_name))

1377

1378

@classmethod

1379

def _get_all_interface_names(cls):

1380

"""Get a sequence of all interfaces supported by an object"""

1381

return (name for name in set(getattr(getattr(x, attr),

1382

"_dbus_interface", None)

1383

for x in (inspect.getmro(cls))

1384

for attr in dir(x))

1385

if name is not None)

1386

1387

@dbus.service.method(dbus.PROPERTIES_IFACE,

1388

in_signature="ss",

880

raise DBusPropertyNotFound(self.dbus_object_path + ":"

881

+ interface_name + "."

882

+ property_name)

883

884

@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ss",

1389

885

out_signature="v")

1390

886

def Get(self, interface_name, property_name):

1391

887

"""Standard D-Bus property Get() method, see D-Bus standard.

1397

893

if not hasattr(value, "variant_level"):

1398

894

return value

1399

895

return type(value)(value, variant_level=value.variant_level+1)

1400

896

1401

897

@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ssv")

1402

898

def Set(self, interface_name, property_name, value):

1403

899

"""Standard D-Bus property Set() method, see D-Bus standard.

1409

905

# The byte_arrays option is not supported yet on

1410

906

# signatures other than "ay".

1411

907

if prop._dbus_signature != "ay":

1412

raise ValueError("Byte arrays not supported for non-"

1413

"'ay' signature {!r}"

1414

.format(prop._dbus_signature))

908

raise ValueError

1415

909

value = dbus.ByteArray(b''.join(chr(byte)

1416

910

for byte in value))

1417

911

prop(value)

1418

1419

@dbus.service.method(dbus.PROPERTIES_IFACE,

1420

in_signature="s",

912

913

@dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="s",

1421

914

out_signature="a{sv}")

1422

915

def GetAll(self, interface_name):

1423

916

"""Standard D-Bus property GetAll() method, see D-Bus

1424

917

standard.

1425

918

1426

919

Note: Will not include properties with access="write".

1427

920

"""

1428

921

properties = {}

1438

931

if not hasattr(value, "variant_level"):

1439

932

properties[name] = value

1440

933

continue

1441

properties[name] = type(value)(

1442

value, variant_level=value.variant_level + 1)

934

properties[name] = type(value)(value, variant_level=

935

value.variant_level+1)

1443

936

return dbus.Dictionary(properties, signature="sv")

1444

1445

@dbus.service.signal(dbus.PROPERTIES_IFACE, signature="sa{sv}as")

1446

def PropertiesChanged(self, interface_name, changed_properties,

1447

invalidated_properties):

1448

"""Standard D-Bus PropertiesChanged() signal, see D-Bus

1449

standard.

1450

"""

1451

pass

1452

937

1453

938

@dbus.service.method(dbus.INTROSPECTABLE_IFACE,

1454

939

out_signature="s",

1455

940

path_keyword='object_path',

1456

941

connection_keyword='connection')

1457

942

def Introspect(self, object_path, connection):

1458

943

"""Overloading of standard D-Bus method.

1459

944

1460

945

Inserts property tags and interface annotation tags.

1461

946

"""

1462

xmlstring = DBusObjectWithAnnotations.Introspect(self,

1463

object_path,

1464

connection)

947

xmlstring = dbus.service.Object.Introspect(self, object_path,

948

connection)

1465

949

try:

1466

950

document = xml.dom.minidom.parseString(xmlstring)

1467

1468

951

def make_tag(document, name, prop):

1469

952

e = document.createElement("property")

1470

953

e.setAttribute("name", name)

1471

954

e.setAttribute("type", prop._dbus_signature)

1472

955

e.setAttribute("access", prop._dbus_access)

1473

956

return e

1474

1475

957

for if_tag in document.getElementsByTagName("interface"):

1476

958

# Add property tags

1477

959

for tag in (make_tag(document, name, prop)

1480

962

if prop._dbus_interface

1481

963

== if_tag.getAttribute("name")):

1482

964

if_tag.appendChild(tag)

1483

# Add annotation tags for properties

1484

for tag in if_tag.getElementsByTagName("property"):

1485

annots = dict()

1486

for name, prop in self._get_all_dbus_things(

1487

"property"):

1488

if (name == tag.getAttribute("name")

1489

and prop._dbus_interface

1490

== if_tag.getAttribute("name")):

1491

annots.update(getattr(

1492

prop, "_dbus_annotations", {}))

1493

for name, value in annots.items():

1494

ann_tag = document.createElement(

1495

"annotation")

1496

ann_tag.setAttribute("name", name)

1497

ann_tag.setAttribute("value", value)

1498

tag.appendChild(ann_tag)

965

# Add annotation tags

966

for typ in ("method", "signal", "property"):

967

for tag in if_tag.getElementsByTagName(typ):

968

annots = dict()

969

for name, prop in (self.

970

_get_all_dbus_things(typ)):

971

if (name == tag.getAttribute("name")

972

and prop._dbus_interface

973

== if_tag.getAttribute("name")):

974

annots.update(getattr

975

(prop,

976

"_dbus_annotations",

977

{}))

978

for name, value in annots.iteritems():

979

ann_tag = document.createElement(

980

"annotation")

981

ann_tag.setAttribute("name", name)

982

ann_tag.setAttribute("value", value)

983

tag.appendChild(ann_tag)

984

# Add interface annotation tags

985

for annotation, value in dict(

986

itertools.chain.from_iterable(

987

annotations().iteritems()

988

for name, annotations in

989

self._get_all_dbus_things("interface")

990

if name == if_tag.getAttribute("name")

991

)).iteritems():

992

ann_tag = document.createElement("annotation")

993

ann_tag.setAttribute("name", annotation)

994

ann_tag.setAttribute("value", value)

995

if_tag.appendChild(ann_tag)

1499

996

# Add the names to the return values for the

1500

997

# "org.freedesktop.DBus.Properties" methods

1501

998

if (if_tag.getAttribute("name")

1520

1017

return xmlstring

1521

1018

1522

1019

1523

try:

1524

dbus.OBJECT_MANAGER_IFACE

1525

except AttributeError:

1526

dbus.OBJECT_MANAGER_IFACE = "org.freedesktop.DBus.ObjectManager"

1527

1528

1529

class DBusObjectWithObjectManager(DBusObjectWithAnnotations):

1530

"""A D-Bus object with an ObjectManager.

1531

1532

Classes inheriting from this exposes the standard

1533

GetManagedObjects call and the InterfacesAdded and

1534

InterfacesRemoved signals on the standard

1535

"org.freedesktop.DBus.ObjectManager" interface.

1536

1537

Note: No signals are sent automatically; they must be sent

1538

manually.

1539

"""

1540

@dbus.service.method(dbus.OBJECT_MANAGER_IFACE,

1541

out_signature="a{oa{sa{sv}}}")

1542

def GetManagedObjects(self):

1543

"""This function must be overridden"""

1544

raise NotImplementedError()

1545

1546

@dbus.service.signal(dbus.OBJECT_MANAGER_IFACE,

1547

signature="oa{sa{sv}}")

1548

def InterfacesAdded(self, object_path, interfaces_and_properties):

1549

pass

1550

1551

@dbus.service.signal(dbus.OBJECT_MANAGER_IFACE, signature="oas")

1552

def InterfacesRemoved(self, object_path, interfaces):

1553

pass

1554

1555

@dbus.service.method(dbus.INTROSPECTABLE_IFACE,

1556

out_signature="s",

1557

path_keyword='object_path',

1558

connection_keyword='connection')

1559

def Introspect(self, object_path, connection):

1560

"""Overloading of standard D-Bus method.

1561

1562

Override return argument name of GetManagedObjects to be

1563

"objpath_interfaces_and_properties"

1564

"""

1565

xmlstring = DBusObjectWithAnnotations.Introspect(self,

1566

object_path,

1567

connection)

1568

try:

1569

document = xml.dom.minidom.parseString(xmlstring)

1570

1571

for if_tag in document.getElementsByTagName("interface"):

1572

# Fix argument name for the GetManagedObjects method

1573

if (if_tag.getAttribute("name")

1574

== dbus.OBJECT_MANAGER_IFACE):

1575

for cn in if_tag.getElementsByTagName("method"):

1576

if (cn.getAttribute("name")

1577

== "GetManagedObjects"):

1578

for arg in cn.getElementsByTagName("arg"):

1579

if (arg.getAttribute("direction")

1580

== "out"):

1581

arg.setAttribute(

1582

"name",

1583

"objpath_interfaces"

1584

"_and_properties")

1585

xmlstring = document.toxml("utf-8")

1586

document.unlink()

1587

except (AttributeError, xml.dom.DOMException,

1588

xml.parsers.expat.ExpatError) as error:

1589

logger.error("Failed to override Introspection method",

1590

exc_info=error)

1591

return xmlstring

1592

1593

1594

1020

def datetime_to_dbus(dt, variant_level=0):

1595

1021

"""Convert a UTC datetime.datetime() to a D-Bus type."""

1596

1022

if dt is None:

1597

return dbus.String("", variant_level=variant_level)

1598

return dbus.String(dt.isoformat(), variant_level=variant_level)

1023

return dbus.String("", variant_level = variant_level)

1024

return dbus.String(dt.isoformat(),

1025

variant_level=variant_level)

1599

1026

1600

1027

1601

1028

def alternate_dbus_interfaces(alt_interface_names, deprecate=True):

1603

1030

dbus.service.Object, it will add alternate D-Bus attributes with

1604

1031

interface names according to the "alt_interface_names" mapping.

1605

1032

Usage:

1606

1033

1607

1034

@alternate_dbus_interfaces({"org.example.Interface":

1608

1035

"net.example.AlternateInterface"})

1609

1036

class SampleDBusObject(dbus.service.Object):

1610

1037

@dbus.service.method("org.example.Interface")

1611

1038

def SampleDBusMethod():

1612

1039

pass

1613

1040

1614

1041

The above "SampleDBusMethod" on "SampleDBusObject" will be

1615

1042

reachable via two interfaces: "org.example.Interface" and

1616

1043

"net.example.AlternateInterface", the latter of which will have

1617

1044

its D-Bus annotation "org.freedesktop.DBus.Deprecated" set to

1618

1045

"true", unless "deprecate" is passed with a False value.

1619

1046

1620

1047

This works for methods and signals, and also for D-Bus properties

1621

1048

(from DBusObjectWithProperties) and interfaces (from the

1622

1049

dbus_interface_annotations decorator).

1623

1050

"""

1624

1625

1051

def wrapper(cls):

1626

1052

for orig_interface_name, alt_interface_name in (

1627

alt_interface_names.items()):

1053

alt_interface_names.iteritems()):

1628

1054

attr = {}

1629

1055

interface_names = set()

1630

1056

# Go though all attributes of the class

1632

1058

# Ignore non-D-Bus attributes, and D-Bus attributes

1633

1059

# with the wrong interface name

1634

1060

if (not hasattr(attribute, "_dbus_interface")

1635

or not attribute._dbus_interface.startswith(

1636

orig_interface_name)):

1061

or not attribute._dbus_interface

1062

.startswith(orig_interface_name)):

1637

1063

continue

1638

1064

# Create an alternate D-Bus interface name based on

1639

1065

# the current name

1640

alt_interface = attribute._dbus_interface.replace(

1641

orig_interface_name, alt_interface_name)

1066

alt_interface = (attribute._dbus_interface

1067

.replace(orig_interface_name,

1068

alt_interface_name))

1642

1069

interface_names.add(alt_interface)

1643

1070

# Is this a D-Bus signal?

1644

1071

if getattr(attribute, "_dbus_is_signal", False):

1645

# Extract the original non-method undecorated

1646

# function by black magic

1647

if sys.version_info.major == 2:

1648

nonmethod_func = (dict(

1072

# Extract the original non-method function by

1073

# black magic

1074

nonmethod_func = (dict(

1649

1075

zip(attribute.func_code.co_freevars,

1650

attribute.__closure__))

1651

["func"].cell_contents)

1652

else:

1653

nonmethod_func = (dict(

1654

zip(attribute.__code__.co_freevars,

1655

attribute.__closure__))

1656

["func"].cell_contents)

1076

attribute.__closure__))["func"]

1077

.cell_contents)

1657

1078

# Create a new, but exactly alike, function

1658

1079

# object, and decorate it to be a new D-Bus signal

1659

1080

# with the alternate D-Bus interface name

1660

new_function = copy_function(nonmethod_func)

1661

new_function = (dbus.service.signal(

1662

alt_interface,

1663

attribute._dbus_signature)(new_function))

1081

new_function = (dbus.service.signal

1082

(alt_interface,

1083

attribute._dbus_signature)

1084

(types.FunctionType(

1085

nonmethod_func.func_code,

1086

nonmethod_func.func_globals,

1087

nonmethod_func.func_name,

1088

nonmethod_func.func_defaults,

1089

nonmethod_func.func_closure)))

1664

1090

# Copy annotations, if any

1665

1091

try:

1666

new_function._dbus_annotations = dict(

1667

attribute._dbus_annotations)

1092

new_function._dbus_annotations = (

1093

dict(attribute._dbus_annotations))

1668

1094

except AttributeError:

1669

1095

pass

1670

1671

1096

# Define a creator of a function to call both the

1672

1097

# original and alternate functions, so both the

1673

1098

# original and alternate signals gets sent when

1676

1101

"""This function is a scope container to pass

1677

1102

func1 and func2 to the "call_both" function

1678

1103

outside of its arguments"""

1679

1680

@functools.wraps(func2)

1681

1104

def call_both(*args, **kwargs):

1682

1105

"""This function will emit two D-Bus

1683

1106

signals by calling func1 and func2"""

1684

1107

func1(*args, **kwargs)

1685

1108

func2(*args, **kwargs)

1686

# Make wrapper function look like a D-Bus

1687

# signal

1688

for name, attr in inspect.getmembers(func2):

1689

if name.startswith("_dbus_"):

1690

setattr(call_both, name, attr)

1691

1692

1109

return call_both

1693

1110

# Create the "call_both" function and add it to

1694

1111

# the class

1699

1116

# object. Decorate it to be a new D-Bus method

1700

1117

# with the alternate D-Bus interface name. Add it

1701

1118

# to the class.

1702

attr[attrname] = (

1703

dbus.service.method(

1704

alt_interface,

1705

attribute._dbus_in_signature,

1706

attribute._dbus_out_signature)

1707

(copy_function(attribute)))

1119

attr[attrname] = (dbus.service.method

1120

(alt_interface,

1121

attribute._dbus_in_signature,

1122

attribute._dbus_out_signature)

1123

(types.FunctionType

1124

(attribute.func_code,

1125

attribute.func_globals,

1126

attribute.func_name,

1127

attribute.func_defaults,

1128

attribute.func_closure)))

1708

1129

# Copy annotations, if any

1709

1130

try:

1710

attr[attrname]._dbus_annotations = dict(

1711

attribute._dbus_annotations)

1131

attr[attrname]._dbus_annotations = (

1132

dict(attribute._dbus_annotations))

1712

1133

except AttributeError:

1713

1134

pass

1714

1135

# Is this a D-Bus property?

1717

1138

# object, and decorate it to be a new D-Bus

1718

1139

# property with the alternate D-Bus interface

1719

1140

# name. Add it to the class.

1720

attr[attrname] = (dbus_service_property(

1721

alt_interface, attribute._dbus_signature,

1722

attribute._dbus_access,

1723

attribute._dbus_get_args_options

1724

["byte_arrays"])

1725

(copy_function(attribute)))

1141

attr[attrname] = (dbus_service_property

1142

(alt_interface,

1143

attribute._dbus_signature,

1144

attribute._dbus_access,

1145

attribute

1146

._dbus_get_args_options

1147

["byte_arrays"])

1148

(types.FunctionType

1149

(attribute.func_code,

1150

attribute.func_globals,

1151

attribute.func_name,

1152

attribute.func_defaults,

1153

attribute.func_closure)))

1726

1154

# Copy annotations, if any

1727

1155

try:

1728

attr[attrname]._dbus_annotations = dict(

1729

attribute._dbus_annotations)

1156

attr[attrname]._dbus_annotations = (

1157

dict(attribute._dbus_annotations))

1730

1158

except AttributeError:

1731

1159

pass

1732

1160

# Is this a D-Bus interface?

1735

1163

# object. Decorate it to be a new D-Bus interface

1736

1164

# with the alternate D-Bus interface name. Add it

1737

1165

# to the class.

1738

attr[attrname] = (

1739

dbus_interface_annotations(alt_interface)

1740

(copy_function(attribute)))

1166

attr[attrname] = (dbus_interface_annotations

1167

(alt_interface)

1168

(types.FunctionType

1169

(attribute.func_code,

1170

attribute.func_globals,

1171

attribute.func_name,

1172

attribute.func_defaults,

1173

attribute.func_closure)))

1741

1174

if deprecate:

1742

1175

# Deprecate all alternate interfaces

1743

iname = "_AlternateDBusNames_interface_annotation{}"

1176

iname="_AlternateDBusNames_interface_annotation{0}"

1744

1177

for interface_name in interface_names:

1745

1746

1178

@dbus_interface_annotations(interface_name)

1747

1179

def func(self):

1748

return {"org.freedesktop.DBus.Deprecated":

1749

"true"}

1180

return { "org.freedesktop.DBus.Deprecated":

1181

"true" }

1750

1182

# Find an unused name

1751

1183

for aname in (iname.format(i)

1752

1184

for i in itertools.count()):

1756

1188

if interface_names:

1757

1189

# Replace the class with a new subclass of it with

1758

1190

# methods, signals, etc. as created above.

1759

if sys.version_info.major == 2:

1760

cls = type(b"{}Alternate".format(cls.__name__),

1761

(cls, ), attr)

1762

else:

1763

cls = type("{}Alternate".format(cls.__name__),

1764

(cls, ), attr)

1191

cls = type(b"{0}Alternate".format(cls.__name__),

1192

(cls,), attr)

1765

1193

return cls

1766

1767

1194

return wrapper

1768

1195

1769

1196

1770

1197

@alternate_dbus_interfaces({"se.recompile.Mandos":

1771

"se.bsnet.fukt.Mandos"})

1198

"se.bsnet.fukt.Mandos"})

1772

1199

class ClientDBus(Client, DBusObjectWithProperties):

1773

1200

"""A Client class using D-Bus

1774

1201

1775

1202

Attributes:

1776

1203

dbus_object_path: dbus.ObjectPath

1777

1204

bus: dbus.SystemBus()

1778

1205

"""

1779

1206

1780

1207

runtime_expansions = (Client.runtime_expansions

1781

+ ("dbus_object_path", ))

1782

1783

_interface = "se.recompile.Mandos.Client"

1784

1208

+ ("dbus_object_path",))

1209

1785

1210

# dbus.service.Object doesn't use super(), so we can't either.

1786

1787

def __init__(self, bus=None, *args, **kwargs):

1211

1212

def __init__(self, bus = None, *args, **kwargs):

1788

1213

self.bus = bus

1789

1214

Client.__init__(self, *args, **kwargs)

1790

1215

# Only now, when this client is initialized, can it show up on

1791

1216

# the D-Bus

1792

client_object_name = str(self.name).translate(

1217

client_object_name = unicode(self.name).translate(

1793

1218

{ord("."): ord("_"),

1794

1219

ord("-"): ord("_")})

1795

self.dbus_object_path = dbus.ObjectPath(

1796

"/clients/" + client_object_name)

1220

self.dbus_object_path = (dbus.ObjectPath

1221

("/clients/" + client_object_name))

1797

1222

DBusObjectWithProperties.__init__(self, self.bus,

1798

1223

self.dbus_object_path)

1799

1800

def notifychangeproperty(transform_func, dbus_name,

1801

type_func=lambda x: x,

1802

variant_level=1,

1803

invalidate_only=False,

1804

_interface=_interface):

1224

1225

def notifychangeproperty(transform_func,

1226

dbus_name, type_func=lambda x: x,

1227

variant_level=1):

1805

1228

""" Modify a variable so that it's a property which announces

1806

1229

its changes to DBus.

1807

1230

1808

1231

transform_fun: Function that takes a value and a variant_level

1809

1232

and transforms it to a D-Bus type.

1810

1233

dbus_name: D-Bus name of the variable

1812

1235

to the D-Bus. Default: no transform

1813

1236

variant_level: D-Bus variant level. Default: 1

1814

1237

"""

1815

attrname = "_{}".format(dbus_name)

1816

1238

attrname = "_{0}".format(dbus_name)

1817

1239

def setter(self, value):

1818

1240

if hasattr(self, "dbus_object_path"):

1819

1241

if (not hasattr(self, attrname) or

1820

1242

type_func(getattr(self, attrname, None))

1821

1243

!= type_func(value)):

1822

if invalidate_only:

1823

self.PropertiesChanged(

1824

_interface, dbus.Dictionary(),

1825

dbus.Array((dbus_name, )))

1826

else:

1827

dbus_value = transform_func(

1828

type_func(value),

1829

variant_level=variant_level)

1830

self.PropertyChanged(dbus.String(dbus_name),

1831

dbus_value)

1832

self.PropertiesChanged(

1833

_interface,

1834

dbus.Dictionary({dbus.String(dbus_name):

1835

dbus_value}),

1836

dbus.Array())

1244

dbus_value = transform_func(type_func(value),

1245

variant_level

1246

=variant_level)

1247

self.PropertyChanged(dbus.String(dbus_name),

1248

dbus_value)

1837

1249

setattr(self, attrname, value)

1838

1250

1839

1251

return property(lambda self: getattr(self, attrname), setter)

1840

1252

1841

1253

expires = notifychangeproperty(datetime_to_dbus, "Expires")

1842

1254

approvals_pending = notifychangeproperty(dbus.Boolean,

1843

1255

"ApprovalPending",

1844

type_func=bool)

1256

type_func = bool)

1845

1257

enabled = notifychangeproperty(dbus.Boolean, "Enabled")

1846

1258

last_enabled = notifychangeproperty(datetime_to_dbus,

1847

1259

"LastEnabled")

1848

checker = notifychangeproperty(

1849

dbus.Boolean, "CheckerRunning",

1850

type_func=lambda checker: checker is not None)

1260

checker = notifychangeproperty(dbus.Boolean, "CheckerRunning",

1261

type_func = lambda checker:

1262

checker is not None)

1851

1263

last_checked_ok = notifychangeproperty(datetime_to_dbus,

1852

1264

"LastCheckedOK")

1853

1265

last_checker_status = notifychangeproperty(dbus.Int16,

1856

1268

datetime_to_dbus, "LastApprovalRequest")

1857

1269

approved_by_default = notifychangeproperty(dbus.Boolean,

1858

1270

"ApprovedByDefault")

1859

approval_delay = notifychangeproperty(

1860

dbus.UInt64, "ApprovalDelay",

1861

type_func=lambda td: td.total_seconds() * 1000)

1271

approval_delay = notifychangeproperty(dbus.UInt64,

1272

"ApprovalDelay",

1273

type_func =

1274

timedelta_to_milliseconds)

1862

1275

approval_duration = notifychangeproperty(

1863

1276

dbus.UInt64, "ApprovalDuration",

1864

type_func=lambda td: td.total_seconds() * 1000)

1277

type_func = timedelta_to_milliseconds)

1865

1278

host = notifychangeproperty(dbus.String, "Host")

1866

timeout = notifychangeproperty(

1867

dbus.UInt64, "Timeout",

1868

type_func=lambda td: td.total_seconds() * 1000)

1279

timeout = notifychangeproperty(dbus.UInt64, "Timeout",

1280

type_func =

1281

timedelta_to_milliseconds)

1869

1282

extended_timeout = notifychangeproperty(

1870

1283

dbus.UInt64, "ExtendedTimeout",

1871

type_func=lambda td: td.total_seconds() * 1000)

1872

interval = notifychangeproperty(

1873

dbus.UInt64, "Interval",

1874

type_func=lambda td: td.total_seconds() * 1000)

1284

type_func = timedelta_to_milliseconds)

1285

interval = notifychangeproperty(dbus.UInt64,

1286

"Interval",

1287

type_func =

1288

timedelta_to_milliseconds)

1875

1289

checker_command = notifychangeproperty(dbus.String, "Checker")

1876

secret = notifychangeproperty(dbus.ByteArray, "Secret",

1877

invalidate_only=True)

1878

1290

1879

1291

del notifychangeproperty

1880

1292

1881

1293

def __del__(self, *args, **kwargs):

1882

1294

try:

1883

1295

self.remove_from_connection()

1886

1298

if hasattr(DBusObjectWithProperties, "__del__"):

1887

1299

DBusObjectWithProperties.__del__(self, *args, **kwargs)

1888

1300

Client.__del__(self, *args, **kwargs)

1889

1890

def checker_callback(self, source, condition,

1891

connection, command, *args, **kwargs):

1892

ret = Client.checker_callback(self, source, condition,

1893

connection, command, *args,

1894

**kwargs)

1895

exitstatus = self.last_checker_status

1896

if exitstatus >= 0:

1301

1302

def checker_callback(self, pid, condition, command,

1303

*args, **kwargs):

1304

self.checker_callback_tag = None

1305

self.checker = None

1306

if os.WIFEXITED(condition):

1307

exitstatus = os.WEXITSTATUS(condition)

1897

1308

# Emit D-Bus signal

1898

1309

self.CheckerCompleted(dbus.Int16(exitstatus),

1899

# This is specific to GNU libC

1900

dbus.Int64(exitstatus << 8),

1310

dbus.Int64(condition),

1901

1311

dbus.String(command))

1902

1312

else:

1903

1313

# Emit D-Bus signal

1904

1314

self.CheckerCompleted(dbus.Int16(-1),

1905

dbus.Int64(

1906

# This is specific to GNU libC

1907

(exitstatus << 8)

1908

| self.last_checker_signal),

1315

dbus.Int64(condition),

1909

1316

dbus.String(command))

1910

return ret

1911

1317

1318

return Client.checker_callback(self, pid, condition, command,

1319

*args, **kwargs)

1320

1912

1321

def start_checker(self, *args, **kwargs):

1913

old_checker_pid = getattr(self.checker, "pid", None)

1322

old_checker = self.checker

1323

if self.checker is not None:

1324

old_checker_pid = self.checker.pid

1325

else:

1326

old_checker_pid = None

1914

1327

r = Client.start_checker(self, *args, **kwargs)

1915

1328

# Only if new checker process was started

1916

1329

if (self.checker is not None

1918

1331

# Emit D-Bus signal

1919

1332

self.CheckerStarted(self.current_checker_command)

1920

1333

return r

1921

1334

1922

1335

def _reset_approved(self):

1923

1336

self.approved = None

1924

1337

return False

1925

1338

1926

1339

def approve(self, value=True):

1927

1340

self.approved = value

1928

GLib.timeout_add(int(self.approval_duration.total_seconds()

1929

* 1000), self._reset_approved)

1341

gobject.timeout_add(timedelta_to_milliseconds

1342

(self.approval_duration),

1343

self._reset_approved)

1930

1344

self.send_changedstate()

1931

1932

# D-Bus methods, signals & properties

1933

1934

# Interfaces

1935

1936

# Signals

1937

1345

1346

## D-Bus methods, signals & properties

1347

_interface = "se.recompile.Mandos.Client"

1348

1349

## Interfaces

1350

1351

@dbus_interface_annotations(_interface)

1352

def _foo(self):

1353

return { "org.freedesktop.DBus.Property.EmitsChangedSignal":

1354

"false"}

1355

1356

## Signals

1357

1938

1358

# CheckerCompleted - signal

1939

1359

@dbus.service.signal(_interface, signature="nxs")

1940

1360

def CheckerCompleted(self, exitcode, waitstatus, command):

1941

1361

"D-Bus signal"

1942

1362

pass

1943

1363

1944

1364

# CheckerStarted - signal

1945

1365

@dbus.service.signal(_interface, signature="s")

1946

1366

def CheckerStarted(self, command):

1947

1367

"D-Bus signal"

1948

1368

pass

1949

1369

1950

1370

# PropertyChanged - signal

1951

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})

1952

1371

@dbus.service.signal(_interface, signature="sv")

1953

1372

def PropertyChanged(self, property, value):

1954

1373

"D-Bus signal"

1955

1374

pass

1956

1375

1957

1376

# GotSecret - signal

1958

1377

@dbus.service.signal(_interface)

1959

1378

def GotSecret(self):

1962

1381

server to mandos-client

1963

1382

"""

1964

1383

pass

1965

1384

1966

1385

# Rejected - signal

1967

1386

@dbus.service.signal(_interface, signature="s")

1968

1387

def Rejected(self, reason):

1969

1388

"D-Bus signal"

1970

1389

pass

1971

1390

1972

1391

# NeedApproval - signal

1973

1392

@dbus.service.signal(_interface, signature="tb")

1974

1393

def NeedApproval(self, timeout, default):

1975

1394

"D-Bus signal"

1976

1395

return self.need_approval()

1977

1978

# Methods

1979

1396

1397

## Methods

1398

1980

1399

# Approve - method

1981

1400

@dbus.service.method(_interface, in_signature="b")

1982

1401

def Approve(self, value):

1983

1402

self.approve(value)

1984

1403

1985

1404

# CheckedOK - method

1986

1405

@dbus.service.method(_interface)

1987

1406

def CheckedOK(self):

1988

1407

self.checked_ok()

1989

1408

1990

1409

# Enable - method

1991

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})

1992

1410

@dbus.service.method(_interface)

1993

1411

def Enable(self):

1994

1412

"D-Bus method"

1995

1413

self.enable()

1996

1414

1997

1415

# StartChecker - method

1998

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})

1999

1416

@dbus.service.method(_interface)

2000

1417

def StartChecker(self):

2001

1418

"D-Bus method"

2002

1419

self.start_checker()

2003

1420

2004

1421

# Disable - method

2005

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})

2006

1422

@dbus.service.method(_interface)

2007

1423

def Disable(self):

2008

1424

"D-Bus method"

2009

1425

self.disable()

2010

1426

2011

1427

# StopChecker - method

2012

@dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})

2013

1428

@dbus.service.method(_interface)

2014

1429

def StopChecker(self):

2015

1430

self.stop_checker()

2016

2017

# Properties

2018

1431

1432

## Properties

1433

2019

1434

# ApprovalPending - property

2020

1435

@dbus_service_property(_interface, signature="b", access="read")

2021

1436

def ApprovalPending_dbus_property(self):

2022

1437

return dbus.Boolean(bool(self.approvals_pending))

2023

1438

2024

1439

# ApprovedByDefault - property

2025

@dbus_service_property(_interface,

2026

signature="b",

1440

@dbus_service_property(_interface, signature="b",

2027

1441

access="readwrite")

2028

1442

def ApprovedByDefault_dbus_property(self, value=None):

2029

1443

if value is None: # get

2030

1444

return dbus.Boolean(self.approved_by_default)

2031

1445

self.approved_by_default = bool(value)

2032

1446

2033

1447

# ApprovalDelay - property

2034

@dbus_service_property(_interface,

2035

signature="t",

1448

@dbus_service_property(_interface, signature="t",

2036

1449

access="readwrite")

2037

1450

def ApprovalDelay_dbus_property(self, value=None):

2038

1451

if value is None: # get

2039

return dbus.UInt64(self.approval_delay.total_seconds()

2040

* 1000)

1452

return dbus.UInt64(self.approval_delay_milliseconds())

2041

1453

self.approval_delay = datetime.timedelta(0, 0, 0, value)

2042

1454

2043

1455

# ApprovalDuration - property

2044

@dbus_service_property(_interface,

2045

signature="t",

1456

@dbus_service_property(_interface, signature="t",

2046

1457

access="readwrite")

2047

1458

def ApprovalDuration_dbus_property(self, value=None):

2048

1459

if value is None: # get

2049

return dbus.UInt64(self.approval_duration.total_seconds()

2050

* 1000)

1460

return dbus.UInt64(timedelta_to_milliseconds(

1461

self.approval_duration))

2051

1462

self.approval_duration = datetime.timedelta(0, 0, 0, value)

2052

1463

2053

1464

# Name - property

2054

@dbus_annotations(

2055

{"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})

2056

1465

@dbus_service_property(_interface, signature="s", access="read")

2057

1466

def Name_dbus_property(self):

2058

1467

return dbus.String(self.name)

2059

2060

# KeyID - property

2061

@dbus_annotations(

2062

{"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})

2063

@dbus_service_property(_interface, signature="s", access="read")

2064

def KeyID_dbus_property(self):

2065

return dbus.String(self.key_id)

2066

1468

2067

1469

# Fingerprint - property

2068

@dbus_annotations(

2069

{"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})

2070

1470

@dbus_service_property(_interface, signature="s", access="read")

2071

1471

def Fingerprint_dbus_property(self):

2072

1472

return dbus.String(self.fingerprint)

2073

1473

2074

1474

# Host - property

2075

@dbus_service_property(_interface,

2076

signature="s",

1475

@dbus_service_property(_interface, signature="s",

2077

1476

access="readwrite")

2078

1477

def Host_dbus_property(self, value=None):

2079

1478

if value is None: # get

2080

1479

return dbus.String(self.host)

2081

self.host = str(value)

2082

1480

self.host = unicode(value)

1481

2083

1482

# Created - property

2084

@dbus_annotations(

2085

{"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})

2086

1483

@dbus_service_property(_interface, signature="s", access="read")

2087

1484

def Created_dbus_property(self):

2088

1485

return datetime_to_dbus(self.created)

2089

1486

2090

1487

# LastEnabled - property

2091

1488

@dbus_service_property(_interface, signature="s", access="read")

2092

1489

def LastEnabled_dbus_property(self):

2093

1490

return datetime_to_dbus(self.last_enabled)

2094

1491

2095

1492

# Enabled - property

2096

@dbus_service_property(_interface,

2097

signature="b",

1493

@dbus_service_property(_interface, signature="b",

2098

1494

access="readwrite")

2099

1495

def Enabled_dbus_property(self, value=None):

2100

1496

if value is None: # get

2103

1499

self.enable()

2104

1500

else:

2105

1501

self.disable()

2106

1502

2107

1503

# LastCheckedOK - property

2108

@dbus_service_property(_interface,

2109

signature="s",

1504

@dbus_service_property(_interface, signature="s",

2110

1505

access="readwrite")

2111

1506

def LastCheckedOK_dbus_property(self, value=None):

2112

1507

if value is not None:

2113

1508

self.checked_ok()

2114

1509

return

2115

1510

return datetime_to_dbus(self.last_checked_ok)

2116

1511

2117

1512

# LastCheckerStatus - property

2118

@dbus_service_property(_interface, signature="n", access="read")

1513

@dbus_service_property(_interface, signature="n",

1514

access="read")

2119

1515

def LastCheckerStatus_dbus_property(self):

2120

1516

return dbus.Int16(self.last_checker_status)

2121

1517

2122

1518

# Expires - property

2123

1519

@dbus_service_property(_interface, signature="s", access="read")

2124

1520

def Expires_dbus_property(self):

2125

1521

return datetime_to_dbus(self.expires)

2126

1522

2127

1523

# LastApprovalRequest - property

2128

1524

@dbus_service_property(_interface, signature="s", access="read")

2129

1525

def LastApprovalRequest_dbus_property(self):

2130

1526

return datetime_to_dbus(self.last_approval_request)

2131

1527

2132

1528

# Timeout - property

2133

@dbus_service_property(_interface,

2134

signature="t",

1529

@dbus_service_property(_interface, signature="t",

2135

1530

access="readwrite")

2136

1531

def Timeout_dbus_property(self, value=None):

2137

1532

if value is None: # get

2138

return dbus.UInt64(self.timeout.total_seconds() * 1000)

1533

return dbus.UInt64(self.timeout_milliseconds())

2139

1534

old_timeout = self.timeout

2140

1535

self.timeout = datetime.timedelta(0, 0, 0, value)

2141

1536

# Reschedule disabling

2149

1544

if (getattr(self, "disable_initiator_tag", None)

2150

1545

is None):

2151

1546

return

2152

GLib.source_remove(self.disable_initiator_tag)

2153

self.disable_initiator_tag = GLib.timeout_add(

2154

int((self.expires - now).total_seconds() * 1000),

2155

self.disable)

2156

1547

gobject.source_remove(self.disable_initiator_tag)

1548

self.disable_initiator_tag = (

1549

gobject.timeout_add(

1550

timedelta_to_milliseconds(self.expires - now),

1551

self.disable))

1552

2157

1553

# ExtendedTimeout - property

2158

@dbus_service_property(_interface,

2159

signature="t",

1554

@dbus_service_property(_interface, signature="t",

2160

1555

access="readwrite")

2161

1556

def ExtendedTimeout_dbus_property(self, value=None):

2162

1557

if value is None: # get

2163

return dbus.UInt64(self.extended_timeout.total_seconds()

2164

* 1000)

1558

return dbus.UInt64(self.extended_timeout_milliseconds())

2165

1559

self.extended_timeout = datetime.timedelta(0, 0, 0, value)

2166

1560

2167

1561

# Interval - property

2168

@dbus_service_property(_interface,

2169

signature="t",

1562

@dbus_service_property(_interface, signature="t",

2170

1563

access="readwrite")

2171

1564

def Interval_dbus_property(self, value=None):

2172

1565

if value is None: # get

2173

return dbus.UInt64(self.interval.total_seconds() * 1000)

1566

return dbus.UInt64(self.interval_milliseconds())

2174

1567

self.interval = datetime.timedelta(0, 0, 0, value)

2175

1568

if getattr(self, "checker_initiator_tag", None) is None:

2176

1569

return

2177

1570

if self.enabled:

2178

1571

# Reschedule checker run

2179

GLib.source_remove(self.checker_initiator_tag)

2180

self.checker_initiator_tag = GLib.timeout_add(

2181

value, self.start_checker)

2182

self.start_checker() # Start one now, too

2183

1572

gobject.source_remove(self.checker_initiator_tag)

1573

self.checker_initiator_tag = (gobject.timeout_add

1574

(value, self.start_checker))

1575

self.start_checker() # Start one now, too

1576

2184

1577

# Checker - property

2185

@dbus_service_property(_interface,

2186

signature="s",

1578

@dbus_service_property(_interface, signature="s",

2187

1579

access="readwrite")

2188

1580

def Checker_dbus_property(self, value=None):

2189

1581

if value is None: # get

2190

1582

return dbus.String(self.checker_command)

2191

self.checker_command = str(value)

2192

1583

self.checker_command = unicode(value)

1584

2193

1585

# CheckerRunning - property

2194

@dbus_service_property(_interface,

2195

signature="b",

1586

@dbus_service_property(_interface, signature="b",

2196

1587

access="readwrite")

2197

1588

def CheckerRunning_dbus_property(self, value=None):

2198

1589

if value is None: # get

2201

1592

self.start_checker()

2202

1593

else:

2203

1594

self.stop_checker()

2204

1595

2205

1596

# ObjectPath - property

2206

@dbus_annotations(

2207

{"org.freedesktop.DBus.Property.EmitsChangedSignal": "const",

2208

"org.freedesktop.DBus.Deprecated": "true"})

2209

1597

@dbus_service_property(_interface, signature="o", access="read")

2210

1598

def ObjectPath_dbus_property(self):

2211

return self.dbus_object_path # is already a dbus.ObjectPath

2212

1599

return self.dbus_object_path # is already a dbus.ObjectPath

1600

2213

1601

# Secret = property

2214

@dbus_annotations(

2215

{"org.freedesktop.DBus.Property.EmitsChangedSignal":

2216

"invalidates"})

2217

@dbus_service_property(_interface,

2218

signature="ay",

2219

access="write",

2220

byte_arrays=True)

1602

@dbus_service_property(_interface, signature="ay",

1603

access="write", byte_arrays=True)

2221

1604

def Secret_dbus_property(self, value):

2222

self.secret = bytes(value)

2223

1605

self.secret = str(value)

1606

2224

1607

del _interface

2225

1608

2226

1609

2227

class ProxyClient:

2228

def __init__(self, child_pipe, key_id, fpr, address):

1610

class ProxyClient(object):

1611

def __init__(self, child_pipe, fpr, address):

2229

1612

self._pipe = child_pipe

2230

self._pipe.send(('init', key_id, fpr, address))

1613

self._pipe.send(('init', fpr, address))

2231

1614

if not self._pipe.recv():

2232

raise KeyError(key_id or fpr)

2233

1615

raise KeyError()

1616

2234

1617

def __getattribute__(self, name):

2235

1618

if name == '_pipe':

2236

1619

return super(ProxyClient, self).__getattribute__(name)

2239

1622

if data[0] == 'data':

2240

1623

return data[1]

2241

1624

if data[0] == 'function':

2242

2243

1625

def func(*args, **kwargs):

2244

1626

self._pipe.send(('funcall', name, args, kwargs))

2245

1627

return self._pipe.recv()[1]

2246

2247

1628

return func

2248

1629

2249

1630

def __setattr__(self, name, value):

2250

1631

if name == '_pipe':

2251

1632

return super(ProxyClient, self).__setattr__(name, value)

2254

1635

2255

1636

class ClientHandler(socketserver.BaseRequestHandler, object):

2256

1637

"""A class to handle client connections.

2257

1638

2258

1639

Instantiated once for each connection to handle it.

2259

1640

Note: This will run in its own forked process."""

2260

1641

2261

1642

def handle(self):

2262

1643

with contextlib.closing(self.server.child_pipe) as child_pipe:

2263

1644

logger.info("TCP connection from: %s",

2264

str(self.client_address))

1645

unicode(self.client_address))

2265

1646

logger.debug("Pipe FD: %d",

2266

1647

self.server.child_pipe.fileno())

2267

2268

session = gnutls.ClientSession(self.request)

2269

2270

# priority = ':'.join(("NONE", "+VERS-TLS1.1",

2271

# "+AES-256-CBC", "+SHA1",

2272

# "+COMP-NULL", "+CTYPE-OPENPGP",

2273

# "+DHE-DSS"))

1648

1649

session = (gnutls.connection

1650

.ClientSession(self.request,

1651

gnutls.connection

1652

.X509Credentials()))

1653

1654

# Note: gnutls.connection.X509Credentials is really a

1655

# generic GnuTLS certificate credentials object so long as

1656

# no X.509 keys are added to it. Therefore, we can use it

1657

# here despite using OpenPGP certificates.

1658

1659

#priority = ':'.join(("NONE", "+VERS-TLS1.1",

1660

# "+AES-256-CBC", "+SHA1",

1661

# "+COMP-NULL", "+CTYPE-OPENPGP",

1662

# "+DHE-DSS"))

2274

1663

# Use a fallback default, since this MUST be set.

2275

1664

priority = self.server.gnutls_priority

2276

1665

if priority is None:

2277

1666

priority = "NORMAL"

2278

gnutls.priority_set_direct(session._c_object,

2279

priority.encode("utf-8"),

2280

None)

2281

1667

(gnutls.library.functions

1668

.gnutls_priority_set_direct(session._c_object,

1669

priority, None))

1670

2282

1671

# Start communication using the Mandos protocol

2283

1672

# Get protocol number

2284

1673

line = self.request.makefile().readline()

2285

1674

logger.debug("Protocol version: %r", line)

2286

1675

try:

2287

1676

if int(line.strip().split()[0]) > 1:

2288

raise RuntimeError(line)

1677

raise RuntimeError

2289

1678

except (ValueError, IndexError, RuntimeError) as error:

2290

1679

logger.error("Unknown protocol version: %s", error)

2291

1680

return

2292

1681

2293

1682

# Start GnuTLS connection

2294

1683

try:

2295

1684

session.handshake()

2296

except gnutls.Error as error:

1685

except gnutls.errors.GNUTLSError as error:

2297

1686

logger.warning("Handshake failed: %s", error)

2298

1687

# Do not run session.bye() here: the session is not

2299

1688

# established. Just abandon the request.

2300

1689

return

2301

1690

logger.debug("Handshake succeeded")

2302

1691

2303

1692

approval_required = False

2304

1693

try:

2305

if gnutls.has_rawpk:

2306

fpr = b""

2307

try:

2308

key_id = self.key_id(

2309

self.peer_certificate(session))

2310

except (TypeError, gnutls.Error) as error:

2311

logger.warning("Bad certificate: %s", error)

2312

return

2313

logger.debug("Key ID: %s", key_id)

2314

2315

else:

2316

key_id = b""

2317

try:

2318

fpr = self.fingerprint(

2319

self.peer_certificate(session))

2320

except (TypeError, gnutls.Error) as error:

2321

logger.warning("Bad certificate: %s", error)

2322

return

2323

logger.debug("Fingerprint: %s", fpr)

2324

2325

try:

2326

client = ProxyClient(child_pipe, key_id, fpr,

1694

try:

1695

fpr = self.fingerprint(self.peer_certificate

1696

(session))

1697

except (TypeError,

1698

gnutls.errors.GNUTLSError) as error:

1699

logger.warning("Bad certificate: %s", error)

1700

return

1701

logger.debug("Fingerprint: %s", fpr)

1702

1703

try:

1704

client = ProxyClient(child_pipe, fpr,

2327

1705

self.client_address)

2328

1706

except KeyError:

2329

1707

return

2330

1708

2331

1709

if client.approval_delay:

2332

1710

delay = client.approval_delay

2333

1711

client.approvals_pending += 1

2334

1712

approval_required = True

2335

1713

2336

1714

while True:

2337

1715

if not client.enabled:

2338

1716

logger.info("Client %s is disabled",

2339

client.name)

1717

client.name)

2340

1718

if self.server.use_dbus:

2341

1719

# Emit D-Bus signal

2342

1720

client.Rejected("Disabled")

2343

1721

return

2344

1722

2345

1723

if client.approved or not client.approval_delay:

2346

# We are approved or approval is disabled

1724

#We are approved or approval is disabled

2347

1725

break

2348

1726

elif client.approved is None:

2349

1727

logger.info("Client %s needs approval",

2351

1729

if self.server.use_dbus:

2352

1730

# Emit D-Bus signal

2353

1731

client.NeedApproval(

2354

client.approval_delay.total_seconds()

2355

* 1000, client.approved_by_default)

1732

client.approval_delay_milliseconds(),

1733

client.approved_by_default)

2356

1734

else:

2357

1735

logger.warning("Client %s was not approved",

2358

1736

client.name)

2360

1738

# Emit D-Bus signal

2361

1739

client.Rejected("Denied")

2362

1740

return

2363

2364

# wait until timeout or approved

1741

1742

#wait until timeout or approved

2365

1743

time = datetime.datetime.now()

2366

1744

client.changedstate.acquire()

2367

client.changedstate.wait(delay.total_seconds())

1745

client.changedstate.wait(

1746

float(timedelta_to_milliseconds(delay)

1747

/ 1000))

2368

1748

client.changedstate.release()

2369

1749

time2 = datetime.datetime.now()

2370

1750

if (time2 - time) >= delay:

2380

1760

break

2381

1761

else:

2382

1762

delay -= time2 - time

2383

2384

try:

2385

session.send(client.secret)

2386

except gnutls.Error as error:

2387

logger.warning("gnutls send failed",

2388

exc_info=error)

2389

return

2390

1763

1764

sent_size = 0

1765

while sent_size < len(client.secret):

1766

try:

1767

sent = session.send(client.secret[sent_size:])

1768

except gnutls.errors.GNUTLSError as error:

1769

logger.warning("gnutls send failed",

1770

exc_info=error)

1771

return

1772

logger.debug("Sent: %d, remaining: %d",

1773

sent, len(client.secret)

1774

- (sent_size + sent))

1775

sent_size += sent

1776

2391

1777

logger.info("Sending secret to %s", client.name)

2392

1778

# bump the timeout using extended_timeout

2393

1779

client.bump_timeout(client.extended_timeout)

2394

1780

if self.server.use_dbus:

2395

1781

# Emit D-Bus signal

2396

1782

client.GotSecret()

2397

1783

2398

1784

finally:

2399

1785

if approval_required:

2400

1786

client.approvals_pending -= 1

2401

1787

try:

2402

1788

session.bye()

2403

except gnutls.Error as error:

1789

except gnutls.errors.GNUTLSError as error:

2404

1790

logger.warning("GnuTLS bye failed",

2405

1791

exc_info=error)

2406

1792

2407

1793

@staticmethod

2408

1794

def peer_certificate(session):

2409

"Return the peer's certificate as a bytestring"

2410

try:

2411

cert_type = gnutls.certificate_type_get2(session._c_object,

2412

gnutls.CTYPE_PEERS)

2413

except AttributeError:

2414

cert_type = gnutls.certificate_type_get(session._c_object)

2415

if gnutls.has_rawpk:

2416

valid_cert_types = frozenset((gnutls.CRT_RAWPK,))

2417

else:

2418

valid_cert_types = frozenset((gnutls.CRT_OPENPGP,))

2419

# If not a valid certificate type...

2420

if cert_type not in valid_cert_types:

2421

logger.info("Cert type %r not in %r", cert_type,

2422

valid_cert_types)

2423

# ...return invalid data

2424

return b""

1795

"Return the peer's OpenPGP certificate as a bytestring"

1796

# If not an OpenPGP certificate...

1797

if (gnutls.library.functions

1798

.gnutls_certificate_type_get(session._c_object)

1799

!= gnutls.library.constants.GNUTLS_CRT_OPENPGP):

1800

# ...do the normal thing

1801

return session.peer_certificate

2425

1802

list_size = ctypes.c_uint(1)

2426

cert_list = (gnutls.certificate_get_peers

1803

cert_list = (gnutls.library.functions

1804

.gnutls_certificate_get_peers

2427

1805

(session._c_object, ctypes.byref(list_size)))

2428

1806

if not bool(cert_list) and list_size.value != 0:

2429

raise gnutls.Error("error getting peer certificate")

1807

raise gnutls.errors.GNUTLSError("error getting peer"

1808

" certificate")

2430

1809

if list_size.value == 0:

2431

1810

return None

2432

1811

cert = cert_list[0]

2433

1812

return ctypes.string_at(cert.data, cert.size)

2434

2435

@staticmethod

2436

def key_id(certificate):

2437

"Convert a certificate bytestring to a hexdigit key ID"

2438

# New GnuTLS "datum" with the public key

2439

datum = gnutls.datum_t(

2440

ctypes.cast(ctypes.c_char_p(certificate),

2441

ctypes.POINTER(ctypes.c_ubyte)),

2442

ctypes.c_uint(len(certificate)))

2443

# XXX all these need to be created in the gnutls "module"

2444

# New empty GnuTLS certificate

2445

pubkey = gnutls.pubkey_t()

2446

gnutls.pubkey_init(ctypes.byref(pubkey))

2447

# Import the raw public key into the certificate

2448

gnutls.pubkey_import(pubkey,

2449

ctypes.byref(datum),

2450

gnutls.X509_FMT_DER)

2451

# New buffer for the key ID

2452

buf = ctypes.create_string_buffer(32)

2453

buf_len = ctypes.c_size_t(len(buf))

2454

# Get the key ID from the raw public key into the buffer

2455

gnutls.pubkey_get_key_id(pubkey,

2456

gnutls.KEYID_USE_SHA256,

2457

ctypes.cast(ctypes.byref(buf),

2458

ctypes.POINTER(ctypes.c_ubyte)),

2459

ctypes.byref(buf_len))

2460

# Deinit the certificate

2461

gnutls.pubkey_deinit(pubkey)

2462

2463

# Convert the buffer to a Python bytestring

2464

key_id = ctypes.string_at(buf, buf_len.value)

2465

# Convert the bytestring to hexadecimal notation

2466

hex_key_id = binascii.hexlify(key_id).upper()

2467

return hex_key_id

2468

1813

2469

1814

@staticmethod

2470

1815

def fingerprint(openpgp):

2471

1816

"Convert an OpenPGP bytestring to a hexdigit fingerprint"

2472

1817

# New GnuTLS "datum" with the OpenPGP public key

2473

datum = gnutls.datum_t(

2474

ctypes.cast(ctypes.c_char_p(openpgp),

2475

ctypes.POINTER(ctypes.c_ubyte)),

2476

ctypes.c_uint(len(openpgp)))

1818

datum = (gnutls.library.types

1819

.gnutls_datum_t(ctypes.cast(ctypes.c_char_p(openpgp),

1820

ctypes.POINTER

1821

(ctypes.c_ubyte)),

1822

ctypes.c_uint(len(openpgp))))

2477

1823

# New empty GnuTLS certificate

2478

crt = gnutls.openpgp_crt_t()

2479

gnutls.openpgp_crt_init(ctypes.byref(crt))

1824

crt = gnutls.library.types.gnutls_openpgp_crt_t()

1825

(gnutls.library.functions

1826

.gnutls_openpgp_crt_init(ctypes.byref(crt)))

2480

1827

# Import the OpenPGP public key into the certificate

2481

gnutls.openpgp_crt_import(crt, ctypes.byref(datum),

2482

gnutls.OPENPGP_FMT_RAW)

1828

(gnutls.library.functions

1829

.gnutls_openpgp_crt_import(crt, ctypes.byref(datum),

1830

gnutls.library.constants

1831

.GNUTLS_OPENPGP_FMT_RAW))

2483

1832

# Verify the self signature in the key

2484

1833

crtverify = ctypes.c_uint()

2485

gnutls.openpgp_crt_verify_self(crt, 0,

2486

ctypes.byref(crtverify))

1834

(gnutls.library.functions

1835

.gnutls_openpgp_crt_verify_self(crt, 0,

1836

ctypes.byref(crtverify)))

2487

1837

if crtverify.value != 0:

2488

gnutls.openpgp_crt_deinit(crt)

2489

raise gnutls.CertificateSecurityError(code

2490

=crtverify.value)

1838

gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)

1839

raise (gnutls.errors.CertificateSecurityError

1840

("Verify failed"))

2491

1841

# New buffer for the fingerprint

2492

1842

buf = ctypes.create_string_buffer(20)

2493

1843

buf_len = ctypes.c_size_t()

2494

1844

# Get the fingerprint from the certificate into the buffer

2495

gnutls.openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),

2496

ctypes.byref(buf_len))

1845

(gnutls.library.functions

1846

.gnutls_openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),

1847

ctypes.byref(buf_len)))

2497

1848

# Deinit the certificate

2498

gnutls.openpgp_crt_deinit(crt)

1849

gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)

2499

1850

# Convert the buffer to a Python bytestring

2500

1851

fpr = ctypes.string_at(buf, buf_len.value)

2501

1852

# Convert the bytestring to hexadecimal notation

2503

1854

return hex_fpr

2504

1855

2505

1856

2506

class MultiprocessingMixIn:

1857

class MultiprocessingMixIn(object):

2507

1858

"""Like socketserver.ThreadingMixIn, but with multiprocessing"""

2508

2509

1859

def sub_process_main(self, request, address):

2510

1860

try:

2511

1861

self.finish_request(request, address)

2512

1862

except Exception:

2513

1863

self.handle_error(request, address)

2514

1864

self.close_request(request)

2515

1865

2516

1866

def process_request(self, request, address):

2517

1867

"""Start a new process to process the request."""

2518

proc = multiprocessing.Process(target=self.sub_process_main,

2519

args=(request, address))

1868

proc = multiprocessing.Process(target = self.sub_process_main,

1869

args = (request, address))

2520

1870

proc.start()

2521

1871

return proc

2522

1872

2523

1873

2524

class MultiprocessingMixInWithPipe(MultiprocessingMixIn):

1874

class MultiprocessingMixInWithPipe(MultiprocessingMixIn, object):

2525

1875

""" adds a pipe to the MixIn """

2526

2527

1876

def process_request(self, request, client_address):

2528

1877

"""Overrides and wraps the original process_request().

2529

1878

2530

1879

This function creates a new pipe in self.pipe

2531

1880

"""

2532

1881

parent_pipe, self.child_pipe = multiprocessing.Pipe()

2533

1882

2534

1883

proc = MultiprocessingMixIn.process_request(self, request,

2535

1884

client_address)

2536

1885

self.child_pipe.close()

2537

1886

self.add_pipe(parent_pipe, proc)

2538

1887

2539

1888

def add_pipe(self, parent_pipe, proc):

2540

1889

"""Dummy function; override as necessary"""

2541

raise NotImplementedError()

1890

raise NotImplementedError

2542

1891

2543

1892

2544

1893

class IPv6_TCPServer(MultiprocessingMixInWithPipe,

2545

socketserver.TCPServer):

1894

socketserver.TCPServer, object):

2546

1895

"""IPv6-capable TCP server. Accepts 'None' as address and/or port

2547

1896

2548

1897

Attributes:

2549

1898

enabled: Boolean; whether this server is activated yet

2550

1899

interface: None or a network interface name (string)

2551

1900

use_ipv6: Boolean; to use IPv6 or not

2552

1901

"""

2553

2554

1902

def __init__(self, server_address, RequestHandlerClass,

2555

interface=None,

2556

use_ipv6=True,

2557

socketfd=None):

1903

interface=None, use_ipv6=True, socketfd=None):

2558

1904

"""If socketfd is set, use that file descriptor instead of

2559

1905

creating a new one with socket.socket().

2560

1906

"""

2566

1912

self.socketfd = socketfd

2567

1913

# Save the original socket.socket() function

2568

1914

self.socket_socket = socket.socket

2569

2570

1915

# To implement --socket, we monkey patch socket.socket.

2571

#

1916

#

2572

1917

# (When socketserver.TCPServer is a new-style class, we

2573

1918

# could make self.socket into a property instead of monkey

2574

1919

# patching socket.socket.)

2575

#

1920

#

2576

1921

# Create a one-time-only replacement for socket.socket()

2577

1922

@functools.wraps(socket.socket)

2578

1923

def socket_wrapper(*args, **kwargs):

2590

1935

# socket_wrapper(), if socketfd was set.

2591

1936

socketserver.TCPServer.__init__(self, server_address,

2592

1937

RequestHandlerClass)

2593

1938

2594

1939

def server_bind(self):

2595

1940

"""This overrides the normal server_bind() function

2596

1941

to bind to an interface if one was specified, and also NOT to

2597

1942

bind to an address or port if they were not specified."""

2598

global SO_BINDTODEVICE

2599

1943

if self.interface is not None:

2600

1944

if SO_BINDTODEVICE is None:

2601

# Fall back to a hard-coded value which seems to be

2602

# common enough.

2603

logger.warning("SO_BINDTODEVICE not found, trying 25")

2604

SO_BINDTODEVICE = 25

2605

try:

2606

self.socket.setsockopt(

2607

socket.SOL_SOCKET, SO_BINDTODEVICE,

2608

(self.interface + "\0").encode("utf-8"))

2609

except socket.error as error:

2610

if error.errno == errno.EPERM:

2611

logger.error("No permission to bind to"

2612

" interface %s", self.interface)

2613

elif error.errno == errno.ENOPROTOOPT:

2614

logger.error("SO_BINDTODEVICE not available;"

2615

" cannot bind to interface %s",

2616

self.interface)

2617

elif error.errno == errno.ENODEV:

2618

logger.error("Interface %s does not exist,"

2619

" cannot bind", self.interface)

2620

else:

2621

raise

1945

logger.error("SO_BINDTODEVICE does not exist;"

1946

" cannot bind to interface %s",

1947

self.interface)

1948

else:

1949

try:

1950

self.socket.setsockopt(socket.SOL_SOCKET,

1951

SO_BINDTODEVICE,

1952

str(self.interface + '\0'))

1953

except socket.error as error:

1954

if error.errno == errno.EPERM:

1955

logger.error("No permission to bind to"

1956

" interface %s", self.interface)

1957

elif error.errno == errno.ENOPROTOOPT:

1958

logger.error("SO_BINDTODEVICE not available;"

1959

" cannot bind to interface %s",

1960

self.interface)

1961

elif error.errno == errno.ENODEV:

1962

logger.error("Interface %s does not exist,"

1963

" cannot bind", self.interface)

1964

else:

1965

raise

2622

1966

# Only bind(2) the socket if we really need to.

2623

1967

if self.server_address[0] or self.server_address[1]:

2624

if self.server_address[1]:

2625

self.allow_reuse_address = True

2626

1968

if not self.server_address[0]:

2627

1969

if self.address_family == socket.AF_INET6:

2628

any_address = "::" # in6addr_any

1970

any_address = "::" # in6addr_any

2629

1971

else:

2630

any_address = "0.0.0.0" # INADDR_ANY

1972

any_address = socket.INADDR_ANY

2631

1973

self.server_address = (any_address,

2632

1974

self.server_address[1])

2633

1975

elif not self.server_address[1]:

2634

self.server_address = (self.server_address[0], 0)

1976

self.server_address = (self.server_address[0],

1977

0)

2635

1978

# if self.interface:

2636

1979

# self.server_address = (self.server_address[0],

2637

1980

# 0, # port

2643

1986

2644

1987

class MandosServer(IPv6_TCPServer):

2645

1988

"""Mandos server.

2646

1989

2647

1990

Attributes:

2648

1991

clients: set of Client objects

2649

1992

gnutls_priority GnuTLS priority string

2650

1993

use_dbus: Boolean; to emit D-Bus signals or not

2651

2652

Assumes a GLib.MainLoop event loop.

1994

1995

Assumes a gobject.MainLoop event loop.

2653

1996

"""

2654

2655

1997

def __init__(self, server_address, RequestHandlerClass,

2656

interface=None,

2657

use_ipv6=True,

2658

clients=None,

2659

gnutls_priority=None,

2660

use_dbus=True,

2661

socketfd=None):

1998

interface=None, use_ipv6=True, clients=None,

1999

gnutls_priority=None, use_dbus=True, socketfd=None):

2662

2000

self.enabled = False

2663

2001

self.clients = clients

2664

2002

if self.clients is None:

2667

2005

self.gnutls_priority = gnutls_priority

2668

2006

IPv6_TCPServer.__init__(self, server_address,

2669

2007

RequestHandlerClass,

2670

interface=interface,

2671

use_ipv6=use_ipv6,

2672

socketfd=socketfd)

2673

2008

interface = interface,

2009

use_ipv6 = use_ipv6,

2010

socketfd = socketfd)

2674

2011

def server_activate(self):

2675

2012

if self.enabled:

2676

2013

return socketserver.TCPServer.server_activate(self)

2677

2014

2678

2015

def enable(self):

2679

2016

self.enabled = True

2680

2017

2681

2018

def add_pipe(self, parent_pipe, proc):

2682

2019

# Call "handle_ipc" for both data and EOF events

2683

GLib.io_add_watch(

2684

GLib.IOChannel.unix_new(parent_pipe.fileno()),

2685

GLib.PRIORITY_DEFAULT, GLib.IO_IN | GLib.IO_HUP,

2686

functools.partial(self.handle_ipc,

2687

parent_pipe=parent_pipe,

2688

proc=proc))

2689

2690

def handle_ipc(self, source, condition,

2691

parent_pipe=None,

2692

proc=None,

2693

client_object=None):

2020

gobject.io_add_watch(parent_pipe.fileno(),

2021

gobject.IO_IN | gobject.IO_HUP,

2022

functools.partial(self.handle_ipc,

2023

parent_pipe =

2024

parent_pipe,

2025

proc = proc))

2026

2027

def handle_ipc(self, source, condition, parent_pipe=None,

2028

proc = None, client_object=None):

2694

2029

# error, or the other end of multiprocessing.Pipe has closed

2695

if condition & (GLib.IO_ERR | GLib.IO_HUP):

2030

if condition & (gobject.IO_ERR | gobject.IO_HUP):

2696

2031

# Wait for other process to exit

2697

2032

proc.join()

2698

2033

return False

2699

2034

2700

2035

# Read a request from the child

2701

2036

request = parent_pipe.recv()

2702

2037

command = request[0]

2703

2038

2704

2039

if command == 'init':

2705

key_id = request[1].decode("ascii")

2706

fpr = request[2].decode("ascii")

2707

address = request[3]

2708

2709

for c in self.clients.values():

2710

if key_id == "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855":

2711

continue

2712

if key_id and c.key_id == key_id:

2713

client = c

2714

break

2715

if fpr and c.fingerprint == fpr:

2040

fpr = request[1]

2041

address = request[2]

2042

2043

for c in self.clients.itervalues():

2044

if c.fingerprint == fpr:

2716

2045

client = c

2717

2046

break

2718

2047

else:

2719

logger.info("Client not found for key ID: %s, address"

2720

": %s", key_id or fpr, address)

2048

logger.info("Client not found for fingerprint: %s, ad"

2049

"dress: %s", fpr, address)

2721

2050

if self.use_dbus:

2722

2051

# Emit D-Bus signal

2723

mandos_dbus_service.ClientNotFound(key_id or fpr,

2052

mandos_dbus_service.ClientNotFound(fpr,

2724

2053

address[0])

2725

2054

parent_pipe.send(False)

2726

2055

return False

2727

2728

GLib.io_add_watch(

2729

GLib.IOChannel.unix_new(parent_pipe.fileno()),

2730

GLib.PRIORITY_DEFAULT, GLib.IO_IN | GLib.IO_HUP,

2731

functools.partial(self.handle_ipc,

2732

parent_pipe=parent_pipe,

2733

proc=proc,

2734

client_object=client))

2056

2057

gobject.io_add_watch(parent_pipe.fileno(),

2058

gobject.IO_IN | gobject.IO_HUP,

2059

functools.partial(self.handle_ipc,

2060

parent_pipe =

2061

parent_pipe,

2062

proc = proc,

2063

client_object =

2064

client))

2735

2065

parent_pipe.send(True)

2736

2066

# remove the old hook in favor of the new above hook on

2737

2067

# same fileno

2740

2070

funcname = request[1]

2741

2071

args = request[2]

2742

2072

kwargs = request[3]

2743

2073

2744

2074

parent_pipe.send(('data', getattr(client_object,

2745

2075

funcname)(*args,

2746

**kwargs)))

2747

2076

**kwargs)))

2077

2748

2078

if command == 'getattr':

2749

2079

attrname = request[1]

2750

if isinstance(client_object.__getattribute__(attrname),

2751

collections.Callable):

2752

parent_pipe.send(('function', ))

2080

if callable(client_object.__getattribute__(attrname)):

2081

parent_pipe.send(('function',))

2753

2082

else:

2754

parent_pipe.send((

2755

'data', client_object.__getattribute__(attrname)))

2756

2083

parent_pipe.send(('data', client_object

2084

.__getattribute__(attrname)))

2085

2757

2086

if command == 'setattr':

2758

2087

attrname = request[1]

2759

2088

value = request[2]

2760

2089

setattr(client_object, attrname, value)

2761

2090

2762

2091

return True

2763

2092

2764

2093

2765

2094

def rfc3339_duration_to_delta(duration):

2766

2095

"""Parse an RFC 3339 "duration" and return a datetime.timedelta

2767

2768

>>> rfc3339_duration_to_delta("P7D") == datetime.timedelta(7)

2769

True

2770

>>> rfc3339_duration_to_delta("PT60S") == datetime.timedelta(0, 60)

2771

True

2772

>>> rfc3339_duration_to_delta("PT60M") == datetime.timedelta(0, 3600)

2773

True

2774

>>> rfc3339_duration_to_delta("PT24H") == datetime.timedelta(1)

2775

True

2776

>>> rfc3339_duration_to_delta("P1W") == datetime.timedelta(7)

2777

True

2778

>>> rfc3339_duration_to_delta("PT5M30S") == datetime.timedelta(0, 330)

2779

True

2780

>>> rfc3339_duration_to_delta("P1DT3M20S") == datetime.timedelta(1, 200)

2781

True

2096

2097

>>> rfc3339_duration_to_delta("P7D")

2098

datetime.timedelta(7)

2099

>>> rfc3339_duration_to_delta("PT60S")

2100

datetime.timedelta(0, 60)

2101

>>> rfc3339_duration_to_delta("PT60M")

2102

datetime.timedelta(0, 3600)

2103

>>> rfc3339_duration_to_delta("PT24H")

2104

datetime.timedelta(1)

2105

>>> rfc3339_duration_to_delta("P1W")

2106

datetime.timedelta(7)

2107

>>> rfc3339_duration_to_delta("PT5M30S")

2108

datetime.timedelta(0, 330)

2109

>>> rfc3339_duration_to_delta("P1DT3M20S")

2110

datetime.timedelta(1, 200)

2782

2111

"""

2783

2112

2784

2113

# Parsing an RFC 3339 duration with regular expressions is not

2785

2114

# possible - there would have to be multiple places for the same

2786

2115

# values, like seconds. The current code, while more esoteric, is

2787

2116

# cleaner without depending on a parsing library. If Python had a

2788

2117

# built-in library for parsing we would use it, but we'd like to

2789

2118

# avoid excessive use of external libraries.

2790

2119

2791

2120

# New type for defining tokens, syntax, and semantics all-in-one

2792

Token = collections.namedtuple("Token", (

2793

"regexp", # To match token; if "value" is not None, must have

2794

# a "group" containing digits

2795

"value", # datetime.timedelta or None

2796

"followers")) # Tokens valid after this token

2121

Token = collections.namedtuple("Token",

2122

("regexp", # To match token; if

2123

# "value" is not None,

2124

# must have a "group"

2125

# containing digits

2126

"value", # datetime.timedelta or

2127

# None

2128

"followers")) # Tokens valid after

2129

# this token

2797

2130

# RFC 3339 "duration" tokens, syntax, and semantics; taken from

2798

2131

# the "duration" ABNF definition in RFC 3339, Appendix A.

2799

2132

token_end = Token(re.compile(r"$"), None, frozenset())

2800

2133

token_second = Token(re.compile(r"(\d+)S"),

2801

2134

datetime.timedelta(seconds=1),

2802

frozenset((token_end, )))

2135

frozenset((token_end,)))

2803

2136

token_minute = Token(re.compile(r"(\d+)M"),

2804

2137

datetime.timedelta(minutes=1),

2805

2138

frozenset((token_second, token_end)))

2821

2154

frozenset((token_month, token_end)))

2822

2155

token_week = Token(re.compile(r"(\d+)W"),

2823

2156

datetime.timedelta(weeks=1),

2824

frozenset((token_end, )))

2157

frozenset((token_end,)))

2825

2158

token_duration = Token(re.compile(r"P"), None,

2826

2159

frozenset((token_year, token_month,

2827

2160

token_day, token_time,

2828

token_week)))

2829

# Define starting values:

2830

# Value so far

2831

value = datetime.timedelta()

2161

token_week))),

2162

# Define starting values

2163

value = datetime.timedelta() # Value so far

2832

2164

found_token = None

2833

# Following valid tokens

2834

followers = frozenset((token_duration, ))

2835

# String left to parse

2836

s = duration

2165

followers = frozenset(token_duration,) # Following valid tokens

2166

s = duration # String left to parse

2837

2167

# Loop until end token is found

2838

2168

while found_token is not token_end:

2839

2169

# Search for any currently valid tokens

2855

2185

break

2856

2186

else:

2857

2187

# No currently valid tokens were found

2858

raise ValueError("Invalid RFC 3339 duration: {!r}"

2859

.format(duration))

2188

raise ValueError("Invalid RFC 3339 duration")

2860

2189

# End token found

2861

2190

return value

2862

2191

2863

2192

2864

2193

def string_to_delta(interval):

2865

2194

"""Parse a string and return a datetime.timedelta

2866

2867

>>> string_to_delta('7d') == datetime.timedelta(7)

2868

True

2869

>>> string_to_delta('60s') == datetime.timedelta(0, 60)

2870

True

2871

>>> string_to_delta('60m') == datetime.timedelta(0, 3600)

2872

True

2873

>>> string_to_delta('24h') == datetime.timedelta(1)

2874

True

2875

>>> string_to_delta('1w') == datetime.timedelta(7)

2876

True

2877

>>> string_to_delta('5m 30s') == datetime.timedelta(0, 330)

2878

True

2195

2196

>>> string_to_delta('7d')

2197

datetime.timedelta(7)

2198

>>> string_to_delta('60s')

2199

datetime.timedelta(0, 60)

2200

>>> string_to_delta('60m')

2201

datetime.timedelta(0, 3600)

2202

>>> string_to_delta('24h')

2203

datetime.timedelta(1)

2204

>>> string_to_delta('1w')

2205

datetime.timedelta(7)

2206

>>> string_to_delta('5m 30s')

2207

datetime.timedelta(0, 330)

2879

2208

"""

2880

2209

2881

2210

try:

2882

2211

return rfc3339_duration_to_delta(interval)

2883

2212

except ValueError:

2884

2213

pass

2885

2214

2886

2215

timevalue = datetime.timedelta(0)

2887

2216

for s in interval.split():

2888

2217

try:

2889

suffix = s[-1]

2218

suffix = unicode(s[-1])

2890

2219

value = int(s[:-1])

2891

2220

if suffix == "d":

2892

2221

delta = datetime.timedelta(value)

2899

2228

elif suffix == "w":

2900

2229

delta = datetime.timedelta(0, 0, 0, 0, 0, 0, value)

2901

2230

else:

2902

raise ValueError("Unknown suffix {!r}".format(suffix))

2903

except IndexError as e:

2231

raise ValueError("Unknown suffix {0!r}"

2232

.format(suffix))

2233

except (ValueError, IndexError) as e:

2904

2234

raise ValueError(*(e.args))

2905

2235

timevalue += delta

2906

2236

return timevalue

2907

2237

2908

2238

2909

def daemon(nochdir=False, noclose=False):

2239

def daemon(nochdir = False, noclose = False):

2910

2240

"""See daemon(3). Standard BSD Unix function.

2911

2241

2912

2242

This should really exist as os.daemon, but it doesn't (yet)."""

2913

2243

if os.fork():

2914

2244

sys.exit()

2922

2252

null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)

2923

2253

if not stat.S_ISCHR(os.fstat(null).st_mode):

2924

2254

raise OSError(errno.ENODEV,

2925

"{} not a character device"

2255

"{0} not a character device"

2926

2256

.format(os.devnull))

2927

2257

os.dup2(null, sys.stdin.fileno())

2928

2258

os.dup2(null, sys.stdout.fileno())

2932

2262

2933

2263

2934

2264

def main():

2935

2265

2936

2266

##################################################################

2937

2267

# Parsing of options, both command line and config file

2938

2268

2939

2269

parser = argparse.ArgumentParser()

2940

2270

parser.add_argument("-v", "--version", action="version",

2941

version="%(prog)s {}".format(version),

2271

version = "%(prog)s {0}".format(version),

2942

2272

help="show version number and exit")

2943

2273

parser.add_argument("-i", "--interface", metavar="IF",

2944

2274

help="Bind to interface IF")

2950

2280

help="Run self-test")

2951

2281

parser.add_argument("--debug", action="store_true",

2952

2282

help="Debug mode; run in foreground and log"

2953

" to terminal", default=None)

2283

" to terminal")

2954

2284

parser.add_argument("--debuglevel", metavar="LEVEL",

2955

2285

help="Debug level for stdout output")

2956

2286

parser.add_argument("--priority", help="GnuTLS"

2963

2293

" files")

2964

2294

parser.add_argument("--no-dbus", action="store_false",

2965

2295

dest="use_dbus", help="Do not provide D-Bus"

2966

" system bus interface", default=None)

2296

" system bus interface")

2967

2297

parser.add_argument("--no-ipv6", action="store_false",

2968

dest="use_ipv6", help="Do not use IPv6",

2969

default=None)

2298

dest="use_ipv6", help="Do not use IPv6")

2970

2299

parser.add_argument("--no-restore", action="store_false",

2971

2300

dest="restore", help="Do not restore stored"

2972

" state", default=None)

2301

" state")

2973

2302

parser.add_argument("--socket", type=int,

2974

2303

help="Specify a file descriptor to a network"

2975

2304

" socket to use instead of creating one")

2976

2305

parser.add_argument("--statedir", metavar="DIR",

2977

2306

help="Directory to save/restore state in")

2978

2307

parser.add_argument("--foreground", action="store_true",

2979

help="Run in foreground", default=None)

2980

parser.add_argument("--no-zeroconf", action="store_false",

2981

dest="zeroconf", help="Do not use Zeroconf",

2982

default=None)

2983

2308

help="Run in foreground")

2309

2984

2310

options = parser.parse_args()

2985

2311

2312

if options.check:

2313

import doctest

2314

doctest.testmod()

2315

sys.exit()

2316

2986

2317

# Default values for config file for server-global settings

2987

if gnutls.has_rawpk:

2988

priority = ("SECURE128:!CTYPE-X.509:+CTYPE-RAWPK:!RSA"

2989

":!VERS-ALL:+VERS-TLS1.3:%PROFILE_ULTRA")

2990

else:

2991

priority = ("SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP:!RSA"

2992

":+SIGN-DSA-SHA256")

2993

server_defaults = {"interface": "",

2994

"address": "",

2995

"port": "",

2996

"debug": "False",

2997

"priority": priority,

2998

"servicename": "Mandos",

2999

"use_dbus": "True",

3000

"use_ipv6": "True",

3001

"debuglevel": "",

3002

"restore": "True",

3003

"socket": "",

3004

"statedir": "/var/lib/mandos",

3005

"foreground": "False",

3006

"zeroconf": "True",

3007

}

3008

del priority

3009

2318

server_defaults = { "interface": "",

2319

"address": "",

2320

"port": "",

2321

"debug": "False",

2322

"priority":

2323

"SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP",

2324

"servicename": "Mandos",

2325

"use_dbus": "True",

2326

"use_ipv6": "True",

2327

"debuglevel": "",

2328

"restore": "True",

2329

"socket": "",

2330

"statedir": "/var/lib/mandos",

2331

"foreground": "False",

2332

}

2333

3010

2334

# Parse config file for server-global settings

3011

server_config = configparser.ConfigParser(server_defaults)

2335

server_config = configparser.SafeConfigParser(server_defaults)

3012

2336

del server_defaults

3013

server_config.read(os.path.join(options.configdir, "mandos.conf"))

3014

# Convert the ConfigParser object to a dict

2337

server_config.read(os.path.join(options.configdir,

2338

"mandos.conf"))

2339

# Convert the SafeConfigParser object to a dict

3015

2340

server_settings = server_config.defaults()

3016

2341

# Use the appropriate methods on the non-string config options

3017

for option in ("debug", "use_dbus", "use_ipv6", "restore",

3018

"foreground", "zeroconf"):

2342

for option in ("debug", "use_dbus", "use_ipv6", "foreground"):

3019

2343

server_settings[option] = server_config.getboolean("DEFAULT",

3020

2344

option)

3021

2345

if server_settings["port"]:

3031

2355

server_settings["socket"] = os.dup(server_settings

3032

2356

["socket"])

3033

2357

del server_config

3034

2358

3035

2359

# Override the settings from the config file with command line

3036

2360

# options, if set.

3037

2361

for option in ("interface", "address", "port", "debug",

3038

"priority", "servicename", "configdir", "use_dbus",

3039

"use_ipv6", "debuglevel", "restore", "statedir",

3040

"socket", "foreground", "zeroconf"):

2362

"priority", "servicename", "configdir",

2363

"use_dbus", "use_ipv6", "debuglevel", "restore",

2364

"statedir", "socket", "foreground"):

3041

2365

value = getattr(options, option)

3042

2366

if value is not None:

3043

2367

server_settings[option] = value

3044

2368

del options

3045

2369

# Force all strings to be unicode

3046

2370

for option in server_settings.keys():

3047

if isinstance(server_settings[option], bytes):

3048

server_settings[option] = (server_settings[option]

3049

.decode("utf-8"))

3050

# Force all boolean options to be boolean

3051

for option in ("debug", "use_dbus", "use_ipv6", "restore",

3052

"foreground", "zeroconf"):

3053

server_settings[option] = bool(server_settings[option])

2371

if type(server_settings[option]) is str:

2372

server_settings[option] = unicode(server_settings[option])

3054

2373

# Debug implies foreground

3055

2374

if server_settings["debug"]:

3056

2375

server_settings["foreground"] = True

3057

2376

# Now we have our good server settings in "server_settings"

3058

2377

3059

2378

##################################################################

3060

3061

if (not server_settings["zeroconf"]

3062

and not (server_settings["port"]

3063

or server_settings["socket"] != "")):

3064

parser.error("Needs port or socket to work without Zeroconf")

3065

2379

3066

2380

# For convenience

3067

2381

debug = server_settings["debug"]

3068

2382

debuglevel = server_settings["debuglevel"]

3071

2385

stored_state_path = os.path.join(server_settings["statedir"],

3072

2386

stored_state_file)

3073

2387

foreground = server_settings["foreground"]

3074

zeroconf = server_settings["zeroconf"]

3075

2388

3076

2389

if debug:

3077

2390

initlogger(debug, logging.DEBUG)

3078

2391

else:

3081

2394

else:

3082

2395

level = getattr(logging, debuglevel.upper())

3083

2396

initlogger(debug, level)

3084

2397

3085

2398

if server_settings["servicename"] != "Mandos":

3086

syslogger.setFormatter(

3087

logging.Formatter('Mandos ({}) [%(process)d]:'

3088

' %(levelname)s: %(message)s'.format(

3089

server_settings["servicename"])))

3090

2399

syslogger.setFormatter(logging.Formatter

2400

('Mandos ({0}) [%(process)d]:'

2401

' %(levelname)s: %(message)s'

2402

.format(server_settings

2403

["servicename"])))

2404

3091

2405

# Parse config file with clients

3092

client_config = configparser.ConfigParser(Client.client_defaults)

2406

client_config = configparser.SafeConfigParser(Client

2407

.client_defaults)

3093

2408

client_config.read(os.path.join(server_settings["configdir"],

3094

2409

"clients.conf"))

3095

2410

3096

2411

global mandos_dbus_service

3097

2412

mandos_dbus_service = None

3098

3099

socketfd = None

3100

if server_settings["socket"] != "":

3101

socketfd = server_settings["socket"]

3102

tcp_server = MandosServer(

3103

(server_settings["address"], server_settings["port"]),

3104

ClientHandler,

3105

interface=(server_settings["interface"] or None),

3106

use_ipv6=use_ipv6,

3107

gnutls_priority=server_settings["priority"],

3108

use_dbus=use_dbus,

3109

socketfd=socketfd)

2413

2414

tcp_server = MandosServer((server_settings["address"],

2415

server_settings["port"]),

2416

ClientHandler,

2417

interface=(server_settings["interface"]

2418

or None),

2419

use_ipv6=use_ipv6,

2420

gnutls_priority=

2421

server_settings["priority"],

2422

use_dbus=use_dbus,

2423

socketfd=(server_settings["socket"]

2424

or None))

3110

2425

if not foreground:

3111

pidfilename = "/run/mandos.pid"

3112

if not os.path.isdir("/run/."):

3113

pidfilename = "/var/run/mandos.pid"

2426

pidfilename = "/var/run/mandos.pid"

3114

2427

pidfile = None

3115

2428

try:

3116

pidfile = codecs.open(pidfilename, "w", encoding="utf-8")

2429

pidfile = open(pidfilename, "w")

3117

2430

except IOError as e:

3118

2431

logger.error("Could not open file %r", pidfilename,

3119

2432

exc_info=e)

3120

3121

for name, group in (("_mandos", "_mandos"),

3122

("mandos", "mandos"),

3123

("nobody", "nogroup")):

2433

2434

for name in ("_mandos", "mandos", "nobody"):

3124

2435

try:

3125

2436

uid = pwd.getpwnam(name).pw_uid

3126

gid = pwd.getpwnam(group).pw_gid

2437

gid = pwd.getpwnam(name).pw_gid

3127

2438

break

3128

2439

except KeyError:

3129

2440

continue

3133

2444

try:

3134

2445

os.setgid(gid)

3135

2446

os.setuid(uid)

3136

if debug:

3137

logger.debug("Did setuid/setgid to {}:{}".format(uid,

3138

gid))

3139

2447

except OSError as error:

3140

logger.warning("Failed to setuid/setgid to {}:{}: {}"

3141

.format(uid, gid, os.strerror(error.errno)))

3142

2448

if error.errno != errno.EPERM:

3143

raise

3144

2449

raise error

2450

3145

2451

if debug:

3146

2452

# Enable all possible GnuTLS debugging

3147

2453

3148

2454

# "Use a log level over 10 to enable all debugging options."

3149

2455

# - GnuTLS manual

3150

gnutls.global_set_log_level(11)

3151

3152

@gnutls.log_func

2456

gnutls.library.functions.gnutls_global_set_log_level(11)

2457

2458

@gnutls.library.types.gnutls_log_func

3153

2459

def debug_gnutls(level, string):

3154

2460

logger.debug("GnuTLS: %s", string[:-1])

3155

3156

gnutls.global_set_log_function(debug_gnutls)

3157

2461

2462

(gnutls.library.functions

2463

.gnutls_global_set_log_function(debug_gnutls))

2464

3158

2465

# Redirect stdin so all checkers get /dev/null

3159

2466

null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)

3160

2467

os.dup2(null, sys.stdin.fileno())

3161

2468

if null > 2:

3162

2469

os.close(null)

3163

2470

3164

2471

# Need to fork before connecting to D-Bus

3165

2472

if not foreground:

3166

2473

# Close all input and output, do double fork, etc.

3167

2474

daemon()

3168

3169

if gi.version_info < (3, 10, 2):

3170

# multiprocessing will use threads, so before we use GLib we

3171

# need to inform GLib that threads will be used.

3172

GLib.threads_init()

3173

2475

2476

# multiprocessing will use threads, so before we use gobject we

2477

# need to inform gobject that threads will be used.

2478

gobject.threads_init()

2479

3174

2480

global main_loop

3175

2481

# From the Avahi example code

3176

2482

DBusGMainLoop(set_as_default=True)

3177

main_loop = GLib.MainLoop()

2483

main_loop = gobject.MainLoop()

3178

2484

bus = dbus.SystemBus()

3179

2485

# End of Avahi example code

3180

2486

if use_dbus:

3181

2487

try:

3182

2488

bus_name = dbus.service.BusName("se.recompile.Mandos",

3183

bus,

3184

do_not_queue=True)

3185

old_bus_name = dbus.service.BusName(

3186

"se.bsnet.fukt.Mandos", bus,

3187

do_not_queue=True)

3188

except dbus.exceptions.DBusException as e:

2489

bus, do_not_queue=True)

2490

old_bus_name = (dbus.service.BusName

2491

("se.bsnet.fukt.Mandos", bus,

2492

do_not_queue=True))

2493

except dbus.exceptions.NameExistsException as e:

3189

2494

logger.error("Disabling D-Bus:", exc_info=e)

3190

2495

use_dbus = False

3191

2496

server_settings["use_dbus"] = False

3192

2497

tcp_server.use_dbus = False

3193

if zeroconf:

3194

protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET

3195

service = AvahiServiceToSyslog(

3196

name=server_settings["servicename"],

3197

servicetype="_mandos._tcp",

3198

protocol=protocol,

3199

bus=bus)

3200

if server_settings["interface"]:

3201

service.interface = if_nametoindex(

3202

server_settings["interface"].encode("utf-8"))

3203

2498

protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET

2499

service = AvahiServiceToSyslog(name =

2500

server_settings["servicename"],

2501

servicetype = "_mandos._tcp",

2502

protocol = protocol, bus = bus)

2503

if server_settings["interface"]:

2504

service.interface = (if_nametoindex

2505

(str(server_settings["interface"])))

2506

3204

2507

global multiprocessing_manager

3205

2508

multiprocessing_manager = multiprocessing.Manager()

3206

2509

3207

2510

client_class = Client

3208

2511

if use_dbus:

3209

client_class = functools.partial(ClientDBus, bus=bus)

3210

2512

client_class = functools.partial(ClientDBus, bus = bus)

2513

3211

2514

client_settings = Client.config_parser(client_config)

3212

2515

old_client_settings = {}

3213

2516

clients_data = {}

3214

3215

# This is used to redirect stdout and stderr for checker processes

3216

global wnull

3217

wnull = open(os.devnull, "w") # A writable /dev/null

3218

# Only used if server is running in foreground but not in debug

3219

# mode

3220

if debug or not foreground:

3221

wnull.close()

3222

2517

3223

2518

# Get client data and settings from last running state.

3224

2519

if server_settings["restore"]:

3225

2520

try:

3226

2521

with open(stored_state_path, "rb") as stored_state:

3227

if sys.version_info.major == 2:

3228

clients_data, old_client_settings = pickle.load(

3229

stored_state)

3230

else:

3231

bytes_clients_data, bytes_old_client_settings = (

3232

pickle.load(stored_state, encoding="bytes"))

3233

# Fix bytes to strings

3234

# clients_data

3235

# .keys()

3236

clients_data = {(key.decode("utf-8")

3237

if isinstance(key, bytes)

3238

else key): value

3239

for key, value in

3240

bytes_clients_data.items()}

3241

del bytes_clients_data

3242

for key in clients_data:

3243

value = {(k.decode("utf-8")

3244

if isinstance(k, bytes) else k): v

3245

for k, v in

3246

clients_data[key].items()}

3247

clients_data[key] = value

3248

# .client_structure

3249

value["client_structure"] = [

3250

(s.decode("utf-8")

3251

if isinstance(s, bytes)

3252

else s) for s in

3253

value["client_structure"]]

3254

# .name & .host

3255

for k in ("name", "host"):

3256

if isinstance(value[k], bytes):

3257

value[k] = value[k].decode("utf-8")

3258

if "key_id" not in value:

3259

value["key_id"] = ""

3260

elif "fingerprint" not in value:

3261

value["fingerprint"] = ""

3262

# old_client_settings

3263

# .keys()

3264

old_client_settings = {

3265

(key.decode("utf-8")

3266

if isinstance(key, bytes)

3267

else key): value

3268

for key, value in

3269

bytes_old_client_settings.items()}

3270

del bytes_old_client_settings

3271

# .host

3272

for value in old_client_settings.values():

3273

if isinstance(value["host"], bytes):

3274

value["host"] = (value["host"]

3275

.decode("utf-8"))

2522

clients_data, old_client_settings = (pickle.load

2523

(stored_state))

3276

2524

os.remove(stored_state_path)

3277

2525

except IOError as e:

3278

2526

if e.errno == errno.ENOENT:

3279

logger.warning("Could not load persistent state:"

3280

" {}".format(os.strerror(e.errno)))

2527

logger.warning("Could not load persistent state: {0}"

2528

.format(os.strerror(e.errno)))

3281

2529

else:

3282

2530

logger.critical("Could not load persistent state:",

3283

2531

exc_info=e)

3284

2532

raise

3285

2533

except EOFError as e:

3286

2534

logger.warning("Could not load persistent state: "

3287

"EOFError:",

3288

exc_info=e)

3289

2535

"EOFError:", exc_info=e)

2536

3290

2537

with PGPEngine() as pgp:

3291

for client_name, client in clients_data.items():

3292

# Skip removed clients

3293

if client_name not in client_settings:

3294

continue

3295

2538

for client_name, client in clients_data.iteritems():

3296

2539

# Decide which value to use after restoring saved state.

3297

2540

# We have three different values: Old config file,

3298

2541

# new config file, and saved state.

3303

2546

# For each value in new config, check if it

3304

2547

# differs from the old config value (Except for

3305

2548

# the "secret" attribute)

3306

if (name != "secret"

3307

and (value !=

3308

old_client_settings[client_name][name])):

2549

if (name != "secret" and

2550

value != old_client_settings[client_name]

2551

[name]):

3309

2552

client[name] = value

3310

2553

except KeyError:

3311

2554

pass

3312

2555

3313

2556

# Clients who has passed its expire date can still be

3314

# enabled if its last checker was successful. A Client

2557

# enabled if its last checker was successful. Clients

3315

2558

# whose checker succeeded before we stored its state is

3316

2559

# assumed to have successfully run all checkers during

3317

2560

# downtime.

3319

2562

if datetime.datetime.utcnow() >= client["expires"]:

3320

2563

if not client["last_checked_ok"]:

3321

2564

logger.warning(

3322

"disabling client {} - Client never "

3323

"performed a successful checker".format(

3324

client_name))

2565

"disabling client {0} - Client never "

2566

"performed a successful checker"

2567

.format(client_name))

3325

2568

client["enabled"] = False

3326

2569

elif client["last_checker_status"] != 0:

3327

2570

logger.warning(

3328

"disabling client {} - Client last"

3329

" checker failed with error code"

3330

" {}".format(

3331

client_name,

3332

client["last_checker_status"]))

2571

"disabling client {0} - Client "

2572

"last checker failed with error code {1}"

2573

.format(client_name,

2574

client["last_checker_status"]))

3333

2575

client["enabled"] = False

3334

2576

else:

3335

client["expires"] = (

3336

datetime.datetime.utcnow()

3337

+ client["timeout"])

2577

client["expires"] = (datetime.datetime

2578

.utcnow()

2579

+ client["timeout"])

3338

2580

logger.debug("Last checker succeeded,"

3339

" keeping {} enabled".format(

3340

client_name))

2581

" keeping {0} enabled"

2582

.format(client_name))

3341

2583

try:

3342

client["secret"] = pgp.decrypt(

3343

client["encrypted_secret"],

3344

client_settings[client_name]["secret"])

2584

client["secret"] = (

2585

pgp.decrypt(client["encrypted_secret"],

2586

client_settings[client_name]

2587

["secret"]))

3345

2588

except PGPError:

3346

2589

# If decryption fails, we use secret from new settings

3347

logger.debug("Failed to decrypt {} old secret".format(

3348

client_name))

3349

client["secret"] = (client_settings[client_name]

3350

["secret"])

3351

2590

logger.debug("Failed to decrypt {0} old secret"

2591

.format(client_name))

2592

client["secret"] = (

2593

client_settings[client_name]["secret"])

2594

3352

2595

# Add/remove clients based on new changes made to config

3353

2596

for client_name in (set(old_client_settings)

3354

2597

- set(client_settings)):

3356

2599

for client_name in (set(client_settings)

3357

2600

- set(old_client_settings)):

3358

2601

clients_data[client_name] = client_settings[client_name]

3359

2602

3360

2603

# Create all client objects

3361

for client_name, client in clients_data.items():

2604

for client_name, client in clients_data.iteritems():

3362

2605

tcp_server.clients[client_name] = client_class(

3363

name=client_name,

3364

settings=client,

3365

server_settings=server_settings)

3366

2606

name = client_name, settings = client)

2607

3367

2608

if not tcp_server.clients:

3368

2609

logger.warning("No clients defined")

3369

2610

3370

2611

if not foreground:

3371

2612

if pidfile is not None:

3372

pid = os.getpid()

3373

2613

try:

3374

2614

with pidfile:

3375

print(pid, file=pidfile)

2615

pid = os.getpid()

2616

pidfile.write(str(pid) + "\n".encode("utf-8"))

3376

2617

except IOError:

3377

2618

logger.error("Could not write to file %r with PID %d",

3378

2619

pidfilename, pid)

3379

2620

del pidfile

3380

2621

del pidfilename

3381

3382

for termsig in (signal.SIGHUP, signal.SIGTERM):

3383

GLib.unix_signal_add(GLib.PRIORITY_HIGH, termsig,

3384

lambda: main_loop.quit() and False)

3385

2622

2623

signal.signal(signal.SIGHUP, lambda signum, frame: sys.exit())

2624

signal.signal(signal.SIGTERM, lambda signum, frame: sys.exit())

2625

3386

2626

if use_dbus:

3387

3388

@alternate_dbus_interfaces(

3389

{"se.recompile.Mandos": "se.bsnet.fukt.Mandos"})

3390

class MandosDBusService(DBusObjectWithObjectManager):

2627

@alternate_dbus_interfaces({"se.recompile.Mandos":

2628

"se.bsnet.fukt.Mandos"})

2629

class MandosDBusService(DBusObjectWithProperties):

3391

2630

"""A D-Bus proxy object"""

3392

3393

2631

def __init__(self):

3394

2632

dbus.service.Object.__init__(self, bus, "/")

3395

3396

2633

_interface = "se.recompile.Mandos"

3397

2634

2635

@dbus_interface_annotations(_interface)

2636

def _foo(self):

2637

return { "org.freedesktop.DBus.Property"

2638

".EmitsChangedSignal":

2639

"false"}

2640

3398

2641

@dbus.service.signal(_interface, signature="o")

3399

2642

def ClientAdded(self, objpath):

3400

2643

"D-Bus signal"

3401

2644

pass

3402

2645

3403

2646

@dbus.service.signal(_interface, signature="ss")

3404

def ClientNotFound(self, key_id, address):

2647

def ClientNotFound(self, fingerprint, address):

3405

2648

"D-Bus signal"

3406

2649

pass

3407

3408

@dbus_annotations({"org.freedesktop.DBus.Deprecated":

3409

"true"})

2650

3410

2651

@dbus.service.signal(_interface, signature="os")

3411

2652

def ClientRemoved(self, objpath, name):

3412

2653

"D-Bus signal"

3413

2654

pass

3414

3415

@dbus_annotations({"org.freedesktop.DBus.Deprecated":

3416

"true"})

2655

3417

2656

@dbus.service.method(_interface, out_signature="ao")

3418

2657

def GetAllClients(self):

3419

2658

"D-Bus method"

3420

return dbus.Array(c.dbus_object_path for c in

3421

tcp_server.clients.values())

3422

3423

@dbus_annotations({"org.freedesktop.DBus.Deprecated":

3424

"true"})

2659

return dbus.Array(c.dbus_object_path

2660

for c in

2661

tcp_server.clients.itervalues())

2662

3425

2663

@dbus.service.method(_interface,

3426

2664

out_signature="a{oa{sv}}")

3427

2665

def GetAllClientsWithProperties(self):

3428

2666

"D-Bus method"

3429

2667

return dbus.Dictionary(

3430

{c.dbus_object_path: c.GetAll(

3431

"se.recompile.Mandos.Client")

3432

for c in tcp_server.clients.values()},

2668

((c.dbus_object_path, c.GetAll(""))

2669

for c in tcp_server.clients.itervalues()),

3433

2670

signature="oa{sv}")

3434

2671

3435

2672

@dbus.service.method(_interface, in_signature="o")

3436

2673

def RemoveClient(self, object_path):

3437

2674

"D-Bus method"

3438

for c in tcp_server.clients.values():

2675

for c in tcp_server.clients.itervalues():

3439

2676

if c.dbus_object_path == object_path:

3440

2677

del tcp_server.clients[c.name]

3441

2678

c.remove_from_connection()

3442

# Don't signal the disabling

2679

# Don't signal anything except ClientRemoved

3443

2680

c.disable(quiet=True)

3444

# Emit D-Bus signal for removal

3445

self.client_removed_signal(c)

2681

# Emit D-Bus signal

2682

self.ClientRemoved(object_path, c.name)

3446

2683

return

3447

2684

raise KeyError(object_path)

3448

2685

3449

2686

del _interface

3450

3451

@dbus.service.method(dbus.OBJECT_MANAGER_IFACE,

3452

out_signature="a{oa{sa{sv}}}")

3453

def GetManagedObjects(self):

3454

"""D-Bus method"""

3455

return dbus.Dictionary(

3456

{client.dbus_object_path:

3457

dbus.Dictionary(

3458

{interface: client.GetAll(interface)

3459

for interface in

3460

client._get_all_interface_names()})

3461

for client in tcp_server.clients.values()})

3462

3463

def client_added_signal(self, client):

3464

"""Send the new standard signal and the old signal"""

3465

if use_dbus:

3466

# New standard signal

3467

self.InterfacesAdded(

3468

client.dbus_object_path,

3469

dbus.Dictionary(

3470

{interface: client.GetAll(interface)

3471

for interface in

3472

client._get_all_interface_names()}))

3473

# Old signal

3474

self.ClientAdded(client.dbus_object_path)

3475

3476

def client_removed_signal(self, client):

3477

"""Send the new standard signal and the old signal"""

3478

if use_dbus:

3479

# New standard signal

3480

self.InterfacesRemoved(

3481

client.dbus_object_path,

3482

client._get_all_interface_names())

3483

# Old signal

3484

self.ClientRemoved(client.dbus_object_path,

3485

client.name)

3486

2687

3487

2688

mandos_dbus_service = MandosDBusService()

3488

3489

# Save modules to variables to exempt the modules from being

3490

# unloaded before the function registered with atexit() is run.

3491

mp = multiprocessing

3492

wn = wnull

3493

2689

3494

2690

def cleanup():

3495

2691

"Cleanup function; run on exit"

3496

if zeroconf:

3497

service.cleanup()

3498

3499

mp.active_children()

3500

wn.close()

2692

service.cleanup()

2693

2694

multiprocessing.active_children()

3501

2695

if not (tcp_server.clients or client_settings):

3502

2696

return

3503

2697

3504

2698

# Store client before exiting. Secrets are encrypted with key

3505

2699

# based on what config file has. If config file is

3506

2700

# removed/edited, old secret will thus be unrecovable.

3507

2701

clients = {}

3508

2702

with PGPEngine() as pgp:

3509

for client in tcp_server.clients.values():

2703

for client in tcp_server.clients.itervalues():

3510

2704

key = client_settings[client.name]["secret"]

3511

2705

client.encrypted_secret = pgp.encrypt(client.secret,

3512

2706

key)

3513

2707

client_dict = {}

3514

2708

3515

2709

# A list of attributes that can not be pickled

3516

2710

# + secret.

3517

exclude = {"bus", "changedstate", "secret",

3518

"checker", "server_settings"}

3519

for name, typ in inspect.getmembers(dbus.service

3520

.Object):

2711

exclude = set(("bus", "changedstate", "secret",

2712

"checker"))

2713

for name, typ in (inspect.getmembers

2714

(dbus.service.Object)):

3521

2715

exclude.add(name)

3522

2716

3523

2717

client_dict["encrypted_secret"] = (client

3524

2718

.encrypted_secret)

3525

2719

for attr in client.client_structure:

3526

2720

if attr not in exclude:

3527

2721

client_dict[attr] = getattr(client, attr)

3528

2722

3529

2723

clients[client.name] = client_dict

3530

2724

del client_settings[client.name]["secret"]

3531

2725

3532

2726

try:

3533

with tempfile.NamedTemporaryFile(

3534

mode='wb',

3535

suffix=".pickle",

3536

prefix='clients-',

3537

dir=os.path.dirname(stored_state_path),

3538

delete=False) as stored_state:

3539

pickle.dump((clients, client_settings), stored_state,

3540

protocol=2)

3541

tempname = stored_state.name

2727

with (tempfile.NamedTemporaryFile

2728

(mode='wb', suffix=".pickle", prefix='clients-',

2729

dir=os.path.dirname(stored_state_path),

2730

delete=False)) as stored_state:

2731

pickle.dump((clients, client_settings), stored_state)

2732

tempname=stored_state.name

3542

2733

os.rename(tempname, stored_state_path)

3543

2734

except (IOError, OSError) as e:

3544

2735

if not debug:

3547

2738

except NameError:

3548

2739

pass

3549

2740

if e.errno in (errno.ENOENT, errno.EACCES, errno.EEXIST):

3550

logger.warning("Could not save persistent state: {}"

2741

logger.warning("Could not save persistent state: {0}"

3551

2742

.format(os.strerror(e.errno)))

3552

2743

else:

3553

2744

logger.warning("Could not save persistent state:",

3554

2745

exc_info=e)

3555

raise

3556

2746

raise e

2747

3557

2748

# Delete all clients, and settings from config

3558

2749

while tcp_server.clients:

3559

2750

name, client = tcp_server.clients.popitem()

3560

2751

if use_dbus:

3561

2752

client.remove_from_connection()

3562

# Don't signal the disabling

2753

# Don't signal anything except ClientRemoved

3563

2754

client.disable(quiet=True)

3564

# Emit D-Bus signal for removal

3565

2755

if use_dbus:

3566

mandos_dbus_service.client_removed_signal(client)

2756

# Emit D-Bus signal

2757

mandos_dbus_service.ClientRemoved(client

2758

.dbus_object_path,

2759

client.name)

3567

2760

client_settings.clear()

3568

2761

3569

2762

atexit.register(cleanup)

3570

3571

for client in tcp_server.clients.values():

2763

2764

for client in tcp_server.clients.itervalues():

3572

2765

if use_dbus:

3573

# Emit D-Bus signal for adding

3574

mandos_dbus_service.client_added_signal(client)

2766

# Emit D-Bus signal

2767

mandos_dbus_service.ClientAdded(client.dbus_object_path)

3575

2768

# Need to initiate checking of clients

3576

2769

if client.enabled:

3577

2770

client.init_checker()

3578

2771

3579

2772

tcp_server.enable()

3580

2773

tcp_server.server_activate()

3581

2774

3582

2775

# Find out what port we got

3583

if zeroconf:

3584

service.port = tcp_server.socket.getsockname()[1]

2776

service.port = tcp_server.socket.getsockname()[1]

3585

2777

if use_ipv6:

3586

2778

logger.info("Now listening on address %r, port %d,"

3587

2779

" flowinfo %d, scope_id %d",

3589

2781

else: # IPv4

3590

2782

logger.info("Now listening on address %r, port %d",

3591

2783

*tcp_server.socket.getsockname())

3592

3593

# service.interface = tcp_server.socket.getsockname()[3]

3594

2784

2785

#service.interface = tcp_server.socket.getsockname()[3]

2786

3595

2787

try:

3596

if zeroconf:

3597

# From the Avahi example code

3598

try:

3599

service.activate()

3600

except dbus.exceptions.DBusException as error:

3601

logger.critical("D-Bus Exception", exc_info=error)

3602

cleanup()

3603

sys.exit(1)

3604

# End of Avahi example code

3605

3606

GLib.io_add_watch(

3607

GLib.IOChannel.unix_new(tcp_server.fileno()),

3608

GLib.PRIORITY_DEFAULT, GLib.IO_IN,

3609

lambda *args, **kwargs: (tcp_server.handle_request

3610

(*args[2:], **kwargs) or True))

3611

2788

# From the Avahi example code

2789

try:

2790

service.activate()

2791

except dbus.exceptions.DBusException as error:

2792

logger.critical("D-Bus Exception", exc_info=error)

2793

cleanup()

2794

sys.exit(1)

2795

# End of Avahi example code

2796

2797

gobject.io_add_watch(tcp_server.fileno(), gobject.IO_IN,

2798

lambda *args, **kwargs:

2799

(tcp_server.handle_request

2800

(*args[2:], **kwargs) or True))

2801

3612

2802

logger.debug("Starting main loop")

3613

2803

main_loop.run()

3614

2804

except AvahiError as error:

3623

2813

# Must run before the D-Bus bus name gets deregistered

3624

2814

cleanup()

3625

2815

3626

3627

def should_only_run_tests():

3628

parser = argparse.ArgumentParser(add_help=False)

3629

parser.add_argument("--check", action='store_true')

3630

args, unknown_args = parser.parse_known_args()

3631

run_tests = args.check

3632

if run_tests:

3633

# Remove --check argument from sys.argv

3634

sys.argv[1:] = unknown_args

3635

return run_tests

3636

3637

# Add all tests from doctest strings

3638

def load_tests(loader, tests, none):

3639

import doctest

3640

tests.addTests(doctest.DocTestSuite())

3641

return tests

3642

3643

2816

if __name__ == '__main__':

3644

try:

3645

if should_only_run_tests():

3646

# Call using ./mandos --check [--verbose]

3647

unittest.main()

3648

else:

3649

main()

3650

finally:

3651

logging.shutdown()

2817

main()