2016-04-24 10:04:53 +00:00
|
|
|
"""Create GPG ECDSA signatures and public keys using TREZOR device."""
|
|
|
|
import base64
|
|
|
|
import hashlib
|
|
|
|
import logging
|
|
|
|
import struct
|
|
|
|
import time
|
|
|
|
|
2016-04-30 13:50:01 +00:00
|
|
|
from . import agent, decode, proto
|
2016-04-24 10:04:53 +00:00
|
|
|
from .. import client, factory, formats, util
|
|
|
|
|
|
|
|
log = logging.getLogger(__name__)
|
|
|
|
|
|
|
|
|
2016-04-28 11:45:45 +00:00
|
|
|
class HardwareSigner(object):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Sign messages and get public keys from a hardware device."""
|
|
|
|
|
2016-04-28 11:45:45 +00:00
|
|
|
def __init__(self, user_id, curve_name):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Connect to the device and retrieve required public key."""
|
2016-04-24 10:04:53 +00:00
|
|
|
self.client_wrapper = factory.load()
|
|
|
|
self.identity = self.client_wrapper.identity_type()
|
|
|
|
self.identity.proto = 'gpg'
|
|
|
|
self.identity.host = user_id
|
2016-04-28 11:45:45 +00:00
|
|
|
self.curve_name = curve_name
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-28 11:45:45 +00:00
|
|
|
def pubkey(self):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Return public key as VerifyingKey object."""
|
2016-04-24 10:04:53 +00:00
|
|
|
addr = client.get_address(self.identity)
|
|
|
|
public_node = self.client_wrapper.connection.get_public_node(
|
|
|
|
n=addr, ecdsa_curve_name=self.curve_name)
|
|
|
|
|
2016-04-28 11:45:45 +00:00
|
|
|
return formats.decompress_pubkey(
|
2016-04-24 10:04:53 +00:00
|
|
|
pubkey=public_node.node.public_key,
|
|
|
|
curve_name=self.curve_name)
|
|
|
|
|
2016-04-29 19:23:12 +00:00
|
|
|
def sign(self, digest):
|
2016-04-30 10:01:14 +00:00
|
|
|
"""Sign the digest and return a serialized signature."""
|
2016-04-28 11:45:45 +00:00
|
|
|
result = self.client_wrapper.connection.sign_identity(
|
|
|
|
identity=self.identity,
|
|
|
|
challenge_hidden=digest,
|
2016-04-29 19:23:12 +00:00
|
|
|
challenge_visual=util.hexlify(digest),
|
2016-04-28 11:45:45 +00:00
|
|
|
ecdsa_curve_name=self.curve_name)
|
|
|
|
assert result.signature[:1] == b'\x00'
|
|
|
|
sig = result.signature[1:]
|
2016-04-30 13:50:01 +00:00
|
|
|
return (proto.mpi(util.bytes2num(sig[:32])) +
|
|
|
|
proto.mpi(util.bytes2num(sig[32:])))
|
2016-04-28 11:45:45 +00:00
|
|
|
|
|
|
|
def close(self):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Close the connection to the device."""
|
2016-04-28 11:45:45 +00:00
|
|
|
self.client_wrapper.connection.clear_session()
|
|
|
|
self.client_wrapper.connection.close()
|
|
|
|
|
|
|
|
|
|
|
|
class AgentSigner(object):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Sign messages and get public keys using gpg-agent tool."""
|
|
|
|
|
2016-04-30 10:20:06 +00:00
|
|
|
def __init__(self, user_id):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Connect to the agent and retrieve required public key."""
|
2016-04-28 11:45:45 +00:00
|
|
|
self.sock = agent.connect()
|
|
|
|
self.keygrip = agent.get_keygrip(user_id)
|
|
|
|
self.public_key = decode.load_from_gpg(user_id)
|
|
|
|
|
|
|
|
def pubkey(self):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Return public key as VerifyingKey object."""
|
2016-04-28 11:45:45 +00:00
|
|
|
return self.public_key['verifying_key']
|
|
|
|
|
2016-04-29 19:23:12 +00:00
|
|
|
def sign(self, digest):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Sign the digest and return an ECDSA signature."""
|
2016-04-30 12:39:32 +00:00
|
|
|
params = agent.sign(sock=self.sock,
|
|
|
|
keygrip=self.keygrip, digest=digest)
|
2016-04-30 13:50:01 +00:00
|
|
|
return b''.join(proto.mpi(p) for p in params)
|
2016-04-28 11:45:45 +00:00
|
|
|
|
|
|
|
def close(self):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Close the connection to gpg-agent."""
|
2016-04-28 11:45:45 +00:00
|
|
|
self.sock.close()
|
|
|
|
|
|
|
|
|
2016-04-29 14:45:16 +00:00
|
|
|
class PublicKey(object):
|
2016-04-30 06:29:04 +00:00
|
|
|
"""GPG representation for public key packets."""
|
|
|
|
|
2016-04-29 14:45:16 +00:00
|
|
|
def __init__(self, curve_name, created, verifying_key):
|
2016-04-30 06:29:04 +00:00
|
|
|
"""Contruct using a ECDSA VerifyingKey object."""
|
2016-04-30 13:50:01 +00:00
|
|
|
self.curve_info = proto.SUPPORTED_CURVES[curve_name]
|
2016-04-30 06:29:04 +00:00
|
|
|
self.created = int(created) # time since Epoch
|
2016-04-29 14:45:16 +00:00
|
|
|
self.verifying_key = verifying_key
|
2016-04-30 10:20:06 +00:00
|
|
|
self.algo_id = self.curve_info['algo_id']
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 19:28:41 +00:00
|
|
|
def data(self):
|
|
|
|
"""Data for packet creation."""
|
2016-04-24 10:04:53 +00:00
|
|
|
header = struct.pack('>BLB',
|
|
|
|
4, # version
|
|
|
|
self.created, # creation
|
2016-04-30 10:20:06 +00:00
|
|
|
self.algo_id) # public key algorithm ID
|
2016-04-30 06:29:04 +00:00
|
|
|
oid = util.prefix_len('>B', self.curve_info['oid'])
|
|
|
|
blob = self.curve_info['serialize'](self.verifying_key)
|
2016-04-24 10:04:53 +00:00
|
|
|
return header + oid + blob
|
|
|
|
|
2016-04-29 19:28:41 +00:00
|
|
|
def data_to_hash(self):
|
|
|
|
"""Data for digest computation."""
|
|
|
|
return b'\x99' + util.prefix_len('>H', self.data())
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 19:45:52 +00:00
|
|
|
def _fingerprint(self):
|
|
|
|
return hashlib.sha1(self.data_to_hash()).digest()
|
|
|
|
|
2016-04-24 10:04:53 +00:00
|
|
|
def key_id(self):
|
|
|
|
"""Short (8 byte) GPG key ID."""
|
2016-04-29 19:45:52 +00:00
|
|
|
return self._fingerprint()[-8:]
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 19:45:52 +00:00
|
|
|
def __repr__(self):
|
2016-04-24 10:04:53 +00:00
|
|
|
"""Short (8 hexadecimal digits) GPG key ID."""
|
2016-04-29 19:45:52 +00:00
|
|
|
return '<{}>'.format(util.hexlify(self.key_id()))
|
|
|
|
|
|
|
|
__str__ = __repr__
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 14:45:16 +00:00
|
|
|
|
|
|
|
class Signer(object):
|
|
|
|
"""Performs GPG signing operations."""
|
|
|
|
|
|
|
|
def __init__(self, user_id, created, curve_name):
|
|
|
|
"""Construct and loads a public key from the device."""
|
|
|
|
self.user_id = user_id
|
|
|
|
assert curve_name in formats.SUPPORTED_CURVES
|
|
|
|
|
|
|
|
self.conn = HardwareSigner(user_id, curve_name=curve_name)
|
|
|
|
self.pubkey = PublicKey(
|
|
|
|
curve_name=curve_name, created=created,
|
|
|
|
verifying_key=self.conn.pubkey())
|
|
|
|
|
|
|
|
log.info('%s GPG public key %s created at %s', curve_name,
|
2016-04-29 19:45:52 +00:00
|
|
|
self.pubkey, util.time_format(self.pubkey.created))
|
2016-04-29 14:45:16 +00:00
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def from_public_key(cls, pubkey, user_id):
|
|
|
|
"""
|
|
|
|
Create from an existing GPG public key.
|
|
|
|
|
|
|
|
`pubkey` should be loaded via `decode.load_from_gpg(user_id)`
|
|
|
|
from the local GPG keyring.
|
|
|
|
"""
|
|
|
|
s = Signer(user_id=user_id,
|
|
|
|
created=pubkey['created'],
|
2016-04-30 13:50:01 +00:00
|
|
|
curve_name=proto.find_curve_by_algo_id(pubkey['algo']))
|
2016-04-29 14:45:16 +00:00
|
|
|
assert s.pubkey.key_id() == pubkey['key_id']
|
|
|
|
return s
|
|
|
|
|
2016-04-24 10:04:53 +00:00
|
|
|
def close(self):
|
|
|
|
"""Close connection and turn off the screen of the device."""
|
2016-04-28 11:45:45 +00:00
|
|
|
self.conn.close()
|
2016-04-24 10:04:53 +00:00
|
|
|
|
|
|
|
def export(self):
|
|
|
|
"""Export GPG public key, ready for "gpg2 --import"."""
|
2016-04-30 13:50:01 +00:00
|
|
|
pubkey_packet = proto.packet(tag=6, blob=self.pubkey.data())
|
|
|
|
user_id_packet = proto.packet(tag=13, blob=self.user_id)
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 19:28:41 +00:00
|
|
|
data_to_sign = (self.pubkey.data_to_hash() +
|
2016-04-24 10:04:53 +00:00
|
|
|
user_id_packet[:1] +
|
|
|
|
util.prefix_len('>L', self.user_id))
|
|
|
|
log.info('signing public key "%s"', self.user_id)
|
|
|
|
hashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket_time(self.pubkey.created), # signature time
|
|
|
|
proto.subpacket_byte(0x1B, 1 | 2), # key flags (certify & sign)
|
|
|
|
proto.subpacket_byte(0x15, 8), # preferred hash (SHA256)
|
|
|
|
proto.subpacket_byte(0x16, 0), # preferred compression (none)
|
|
|
|
proto.subpacket_byte(0x17, 0x80)] # key server prefs (no-modify)
|
2016-04-29 14:45:16 +00:00
|
|
|
unhashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket(16, self.pubkey.key_id()), # issuer key id
|
2016-04-30 18:07:19 +00:00
|
|
|
proto.CUSTOM_SUBPACKET]
|
2016-04-29 14:45:16 +00:00
|
|
|
|
|
|
|
signature = _make_signature(
|
2016-04-30 10:20:06 +00:00
|
|
|
signer_func=self.conn.sign,
|
|
|
|
public_algo=self.pubkey.algo_id,
|
2016-04-29 14:45:16 +00:00
|
|
|
data_to_sign=data_to_sign,
|
|
|
|
sig_type=0x13, # user id & public key
|
|
|
|
hashed_subpackets=hashed_subpackets,
|
|
|
|
unhashed_subpackets=unhashed_subpackets)
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-30 13:50:01 +00:00
|
|
|
sign_packet = proto.packet(tag=2, blob=signature)
|
2016-04-24 10:04:53 +00:00
|
|
|
return pubkey_packet + user_id_packet + sign_packet
|
|
|
|
|
2016-04-29 19:45:52 +00:00
|
|
|
def subkey(self):
|
2016-04-30 07:04:44 +00:00
|
|
|
"""Export a subkey to `self.user_id` GPG primary key."""
|
2016-04-30 13:50:01 +00:00
|
|
|
subkey_packet = proto.packet(tag=14, blob=self.pubkey.data())
|
2016-04-29 19:45:52 +00:00
|
|
|
primary = decode.load_from_gpg(self.user_id)
|
2016-04-30 18:55:24 +00:00
|
|
|
log.info('adding subkey to primary GPG key "%s" (%s)',
|
|
|
|
self.user_id, util.hexlify(primary['key_id']))
|
2016-04-29 19:28:41 +00:00
|
|
|
data_to_sign = primary['_to_hash'] + self.pubkey.data_to_hash()
|
2016-04-30 10:25:14 +00:00
|
|
|
|
|
|
|
# Primary Key Binding Signature
|
2016-04-28 19:10:40 +00:00
|
|
|
hashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket_time(self.pubkey.created)] # signature time
|
2016-04-29 14:45:16 +00:00
|
|
|
unhashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket(16, self.pubkey.key_id())] # issuer key id
|
2016-04-30 19:20:50 +00:00
|
|
|
log.info('confirm signing subkey with hardware device')
|
2016-04-30 12:39:32 +00:00
|
|
|
embedded_sig = _make_signature(signer_func=self.conn.sign,
|
|
|
|
data_to_sign=data_to_sign,
|
|
|
|
public_algo=self.pubkey.algo_id,
|
|
|
|
sig_type=0x19,
|
|
|
|
hashed_subpackets=hashed_subpackets,
|
|
|
|
unhashed_subpackets=unhashed_subpackets)
|
2016-04-30 10:25:14 +00:00
|
|
|
|
|
|
|
# Subkey Binding Signature
|
2016-04-28 18:31:01 +00:00
|
|
|
hashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket_time(self.pubkey.created), # signature time
|
|
|
|
proto.subpacket_byte(0x1B, 2)] # key flags (certify & sign)
|
2016-04-29 14:45:16 +00:00
|
|
|
unhashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket(16, primary['key_id']), # issuer key id
|
|
|
|
proto.subpacket(32, embedded_sig),
|
2016-04-30 18:07:19 +00:00
|
|
|
proto.CUSTOM_SUBPACKET]
|
2016-04-30 19:20:50 +00:00
|
|
|
log.info('confirm signing subkey with gpg-agent')
|
2016-04-30 10:20:06 +00:00
|
|
|
gpg_agent = AgentSigner(self.user_id)
|
|
|
|
signature = _make_signature(signer_func=gpg_agent.sign,
|
2016-04-29 14:45:16 +00:00
|
|
|
data_to_sign=data_to_sign,
|
2016-04-30 10:25:14 +00:00
|
|
|
public_algo=primary['algo'],
|
2016-04-29 14:45:16 +00:00
|
|
|
sig_type=0x18,
|
|
|
|
hashed_subpackets=hashed_subpackets,
|
2016-04-30 10:25:14 +00:00
|
|
|
unhashed_subpackets=unhashed_subpackets)
|
2016-04-30 13:50:01 +00:00
|
|
|
sign_packet = proto.packet(tag=2, blob=signature)
|
2016-04-28 18:31:01 +00:00
|
|
|
return subkey_packet + sign_packet
|
|
|
|
|
2016-04-24 10:04:53 +00:00
|
|
|
def sign(self, msg, sign_time=None):
|
|
|
|
"""Sign GPG message at specified time."""
|
|
|
|
if sign_time is None:
|
|
|
|
sign_time = int(time.time())
|
|
|
|
|
|
|
|
log.info('signing %d byte message at %s',
|
|
|
|
len(msg), util.time_format(sign_time))
|
2016-04-30 13:50:01 +00:00
|
|
|
hashed_subpackets = [proto.subpacket_time(sign_time)]
|
2016-04-29 14:45:16 +00:00
|
|
|
unhashed_subpackets = [
|
2016-04-30 13:50:01 +00:00
|
|
|
proto.subpacket(16, self.pubkey.key_id())] # issuer key id
|
2016-04-29 14:45:16 +00:00
|
|
|
|
2016-04-30 10:25:14 +00:00
|
|
|
blob = _make_signature(signer_func=self.conn.sign,
|
|
|
|
data_to_sign=msg,
|
|
|
|
public_algo=self.pubkey.algo_id,
|
|
|
|
hashed_subpackets=hashed_subpackets,
|
|
|
|
unhashed_subpackets=unhashed_subpackets)
|
2016-04-30 13:50:01 +00:00
|
|
|
return proto.packet(tag=2, blob=blob)
|
2016-04-24 10:04:53 +00:00
|
|
|
|
2016-04-29 14:45:16 +00:00
|
|
|
|
2016-04-30 10:20:06 +00:00
|
|
|
def _make_signature(signer_func, data_to_sign, public_algo,
|
|
|
|
hashed_subpackets, unhashed_subpackets, sig_type=0):
|
2016-04-30 12:39:32 +00:00
|
|
|
# pylint: disable=too-many-arguments
|
2016-04-29 14:45:16 +00:00
|
|
|
header = struct.pack('>BBBB',
|
|
|
|
4, # version
|
|
|
|
sig_type, # rfc4880 (section-5.2.1)
|
2016-04-30 10:20:06 +00:00
|
|
|
public_algo,
|
2016-04-29 14:45:16 +00:00
|
|
|
8) # hash_alg (SHA256)
|
2016-04-30 13:50:01 +00:00
|
|
|
hashed = proto.subpackets(*hashed_subpackets)
|
|
|
|
unhashed = proto.subpackets(*unhashed_subpackets)
|
2016-04-29 14:45:16 +00:00
|
|
|
tail = b'\x04\xff' + struct.pack('>L', len(header) + len(hashed))
|
|
|
|
data_to_hash = data_to_sign + header + hashed + tail
|
|
|
|
|
|
|
|
log.debug('hashing %d bytes', len(data_to_hash))
|
|
|
|
digest = hashlib.sha256(data_to_hash).digest()
|
2016-04-30 19:11:51 +00:00
|
|
|
log.info('SHA256 digest to sign: %s', util.hexlify(digest))
|
2016-04-30 10:20:06 +00:00
|
|
|
sig = signer_func(digest=digest)
|
2016-04-29 14:45:16 +00:00
|
|
|
|
|
|
|
return bytes(header + hashed + unhashed +
|
|
|
|
digest[:2] + # used for decoder's sanity check
|
|
|
|
sig) # actual ECDSA signature
|
2016-04-24 10:04:53 +00:00
|
|
|
|
|
|
|
|
|
|
|
def _split_lines(body, size):
|
|
|
|
lines = []
|
|
|
|
for i in range(0, len(body), size):
|
|
|
|
lines.append(body[i:i+size] + '\n')
|
|
|
|
return ''.join(lines)
|
|
|
|
|
|
|
|
|
|
|
|
def armor(blob, type_str):
|
|
|
|
"""See https://tools.ietf.org/html/rfc4880#section-6 for details."""
|
|
|
|
head = '-----BEGIN PGP {}-----\nVersion: GnuPG v2\n\n'.format(type_str)
|
|
|
|
body = base64.b64encode(blob)
|
|
|
|
checksum = base64.b64encode(util.crc24(blob))
|
|
|
|
tail = '-----END PGP {}-----\n'.format(type_str)
|
|
|
|
return head + _split_lines(body, 64) + '=' + checksum + '\n' + tail
|