mirror of
https://mau.dev/maunium/synapse.git
synced 2024-08-23 18:56:10 +00:00
![Richard van der Hoff](/assets/img/avatar_default.png)
A new `registration_shared_secret_path` option. This is kinda handy for k8s deployments and things.
318 lines
8.9 KiB
Python
318 lines
8.9 KiB
Python
# Copyright 2015, 2016 OpenMarket Ltd
|
|
# Copyright 2018 New Vector
|
|
# Copyright 2021-22 The Matrix.org Foundation C.I.C.
|
|
#
|
|
# 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 argparse
|
|
import getpass
|
|
import hashlib
|
|
import hmac
|
|
import logging
|
|
import sys
|
|
from typing import Any, Callable, Dict, Optional
|
|
|
|
import requests
|
|
import yaml
|
|
|
|
_CONFLICTING_SHARED_SECRET_OPTS_ERROR = """\
|
|
Conflicting options 'registration_shared_secret' and 'registration_shared_secret_path'
|
|
are both defined in config file.
|
|
"""
|
|
|
|
_NO_SHARED_SECRET_OPTS_ERROR = """\
|
|
No 'registration_shared_secret' or 'registration_shared_secret_path' defined in config.
|
|
"""
|
|
|
|
_DEFAULT_SERVER_URL = "http://localhost:8008"
|
|
|
|
|
|
def request_registration(
|
|
user: str,
|
|
password: str,
|
|
server_location: str,
|
|
shared_secret: str,
|
|
admin: bool = False,
|
|
user_type: Optional[str] = None,
|
|
_print: Callable[[str], None] = print,
|
|
exit: Callable[[int], None] = sys.exit,
|
|
) -> None:
|
|
|
|
url = "%s/_synapse/admin/v1/register" % (server_location.rstrip("/"),)
|
|
|
|
# Get the nonce
|
|
r = requests.get(url, verify=False)
|
|
|
|
if r.status_code != 200:
|
|
_print("ERROR! Received %d %s" % (r.status_code, r.reason))
|
|
if 400 <= r.status_code < 500:
|
|
try:
|
|
_print(r.json()["error"])
|
|
except Exception:
|
|
pass
|
|
return exit(1)
|
|
|
|
nonce = r.json()["nonce"]
|
|
|
|
mac = hmac.new(key=shared_secret.encode("utf8"), digestmod=hashlib.sha1)
|
|
|
|
mac.update(nonce.encode("utf8"))
|
|
mac.update(b"\x00")
|
|
mac.update(user.encode("utf8"))
|
|
mac.update(b"\x00")
|
|
mac.update(password.encode("utf8"))
|
|
mac.update(b"\x00")
|
|
mac.update(b"admin" if admin else b"notadmin")
|
|
if user_type:
|
|
mac.update(b"\x00")
|
|
mac.update(user_type.encode("utf8"))
|
|
|
|
hex_mac = mac.hexdigest()
|
|
|
|
data = {
|
|
"nonce": nonce,
|
|
"username": user,
|
|
"password": password,
|
|
"mac": hex_mac,
|
|
"admin": admin,
|
|
"user_type": user_type,
|
|
}
|
|
|
|
_print("Sending registration request...")
|
|
r = requests.post(url, json=data, verify=False)
|
|
|
|
if r.status_code != 200:
|
|
_print("ERROR! Received %d %s" % (r.status_code, r.reason))
|
|
if 400 <= r.status_code < 500:
|
|
try:
|
|
_print(r.json()["error"])
|
|
except Exception:
|
|
pass
|
|
return exit(1)
|
|
|
|
_print("Success!")
|
|
|
|
|
|
def register_new_user(
|
|
user: str,
|
|
password: str,
|
|
server_location: str,
|
|
shared_secret: str,
|
|
admin: Optional[bool],
|
|
user_type: Optional[str],
|
|
) -> None:
|
|
if not user:
|
|
try:
|
|
default_user: Optional[str] = getpass.getuser()
|
|
except Exception:
|
|
default_user = None
|
|
|
|
if default_user:
|
|
user = input("New user localpart [%s]: " % (default_user,))
|
|
if not user:
|
|
user = default_user
|
|
else:
|
|
user = input("New user localpart: ")
|
|
|
|
if not user:
|
|
print("Invalid user name")
|
|
sys.exit(1)
|
|
|
|
if not password:
|
|
password = getpass.getpass("Password: ")
|
|
|
|
if not password:
|
|
print("Password cannot be blank.")
|
|
sys.exit(1)
|
|
|
|
confirm_password = getpass.getpass("Confirm password: ")
|
|
|
|
if password != confirm_password:
|
|
print("Passwords do not match")
|
|
sys.exit(1)
|
|
|
|
if admin is None:
|
|
admin_inp = input("Make admin [no]: ")
|
|
if admin_inp in ("y", "yes", "true"):
|
|
admin = True
|
|
else:
|
|
admin = False
|
|
|
|
request_registration(
|
|
user, password, server_location, shared_secret, bool(admin), user_type
|
|
)
|
|
|
|
|
|
def main() -> None:
|
|
|
|
logging.captureWarnings(True)
|
|
|
|
parser = argparse.ArgumentParser(
|
|
description="Used to register new users with a given homeserver when"
|
|
" registration has been disabled. The homeserver must be"
|
|
" configured with the 'registration_shared_secret' option"
|
|
" set."
|
|
)
|
|
parser.add_argument(
|
|
"-u",
|
|
"--user",
|
|
default=None,
|
|
help="Local part of the new user. Will prompt if omitted.",
|
|
)
|
|
parser.add_argument(
|
|
"-p",
|
|
"--password",
|
|
default=None,
|
|
help="New password for user. Will prompt if omitted.",
|
|
)
|
|
parser.add_argument(
|
|
"-t",
|
|
"--user_type",
|
|
default=None,
|
|
help="User type as specified in synapse.api.constants.UserTypes",
|
|
)
|
|
admin_group = parser.add_mutually_exclusive_group()
|
|
admin_group.add_argument(
|
|
"-a",
|
|
"--admin",
|
|
action="store_true",
|
|
help=(
|
|
"Register new user as an admin. "
|
|
"Will prompt if --no-admin is not set either."
|
|
),
|
|
)
|
|
admin_group.add_argument(
|
|
"--no-admin",
|
|
action="store_true",
|
|
help=(
|
|
"Register new user as a regular user. "
|
|
"Will prompt if --admin is not set either."
|
|
),
|
|
)
|
|
|
|
group = parser.add_mutually_exclusive_group(required=True)
|
|
group.add_argument(
|
|
"-c",
|
|
"--config",
|
|
type=argparse.FileType("r"),
|
|
help="Path to server config file. Used to read in shared secret.",
|
|
)
|
|
|
|
group.add_argument(
|
|
"-k", "--shared-secret", help="Shared secret as defined in server config file."
|
|
)
|
|
|
|
parser.add_argument(
|
|
"server_url",
|
|
nargs="?",
|
|
help="URL to use to talk to the homeserver. By default, tries to find a "
|
|
"suitable URL from the configuration file. Otherwise, defaults to "
|
|
f"'{_DEFAULT_SERVER_URL}'.",
|
|
)
|
|
|
|
args = parser.parse_args()
|
|
|
|
if "config" in args and args.config:
|
|
config = yaml.safe_load(args.config)
|
|
|
|
if args.shared_secret:
|
|
secret = args.shared_secret
|
|
else:
|
|
# argparse should check that we have either config or shared secret
|
|
assert config
|
|
|
|
secret = config.get("registration_shared_secret")
|
|
secret_file = config.get("registration_shared_secret_path")
|
|
if secret_file:
|
|
if secret:
|
|
print(_CONFLICTING_SHARED_SECRET_OPTS_ERROR, file=sys.stderr)
|
|
sys.exit(1)
|
|
secret = _read_file(secret_file, "registration_shared_secret_path").strip()
|
|
if not secret:
|
|
print(_NO_SHARED_SECRET_OPTS_ERROR, file=sys.stderr)
|
|
sys.exit(1)
|
|
|
|
if args.server_url:
|
|
server_url = args.server_url
|
|
elif config:
|
|
server_url = _find_client_listener(config)
|
|
if not server_url:
|
|
server_url = _DEFAULT_SERVER_URL
|
|
print(
|
|
"Unable to find a suitable HTTP listener in the configuration file. "
|
|
f"Trying {server_url} as a last resort.",
|
|
file=sys.stderr,
|
|
)
|
|
else:
|
|
server_url = _DEFAULT_SERVER_URL
|
|
print(
|
|
f"No server url or configuration file given. Defaulting to {server_url}.",
|
|
file=sys.stderr,
|
|
)
|
|
|
|
admin = None
|
|
if args.admin or args.no_admin:
|
|
admin = args.admin
|
|
|
|
register_new_user(
|
|
args.user, args.password, server_url, secret, admin, args.user_type
|
|
)
|
|
|
|
|
|
def _read_file(file_path: Any, config_path: str) -> str:
|
|
"""Check the given file exists, and read it into a string
|
|
|
|
If it does not, exit with an error indicating the problem
|
|
|
|
Args:
|
|
file_path: the file to be read
|
|
config_path: where in the configuration file_path came from, so that a useful
|
|
error can be emitted if it does not exist.
|
|
Returns:
|
|
content of the file.
|
|
"""
|
|
if not isinstance(file_path, str):
|
|
print(f"{config_path} setting is not a string", file=sys.stderr)
|
|
sys.exit(1)
|
|
|
|
try:
|
|
with open(file_path) as file_stream:
|
|
return file_stream.read()
|
|
except OSError as e:
|
|
print(f"Error accessing file {file_path}: {e}", file=sys.stderr)
|
|
sys.exit(1)
|
|
|
|
|
|
def _find_client_listener(config: Dict[str, Any]) -> Optional[str]:
|
|
# try to find a listener in the config. Returns a host:port pair
|
|
for listener in config.get("listeners", []):
|
|
if listener.get("type") != "http" or listener.get("tls", False):
|
|
continue
|
|
|
|
if not any(
|
|
name == "client"
|
|
for resource in listener.get("resources", [])
|
|
for name in resource.get("names", [])
|
|
):
|
|
continue
|
|
|
|
# TODO: consider bind_addresses
|
|
return f"http://localhost:{listener['port']}"
|
|
|
|
# no suitable listeners?
|
|
return None
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|