Mercurial > libervia-backend
changeset 2738:eb58f26ed236
plugin XEP-0384: update to last python-omemo + trust management:
- Plugin has been updated to use last version of python-omemo (10.0.3).
- A temporary method remove all storage data if they are found, this method must be removed before 0.7 release (only people using dev version should have old omemo data in there storage).
- Trust management is not implemented, using new encryptionTrustUIGet method (an UI is also displayed when trust handling is needed before sending a message).
- omemo.DefaultOTPKPolicy is now used, instead of previous test policy of always deleting.
OMEMO e2e encryption is now functional for one2one conversations, including fingerprint management.
author | Goffi <goffi@goffi.org> |
---|---|
date | Wed, 02 Jan 2019 18:50:28 +0100 |
parents | 5c2ed8a5ae22 |
children | e8dc00f612fb |
files | CHANGELOG sat/plugins/plugin_xep_0384.py setup.py |
diffstat | 3 files changed, 500 insertions(+), 111 deletions(-) [+] |
line wrap: on
line diff
--- a/CHANGELOG Wed Jan 02 18:32:16 2019 +0100 +++ b/CHANGELOG Wed Jan 02 18:50:28 2019 +0100 @@ -12,7 +12,7 @@ - XEP-0280 implementation (Mesage Carbons) - XEP-0313 implementation of messages part (one2one + MUC) - XEP-0329 implementation (File Information Sharing) - - XEP-0384 implementation (OMEMO encryption) + - XEP-0384 implementation (OMEMO encryption), one2one - new bridges are available: pb (perspective browser), and embedded (use backend as a module) - D-Bus bridge: changed namespace from org.goffi.SAT to org.salutatoi.SAT - components (SàT can now act as a component)
--- a/sat/plugins/plugin_xep_0384.py Wed Jan 02 18:32:16 2019 +0100 +++ b/sat/plugins/plugin_xep_0384.py Wed Jan 02 18:50:28 2019 +0100 @@ -17,24 +17,27 @@ # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. -from sat.core.i18n import _ +from sat.core.i18n import _, D_ from sat.core.constants import Const as C from sat.core.log import getLogger from sat.core import exceptions +from omemo import exceptions as omemo_excpt from twisted.internet import defer from twisted.words.xish import domish from twisted.words.protocols.jabber import jid from twisted.words.protocols.jabber import error from sat.memory import persistent from functools import partial +from sat.tools import xml_tools import logging import random import base64 try: import omemo from omemo.extendedpublicbundle import ExtendedPublicBundle - from omemo import wireformat -except ImportError: + from omemo_backend_signal import BACKEND as omemo_backend + # from omemo import wireformat +except ImportError as e: raise exceptions.MissingModule( u'Missing module omemo, please download/install it. You can use ' u'"pip install omemo"' @@ -53,17 +56,20 @@ C.PI_DESCRIPTION: _(u"""Implementation of OMEMO"""), } +OMEMO_MIN_VER = (0, 10, 3) NS_OMEMO = "eu.siacs.conversations.axolotl" NS_OMEMO_DEVICES = NS_OMEMO + ".devicelist" NS_OMEMO_BUNDLE = NS_OMEMO + ".bundles:{device_id}" KEY_STATE = "STATE" KEY_DEVICE_ID = "DEVICE_ID" KEY_SESSION = "SESSION" +KEY_TRUST = "TRUST" KEY_ACTIVE_DEVICES = "DEVICES" -KEY_INACTIVE_DEVICES = "DEVICES" +KEY_INACTIVE_DEVICES = "INACTIVE_DEVICES" +KEY_ALL_JIDS = "ALL_JIDS" -# we want to manage log emitted by omemo module ourseves +# we want to manage log emitted by omemo module ourselves class SatHandler(logging.Handler): @@ -81,18 +87,30 @@ def b64enc(data): - return base64.b64encode(bytes(bytearray(data))).decode("ASCII") + return base64.b64encode(bytes(bytearray(data))).decode("US-ASCII") + + +def promise2Deferred(promise_): + """Create a Deferred and fire it when promise is resolved + + @param promise_(promise.Promise): promise to convert + @return (defer.Deferred): deferred instance linked to the promise + """ + d = defer.Deferred() + promise_.then(d.callback, d.errback) + return d class OmemoStorage(omemo.Storage): - def __init__(self, client, device_id, persistent_dict): + def __init__(self, client, device_id, all_jids, persistent_dict): """ @param persistent_dict(persistent.LazyPersistentBinaryDict): object which will store data in SàT database """ self.own_bare_jid_s = client.jid.userhost() self.device_id = device_id + self.all_jids = all_jids self.data = persistent_dict @property @@ -110,6 +128,19 @@ deferred.addCallback(partial(callback, True)) deferred.addErrback(partial(callback, False)) + def _checkJid(self, bare_jid): + """Check if jid is know, and store it if not + + @param bare_jid(unicode): bare jid to check + @return (D): Deferred fired when jid is stored + """ + if bare_jid in self.all_jids: + return defer.succeed(None) + else: + self.all_jids.add(bare_jid) + d = self.data.force(KEY_ALL_JIDS, self.all_jids) + return d + def loadOwnData(self, callback): callback(True, {'own_bare_jid': self.own_bare_jid_s, 'own_device_id': self.device_id}) @@ -137,37 +168,114 @@ d = self.data.force(key, session) self.setCb(d, callback) + def deleteSession(self, callback, bare_jid, device_id): + key = u'\n'.join([KEY_SESSION, bare_jid, unicode(device_id)]) + d = self.data.remove(key) + self.setCb(d, callback) + def loadActiveDevices(self, callback, bare_jid): key = u'\n'.join([KEY_ACTIVE_DEVICES, bare_jid]) d = self.data.get(key, {}) - self.setCb(d, callback) + if callback is not None: + self.setCb(d, callback) + return d def loadInactiveDevices(self, callback, bare_jid): key = u'\n'.join([KEY_INACTIVE_DEVICES, bare_jid]) d = self.data.get(key, {}) - self.setCb(d, callback) + if callback is not None: + self.setCb(d, callback) + return d def storeActiveDevices(self, callback, bare_jid, devices): key = u'\n'.join([KEY_ACTIVE_DEVICES, bare_jid]) - d = self.data.force(key, devices) + d = self._checkJid(bare_jid) + d.addCallback(lambda _: self.data.force(key, devices)) self.setCb(d, callback) def storeInactiveDevices(self, callback, bare_jid, devices): key = u'\n'.join([KEY_INACTIVE_DEVICES, bare_jid]) - d = self.data.force(key, devices) + d = self._checkJid(bare_jid) + d.addCallback(lambda _: self.data.force(key, devices)) + self.setCb(d, callback) + + def storeTrust(self, callback, bare_jid, device_id, trust): + key = u'\n'.join([KEY_TRUST, bare_jid, unicode(device_id)]) + d = self.data.force(key, trust) self.setCb(d, callback) - def isTrusted(self, callback, bare_jid, device): - trusted = True - callback(True, trusted) + def loadTrust(self, callback, bare_jid, device_id): + key = u'\n'.join([KEY_TRUST, bare_jid, unicode(device_id)]) + d = self.data.get(key) + if callback is not None: + self.setCb(d, callback) + return d + + def listJIDs(self, callback): + d = defer.succeed(self.all_jids) + if callback is not None: + self.setCb(d, callback) + return d + + def _deleteJID_logResults(self, results): + failed = [success for success, __ in results if not success] + if failed: + log.warning( + u"delete JID failed for {failed_count} on {total_count} operations" + .format(failed_count=len(failed), total_count=len(results))) + else: + log.info( + u"Delete JID operation succeed ({total_count} operations)." + .format(total_count=len(results))) + + def _deleteJID_gotDevices(self, results, bare_jid): + assert len(results) == 2 + active_success, active_devices = results[0] + inactive_success, inactive_devices = results[0] + d_list = [] + for success, devices in results: + if not success: + log.warning("Can't retrieve devices for {bare_jid}: {reason}" + .format(bare_jid=bare_jid, reason=active_devices)) + else: + for device_id in devices: + for key in (KEY_SESSION, KEY_TRUST): + k = u'\n'.join([key, bare_jid, unicode(device_id)]) + d_list.append(self.data.remove(k)) + + d_list.append(self.data.remove(KEY_ACTIVE_DEVICES, bare_jid)) + d_list.append(self.data.remove(KEY_INACTIVE_DEVICES, bare_jid)) + d_list.append(lambda __: self.all_jids.discard(bare_jid)) + # FIXME: there is a risk of race condition here, + # if self.all_jids is modified between discard and force) + d_list.append(lambda __: self.data.force(KEY_ALL_JIDS, self.all_jids)) + d = defer.DeferredList(d_list) + d.addCallback(self._deleteJID_logResults) + return d + + def deleteJID(self, callback, bare_jid): + """Retrieve all (in)actives of bare_jid, and delete all related keys""" + d_list = [] + + key = u'\n'.join([KEY_ACTIVE_DEVICES, bare_jid]) + d_list.append(self.data.get(key, [])) + + key = u'\n'.join([KEY_INACTIVE_DEVICES, bare_jid]) + d_inactive = self.data.get(key, {}) + # inactive devices are returned as a dict mapping from devices_id to timestamp + # but we only need devices ids + d_inactive.addCallback(lambda devices: [k for k, __ in devices]) + + d_list.append(d_inactive) + d = defer.DeferredList(d_list) + d.addCallback(self._deleteJID_gotDevices, bare_jid) + if callback is not None: + self.setCb(d, callback) + return d -class SatOTPKPolicy(omemo.OTPKPolicy): - - @staticmethod - def decideOTPK(preKeyMessages): - # always delete - return False +class SatOTPKPolicy(omemo.DefaultOTPKPolicy): + pass class OmemoSession(object): @@ -177,55 +285,46 @@ self._session = session @property - def state(self): - return self._session.state - - @staticmethod - def promise2Deferred(promise_): - """Create a Deferred and fire it when promise is resolved + def republish_bundle(self): + return self._session.republish_bundle - @param promise_(promise.Promise): promise to convert - @return (defer.Deferred): deferred instance linked to the promise - """ - d = defer.Deferred() - promise_.then(d.callback, d.errback) - return d + @property + def public_bundle(self): + return self._session.public_bundle @classmethod def create(cls, client, storage, my_device_id = None): omemo_session_p = client._xep_0384_session = omemo.SessionManager.create( storage, SatOTPKPolicy, + omemo_backend, client.jid.userhost(), my_device_id) - d = cls.promise2Deferred(omemo_session_p) + d = promise2Deferred(omemo_session_p) d.addCallback(lambda session: cls(session)) return d - def newDeviceList(self, devices, jid): + def newDeviceList(self, jid, devices): jid = jid.userhost() - new_device_p = self._session.newDeviceList(devices, jid) - return self.promise2Deferred(new_device_p) + new_device_p = self._session.newDeviceList(jid, devices) + return promise2Deferred(new_device_p) def getDevices(self, bare_jid=None): get_devices_p = self._session.getDevices(bare_jid=bare_jid) - return self.promise2Deferred(get_devices_p) + return promise2Deferred(get_devices_p) def buildSession(self, bare_jid, device, bundle): bare_jid = bare_jid.userhost() build_session_p = self._session.buildSession(bare_jid, device, bundle) - return self.promise2Deferred(build_session_p) + return promise2Deferred(build_session_p) - def encryptMessage(self, bare_jids, message, bundles=None, devices=None, - always_trust = False): + def encryptMessage(self, bare_jids, message, bundles=None, expect_problems=None): """Encrypt a message @param bare_jids(iterable[jid.JID]): destinees of the message @param message(unicode): message to encode @param bundles(dict[jid.JID, dict[int, ExtendedPublicBundle]): entities => devices => bundles map - @param devices(iterable[int], None): devices to encode for - @param always_trust(bool): TODO @return D(dict): encryption data """ if isinstance(bare_jids, jid.JID): @@ -238,12 +337,11 @@ bare_jids=bare_jids, plaintext=message.encode('utf-8'), bundles=bundles, - devices=devices, - always_trust=always_trust) - return self.promise2Deferred(encrypt_mess_p) + expect_problems=expect_problems) + return promise2Deferred(encrypt_mess_p) def decryptMessage(self, bare_jid, device, iv, message, is_pre_key_message, - payload=None, from_storage=False): + ciphertext, additional_information=None, allow_untrusted=False): bare_jid = bare_jid.userhost() decrypt_mess_p = self._session.decryptMessage( bare_jid=bare_jid, @@ -251,14 +349,45 @@ iv=iv, message=message, is_pre_key_message=is_pre_key_message, - payload=payload, - from_storage=from_storage) - return self.promise2Deferred(decrypt_mess_p) + ciphertext=ciphertext, + additional_information=additional_information, + allow_untrusted=allow_untrusted + ) + return promise2Deferred(decrypt_mess_p) + + def trust(self, bare_jid, device, key): + bare_jid = bare_jid.userhost() + trust_p = self._session.trust( + bare_jid=bare_jid, + device=device, + key=key) + return promise2Deferred(trust_p) + + def distrust(self, bare_jid, device, key): + bare_jid = bare_jid.userhost() + distrust_p = self._session.distrust( + bare_jid=bare_jid, + device=device, + key=key) + return promise2Deferred(distrust_p) + + def getTrustForJID(self, bare_jid): + bare_jid = bare_jid.userhost() + get_trust_p = self._session.getTrustForJID(bare_jid=bare_jid) + return promise2Deferred(get_trust_p) class OMEMO(object): + def __init__(self, host): - log.info(_(u"OMEMO plugin initialization")) + log.info(_(u"OMEMO plugin initialization (omemo module v{version})").format( + version=omemo.__version__)) + version = tuple(map(int, omemo.__version__.split(u'.')[:3])) + if version < OMEMO_MIN_VER: + log.warning(_( + u"Your version of omemo module is too old: {v[0]}.{v[1]}.{v[2]} is " + u"minimum required), please update.").format(v=OMEMO_MIN_VER)) + raise exceptions.CancelError("module is too old") self.host = host self._p_hints = host.plugins[u"XEP-0334"] self._p_carbons = host.plugins[u"XEP-0280"] @@ -270,14 +399,149 @@ pep.addPEPEvent("OMEMO_DEVICES", NS_OMEMO_DEVICES, self.onNewDevices) @defer.inlineCallbacks + def trustUICb(self, xmlui_data, trust_data, expect_problems=None, + profile=C.PROF_KEY_NONE): + if C.bool(xmlui_data.get('cancelled', 'false')): + defer.returnValue({}) + client = self.host.getClient(profile) + session = client._xep_0384_session + answer = xml_tools.XMLUIResult2DataFormResult(xmlui_data) + for key, value in answer.iteritems(): + if key.startswith(u'trust_'): + trust_id = key[6:] + else: + continue + data = trust_data[trust_id] + trust = C.bool(value) + if trust: + yield session.trust(data[u"jid"], + data[u"device"], + data[u"ik"]) + else: + yield session.distrust(data[u"jid"], + data[u"device"], + data[u"ik"]) + if expect_problems is not None: + expect_problems.setdefault(data.bare_jid, set()).add(data.device) + defer.returnValue({}) + + + + @defer.inlineCallbacks + def getTrustUI(self, client, entity_jid=None, trust_data=None, submit_id=None): + """Generate a XMLUI to manage trust + + @param entity_jid(None, jid.JID): jid of entity to manage + None to use trust_data + @param trust_data(None, dict): devices data: + None to use entity_jid + else a dict mapping from trust ids (unicode) to devices data, + where a device data must have the following keys: + - jid(jid.JID): bare jid of the device owner + - device(int): device id + - ik(bytes): identity key + and may have the following key: + - trusted(bool): True if device is trusted + @param submit_id(None, unicode): submit_id to use + if None set UI callback to trustUICb + @return D(xmlui): trust management form + """ + # we need entity_jid xor trust_data + assert entity_jid and not trust_data or not entity_jid and trust_data + if entity_jid.resource: + raise ValueError(u"A bare jid is expected") + + session = client._xep_0384_session + + if trust_data is None: + trust_data = {} + trust_session_data = yield session.getTrustForJID(entity_jid) + bare_jid_s = entity_jid.userhost() + for device_id, trust_info in trust_session_data['active'].iteritems(): + ik = trust_info["key"] + trust_id = unicode(hash((bare_jid_s, device_id, ik))) + trust_data[trust_id] = { + u"jid": entity_jid, + u"device": device_id, + u"ik": ik, + u"trusted": trust_info[u"trusted"], + } + + if submit_id is None: + submit_id = self.host.registerCallback(partial(self.trustUICb, + trust_data=trust_data), + with_data=True, + one_shot=True) + xmlui = xml_tools.XMLUI( + panel_type = C.XMLUI_FORM, + title = D_(u"OMEMO trust management"), + submit_id = submit_id + ) + xmlui.addText(D_( + u"This is OMEMO trusting system. You'll see below the devices of your " + u"contacts, and a checkbox to trust them or not. A trusted device " + u"can read your messages in plain text, so be sure to only validate " + u"devices that you are sure are belonging to your contact. It's better " + u"to do this when you are next to your contact and her/his device, so " + u"you can check the \"fingerprint\" (the number next to the device) " + u"yourself. Do *not* validate a device if the fingerprint is wrong!")) + + xmlui.changeContainer("label") + xmlui.addLabel(D_(u"This device ID")) + xmlui.addText(unicode(client._xep_0384_device_id)) + xmlui.addLabel(D_(u"This device fingerprint")) + ik_hex = session.public_bundle.ik.encode('hex').upper() + fp_human = u' '.join([ik_hex[i:i+8] for i in range(0, len(ik_hex), 8)]) + xmlui.addText(fp_human) + xmlui.addEmpty() + xmlui.addEmpty() + + + for trust_id, data in trust_data.iteritems(): + xmlui.addLabel(D_(u"Contact")) + xmlui.addJid(data[u'jid']) + xmlui.addLabel(D_(u"Device ID")) + xmlui.addText(unicode(data[u'device'])) + xmlui.addLabel(D_(u"Fingerprint")) + ik_hex = data[u'ik'].encode('hex').upper() + fp_human = u' '.join([ik_hex[i:i+8] for i in range(0, len(ik_hex), 8)]) + xmlui.addText(fp_human) + xmlui.addLabel(D_(u"Trust this device?")) + xmlui.addBool(u"trust_{}".format(trust_id), + value=C.boolConst(data.get(u'trusted', False))) + + xmlui.addEmpty() + xmlui.addEmpty() + + defer.returnValue(xmlui) + + @defer.inlineCallbacks + def _purgeOldData(self, client, persistent_dict): + # FIXME: temporary method to deal with data change in omemo module + # We remove the old data, which is acceptable as + # no release of SàT (beside alpha versions) has been done + # since this data has been used. + # /!\ this method must be removed before 0.7 release /!\ + log.warning(u"FIXME: Using temporary purgeOldData code, to be removed before 0.7 release.") + + state = yield persistent_dict.get(KEY_STATE) + if state and "version" not in state: + log.info(u"Old data found, purging it") + self.host.memory.storage.delPrivateNamespace("XEP-0384", binary=True, + profile=client.profile) + + @defer.inlineCallbacks def profileConnected(self, client): + client._xep_0384_ready = defer.Deferred() # we first need to get devices ids (including our own) persistent_dict = persistent.LazyPersistentBinaryDict("XEP-0384", client.profile) + yield self._purgeOldData(client, persistent_dict) # all known devices of profile devices = yield self.getDevices(client) # and our own device id device_id = yield persistent_dict.get(KEY_DEVICE_ID) if device_id is None: + log.info(_(u"We have no identity for this device yet, let's generate one")) # we have a new device, we create device_id device_id = random.randint(1, 2**31-1) # we check that it's really unique @@ -290,17 +554,20 @@ devices.add(device_id) yield self.setDevices(client, devices) - omemo_storage = OmemoStorage(client, device_id, persistent_dict) + all_jids = yield persistent_dict.get(KEY_ALL_JIDS, set()) + + omemo_storage = OmemoStorage(client, device_id, all_jids, persistent_dict) omemo_session = yield OmemoSession.create(client, omemo_storage, device_id) client._xep_0384_cache = {} client._xep_0384_session = omemo_session client._xep_0384_device_id = device_id - yield omemo_session.newDeviceList(devices, client.jid) - if omemo_session.state.changed: + yield omemo_session.newDeviceList(client.jid, devices) + if omemo_session.republish_bundle: log.info(_(u"Saving public bundle for this device ({device_id})").format( device_id=device_id)) - bundle = omemo_session.state.getPublicBundle() - yield self.setBundle(client, bundle, device_id) + yield self.setBundle(client, omemo_session.public_bundle, device_id) + client._xep_0384_ready.callback(None) + del client._xep_0384_ready ## XMPP PEP nodes manipulation @@ -376,20 +643,29 @@ @param entity_jid(jid.JID): bare jid of entity @param devices_id(iterable[int]): ids of the devices bundles to retrieve - @return (dict[int, ExtendedPublicBundle]): bundles collection - key is device_id - value is parsed bundle + @return (tuple(dict[int, ExtendedPublicBundle], list(int))): + - bundles collection: + * key is device_id + * value is parsed bundle + - set of bundles not found """ assert not entity_jid.resource bundles = {} + missing = set() for device_id in devices_ids: node = NS_OMEMO_BUNDLE.format(device_id=device_id) try: items, metadata = yield self._p.getItems(client, entity_jid, node) - except Exception as e: - log.warning(_(u"Can't get bundle for device {device_id}: {reason}") - .format(device_id=device_id, reason=e)) - continue + except error.StanzaError as e: + if e.condition == u"item-not-found": + log.warning(_(u"Bundle missing for device {device_id}") + .format(device_id=device_id)) + missing.add(device_id) + continue + else: + log.warning(_(u"Can't get bundle for device {device_id}: {reason}") + .format(device_id=device_id, reason=e)) + continue if not items: log.warning(_(u"no item found in node {node}, can't get public bundle " u"for device {device_id}").format(node=node, @@ -419,17 +695,16 @@ spkSignature = base64.b64decode( unicode(signedPreKeySignature_elt)) - identityKey = base64.b64decode(unicode(identityKey_elt)) + ik = base64.b64decode(unicode(identityKey_elt)) spk = { - "key": wireformat.decodePublicKey(spkPublic), + "key": spkPublic, "id": int(signedPreKeyPublic_elt['signedPreKeyId']) } - ik = wireformat.decodePublicKey(identityKey) otpks = [] for preKeyPublic_elt in prekeys_elt.elements(NS_OMEMO, 'preKeyPublic'): preKeyPublic = base64.b64decode(unicode(preKeyPublic_elt)) otpk = { - "key": wireformat.decodePublicKey(preKeyPublic), + "key": preKeyPublic, "id": int(preKeyPublic_elt['preKeyId']) } otpks.append(otpk) @@ -439,9 +714,10 @@ .format(device_id=device_id, msg=e)) continue - bundles[device_id] = ExtendedPublicBundle(ik, spk, spkSignature, otpks) + bundles[device_id] = ExtendedPublicBundle.parse(omemo_backend, ik, spk, + spkSignature, otpks) - defer.returnValue(bundles) + defer.returnValue((bundles, missing)) def setBundleEb(self, failure_): log.warning(_(u"Can't set bundle: {reason}").format(reason=failure_)) @@ -452,25 +728,26 @@ @param bundle(ExtendedPublicBundle): bundle to publish """ log.debug(_(u"updating bundle for {device_id}").format(device_id=device_id)) + bundle = bundle.serialize(omemo_backend) bundle_elt = domish.Element((NS_OMEMO, 'bundle')) signedPreKeyPublic_elt = bundle_elt.addElement( "signedPreKeyPublic", - content=b64enc(wireformat.encodePublicKey(bundle.spk['key']))) - signedPreKeyPublic_elt['signedPreKeyId'] = unicode(bundle.spk['id']) + content=b64enc(bundle["spk"]['key'])) + signedPreKeyPublic_elt['signedPreKeyId'] = unicode(bundle["spk"]['id']) bundle_elt.addElement( "signedPreKeySignature", - content=b64enc(bundle.spk_signature)) + content=b64enc(bundle["spk_signature"])) bundle_elt.addElement( "identityKey", - content=b64enc(wireformat.encodePublicKey(bundle.ik))) + content=b64enc(bundle["ik"])) prekeys_elt = bundle_elt.addElement('prekeys') - for otpk in bundle.otpks: + for otpk in bundle["otpks"]: preKeyPublic_elt = prekeys_elt.addElement( 'preKeyPublic', - content=b64enc(wireformat.encodePublicKey(otpk["key"]))) + content=b64enc(otpk["key"])) preKeyPublic_elt['preKeyId'] = unicode(otpk['id']) node = NS_OMEMO_BUNDLE.format(device_id=device_id) @@ -488,27 +765,121 @@ entity = itemsEvent.sender entity_cache = cache.setdefault(entity, {}) devices = self.parseDevices(itemsEvent.items) - omemo_session.newDeviceList(devices, entity) + omemo_session.newDeviceList(entity, devices) missing_devices = devices.difference(entity_cache.keys()) if missing_devices: - missing_bundles = yield self.getBundles(client, entity, missing_devices) - entity_cache.update(missing_bundles) + bundles, bundles_not_found = yield self.getBundles( + client, entity, missing_devices) + entity_cache.update(bundles) + if bundles_not_found and entity == client.jid.userhostJID(): + # we have devices announced in our own public list + # with missing bundles + own_device = client._xep_0384_device_id + if own_device in bundles_not_found: + log.warning(_(u"Our own device has no attached bundle, fixing it")) + bundles_not_found.remove(own_device) + yield self.setBundle(client, omemo_session.public_bundle, own_device) + + if bundles_not_found: + # some announced devices have no bundle, we update our public + # list to remove missing devices. + log.warning(_( + u"Some devices have missing bundles, cleaning out public " + u"devices list")) + existing_devices = devices - bundles_not_found + yield self.setDevices(client, existing_devices) ## triggers @defer.inlineCallbacks + def handleProblems(self, client, bundles, problems): + """Try to solve problem found by EncryptMessage + + @param bundles(dict): bundles data as used in EncryptMessage + already filled with known bundles, missing bundles + need to be added to it + @param problems(list): exceptions raised by EncryptMessage + @return (dict): expect_problems arguments, used in EncryptMessage + this dict will list devices where problems can be ignored + (those devices won't receive the encrypted data) + """ + # FIXME: not all problems are handled yet + untrusted = {} + expect_problems = {} + for problem in problems: + if isinstance(problem, omemo_excpt.UntrustedException): + untrusted[unicode(hash(problem))] = problem + elif isinstance(problem, omemo_excpt.NoEligibleDevicesException): + pass + + if untrusted: + trust_data = {} + for device_id, data in untrusted.iteritems(): + trust_data[u'jid'] = jid.JID(data.bare_jid) + trust_data[u'device'] = data.device + trust_data[u'ik'] = data.ik + + xmlui = yield self.getTrustUI(client, trust_data, submit_id=u"") + + answer = yield xml_tools.deferXMLUI( + self.host, + xmlui, + action_extra={ + u"meta_encryption_trust": NS_OMEMO, + }, + profile=client.profile) + yield self.trustUICb(answer, trust_data, expect_problems, client.profile) + + defer.returnValue(expect_problems) + + @defer.inlineCallbacks def encryptMessage(self, client, entity_bare_jid, message): omemo_session = client._xep_0384_session + cache = client._xep_0384_cache try: - bundles = client._xep_0384_cache[entity_bare_jid] + bundles = {entity_bare_jid: cache[entity_bare_jid]} except KeyError: - raise exceptions.NotFound(_(u"No OMEMO encryption information found for this" - u"contact ({entity})".format( - entity=entity_bare_jid.full()))) - encrypted = yield omemo_session.encryptMessage( - entity_bare_jid, - message, - {entity_bare_jid: bundles}) + # No devices know for this entity, let try to find them. + # This can happen if the entity is not in our roster, or doesn't handle OMEMO + # or if we haven't received the devices from PEP yet. + try: + devices = yield self.getDevices(client, entity_bare_jid) + bundles, __ = yield self.getBundles(client, entity_bare_jid, devices) + except Exception as e: + raise exceptions.NotFound( + _(u"Can retrieve bundles for {entity}: {reason}" .format( + entity=entity_bare_jid.full(), reason=e))) + else: + cache[entity_bare_jid] = bundles + bundles = {entity_bare_jid: bundles} + + own_jid = client.jid.userhostJID() + if entity_bare_jid != own_jid: + # message will be copied to our devices, so we need to add our own bundles + bundles[own_jid] = cache[own_jid] + + try: + # first try may fail, in case of e.g. trust issue or missing bundle + encrypted = yield omemo_session.encryptMessage( + entity_bare_jid, + message, + bundles) + except omemo_excpt.EncryptionProblemsException as e: + # we know the problem to solve, we can try to fix them + expect_problems = yield self.handleProblems(client, bundles, e.problems) + # and try an encryption again. + try: + encrypted = yield omemo_session.encryptMessage( + entity_bare_jid, + message, + bundles, + expect_problems = expect_problems) + except omemo_excpt.EncryptionProblemsException as e: + log.warning( + _(u"Can't encrypt message for {entity}: {reason}".format( + entity=entity_bare_jid.full(), reason=e))) + raise e + defer.returnValue(encrypted) @defer.inlineCallbacks @@ -523,7 +894,14 @@ # we have an encrypted message let's decrypt it from_jid = jid.JID(message_elt['from']) - omemo_session = client._xep_0384_session + try: + omemo_session = client._xep_0384_session + except AttributeError: + # on startup, message can ve received before session actually exists + # so we need to synchronise here + yield client._xep_0384_ready + omemo_session = client._xep_0384_session + device_id = client._xep_0384_device_id try: header_elt = next(encrypted_elt.elements(NS_OMEMO, u'header')) @@ -543,37 +921,48 @@ key_elt = next((e for e in header_elt.elements(NS_OMEMO, u'key') if int(e[u'rid']) == device_id)) except StopIteration: - log.warning(_(u"This OMEMO encrypted stanza has not been encrypted" - u"for our device ({device_id}): {xml}").format( - device_id=device_id, xml=encrypted_elt.toXml())) + log.warning(_(u"This OMEMO encrypted stanza has not been encrypted " + u"for our device (device_id: {device_id}, fingerprint: " + u"{fingerprint}): {xml}").format( + device_id=device_id, + fingerprint=omemo_session.public_bundle.ik.encode('hex'), + xml=encrypted_elt.toXml())) defer.returnValue(False) except ValueError as e: log.warning(_(u"Invalid recipient ID: {msg}".format(msg=e))) defer.returnValue(False) is_pre_key = C.bool(key_elt.getAttribute('prekey', 'false')) payload_elt = next(encrypted_elt.elements(NS_OMEMO, u'payload'), None) + additional_information = { + "from_storage": bool(message_elt.delay) + } + kwargs = { + "bare_jid": from_jid.userhostJID(), + "device": s_device_id, + "iv": base64.b64decode(bytes(iv_elt)), + "message": base64.b64decode(bytes(key_elt)), + "is_pre_key_message": is_pre_key, + "ciphertext": base64.b64decode(bytes(payload_elt)) + if payload_elt is not None else None, + "additional_information": additional_information, + } try: - cipher, plaintext = yield omemo_session.decryptMessage( - bare_jid=from_jid.userhostJID(), - device=s_device_id, - iv=base64.b64decode(bytes(iv_elt)), - message=base64.b64decode(bytes(key_elt)), - is_pre_key_message=is_pre_key, - payload=base64.b64decode(bytes(payload_elt)) - if payload_elt is not None else None, - from_storage=False - ) + try: + plaintext = yield omemo_session.decryptMessage(**kwargs) + except omemo_excpt.UntrustedException: + post_treat.addCallback(client.encryption.markAsUntrusted) + kwargs['allow_untrusted'] = True + plaintext = yield omemo_session.decryptMessage(**kwargs) except Exception as e: - log.error(_(u"Can't decrypt message: {reason}\n{xml}").format( + log.warning(_(u"Can't decrypt message: {reason}\n{xml}").format( reason=e, xml=message_elt.toXml())) defer.returnValue(False) - if omemo_session.state.changed: - bundle = omemo_session.state.getPublicBundle() + if omemo_session.republish_bundle: # we don't wait for the Deferred (i.e. no yield) on purpose # there is no need to block the whole message workflow while # updating the bundle - self.setBundle(client, bundle, device_id) + self.setBundle(client, omemo_session.public_bundle, device_id) message_elt.children.remove(encrypted_elt) if plaintext: @@ -612,13 +1001,12 @@ header_elt['sid'] = unicode(encryption_data['sid']) bare_jid_s = to_jid.userhost() - for message in (m for m in encryption_data['messages'] - if m['bare_jid'] == bare_jid_s): + for rid, data in encryption_data['keys'][bare_jid_s].iteritems(): key_elt = header_elt.addElement( 'key', - content=b64enc(message['message'])) - key_elt['rid'] = unicode(message['rid']) - if message['pre_key']: + content=b64enc(data['data'])) + key_elt['rid'] = unicode(rid) + if data['pre_key']: key_elt['prekey'] = 'true' header_elt.addElement(
--- a/setup.py Wed Jan 02 18:32:16 2019 +0100 +++ b/setup.py Wed Jan 02 18:50:28 2019 +0100 @@ -43,14 +43,15 @@ 'python-dateutil', 'python-potr', 'pyxdg', - 'sat_tmp>=0.0.3', + 'sat_tmp >= 0.0.3', 'service_identity', 'shortuuid', 'twisted >= 15.2.0', 'urwid >= 1.2.0', 'urwid-satext >= 0.6.1', 'wokkel >= 0.7.1', - 'omemo', + 'omemo >= 0.10.3', + 'omemo_backend_signal', ] DBUS_DIR = 'dbus-1/services'