280 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			Python
		
	
	
			
		
		
	
	
			280 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			Python
		
	
	
# -*- coding: utf-8 -*-
 | 
						|
# Copyright 2016 OpenMarket Ltd
 | 
						|
#
 | 
						|
# Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
# you may not use this file except in compliance with the License.
 | 
						|
# You may obtain a copy of the License at
 | 
						|
#
 | 
						|
#     http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
#
 | 
						|
# Unless required by applicable law or agreed to in writing, software
 | 
						|
# distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
# See the License for the specific language governing permissions and
 | 
						|
# limitations under the License.
 | 
						|
 | 
						|
import ujson as json
 | 
						|
import logging
 | 
						|
 | 
						|
from canonicaljson import encode_canonical_json
 | 
						|
from twisted.internet import defer
 | 
						|
 | 
						|
from synapse.api.errors import SynapseError, CodeMessageException
 | 
						|
from synapse.types import get_domain_from_id
 | 
						|
from synapse.util.logcontext import preserve_fn, preserve_context_over_deferred
 | 
						|
from synapse.util.retryutils import get_retry_limiter, NotRetryingDestination
 | 
						|
 | 
						|
logger = logging.getLogger(__name__)
 | 
						|
 | 
						|
 | 
						|
class E2eKeysHandler(object):
 | 
						|
    def __init__(self, hs):
 | 
						|
        self.store = hs.get_datastore()
 | 
						|
        self.federation = hs.get_replication_layer()
 | 
						|
        self.device_handler = hs.get_device_handler()
 | 
						|
        self.is_mine_id = hs.is_mine_id
 | 
						|
        self.clock = hs.get_clock()
 | 
						|
 | 
						|
        # doesn't really work as part of the generic query API, because the
 | 
						|
        # query request requires an object POST, but we abuse the
 | 
						|
        # "query handler" interface.
 | 
						|
        self.federation.register_query_handler(
 | 
						|
            "client_keys", self.on_federation_query_client_keys
 | 
						|
        )
 | 
						|
 | 
						|
    @defer.inlineCallbacks
 | 
						|
    def query_devices(self, query_body, timeout):
 | 
						|
        """ Handle a device key query from a client
 | 
						|
 | 
						|
        {
 | 
						|
            "device_keys": {
 | 
						|
                "<user_id>": ["<device_id>"]
 | 
						|
            }
 | 
						|
        }
 | 
						|
        ->
 | 
						|
        {
 | 
						|
            "device_keys": {
 | 
						|
                "<user_id>": {
 | 
						|
                    "<device_id>": {
 | 
						|
                        ...
 | 
						|
                    }
 | 
						|
                }
 | 
						|
            }
 | 
						|
        }
 | 
						|
        """
 | 
						|
        device_keys_query = query_body.get("device_keys", {})
 | 
						|
 | 
						|
        # separate users by domain.
 | 
						|
        # make a map from domain to user_id to device_ids
 | 
						|
        local_query = {}
 | 
						|
        remote_queries = {}
 | 
						|
 | 
						|
        for user_id, device_ids in device_keys_query.items():
 | 
						|
            if self.is_mine_id(user_id):
 | 
						|
                local_query[user_id] = device_ids
 | 
						|
            else:
 | 
						|
                domain = get_domain_from_id(user_id)
 | 
						|
                remote_queries.setdefault(domain, {})[user_id] = device_ids
 | 
						|
 | 
						|
        # do the queries
 | 
						|
        failures = {}
 | 
						|
        results = {}
 | 
						|
        if local_query:
 | 
						|
            local_result = yield self.query_local_devices(local_query)
 | 
						|
            for user_id, keys in local_result.items():
 | 
						|
                if user_id in local_query:
 | 
						|
                    results[user_id] = keys
 | 
						|
 | 
						|
        @defer.inlineCallbacks
 | 
						|
        def do_remote_query(destination):
 | 
						|
            destination_query = remote_queries[destination]
 | 
						|
            try:
 | 
						|
                limiter = yield get_retry_limiter(
 | 
						|
                    destination, self.clock, self.store
 | 
						|
                )
 | 
						|
                with limiter:
 | 
						|
                    remote_result = yield self.federation.query_client_keys(
 | 
						|
                        destination,
 | 
						|
                        {"device_keys": destination_query},
 | 
						|
                        timeout=timeout
 | 
						|
                    )
 | 
						|
 | 
						|
                for user_id, keys in remote_result["device_keys"].items():
 | 
						|
                    if user_id in destination_query:
 | 
						|
                        results[user_id] = keys
 | 
						|
 | 
						|
            except CodeMessageException as e:
 | 
						|
                failures[destination] = {
 | 
						|
                    "status": e.code, "message": e.message
 | 
						|
                }
 | 
						|
            except NotRetryingDestination as e:
 | 
						|
                failures[destination] = {
 | 
						|
                    "status": 503, "message": "Not ready for retry",
 | 
						|
                }
 | 
						|
 | 
						|
        yield preserve_context_over_deferred(defer.gatherResults([
 | 
						|
            preserve_fn(do_remote_query)(destination)
 | 
						|
            for destination in remote_queries
 | 
						|
        ]))
 | 
						|
 | 
						|
        defer.returnValue({
 | 
						|
            "device_keys": results, "failures": failures,
 | 
						|
        })
 | 
						|
 | 
						|
    @defer.inlineCallbacks
 | 
						|
    def query_local_devices(self, query):
 | 
						|
        """Get E2E device keys for local users
 | 
						|
 | 
						|
        Args:
 | 
						|
            query (dict[string, list[string]|None): map from user_id to a list
 | 
						|
                 of devices to query (None for all devices)
 | 
						|
 | 
						|
        Returns:
 | 
						|
            defer.Deferred: (resolves to dict[string, dict[string, dict]]):
 | 
						|
                 map from user_id -> device_id -> device details
 | 
						|
        """
 | 
						|
        local_query = []
 | 
						|
 | 
						|
        result_dict = {}
 | 
						|
        for user_id, device_ids in query.items():
 | 
						|
            if not self.is_mine_id(user_id):
 | 
						|
                logger.warning("Request for keys for non-local user %s",
 | 
						|
                               user_id)
 | 
						|
                raise SynapseError(400, "Not a user here")
 | 
						|
 | 
						|
            if not device_ids:
 | 
						|
                local_query.append((user_id, None))
 | 
						|
            else:
 | 
						|
                for device_id in device_ids:
 | 
						|
                    local_query.append((user_id, device_id))
 | 
						|
 | 
						|
            # make sure that each queried user appears in the result dict
 | 
						|
            result_dict[user_id] = {}
 | 
						|
 | 
						|
        results = yield self.store.get_e2e_device_keys(local_query)
 | 
						|
 | 
						|
        # Build the result structure, un-jsonify the results, and add the
 | 
						|
        # "unsigned" section
 | 
						|
        for user_id, device_keys in results.items():
 | 
						|
            for device_id, device_info in device_keys.items():
 | 
						|
                r = json.loads(device_info["key_json"])
 | 
						|
                r["unsigned"] = {}
 | 
						|
                display_name = device_info["device_display_name"]
 | 
						|
                if display_name is not None:
 | 
						|
                    r["unsigned"]["device_display_name"] = display_name
 | 
						|
                result_dict[user_id][device_id] = r
 | 
						|
 | 
						|
        defer.returnValue(result_dict)
 | 
						|
 | 
						|
    @defer.inlineCallbacks
 | 
						|
    def on_federation_query_client_keys(self, query_body):
 | 
						|
        """ Handle a device key query from a federated server
 | 
						|
        """
 | 
						|
        device_keys_query = query_body.get("device_keys", {})
 | 
						|
        res = yield self.query_local_devices(device_keys_query)
 | 
						|
        defer.returnValue({"device_keys": res})
 | 
						|
 | 
						|
    @defer.inlineCallbacks
 | 
						|
    def claim_one_time_keys(self, query, timeout):
 | 
						|
        local_query = []
 | 
						|
        remote_queries = {}
 | 
						|
 | 
						|
        for user_id, device_keys in query.get("one_time_keys", {}).items():
 | 
						|
            if self.is_mine_id(user_id):
 | 
						|
                for device_id, algorithm in device_keys.items():
 | 
						|
                    local_query.append((user_id, device_id, algorithm))
 | 
						|
            else:
 | 
						|
                domain = get_domain_from_id(user_id)
 | 
						|
                remote_queries.setdefault(domain, {})[user_id] = device_keys
 | 
						|
 | 
						|
        results = yield self.store.claim_e2e_one_time_keys(local_query)
 | 
						|
 | 
						|
        json_result = {}
 | 
						|
        failures = {}
 | 
						|
        for user_id, device_keys in results.items():
 | 
						|
            for device_id, keys in device_keys.items():
 | 
						|
                for key_id, json_bytes in keys.items():
 | 
						|
                    json_result.setdefault(user_id, {})[device_id] = {
 | 
						|
                        key_id: json.loads(json_bytes)
 | 
						|
                    }
 | 
						|
 | 
						|
        @defer.inlineCallbacks
 | 
						|
        def claim_client_keys(destination):
 | 
						|
            device_keys = remote_queries[destination]
 | 
						|
            try:
 | 
						|
                limiter = yield get_retry_limiter(
 | 
						|
                    destination, self.clock, self.store
 | 
						|
                )
 | 
						|
                with limiter:
 | 
						|
                    remote_result = yield self.federation.claim_client_keys(
 | 
						|
                        destination,
 | 
						|
                        {"one_time_keys": device_keys},
 | 
						|
                        timeout=timeout
 | 
						|
                    )
 | 
						|
                    for user_id, keys in remote_result["one_time_keys"].items():
 | 
						|
                        if user_id in device_keys:
 | 
						|
                            json_result[user_id] = keys
 | 
						|
            except CodeMessageException as e:
 | 
						|
                failures[destination] = {
 | 
						|
                    "status": e.code, "message": e.message
 | 
						|
                }
 | 
						|
            except NotRetryingDestination as e:
 | 
						|
                failures[destination] = {
 | 
						|
                    "status": 503, "message": "Not ready for retry",
 | 
						|
                }
 | 
						|
 | 
						|
        yield preserve_context_over_deferred(defer.gatherResults([
 | 
						|
            preserve_fn(claim_client_keys)(destination)
 | 
						|
            for destination in remote_queries
 | 
						|
        ]))
 | 
						|
 | 
						|
        defer.returnValue({
 | 
						|
            "one_time_keys": json_result,
 | 
						|
            "failures": failures
 | 
						|
        })
 | 
						|
 | 
						|
    @defer.inlineCallbacks
 | 
						|
    def upload_keys_for_user(self, user_id, device_id, keys):
 | 
						|
        time_now = self.clock.time_msec()
 | 
						|
 | 
						|
        # TODO: Validate the JSON to make sure it has the right keys.
 | 
						|
        device_keys = keys.get("device_keys", None)
 | 
						|
        if device_keys:
 | 
						|
            logger.info(
 | 
						|
                "Updating device_keys for device %r for user %s at %d",
 | 
						|
                device_id, user_id, time_now
 | 
						|
            )
 | 
						|
            # TODO: Sign the JSON with the server key
 | 
						|
            yield self.store.set_e2e_device_keys(
 | 
						|
                user_id, device_id, time_now,
 | 
						|
                encode_canonical_json(device_keys)
 | 
						|
            )
 | 
						|
 | 
						|
        one_time_keys = keys.get("one_time_keys", None)
 | 
						|
        if one_time_keys:
 | 
						|
            logger.info(
 | 
						|
                "Adding %d one_time_keys for device %r for user %r at %d",
 | 
						|
                len(one_time_keys), device_id, user_id, time_now
 | 
						|
            )
 | 
						|
            key_list = []
 | 
						|
            for key_id, key_json in one_time_keys.items():
 | 
						|
                algorithm, key_id = key_id.split(":")
 | 
						|
                key_list.append((
 | 
						|
                    algorithm, key_id, encode_canonical_json(key_json)
 | 
						|
                ))
 | 
						|
 | 
						|
            yield self.store.add_e2e_one_time_keys(
 | 
						|
                user_id, device_id, time_now, key_list
 | 
						|
            )
 | 
						|
 | 
						|
        # the device should have been registered already, but it may have been
 | 
						|
        # deleted due to a race with a DELETE request. Or we may be using an
 | 
						|
        # old access_token without an associated device_id. Either way, we
 | 
						|
        # need to double-check the device is registered to avoid ending up with
 | 
						|
        # keys without a corresponding device.
 | 
						|
        self.device_handler.check_device_registered(user_id, device_id)
 | 
						|
 | 
						|
        result = yield self.store.count_e2e_one_time_keys(user_id, device_id)
 | 
						|
 | 
						|
        defer.returnValue({"one_time_key_counts": result})
 |