# Copyright (C) 2020, 2023 by Thomas Lindner # Copyright (C) 2020 by Cathy Hu # Copyright (C) 2020 by Christian Hagenest # Copyright (C) 2020 by Martin Rey # # SPDX-License-Identifier: 0BSD """REST API endpoints for hood admins.""" from datetime import datetime, timedelta from logging import getLogger from pickle import dumps, loads from smtplib import SMTPException from fastapi import APIRouter, Depends, HTTPException, status from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm from nacl.encoding import URLSafeBase64Encoder from nacl.exceptions import CryptoError from nacl.secret import SecretBox from nacl.utils import random from passlib.hash import argon2 from pydantic import BaseModel, validator from tortoise.exceptions import DoesNotExist, IntegrityError from kibicara import email from kibicara.config import config from kibicara.model import Admin, Hood from kibicara.webapi.utils import delete_hood logger = getLogger(__name__) class BodyEmail(BaseModel): email: str class BodyPassword(BaseModel): password: str @validator("password") def valid_password(cls, value): if len(value) < 8: raise ValueError("Password is too short") return value class BodyAdmin(BodyEmail, BodyPassword): pass class BodyAccessToken(BaseModel): access_token: str token_type: str = "bearer" oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/api/admin/login") secret_box = SecretBox( bytes.fromhex(str(config.get("secret", random(SecretBox.KEY_SIZE).hex()))) ) def to_token(**kwargs) -> str: return secret_box.encrypt(dumps(kwargs), encoder=URLSafeBase64Encoder).decode( "ascii" ) def from_token(token: str) -> dict: return loads( secret_box.decrypt(token.encode("ascii"), encoder=URLSafeBase64Encoder) ) async def get_auth(email: str, password: str) -> Admin: try: admin = await Admin.get(email=email) if argon2.verify(password, admin.passhash): return admin raise ValueError except DoesNotExist: raise ValueError async def get_admin(access_token: str = Depends(oauth2_scheme)) -> Admin: try: return await get_auth(**from_token(access_token)) except (CryptoError, ValueError): raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, detail="Invalid authentication credentials", headers={"WWW-Authenticate": "Bearer"}, ) router = APIRouter() @router.post( "/register/", status_code=status.HTTP_202_ACCEPTED, response_model=BaseModel, operation_id="register", ) async def admin_register(values: BodyAdmin): """Sends an email with a confirmation link. - **email**: E-Mail Address of new hood admin - **password**: Password of new hood admin """ register_token = to_token(**values.__dict__) logger.debug("register_token={0}".format(register_token)) try: if await Admin.exists(email=values.email): raise HTTPException(status_code=status.HTTP_409_CONFLICT) # link goes to frontend. this is not the confirm API endpoint below! body = "{0}/confirm?token={1}".format(config["frontend_url"], register_token) logger.debug(body) email.send_email( to=values.email, subject="Confirm Account", body=body, ) except (ConnectionRefusedError, SMTPException): logger.exception("Email sending failed") raise HTTPException(status_code=status.HTTP_502_BAD_GATEWAY) return {} @router.post( "/confirm/{register_token}", response_model=BodyAccessToken, operation_id="confirm", ) async def admin_confirm(register_token: str): """Registration confirmation and account creation. - **register_token**: Registration token received in email from /register """ try: values = from_token(register_token) passhash = argon2.hash(values["password"]) await Admin.create(email=values["email"], passhash=passhash) # XXX login and registration tokens are exchangeable. does this hurt? return BodyAccessToken(access_token=register_token) except IntegrityError: raise HTTPException(status_code=status.HTTP_409_CONFLICT) @router.post( "/login/", response_model=BodyAccessToken, operation_id="login", ) async def admin_login(form_data: OAuth2PasswordRequestForm = Depends()): """Get an access token. - **username**: Email of a registered hood admin - **password**: Password of a registered hood admin """ try: await get_auth(form_data.username, form_data.password) except ValueError: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="Incorrect email or password", ) token = to_token(email=form_data.username, password=form_data.password) return BodyAccessToken(access_token=token) @router.post( "/reset/", status_code=status.HTTP_202_ACCEPTED, response_model=BaseModel, operation_id="reset", ) async def admin_reset_password(values: BodyEmail): """Sends an email with a password reset link. - **email**: E-Mail Address of new hood admin - **password**: Password of new hood admin """ reset_token = to_token(datetime=datetime.now().isoformat(), **values.__dict__) logger.debug("reset_token={0}".format(reset_token)) try: if await Admin.exists(email=values.email): raise HTTPException(status_code=status.HTTP_404_NOT_FOUND) # link goes to frontend. this is not the reset API endpoint below! body = "{0}/password-reset?token={1}".format( config["frontend_url"], reset_token ) logger.debug(body) email.send_email( to=values.email, subject="Reset your password", body=body, ) except (ConnectionRefusedError, SMTPException): logger.exception("Email sending failed") raise HTTPException(status_code=status.HTTP_502_BAD_GATEWAY) return {} @router.post( "/reset/{reset_token}", response_model=BodyAccessToken, operation_id="confirm_reset", ) async def admin_confirm_reset(reset_token: str, values: BodyPassword): try: token_values = from_token(reset_token) if ( datetime.fromisoformat(token_values["datetime"]) + timedelta(hours=3) < datetime.now() ): raise HTTPException(status_code=status.HTTP_410_GONE) passhash = argon2.hash(values.password) await Admin.filter(email=token_values["email"]).update(passhash=passhash) return BodyAccessToken(access_token=reset_token) except DoesNotExist: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND) except IntegrityError: raise HTTPException(status_code=status.HTTP_409_CONFLICT) except CryptoError: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST) @router.get( "/hoods/", # TODO response_model, operation_id="get_hoods_admin", ) async def admin_hood_read_all(admin: Admin = Depends(get_admin)): """Get a list of all hoods of a given admin.""" return await Hood.filter(admin=admin) @router.get( "/", # TODO response_model, operation_id="get_admin", ) async def admin_read(admin: Admin = Depends(get_admin)): return BodyEmail(email=admin.email) @router.delete( "/", status_code=status.HTTP_204_NO_CONTENT, operation_id="delete_admin", ) async def admin_delete(admin: Admin = Depends(get_admin)): async for hood in Hood.filter(admins__contains=admin): await hood.admins.remove(admin) await hood.fetch_related("admins") if len(hood.admins) == 0: await delete_hood(hood) await admin.delete()