2015-01-23 11:54:51 -07:00
|
|
|
# -*- coding: utf-8 -*-
|
2016-01-06 21:26:29 -07:00
|
|
|
# Copyright 2014-2016 OpenMarket Ltd
|
2015-01-23 11:54:51 -07:00
|
|
|
#
|
|
|
|
# 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.
|
|
|
|
|
|
|
|
"""This module contains base REST classes for constructing client v1 servlets.
|
|
|
|
"""
|
2017-12-04 08:47:27 -07:00
|
|
|
import logging
|
2015-01-23 11:54:51 -07:00
|
|
|
import re
|
|
|
|
|
2017-12-04 08:47:27 -07:00
|
|
|
from twisted.internet import defer
|
2015-01-23 11:54:51 -07:00
|
|
|
|
2017-12-04 08:47:27 -07:00
|
|
|
from synapse.api.errors import InteractiveAuthIncompleteError
|
2019-05-15 10:37:46 -06:00
|
|
|
from synapse.api.urls import CLIENT_API_PREFIX
|
2015-01-23 11:54:51 -07:00
|
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
|
|
|
2019-06-03 05:28:59 -06:00
|
|
|
def client_patterns(path_regex, releases=(0,), unstable=True, v1=False):
|
2015-01-23 11:54:51 -07:00
|
|
|
"""Creates a regex compiled client path with the correct client path
|
|
|
|
prefix.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
path_regex (str): The regex string to match. This should NOT have a ^
|
2020-01-22 06:36:43 -07:00
|
|
|
as this will be prefixed.
|
2015-01-23 11:54:51 -07:00
|
|
|
Returns:
|
|
|
|
SRE_Pattern
|
|
|
|
"""
|
2016-07-20 09:34:00 -06:00
|
|
|
patterns = []
|
2019-09-06 04:35:28 -06:00
|
|
|
|
2016-07-20 09:34:00 -06:00
|
|
|
if unstable:
|
2019-05-15 10:37:46 -06:00
|
|
|
unstable_prefix = CLIENT_API_PREFIX + "/unstable"
|
2016-07-20 09:34:00 -06:00
|
|
|
patterns.append(re.compile("^" + unstable_prefix + path_regex))
|
2019-06-03 05:28:59 -06:00
|
|
|
if v1:
|
|
|
|
v1_prefix = CLIENT_API_PREFIX + "/api/v1"
|
|
|
|
patterns.append(re.compile("^" + v1_prefix + path_regex))
|
2015-12-01 10:34:32 -07:00
|
|
|
for release in releases:
|
2019-05-15 10:37:46 -06:00
|
|
|
new_prefix = CLIENT_API_PREFIX + "/r%d" % (release,)
|
2015-12-01 10:34:32 -07:00
|
|
|
patterns.append(re.compile("^" + new_prefix + path_regex))
|
2019-09-06 04:35:28 -06:00
|
|
|
|
2015-12-01 10:34:32 -07:00
|
|
|
return patterns
|
2017-05-13 10:17:54 -06:00
|
|
|
|
|
|
|
|
|
|
|
def set_timeline_upper_limit(filter_json, filter_timeline_limit):
|
|
|
|
if filter_timeline_limit < 0:
|
|
|
|
return # no upper limits
|
2019-06-20 03:32:02 -06:00
|
|
|
timeline = filter_json.get("room", {}).get("timeline", {})
|
|
|
|
if "limit" in timeline:
|
|
|
|
filter_json["room"]["timeline"]["limit"] = min(
|
|
|
|
filter_json["room"]["timeline"]["limit"], filter_timeline_limit
|
|
|
|
)
|
2017-12-04 08:47:27 -07:00
|
|
|
|
|
|
|
|
|
|
|
def interactive_auth_handler(orig):
|
|
|
|
"""Wraps an on_POST method to handle InteractiveAuthIncompleteErrors
|
|
|
|
|
|
|
|
Takes a on_POST method which returns a deferred (errcode, body) response
|
|
|
|
and adds exception handling to turn a InteractiveAuthIncompleteError into
|
|
|
|
a 401 response.
|
|
|
|
|
|
|
|
Normal usage is:
|
|
|
|
|
|
|
|
@interactive_auth_handler
|
|
|
|
@defer.inlineCallbacks
|
|
|
|
def on_POST(self, request):
|
|
|
|
# ...
|
|
|
|
yield self.auth_handler.check_auth
|
|
|
|
"""
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2017-12-04 08:47:27 -07:00
|
|
|
def wrapped(*args, **kwargs):
|
2019-12-05 09:46:37 -07:00
|
|
|
res = defer.ensureDeferred(orig(*args, **kwargs))
|
2017-12-04 08:47:27 -07:00
|
|
|
res.addErrback(_catch_incomplete_interactive_auth)
|
|
|
|
return res
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2017-12-04 08:47:27 -07:00
|
|
|
return wrapped
|
|
|
|
|
|
|
|
|
|
|
|
def _catch_incomplete_interactive_auth(f):
|
|
|
|
"""helper for interactive_auth_handler
|
|
|
|
|
|
|
|
Catches InteractiveAuthIncompleteErrors and turns them into 401 responses
|
|
|
|
|
|
|
|
Args:
|
|
|
|
f (failure.Failure):
|
|
|
|
"""
|
|
|
|
f.trap(InteractiveAuthIncompleteError)
|
|
|
|
return 401, f.value.result
|