2014-08-12 10:10:52 -04:00
|
|
|
# -*- coding: utf-8 -*-
|
2016-01-06 23:26:29 -05:00
|
|
|
# Copyright 2014-2016 OpenMarket Ltd
|
2014-08-12 10:10:52 -04: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.
|
2014-08-12 22:14:34 -04:00
|
|
|
|
2018-07-09 02:09:20 -04:00
|
|
|
import logging
|
|
|
|
import xml.etree.ElementTree as ET
|
|
|
|
|
2018-09-12 06:41:31 -04:00
|
|
|
from six.moves import urllib
|
2015-07-07 08:10:30 -04:00
|
|
|
|
2017-03-14 09:37:36 -04:00
|
|
|
from twisted.web.client import PartialDownloadError
|
|
|
|
|
2018-07-09 02:09:20 -04:00
|
|
|
from synapse.api.errors import Codes, LoginError, SynapseError
|
2019-03-15 13:46:16 -04:00
|
|
|
from synapse.api.ratelimiting import Ratelimiter
|
2018-07-09 02:09:20 -04:00
|
|
|
from synapse.http.server import finish_request
|
2018-12-07 07:10:07 -05:00
|
|
|
from synapse.http.servlet import (
|
|
|
|
RestServlet,
|
|
|
|
parse_json_object_from_request,
|
|
|
|
parse_string,
|
|
|
|
)
|
2019-09-13 10:20:49 -04:00
|
|
|
from synapse.http.site import SynapseRequest
|
2019-06-03 07:28:59 -04:00
|
|
|
from synapse.rest.client.v2_alpha._base import client_patterns
|
2018-12-24 04:44:33 -05:00
|
|
|
from synapse.rest.well_known import WellKnownBuilder
|
2018-12-07 07:10:07 -05:00
|
|
|
from synapse.types import UserID, map_username_to_mxid_localpart
|
2018-07-09 02:09:20 -04:00
|
|
|
from synapse.util.msisdn import phone_number_to_msisdn
|
|
|
|
|
2015-07-09 03:28:15 -04:00
|
|
|
logger = logging.getLogger(__name__)
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
|
2017-03-13 13:27:51 -04:00
|
|
|
def login_submission_legacy_convert(submission):
|
|
|
|
"""
|
|
|
|
If the input login submission is an old style object
|
|
|
|
(ie. with top-level user / medium / address) convert it
|
|
|
|
to a typed object.
|
|
|
|
"""
|
|
|
|
if "user" in submission:
|
2019-06-20 05:32:02 -04:00
|
|
|
submission["identifier"] = {"type": "m.id.user", "user": submission["user"]}
|
2017-03-13 13:27:51 -04:00
|
|
|
del submission["user"]
|
|
|
|
|
|
|
|
if "medium" in submission and "address" in submission:
|
|
|
|
submission["identifier"] = {
|
|
|
|
"type": "m.id.thirdparty",
|
|
|
|
"medium": submission["medium"],
|
|
|
|
"address": submission["address"],
|
|
|
|
}
|
|
|
|
del submission["medium"]
|
|
|
|
del submission["address"]
|
|
|
|
|
|
|
|
|
|
|
|
def login_id_thirdparty_from_phone(identifier):
|
|
|
|
"""
|
|
|
|
Convert a phone login identifier type to a generic threepid identifier
|
|
|
|
Args:
|
|
|
|
identifier(dict): Login identifier dict of type 'm.id.phone'
|
|
|
|
|
|
|
|
Returns: Login identifier dict of type 'm.id.threepid'
|
|
|
|
"""
|
|
|
|
if "country" not in identifier or "number" not in identifier:
|
|
|
|
raise SynapseError(400, "Invalid phone-type identifier")
|
|
|
|
|
|
|
|
msisdn = phone_number_to_msisdn(identifier["country"], identifier["number"])
|
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
return {"type": "m.id.thirdparty", "medium": "msisdn", "address": msisdn}
|
2017-03-13 13:27:51 -04:00
|
|
|
|
|
|
|
|
2019-06-03 07:28:59 -04:00
|
|
|
class LoginRestServlet(RestServlet):
|
|
|
|
PATTERNS = client_patterns("/login$", v1=True)
|
2015-10-07 09:45:57 -04:00
|
|
|
CAS_TYPE = "m.login.cas"
|
2018-11-27 02:51:52 -05:00
|
|
|
SSO_TYPE = "m.login.sso"
|
2015-11-05 09:01:12 -05:00
|
|
|
TOKEN_TYPE = "m.login.token"
|
2016-03-28 15:33:40 -04:00
|
|
|
JWT_TYPE = "m.login.jwt"
|
2015-07-07 08:10:30 -04:00
|
|
|
|
|
|
|
def __init__(self, hs):
|
2019-06-03 07:28:59 -04:00
|
|
|
super(LoginRestServlet, self).__init__()
|
|
|
|
self.hs = hs
|
2016-03-28 15:33:40 -04:00
|
|
|
self.jwt_enabled = hs.config.jwt_enabled
|
|
|
|
self.jwt_secret = hs.config.jwt_secret
|
|
|
|
self.jwt_algorithm = hs.config.jwt_algorithm
|
2019-06-02 12:13:20 -04:00
|
|
|
self.saml2_enabled = hs.config.saml2_enabled
|
2015-10-07 09:45:57 -04:00
|
|
|
self.cas_enabled = hs.config.cas_enabled
|
2016-06-02 08:31:45 -04:00
|
|
|
self.auth_handler = self.hs.get_auth_handler()
|
2019-02-20 02:47:31 -05:00
|
|
|
self.registration_handler = hs.get_registration_handler()
|
2016-08-12 05:03:19 -04:00
|
|
|
self.handlers = hs.get_handlers()
|
2019-11-05 12:39:16 -05:00
|
|
|
self._clock = hs.get_clock()
|
2018-12-24 04:44:33 -05:00
|
|
|
self._well_known_builder = WellKnownBuilder(hs)
|
2019-03-15 13:46:16 -04:00
|
|
|
self._address_ratelimiter = Ratelimiter()
|
2019-11-05 12:39:16 -05:00
|
|
|
self._account_ratelimiter = Ratelimiter()
|
|
|
|
self._failed_attempts_ratelimiter = Ratelimiter()
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
def on_GET(self, request):
|
2015-10-22 05:37:04 -04:00
|
|
|
flows = []
|
2016-03-28 15:33:40 -04:00
|
|
|
if self.jwt_enabled:
|
|
|
|
flows.append({"type": LoginRestServlet.JWT_TYPE})
|
2019-06-02 12:13:20 -04:00
|
|
|
if self.saml2_enabled:
|
|
|
|
flows.append({"type": LoginRestServlet.SSO_TYPE})
|
|
|
|
flows.append({"type": LoginRestServlet.TOKEN_TYPE})
|
2015-10-07 09:45:57 -04:00
|
|
|
if self.cas_enabled:
|
2018-11-27 02:51:52 -05:00
|
|
|
flows.append({"type": LoginRestServlet.SSO_TYPE})
|
|
|
|
|
|
|
|
# we advertise CAS for backwards compat, though MSC1721 renamed it
|
|
|
|
# to SSO.
|
2015-10-07 09:45:57 -04:00
|
|
|
flows.append({"type": LoginRestServlet.CAS_TYPE})
|
2015-11-20 09:05:22 -05:00
|
|
|
|
|
|
|
# While its valid for us to advertise this login type generally,
|
|
|
|
# synapse currently only gives out these tokens as part of the
|
|
|
|
# CAS login flow.
|
|
|
|
# Generally we don't want to advertise login flows that clients
|
|
|
|
# don't know how to implement, since they (currently) will always
|
|
|
|
# fall back to the fallback API if they don't understand one of the
|
|
|
|
# login flow types returned.
|
2015-11-19 11:16:49 -05:00
|
|
|
flows.append({"type": LoginRestServlet.TOKEN_TYPE})
|
2017-10-31 06:38:40 -04:00
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
flows.extend(
|
|
|
|
({"type": t} for t in self.auth_handler.get_supported_login_types())
|
|
|
|
)
|
2015-11-19 11:16:49 -05:00
|
|
|
|
2019-08-30 11:28:26 -04:00
|
|
|
return 200, {"flows": flows}
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
def on_OPTIONS(self, request):
|
2019-08-30 11:28:26 -04:00
|
|
|
return 200, {}
|
2014-08-12 10:10:52 -04:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def on_POST(self, request):
|
2019-03-15 13:46:16 -04:00
|
|
|
self._address_ratelimiter.ratelimit(
|
2019-06-20 05:32:02 -04:00
|
|
|
request.getClientIP(),
|
|
|
|
time_now_s=self.hs.clock.time(),
|
2019-03-15 13:46:16 -04:00
|
|
|
rate_hz=self.hs.config.rc_login_address.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_address.burst_count,
|
|
|
|
update=True,
|
|
|
|
)
|
|
|
|
|
2016-03-09 06:26:26 -05:00
|
|
|
login_submission = parse_json_object_from_request(request)
|
2014-08-12 10:10:52 -04:00
|
|
|
try:
|
2019-06-20 05:32:02 -04:00
|
|
|
if self.jwt_enabled and (
|
|
|
|
login_submission["type"] == LoginRestServlet.JWT_TYPE
|
|
|
|
):
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self.do_jwt_login(login_submission)
|
2015-11-05 09:01:12 -05:00
|
|
|
elif login_submission["type"] == LoginRestServlet.TOKEN_TYPE:
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self.do_token_login(login_submission)
|
2014-08-12 10:10:52 -04:00
|
|
|
else:
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self._do_other_login(login_submission)
|
2014-08-12 10:10:52 -04:00
|
|
|
except KeyError:
|
|
|
|
raise SynapseError(400, "Missing JSON keys.")
|
|
|
|
|
2018-12-24 04:44:33 -05:00
|
|
|
well_known_data = self._well_known_builder.get_well_known()
|
|
|
|
if well_known_data:
|
|
|
|
result["well_known"] = well_known_data
|
2019-08-30 11:28:26 -04:00
|
|
|
return 200, result
|
2018-12-24 04:44:33 -05:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def _do_other_login(self, login_submission):
|
2017-10-31 06:38:40 -04:00
|
|
|
"""Handle non-token/saml/jwt logins
|
|
|
|
|
|
|
|
Args:
|
|
|
|
login_submission:
|
2017-03-13 13:27:51 -04:00
|
|
|
|
2017-10-31 06:38:40 -04:00
|
|
|
Returns:
|
2018-12-24 04:44:33 -05:00
|
|
|
dict: HTTP response
|
2017-10-31 06:38:40 -04:00
|
|
|
"""
|
2017-11-01 09:58:01 -04:00
|
|
|
# Log the request we got, but only certain fields to minimise the chance of
|
|
|
|
# logging someone's password (even if they accidentally put it in the wrong
|
|
|
|
# field)
|
|
|
|
logger.info(
|
|
|
|
"Got login request with identifier: %r, medium: %r, address: %r, user: %r",
|
2019-06-20 05:32:02 -04:00
|
|
|
login_submission.get("identifier"),
|
|
|
|
login_submission.get("medium"),
|
|
|
|
login_submission.get("address"),
|
|
|
|
login_submission.get("user"),
|
2017-11-01 10:02:52 -04:00
|
|
|
)
|
2017-03-13 13:27:51 -04:00
|
|
|
login_submission_legacy_convert(login_submission)
|
|
|
|
|
|
|
|
if "identifier" not in login_submission:
|
|
|
|
raise SynapseError(400, "Missing param: identifier")
|
|
|
|
|
|
|
|
identifier = login_submission["identifier"]
|
|
|
|
if "type" not in identifier:
|
|
|
|
raise SynapseError(400, "Login identifier has no type")
|
|
|
|
|
|
|
|
# convert phone type identifiers to generic threepids
|
|
|
|
if identifier["type"] == "m.id.phone":
|
|
|
|
identifier = login_id_thirdparty_from_phone(identifier)
|
|
|
|
|
|
|
|
# convert threepid identifiers to user IDs
|
|
|
|
if identifier["type"] == "m.id.thirdparty":
|
2019-06-20 05:32:02 -04:00
|
|
|
address = identifier.get("address")
|
|
|
|
medium = identifier.get("medium")
|
2017-12-20 14:31:00 -05:00
|
|
|
|
|
|
|
if medium is None or address is None:
|
2017-03-13 13:27:51 -04:00
|
|
|
raise SynapseError(400, "Invalid thirdparty identifier")
|
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
if medium == "email":
|
2017-01-18 08:25:56 -05:00
|
|
|
# For emails, transform the address to lowercase.
|
|
|
|
# We store all email addreses as lowercase in the DB.
|
|
|
|
# (See add_threepid in synapse/handlers/auth.py)
|
|
|
|
address = address.lower()
|
2019-03-26 13:48:30 -04:00
|
|
|
|
2019-11-05 12:39:16 -05:00
|
|
|
# We also apply account rate limiting using the 3PID as a key, as
|
|
|
|
# otherwise using 3PID bypasses the ratelimiting based on user ID.
|
|
|
|
self._failed_attempts_ratelimiter.ratelimit(
|
|
|
|
(medium, address),
|
|
|
|
time_now_s=self._clock.time(),
|
|
|
|
rate_hz=self.hs.config.rc_login_failed_attempts.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_failed_attempts.burst_count,
|
|
|
|
update=False,
|
|
|
|
)
|
|
|
|
|
2019-03-26 13:48:30 -04:00
|
|
|
# Check for login providers that support 3pid login types
|
2019-10-31 11:43:24 -04:00
|
|
|
(
|
|
|
|
canonical_user_id,
|
|
|
|
callback_3pid,
|
2019-12-05 10:53:06 -05:00
|
|
|
) = await self.auth_handler.check_password_provider_3pid(
|
2019-10-31 11:43:24 -04:00
|
|
|
medium, address, login_submission["password"]
|
2019-03-26 13:48:30 -04:00
|
|
|
)
|
|
|
|
if canonical_user_id:
|
|
|
|
# Authentication through password provider and 3pid succeeded
|
2019-11-05 12:39:16 -05:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self._complete_login(
|
2019-06-20 05:32:02 -04:00
|
|
|
canonical_user_id, login_submission, callback_3pid
|
2019-03-26 13:48:30 -04:00
|
|
|
)
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2019-03-26 13:48:30 -04:00
|
|
|
|
|
|
|
# No password providers were able to handle this 3pid
|
|
|
|
# Check local store
|
2019-12-05 10:53:06 -05:00
|
|
|
user_id = await self.hs.get_datastore().get_user_id_by_threepid(
|
2019-06-20 05:32:02 -04:00
|
|
|
medium, address
|
2015-08-04 11:29:54 -04:00
|
|
|
)
|
2015-10-20 06:07:50 -04:00
|
|
|
if not user_id:
|
2019-10-31 06:23:24 -04:00
|
|
|
logger.warning(
|
2019-06-20 05:32:02 -04:00
|
|
|
"unknown 3pid identifier medium %s, address %r", medium, address
|
2017-12-20 14:31:00 -05:00
|
|
|
)
|
2019-11-05 12:39:16 -05:00
|
|
|
# We mark that we've failed to log in here, as
|
|
|
|
# `check_password_provider_3pid` might have returned `None` due
|
|
|
|
# to an incorrect password, rather than the account not
|
|
|
|
# existing.
|
|
|
|
#
|
|
|
|
# If it returned None but the 3PID was bound then we won't hit
|
|
|
|
# this code path, which is fine as then the per-user ratelimit
|
|
|
|
# will kick in below.
|
|
|
|
self._failed_attempts_ratelimiter.can_do_action(
|
|
|
|
(medium, address),
|
|
|
|
time_now_s=self._clock.time(),
|
|
|
|
rate_hz=self.hs.config.rc_login_failed_attempts.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_failed_attempts.burst_count,
|
|
|
|
update=True,
|
|
|
|
)
|
2015-10-21 04:42:07 -04:00
|
|
|
raise LoginError(403, "", errcode=Codes.FORBIDDEN)
|
2017-03-13 13:27:51 -04:00
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
identifier = {"type": "m.id.user", "user": user_id}
|
2017-03-13 13:27:51 -04:00
|
|
|
|
|
|
|
# by this point, the identifier should be an m.id.user: if it's anything
|
|
|
|
# else, we haven't understood it.
|
|
|
|
if identifier["type"] != "m.id.user":
|
|
|
|
raise SynapseError(400, "Unknown login identifier type")
|
|
|
|
if "user" not in identifier:
|
|
|
|
raise SynapseError(400, "User identifier is missing 'user' key")
|
|
|
|
|
2019-11-05 12:39:16 -05:00
|
|
|
if identifier["user"].startswith("@"):
|
|
|
|
qualified_user_id = identifier["user"]
|
|
|
|
else:
|
|
|
|
qualified_user_id = UserID(identifier["user"], self.hs.hostname).to_string()
|
|
|
|
|
|
|
|
# Check if we've hit the failed ratelimit (but don't update it)
|
|
|
|
self._failed_attempts_ratelimiter.ratelimit(
|
|
|
|
qualified_user_id.lower(),
|
|
|
|
time_now_s=self._clock.time(),
|
|
|
|
rate_hz=self.hs.config.rc_login_failed_attempts.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_failed_attempts.burst_count,
|
|
|
|
update=False,
|
2017-10-31 06:38:40 -04:00
|
|
|
)
|
|
|
|
|
2019-11-05 12:39:16 -05:00
|
|
|
try:
|
2019-12-05 10:53:06 -05:00
|
|
|
canonical_user_id, callback = await self.auth_handler.validate_login(
|
2019-11-05 12:39:16 -05:00
|
|
|
identifier["user"], login_submission
|
|
|
|
)
|
|
|
|
except LoginError:
|
|
|
|
# The user has failed to log in, so we need to update the rate
|
|
|
|
# limiter. Using `can_do_action` avoids us raising a ratelimit
|
|
|
|
# exception and masking the LoginError. The actual ratelimiting
|
|
|
|
# should have happened above.
|
|
|
|
self._failed_attempts_ratelimiter.can_do_action(
|
|
|
|
qualified_user_id.lower(),
|
|
|
|
time_now_s=self._clock.time(),
|
|
|
|
rate_hz=self.hs.config.rc_login_failed_attempts.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_failed_attempts.burst_count,
|
|
|
|
update=True,
|
|
|
|
)
|
|
|
|
raise
|
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self._complete_login(
|
2019-06-20 05:32:02 -04:00
|
|
|
canonical_user_id, login_submission, callback
|
2019-03-26 13:48:30 -04:00
|
|
|
)
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2019-03-26 13:48:30 -04:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def _complete_login(
|
2019-11-05 12:39:16 -05:00
|
|
|
self, user_id, login_submission, callback=None, create_non_existant_users=False
|
|
|
|
):
|
|
|
|
"""Called when we've successfully authed the user and now need to
|
|
|
|
actually login them in (e.g. create devices). This gets called on
|
|
|
|
all succesful logins.
|
|
|
|
|
|
|
|
Applies the ratelimiting for succesful login attempts against an
|
|
|
|
account.
|
2019-03-26 13:48:30 -04:00
|
|
|
|
|
|
|
Args:
|
|
|
|
user_id (str): ID of the user to register.
|
|
|
|
login_submission (dict): Dictionary of login information.
|
|
|
|
callback (func|None): Callback function to run after registration.
|
2019-11-05 12:39:16 -05:00
|
|
|
create_non_existant_users (bool): Whether to create the user if
|
|
|
|
they don't exist. Defaults to False.
|
2019-03-26 13:48:30 -04:00
|
|
|
|
|
|
|
Returns:
|
|
|
|
result (Dict[str,str]): Dictionary of account information after
|
|
|
|
successful registration.
|
|
|
|
"""
|
2019-11-05 12:39:16 -05:00
|
|
|
|
|
|
|
# Before we actually log them in we check if they've already logged in
|
|
|
|
# too often. This happens here rather than before as we don't
|
|
|
|
# necessarily know the user before now.
|
|
|
|
self._account_ratelimiter.ratelimit(
|
|
|
|
user_id.lower(),
|
|
|
|
time_now_s=self._clock.time(),
|
|
|
|
rate_hz=self.hs.config.rc_login_account.per_second,
|
|
|
|
burst_count=self.hs.config.rc_login_account.burst_count,
|
|
|
|
update=True,
|
|
|
|
)
|
|
|
|
|
|
|
|
if create_non_existant_users:
|
2019-12-05 10:53:06 -05:00
|
|
|
user_id = await self.auth_handler.check_user_exists(user_id)
|
2019-11-05 12:39:16 -05:00
|
|
|
if not user_id:
|
2019-12-05 10:53:06 -05:00
|
|
|
user_id = await self.registration_handler.register_user(
|
2019-11-05 12:39:16 -05:00
|
|
|
localpart=UserID.from_string(user_id).localpart
|
|
|
|
)
|
|
|
|
|
2019-02-18 11:49:38 -05:00
|
|
|
device_id = login_submission.get("device_id")
|
|
|
|
initial_display_name = login_submission.get("initial_device_display_name")
|
2019-12-05 10:53:06 -05:00
|
|
|
device_id, access_token = await self.registration_handler.register_device(
|
2019-06-20 05:32:02 -04:00
|
|
|
user_id, device_id, initial_display_name
|
2016-07-15 07:34:23 -04:00
|
|
|
)
|
2017-10-31 06:38:40 -04:00
|
|
|
|
2014-08-12 10:10:52 -04:00
|
|
|
result = {
|
2019-03-26 13:48:30 -04:00
|
|
|
"user_id": user_id,
|
2015-08-20 11:21:35 -04:00
|
|
|
"access_token": access_token,
|
2014-08-12 10:10:52 -04:00
|
|
|
"home_server": self.hs.hostname,
|
2016-07-15 08:19:07 -04:00
|
|
|
"device_id": device_id,
|
2014-08-12 10:10:52 -04:00
|
|
|
}
|
|
|
|
|
2017-10-31 11:15:51 -04:00
|
|
|
if callback is not None:
|
2019-12-05 10:53:06 -05:00
|
|
|
await callback(result)
|
2017-10-31 11:15:51 -04:00
|
|
|
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2014-08-12 10:10:52 -04:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def do_token_login(self, login_submission):
|
2019-06-20 05:32:02 -04:00
|
|
|
token = login_submission["token"]
|
2016-06-02 08:31:45 -04:00
|
|
|
auth_handler = self.auth_handler
|
2019-12-05 10:53:06 -05:00
|
|
|
user_id = await auth_handler.validate_short_term_login_token_and_get_user_id(
|
2019-10-31 11:43:24 -04:00
|
|
|
token
|
2015-11-05 09:01:12 -05:00
|
|
|
)
|
2019-02-18 11:49:38 -05:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self._complete_login(user_id, login_submission)
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2015-11-05 09:01:12 -05:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def do_jwt_login(self, login_submission):
|
2016-04-01 13:04:28 -04:00
|
|
|
token = login_submission.get("token", None)
|
2016-03-28 15:33:40 -04:00
|
|
|
if token is None:
|
2016-04-25 09:30:15 -04:00
|
|
|
raise LoginError(
|
2019-06-20 05:32:02 -04:00
|
|
|
401, "Token field for JWT is missing", errcode=Codes.UNAUTHORIZED
|
2016-04-25 09:30:15 -04:00
|
|
|
)
|
|
|
|
|
|
|
|
import jwt
|
|
|
|
from jwt.exceptions import InvalidTokenError
|
2016-03-28 15:33:40 -04:00
|
|
|
|
|
|
|
try:
|
2019-06-20 05:32:02 -04:00
|
|
|
payload = jwt.decode(
|
|
|
|
token, self.jwt_secret, algorithms=[self.jwt_algorithm]
|
|
|
|
)
|
2016-04-01 13:04:28 -04:00
|
|
|
except jwt.ExpiredSignatureError:
|
|
|
|
raise LoginError(401, "JWT expired", errcode=Codes.UNAUTHORIZED)
|
2016-03-28 15:33:40 -04:00
|
|
|
except InvalidTokenError:
|
|
|
|
raise LoginError(401, "Invalid JWT", errcode=Codes.UNAUTHORIZED)
|
|
|
|
|
2016-04-01 13:04:28 -04:00
|
|
|
user = payload.get("sub", None)
|
2016-03-28 15:33:40 -04:00
|
|
|
if user is None:
|
|
|
|
raise LoginError(401, "Invalid JWT", errcode=Codes.UNAUTHORIZED)
|
|
|
|
|
2017-10-20 11:33:15 -04:00
|
|
|
user_id = UserID(user, self.hs.hostname).to_string()
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self._complete_login(
|
2019-11-20 04:29:48 -05:00
|
|
|
user_id, login_submission, create_non_existant_users=True
|
|
|
|
)
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2016-03-28 15:33:40 -04:00
|
|
|
|
2014-08-12 10:10:52 -04:00
|
|
|
|
2019-06-26 19:46:57 -04:00
|
|
|
class BaseSSORedirectServlet(RestServlet):
|
2019-06-10 19:03:57 -04:00
|
|
|
"""Common base class for /login/sso/redirect impls"""
|
2019-06-26 17:34:41 -04:00
|
|
|
|
2019-06-03 07:28:59 -04:00
|
|
|
PATTERNS = client_patterns("/login/(cas|sso)/redirect", v1=True)
|
2015-11-05 09:01:12 -05:00
|
|
|
|
2019-06-10 19:03:57 -04:00
|
|
|
def on_GET(self, request):
|
|
|
|
args = request.args
|
|
|
|
if b"redirectUrl" not in args:
|
|
|
|
return 400, "Redirect URL not specified for SSO auth"
|
|
|
|
client_redirect_url = args[b"redirectUrl"][0]
|
|
|
|
sso_url = self.get_sso_url(client_redirect_url)
|
|
|
|
request.redirect(sso_url)
|
|
|
|
finish_request(request)
|
|
|
|
|
|
|
|
def get_sso_url(self, client_redirect_url):
|
|
|
|
"""Get the URL to redirect to, to perform SSO auth
|
|
|
|
|
|
|
|
Args:
|
|
|
|
client_redirect_url (bytes): the URL that we should redirect the
|
|
|
|
client to when everything is done
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
bytes: URL to redirect to
|
|
|
|
"""
|
|
|
|
# to be implemented by subclasses
|
|
|
|
raise NotImplementedError()
|
|
|
|
|
|
|
|
|
2019-06-26 19:46:57 -04:00
|
|
|
class CasRedirectServlet(BaseSSORedirectServlet):
|
2015-11-05 09:01:12 -05:00
|
|
|
def __init__(self, hs):
|
2018-11-27 02:51:52 -05:00
|
|
|
super(CasRedirectServlet, self).__init__()
|
2019-06-20 05:32:02 -04:00
|
|
|
self.cas_server_url = hs.config.cas_server_url.encode("ascii")
|
|
|
|
self.cas_service_url = hs.config.cas_service_url.encode("ascii")
|
2015-11-05 09:01:12 -05:00
|
|
|
|
2019-06-10 19:03:57 -04:00
|
|
|
def get_sso_url(self, client_redirect_url):
|
2019-06-20 05:32:02 -04:00
|
|
|
client_redirect_url_param = urllib.parse.urlencode(
|
2019-06-26 17:34:41 -04:00
|
|
|
{b"redirectUrl": client_redirect_url}
|
2019-06-20 05:32:02 -04:00
|
|
|
).encode("ascii")
|
|
|
|
hs_redirect_url = self.cas_service_url + b"/_matrix/client/r0/login/cas/ticket"
|
|
|
|
service_param = urllib.parse.urlencode(
|
|
|
|
{b"service": b"%s?%s" % (hs_redirect_url, client_redirect_url_param)}
|
|
|
|
).encode("ascii")
|
2019-06-10 19:03:57 -04:00
|
|
|
return b"%s/login?%s" % (self.cas_server_url, service_param)
|
2015-11-05 09:01:12 -05:00
|
|
|
|
|
|
|
|
2019-06-03 07:28:59 -04:00
|
|
|
class CasTicketServlet(RestServlet):
|
|
|
|
PATTERNS = client_patterns("/login/cas/ticket", v1=True)
|
2015-11-05 09:01:12 -05:00
|
|
|
|
|
|
|
def __init__(self, hs):
|
2019-06-03 07:28:59 -04:00
|
|
|
super(CasTicketServlet, self).__init__()
|
2015-11-05 09:01:12 -05:00
|
|
|
self.cas_server_url = hs.config.cas_server_url
|
|
|
|
self.cas_service_url = hs.config.cas_service_url
|
2019-10-11 07:33:12 -04:00
|
|
|
self.cas_displayname_attribute = hs.config.cas_displayname_attribute
|
2015-11-05 09:01:12 -05:00
|
|
|
self.cas_required_attributes = hs.config.cas_required_attributes
|
2018-12-07 07:10:07 -05:00
|
|
|
self._sso_auth_handler = SSOAuthHandler(hs)
|
2019-11-01 10:07:44 -04:00
|
|
|
self._http_client = hs.get_proxied_http_client()
|
2015-11-05 09:01:12 -05:00
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def on_GET(self, request):
|
2018-12-07 07:10:07 -05:00
|
|
|
client_redirect_url = parse_string(request, "redirectUrl", required=True)
|
2015-11-05 09:01:12 -05:00
|
|
|
uri = self.cas_server_url + "/proxyValidate"
|
|
|
|
args = {
|
2018-12-07 07:10:07 -05:00
|
|
|
"ticket": parse_string(request, "ticket", required=True),
|
2019-06-20 05:32:02 -04:00
|
|
|
"service": self.cas_service_url,
|
2015-11-05 09:01:12 -05:00
|
|
|
}
|
2017-03-14 09:37:36 -04:00
|
|
|
try:
|
2019-12-05 10:53:06 -05:00
|
|
|
body = await self._http_client.get_raw(uri, args)
|
2017-03-14 09:37:36 -04:00
|
|
|
except PartialDownloadError as pde:
|
|
|
|
# Twisted raises this error if the connection is closed,
|
|
|
|
# even if that's being used old-http style to signal end-of-data
|
|
|
|
body = pde.response
|
2019-12-05 10:53:06 -05:00
|
|
|
result = await self.handle_cas_response(request, body, client_redirect_url)
|
2019-07-23 09:00:55 -04:00
|
|
|
return result
|
2015-11-05 09:01:12 -05:00
|
|
|
|
2015-11-11 06:20:23 -05:00
|
|
|
def handle_cas_response(self, request, cas_response_body, client_redirect_url):
|
2015-11-05 09:01:12 -05:00
|
|
|
user, attributes = self.parse_cas_response(cas_response_body)
|
2019-10-11 07:33:12 -04:00
|
|
|
displayname = attributes.pop(self.cas_displayname_attribute, None)
|
2015-11-05 09:01:12 -05:00
|
|
|
|
|
|
|
for required_attribute, required_value in self.cas_required_attributes.items():
|
|
|
|
# If required attribute was not in CAS Response - Forbidden
|
|
|
|
if required_attribute not in attributes:
|
|
|
|
raise LoginError(401, "Unauthorized", errcode=Codes.UNAUTHORIZED)
|
|
|
|
|
|
|
|
# Also need to check value
|
|
|
|
if required_value is not None:
|
|
|
|
actual_value = attributes[required_attribute]
|
|
|
|
# If required attribute value does not match expected - Forbidden
|
|
|
|
if required_value != actual_value:
|
|
|
|
raise LoginError(401, "Unauthorized", errcode=Codes.UNAUTHORIZED)
|
|
|
|
|
2018-12-07 07:10:07 -05:00
|
|
|
return self._sso_auth_handler.on_successful_auth(
|
2019-10-11 07:33:12 -04:00
|
|
|
user, request, client_redirect_url, displayname
|
2017-02-02 05:53:36 -05:00
|
|
|
)
|
2015-11-05 09:01:12 -05:00
|
|
|
|
|
|
|
def parse_cas_response(self, cas_response_body):
|
2016-08-08 12:17:25 -04:00
|
|
|
user = None
|
2016-09-09 14:39:30 -04:00
|
|
|
attributes = {}
|
2016-08-08 12:17:25 -04:00
|
|
|
try:
|
|
|
|
root = ET.fromstring(cas_response_body)
|
|
|
|
if not root.tag.endswith("serviceResponse"):
|
|
|
|
raise Exception("root of CAS response is not serviceResponse")
|
2019-06-20 05:32:02 -04:00
|
|
|
success = root[0].tag.endswith("authenticationSuccess")
|
2016-08-08 12:17:25 -04:00
|
|
|
for child in root[0]:
|
|
|
|
if child.tag.endswith("user"):
|
|
|
|
user = child.text
|
|
|
|
if child.tag.endswith("attributes"):
|
|
|
|
for attribute in child:
|
|
|
|
# ElementTree library expands the namespace in
|
|
|
|
# attribute tags to the full URL of the namespace.
|
|
|
|
# We don't care about namespace here and it will always
|
|
|
|
# be encased in curly braces, so we remove them.
|
|
|
|
tag = attribute.tag
|
|
|
|
if "}" in tag:
|
|
|
|
tag = tag.split("}")[1]
|
|
|
|
attributes[tag] = attribute.text
|
|
|
|
if user is None:
|
|
|
|
raise Exception("CAS response does not contain user")
|
|
|
|
except Exception:
|
2020-01-20 12:38:21 -05:00
|
|
|
logger.exception("Error parsing CAS response")
|
2019-06-20 05:32:02 -04:00
|
|
|
raise LoginError(401, "Invalid CAS response", errcode=Codes.UNAUTHORIZED)
|
2016-08-08 12:17:25 -04:00
|
|
|
if not success:
|
2019-06-20 05:32:02 -04:00
|
|
|
raise LoginError(
|
|
|
|
401, "Unsuccessful CAS response", errcode=Codes.UNAUTHORIZED
|
|
|
|
)
|
2016-08-08 12:17:25 -04:00
|
|
|
return user, attributes
|
2015-11-05 09:01:12 -05:00
|
|
|
|
|
|
|
|
2019-06-26 19:46:57 -04:00
|
|
|
class SAMLRedirectServlet(BaseSSORedirectServlet):
|
2019-06-10 15:28:08 -04:00
|
|
|
PATTERNS = client_patterns("/login/sso/redirect", v1=True)
|
2019-06-02 12:13:20 -04:00
|
|
|
|
|
|
|
def __init__(self, hs):
|
2019-06-26 17:52:02 -04:00
|
|
|
self._saml_handler = hs.get_saml_handler()
|
2019-06-02 12:13:20 -04:00
|
|
|
|
2019-06-10 19:03:57 -04:00
|
|
|
def get_sso_url(self, client_redirect_url):
|
2019-06-26 17:52:02 -04:00
|
|
|
return self._saml_handler.handle_redirect_request(client_redirect_url)
|
2019-06-02 12:13:20 -04:00
|
|
|
|
|
|
|
|
2018-12-07 07:10:07 -05:00
|
|
|
class SSOAuthHandler(object):
|
|
|
|
"""
|
|
|
|
Utility class for Resources and Servlets which handle the response from a SSO
|
|
|
|
service
|
|
|
|
|
|
|
|
Args:
|
|
|
|
hs (synapse.server.HomeServer)
|
|
|
|
"""
|
2019-06-20 05:32:02 -04:00
|
|
|
|
2018-12-07 07:10:07 -05:00
|
|
|
def __init__(self, hs):
|
|
|
|
self._hostname = hs.hostname
|
|
|
|
self._auth_handler = hs.get_auth_handler()
|
2019-02-20 02:47:31 -05:00
|
|
|
self._registration_handler = hs.get_registration_handler()
|
2018-12-07 07:10:07 -05:00
|
|
|
self._macaroon_gen = hs.get_macaroon_generator()
|
|
|
|
|
2019-12-05 10:53:06 -05:00
|
|
|
async def on_successful_auth(
|
2019-06-20 05:32:02 -04:00
|
|
|
self, username, request, client_redirect_url, user_display_name=None
|
2018-12-07 07:10:07 -05:00
|
|
|
):
|
|
|
|
"""Called once the user has successfully authenticated with the SSO.
|
|
|
|
|
|
|
|
Registers the user if necessary, and then returns a redirect (with
|
|
|
|
a login token) to the client.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
username (unicode|bytes): the remote user id. We'll map this onto
|
|
|
|
something sane for a MXID localpath.
|
|
|
|
|
|
|
|
request (SynapseRequest): the incoming request from the browser. We'll
|
|
|
|
respond to it with a redirect.
|
|
|
|
|
|
|
|
client_redirect_url (unicode): the redirect_url the client gave us when
|
|
|
|
it first started the process.
|
|
|
|
|
2018-12-07 08:44:46 -05:00
|
|
|
user_display_name (unicode|None): if set, and we have to register a new user,
|
|
|
|
we will set their displayname to this.
|
|
|
|
|
2018-12-07 07:10:07 -05:00
|
|
|
Returns:
|
|
|
|
Deferred[none]: Completes once we have handled the request.
|
|
|
|
"""
|
|
|
|
localpart = map_username_to_mxid_localpart(username)
|
|
|
|
user_id = UserID(localpart, self._hostname).to_string()
|
2019-12-05 10:53:06 -05:00
|
|
|
registered_user_id = await self._auth_handler.check_user_exists(user_id)
|
2018-12-07 07:10:07 -05:00
|
|
|
if not registered_user_id:
|
2019-12-05 10:53:06 -05:00
|
|
|
registered_user_id = await self._registration_handler.register_user(
|
2019-07-08 14:01:08 -04:00
|
|
|
localpart=localpart, default_display_name=user_display_name
|
2018-12-07 07:10:07 -05:00
|
|
|
)
|
|
|
|
|
2019-09-13 10:20:49 -04:00
|
|
|
self.complete_sso_login(registered_user_id, request, client_redirect_url)
|
|
|
|
|
|
|
|
def complete_sso_login(
|
|
|
|
self, registered_user_id: str, request: SynapseRequest, client_redirect_url: str
|
|
|
|
):
|
|
|
|
"""Having figured out a mxid for this user, complete the HTTP request
|
|
|
|
|
|
|
|
Args:
|
|
|
|
registered_user_id:
|
|
|
|
request:
|
|
|
|
client_redirect_url:
|
|
|
|
"""
|
|
|
|
|
2018-12-07 07:10:07 -05:00
|
|
|
login_token = self._macaroon_gen.generate_short_term_login_token(
|
|
|
|
registered_user_id
|
|
|
|
)
|
|
|
|
redirect_url = self._add_login_token_to_redirect_url(
|
|
|
|
client_redirect_url, login_token
|
|
|
|
)
|
2020-02-26 07:22:55 -05:00
|
|
|
# Load page
|
2018-12-07 07:10:07 -05:00
|
|
|
request.redirect(redirect_url)
|
|
|
|
finish_request(request)
|
|
|
|
|
|
|
|
@staticmethod
|
|
|
|
def _add_login_token_to_redirect_url(url, token):
|
|
|
|
url_parts = list(urllib.parse.urlparse(url))
|
|
|
|
query = dict(urllib.parse.parse_qsl(url_parts[4]))
|
|
|
|
query.update({"loginToken": token})
|
|
|
|
url_parts[4] = urllib.parse.urlencode(query)
|
|
|
|
return urllib.parse.urlunparse(url_parts)
|
|
|
|
|
|
|
|
|
2014-08-12 10:10:52 -04:00
|
|
|
def register_servlets(hs, http_server):
|
|
|
|
LoginRestServlet(hs).register(http_server)
|
2015-10-07 09:45:57 -04:00
|
|
|
if hs.config.cas_enabled:
|
2015-11-05 09:01:12 -05:00
|
|
|
CasRedirectServlet(hs).register(http_server)
|
|
|
|
CasTicketServlet(hs).register(http_server)
|
2019-06-10 19:03:57 -04:00
|
|
|
elif hs.config.saml2_enabled:
|
|
|
|
SAMLRedirectServlet(hs).register(http_server)
|