/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/gpg.py

  • Committer: Robert Collins
  • Date: 2010-05-06 11:08:10 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506110810-h3j07fh5gmw54s25
Cleaner matcher matching revised unlocking protocol.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/gpg.py
1
 
# Copyright (C) 2005, 2006, 2007, 2009, 2011, 2012, 2013, 2016 Canonical Ltd
 
1
# Copyright (C) 2005 Canonical Ltd
2
2
#   Authors: Robert Collins <robert.collins@canonical.com>
3
3
#
4
4
# This program is free software; you can redistribute it and/or modify
17
17
 
18
18
"""GPG signing and checking logic."""
19
19
 
20
 
from __future__ import absolute_import
21
 
 
22
20
import os
 
21
import sys
23
22
 
24
 
from breezy.lazy_import import lazy_import
 
23
from bzrlib.lazy_import import lazy_import
25
24
lazy_import(globals(), """
26
 
from breezy import (
27
 
    config,
 
25
import errno
 
26
import subprocess
 
27
 
 
28
from bzrlib import (
 
29
    errors,
28
30
    trace,
29
31
    ui,
30
32
    )
31
 
from breezy.i18n import (
32
 
    gettext,
33
 
    ngettext,
34
 
    )
35
33
""")
36
34
 
37
 
from . import (
38
 
    errors,
39
 
    )
40
 
from .sixish import (
41
 
    text_type,
42
 
    )
43
 
 
44
 
# verification results
45
 
SIGNATURE_VALID = 0
46
 
SIGNATURE_KEY_MISSING = 1
47
 
SIGNATURE_NOT_VALID = 2
48
 
SIGNATURE_NOT_SIGNED = 3
49
 
SIGNATURE_EXPIRED = 4
50
 
 
51
 
MODE_NORMAL = 0
52
 
MODE_DETACH = 1
53
 
MODE_CLEAR = 2
54
 
 
55
 
 
56
 
class GpgNotInstalled(errors.DependencyNotPresent):
57
 
 
58
 
    _fmt = ('python-gpg is not installed, it is needed to create or '
59
 
            'verify signatures. %(error)s')
60
 
 
61
 
    def __init__(self, error):
62
 
        errors.DependencyNotPresent.__init__(self, 'gpg', error)
63
 
 
64
 
 
65
 
class SigningFailed(errors.BzrError):
66
 
 
67
 
    _fmt = 'Failed to GPG sign data: "%(error)s"'
68
 
 
69
 
    def __init__(self, error):
70
 
        errors.BzrError.__init__(self, error=error)
71
 
 
72
 
 
73
 
class SignatureVerificationFailed(errors.BzrError):
74
 
 
75
 
    _fmt = 'Failed to verify GPG signature data with error "%(error)s"'
76
 
 
77
 
    def __init__(self, error):
78
 
        errors.BzrError.__init__(self, error=error)
79
 
 
80
 
 
81
 
def bulk_verify_signatures(repository, revids, strategy,
82
 
                           process_events_callback=None):
83
 
    """Do verifications on a set of revisions
84
 
 
85
 
    :param repository: repository object
86
 
    :param revids: list of revision ids to verify
87
 
    :param strategy: GPG strategy to use
88
 
    :param process_events_callback: method to call for GUI frontends that
89
 
        want to keep their UI refreshed
90
 
 
91
 
    :return: count dictionary of results of each type,
92
 
             result list for each revision,
93
 
             boolean True if all results are verified successfully
94
 
    """
95
 
    count = {SIGNATURE_VALID: 0,
96
 
             SIGNATURE_KEY_MISSING: 0,
97
 
             SIGNATURE_NOT_VALID: 0,
98
 
             SIGNATURE_NOT_SIGNED: 0,
99
 
             SIGNATURE_EXPIRED: 0}
100
 
    result = []
101
 
    all_verifiable = True
102
 
    total = len(revids)
103
 
    with ui.ui_factory.nested_progress_bar() as pb:
104
 
        for i, (rev_id, verification_result, uid) in enumerate(
105
 
                repository.verify_revision_signatures(
106
 
                    revids, strategy)):
107
 
            pb.update("verifying signatures", i, total)
108
 
            result.append([rev_id, verification_result, uid])
109
 
            count[verification_result] += 1
110
 
            if verification_result != SIGNATURE_VALID:
111
 
                all_verifiable = False
112
 
            if process_events_callback is not None:
113
 
                process_events_callback()
114
 
    return (count, result, all_verifiable)
115
 
 
116
35
 
117
36
class DisabledGPGStrategy(object):
118
37
    """A GPG Strategy that makes everything fail."""
119
38
 
120
 
    @staticmethod
121
 
    def verify_signatures_available():
122
 
        return True
123
 
 
124
39
    def __init__(self, ignored):
125
40
        """Real strategies take a configuration."""
126
41
 
127
 
    def sign(self, content, mode):
128
 
        raise SigningFailed('Signing is disabled.')
129
 
 
130
 
    def verify(self, signed_data, signature=None):
131
 
        raise SignatureVerificationFailed('Signature verification is \
132
 
disabled.')
133
 
 
134
 
    def set_acceptable_keys(self, command_line_input):
135
 
        pass
 
42
    def sign(self, content):
 
43
        raise errors.SigningFailed('Signing is disabled.')
136
44
 
137
45
 
138
46
class LoopbackGPGStrategy(object):
139
 
    """A GPG Strategy that acts like 'cat' - data is just passed through.
140
 
    Used in tests.
141
 
    """
142
 
 
143
 
    @staticmethod
144
 
    def verify_signatures_available():
145
 
        return True
 
47
    """A GPG Strategy that acts like 'cat' - data is just passed through."""
146
48
 
147
49
    def __init__(self, ignored):
148
50
        """Real strategies take a configuration."""
149
51
 
150
 
    def sign(self, content, mode):
151
 
        return (b"-----BEGIN PSEUDO-SIGNED CONTENT-----\n" + content
152
 
                + b"-----END PSEUDO-SIGNED CONTENT-----\n")
153
 
 
154
 
    def verify(self, signed_data, signature=None):
155
 
        plain_text = signed_data.replace(
156
 
            b"-----BEGIN PSEUDO-SIGNED CONTENT-----\n", b"")
157
 
        plain_text = plain_text.replace(
158
 
            b"-----END PSEUDO-SIGNED CONTENT-----\n", b"")
159
 
        return SIGNATURE_VALID, None, plain_text
160
 
 
161
 
    def set_acceptable_keys(self, command_line_input):
162
 
        if command_line_input is not None:
163
 
            patterns = command_line_input.split(",")
164
 
            self.acceptable_keys = []
165
 
            for pattern in patterns:
166
 
                if pattern == "unknown":
167
 
                    pass
168
 
                else:
169
 
                    self.acceptable_keys.append(pattern)
 
52
    def sign(self, content):
 
53
        return ("-----BEGIN PSEUDO-SIGNED CONTENT-----\n" + content +
 
54
                "-----END PSEUDO-SIGNED CONTENT-----\n")
170
55
 
171
56
 
172
57
def _set_gpg_tty():
177
62
    else:
178
63
        # This is not quite worthy of a warning, because some people
179
64
        # don't need GPG_TTY to be set. But it is worthy of a big mark
180
 
        # in ~/.brz.log, so that people can debug it if it happens to them
 
65
        # in ~/.bzr.log, so that people can debug it if it happens to them
181
66
        trace.mutter('** Env var TTY empty, cannot set GPG_TTY.'
182
67
                     '  Is TTY exported?')
183
68
 
185
70
class GPGStrategy(object):
186
71
    """GPG Signing and checking facilities."""
187
72
 
188
 
    acceptable_keys = None
189
 
 
190
 
    def __init__(self, config_stack):
191
 
        self._config_stack = config_stack
 
73
    def _command_line(self):
 
74
        return [self._config.gpg_signing_command(), '--clearsign']
 
75
 
 
76
    def __init__(self, config):
 
77
        self._config = config
 
78
 
 
79
    def sign(self, content):
 
80
        if isinstance(content, unicode):
 
81
            raise errors.BzrBadParameterUnicode('content')
 
82
        ui.ui_factory.clear_term()
 
83
 
 
84
        preexec_fn = _set_gpg_tty
 
85
        if sys.platform == 'win32':
 
86
            # Win32 doesn't support preexec_fn, but wouldn't support TTY anyway.
 
87
            preexec_fn = None
192
88
        try:
193
 
            import gpg
194
 
            self.context = gpg.Context()
195
 
            self.context.armor = True
196
 
            self.context.signers = self._get_signing_keys()
197
 
        except ImportError:
198
 
            pass  # can't use verify()
199
 
 
200
 
    def _get_signing_keys(self):
201
 
        import gpg
202
 
        keyname = self._config_stack.get('gpg_signing_key')
203
 
        if keyname:
 
89
            process = subprocess.Popen(self._command_line(),
 
90
                                       stdin=subprocess.PIPE,
 
91
                                       stdout=subprocess.PIPE,
 
92
                                       preexec_fn=preexec_fn)
204
93
            try:
205
 
                return [self.context.get_key(keyname)]
206
 
            except gpg.errors.KeyNotFound:
207
 
                pass
208
 
 
209
 
        if keyname is None or keyname == 'default':
210
 
            # 'default' or not setting gpg_signing_key at all means we should
211
 
            # use the user email address
212
 
            keyname = config.extract_email_address(
213
 
                self._config_stack.get('email'))
214
 
        possible_keys = self.context.keylist(keyname, secret=True)
215
 
        try:
216
 
            return [next(possible_keys)]
217
 
        except StopIteration:
218
 
            return []
219
 
 
220
 
    @staticmethod
221
 
    def verify_signatures_available():
222
 
        """
223
 
        check if this strategy can verify signatures
224
 
 
225
 
        :return: boolean if this strategy can verify signatures
226
 
        """
227
 
        try:
228
 
            import gpg  # noqa: F401
229
 
            return True
230
 
        except ImportError:
231
 
            return False
232
 
 
233
 
    def sign(self, content, mode):
234
 
        try:
235
 
            import gpg
236
 
        except ImportError as error:
237
 
            raise GpgNotInstalled(
238
 
                'Set create_signatures=no to disable creating signatures.')
239
 
 
240
 
        if isinstance(content, text_type):
241
 
            raise errors.BzrBadParameterUnicode('content')
242
 
 
243
 
        plain_text = gpg.Data(content)
244
 
        try:
245
 
            output, result = self.context.sign(
246
 
                plain_text, mode={
247
 
                    MODE_DETACH: gpg.constants.sig.mode.DETACH,
248
 
                    MODE_CLEAR: gpg.constants.sig.mode.CLEAR,
249
 
                    MODE_NORMAL: gpg.constants.sig.mode.NORMAL,
250
 
                    }[mode])
251
 
        except gpg.errors.GPGMEError as error:
252
 
            raise SigningFailed(str(error))
253
 
 
254
 
        return output
255
 
 
256
 
    def verify(self, signed_data, signature=None):
257
 
        """Check content has a valid signature.
258
 
 
259
 
        :param signed_data; Signed data
260
 
        :param signature: optional signature (if detached)
261
 
 
262
 
        :return: SIGNATURE_VALID or a failed SIGNATURE_ value, key uid if valid, plain text
263
 
        """
264
 
        try:
265
 
            import gpg
266
 
        except ImportError as error:
267
 
            raise GpgNotInstalled(
268
 
                'Set check_signatures=ignore to disable verifying signatures.')
269
 
 
270
 
        signed_data = gpg.Data(signed_data)
271
 
        if signature:
272
 
            signature = gpg.Data(signature)
273
 
        try:
274
 
            plain_output, result = self.context.verify(signed_data, signature)
275
 
        except gpg.errors.BadSignatures as error:
276
 
            fingerprint = error.result.signatures[0].fpr
277
 
            if error.result.signatures[0].summary & gpg.constants.SIGSUM_KEY_EXPIRED:
278
 
                expires = self.context.get_key(
279
 
                    error.result.signatures[0].fpr).subkeys[0].expires
280
 
                if expires > error.result.signatures[0].timestamp:
281
 
                    # The expired key was not expired at time of signing.
282
 
                    # test_verify_expired_but_valid()
283
 
                    return SIGNATURE_EXPIRED, fingerprint[-8:], None
 
94
                result = process.communicate(content)[0]
 
95
                if process.returncode is None:
 
96
                    process.wait()
 
97
                if process.returncode != 0:
 
98
                    raise errors.SigningFailed(self._command_line())
 
99
                return result
 
100
            except OSError, e:
 
101
                if e.errno == errno.EPIPE:
 
102
                    raise errors.SigningFailed(self._command_line())
284
103
                else:
285
 
                    # I can't work out how to create a test where the signature
286
 
                    # was expired at the time of signing.
287
 
                    return SIGNATURE_NOT_VALID, None, None
288
 
 
289
 
            # GPG does not know this key.
290
 
            # test_verify_unknown_key()
291
 
            if (error.result.signatures[0].summary &
292
 
                    gpg.constants.SIGSUM_KEY_MISSING):
293
 
                return SIGNATURE_KEY_MISSING, fingerprint[-8:], None
294
 
 
295
 
            return SIGNATURE_NOT_VALID, None, None
296
 
        except gpg.errors.GPGMEError as error:
297
 
            raise SignatureVerificationFailed(error)
298
 
 
299
 
        # No result if input is invalid.
300
 
        # test_verify_invalid()
301
 
        if len(result.signatures) == 0:
302
 
            return SIGNATURE_NOT_VALID, None, plain_output
303
 
 
304
 
        # User has specified a list of acceptable keys, check our result is in
305
 
        # it.  test_verify_unacceptable_key()
306
 
        fingerprint = result.signatures[0].fpr
307
 
        if self.acceptable_keys is not None:
308
 
            if fingerprint not in self.acceptable_keys:
309
 
                return SIGNATURE_KEY_MISSING, fingerprint[-8:], plain_output
310
 
        # Yay gpg set the valid bit.
311
 
        # Can't write a test for this one as you can't set a key to be
312
 
        # trusted using gpg.
313
 
        if result.signatures[0].summary & gpg.constants.SIGSUM_VALID:
314
 
            key = self.context.get_key(fingerprint)
315
 
            name = key.uids[0].name
316
 
            email = key.uids[0].email
317
 
            return (
318
 
                SIGNATURE_VALID,
319
 
                name.decode('utf-8') + u" <" + email.decode('utf-8') + u">",
320
 
                plain_output)
321
 
        # Sigsum_red indicates a problem, unfortunatly I have not been able
322
 
        # to write any tests which actually set this.
323
 
        if result.signatures[0].summary & gpg.constants.SIGSUM_RED:
324
 
            return SIGNATURE_NOT_VALID, None, plain_output
325
 
        # Summary isn't set if sig is valid but key is untrusted but if user
326
 
        # has explicity set the key as acceptable we can validate it.
327
 
        if (result.signatures[0].summary == 0 and
328
 
                self.acceptable_keys is not None):
329
 
            if fingerprint in self.acceptable_keys:
330
 
                # test_verify_untrusted_but_accepted()
331
 
                return SIGNATURE_VALID, None, plain_output
332
 
        # test_verify_valid_but_untrusted()
333
 
        if result.signatures[0].summary == 0 and self.acceptable_keys is None:
334
 
            return SIGNATURE_NOT_VALID, None, plain_output
335
 
        # Other error types such as revoked keys should (I think) be caught by
336
 
        # SIGSUM_RED so anything else means something is buggy.
337
 
        raise SignatureVerificationFailed(
338
 
            "Unknown GnuPG key verification result")
339
 
 
340
 
    def set_acceptable_keys(self, command_line_input):
341
 
        """Set the acceptable keys for verifying with this GPGStrategy.
342
 
 
343
 
        :param command_line_input: comma separated list of patterns from
344
 
                                command line
345
 
        :return: nothing
346
 
        """
347
 
        patterns = None
348
 
        acceptable_keys_config = self._config_stack.get('acceptable_keys')
349
 
        if acceptable_keys_config is not None:
350
 
            patterns = acceptable_keys_config
351
 
        if command_line_input is not None:  # command line overrides config
352
 
            patterns = command_line_input.split(',')
353
 
 
354
 
        if patterns:
355
 
            self.acceptable_keys = []
356
 
            for pattern in patterns:
357
 
                result = self.context.keylist(pattern)
358
 
                found_key = False
359
 
                for key in result:
360
 
                    found_key = True
361
 
                    self.acceptable_keys.append(key.subkeys[0].fpr)
362
 
                    trace.mutter("Added acceptable key: " + key.subkeys[0].fpr)
363
 
                if not found_key:
364
 
                    trace.note(gettext(
365
 
                        "No GnuPG key results for pattern: {0}"
366
 
                        ).format(pattern))
367
 
 
368
 
 
369
 
def valid_commits_message(count):
370
 
    """returns message for number of commits"""
371
 
    return gettext(u"{0} commits with valid signatures").format(
372
 
        count[SIGNATURE_VALID])
373
 
 
374
 
 
375
 
def unknown_key_message(count):
376
 
    """returns message for number of commits"""
377
 
    return ngettext(u"{0} commit with unknown key",
378
 
                    u"{0} commits with unknown keys",
379
 
                    count[SIGNATURE_KEY_MISSING]).format(
380
 
        count[SIGNATURE_KEY_MISSING])
381
 
 
382
 
 
383
 
def commit_not_valid_message(count):
384
 
    """returns message for number of commits"""
385
 
    return ngettext(u"{0} commit not valid",
386
 
                    u"{0} commits not valid",
387
 
                    count[SIGNATURE_NOT_VALID]).format(
388
 
        count[SIGNATURE_NOT_VALID])
389
 
 
390
 
 
391
 
def commit_not_signed_message(count):
392
 
    """returns message for number of commits"""
393
 
    return ngettext(u"{0} commit not signed",
394
 
                    u"{0} commits not signed",
395
 
                    count[SIGNATURE_NOT_SIGNED]).format(
396
 
        count[SIGNATURE_NOT_SIGNED])
397
 
 
398
 
 
399
 
def expired_commit_message(count):
400
 
    """returns message for number of commits"""
401
 
    return ngettext(u"{0} commit with key now expired",
402
 
                    u"{0} commits with key now expired",
403
 
                    count[SIGNATURE_EXPIRED]).format(
404
 
        count[SIGNATURE_EXPIRED])
405
 
 
406
 
 
407
 
def verbose_expired_key_message(result, repo):
408
 
    """takes a verify result and returns list of expired key info"""
409
 
    signers = {}
410
 
    fingerprint_to_authors = {}
411
 
    for rev_id, validity, fingerprint in result:
412
 
        if validity == SIGNATURE_EXPIRED:
413
 
            revision = repo.get_revision(rev_id)
414
 
            authors = ', '.join(revision.get_apparent_authors())
415
 
            signers.setdefault(fingerprint, 0)
416
 
            signers[fingerprint] += 1
417
 
            fingerprint_to_authors[fingerprint] = authors
418
 
    result = []
419
 
    for fingerprint, number in signers.items():
420
 
        result.append(
421
 
            ngettext(u"{0} commit by author {1} with key {2} now expired",
422
 
                     u"{0} commits by author {1} with key {2} now expired",
423
 
                     number).format(
424
 
                number, fingerprint_to_authors[fingerprint], fingerprint))
425
 
    return result
426
 
 
427
 
 
428
 
def verbose_valid_message(result):
429
 
    """takes a verify result and returns list of signed commits strings"""
430
 
    signers = {}
431
 
    for rev_id, validity, uid in result:
432
 
        if validity == SIGNATURE_VALID:
433
 
            signers.setdefault(uid, 0)
434
 
            signers[uid] += 1
435
 
    result = []
436
 
    for uid, number in signers.items():
437
 
        result.append(ngettext(u"{0} signed {1} commit",
438
 
                               u"{0} signed {1} commits",
439
 
                               number).format(uid, number))
440
 
    return result
441
 
 
442
 
 
443
 
def verbose_not_valid_message(result, repo):
444
 
    """takes a verify result and returns list of not valid commit info"""
445
 
    signers = {}
446
 
    for rev_id, validity, empty in result:
447
 
        if validity == SIGNATURE_NOT_VALID:
448
 
            revision = repo.get_revision(rev_id)
449
 
            authors = ', '.join(revision.get_apparent_authors())
450
 
            signers.setdefault(authors, 0)
451
 
            signers[authors] += 1
452
 
    result = []
453
 
    for authors, number in signers.items():
454
 
        result.append(ngettext(u"{0} commit by author {1}",
455
 
                               u"{0} commits by author {1}",
456
 
                               number).format(number, authors))
457
 
    return result
458
 
 
459
 
 
460
 
def verbose_not_signed_message(result, repo):
461
 
    """takes a verify result and returns list of not signed commit info"""
462
 
    signers = {}
463
 
    for rev_id, validity, empty in result:
464
 
        if validity == SIGNATURE_NOT_SIGNED:
465
 
            revision = repo.get_revision(rev_id)
466
 
            authors = ', '.join(revision.get_apparent_authors())
467
 
            signers.setdefault(authors, 0)
468
 
            signers[authors] += 1
469
 
    result = []
470
 
    for authors, number in signers.items():
471
 
        result.append(ngettext(u"{0} commit by author {1}",
472
 
                               u"{0} commits by author {1}",
473
 
                               number).format(number, authors))
474
 
    return result
475
 
 
476
 
 
477
 
def verbose_missing_key_message(result):
478
 
    """takes a verify result and returns list of missing key info"""
479
 
    signers = {}
480
 
    for rev_id, validity, fingerprint in result:
481
 
        if validity == SIGNATURE_KEY_MISSING:
482
 
            signers.setdefault(fingerprint, 0)
483
 
            signers[fingerprint] += 1
484
 
    result = []
485
 
    for fingerprint, number in list(signers.items()):
486
 
        result.append(ngettext(u"Unknown key {0} signed {1} commit",
487
 
                               u"Unknown key {0} signed {1} commits",
488
 
                               number).format(fingerprint, number))
489
 
    return result
 
104
                    raise
 
105
        except ValueError:
 
106
            # bad subprocess parameters, should never happen.
 
107
            raise
 
108
        except OSError, e:
 
109
            if e.errno == errno.ENOENT:
 
110
                # gpg is not installed
 
111
                raise errors.SigningFailed(self._command_line())
 
112
            else:
 
113
                raise