# Copyright (c) 2025 Patrick Motsch # All rights reserved. """ User routes for the backend API. Implements the endpoints for user management. MULTI-TENANT: User management requires RequestContext. - mandateId from X-Mandate-Id header determines which users are visible - SysAdmin can see all users across mandates """ from fastapi import APIRouter, HTTPException, Depends, Body, Path, Request, Response, Query from typing import List, Dict, Any, Optional from fastapi import status from pydantic import BaseModel import logging import json # Import interfaces and models import modules.interfaces.interfaceDbApp as interfaceDbApp from modules.auth import limiter, getRequestContext, RequestContext # Import the attribute definition and helper functions from modules.datamodels.datamodelUam import User, UserInDB, AuthAuthority from modules.interfaces.interfaceDbApp import getRootInterface from modules.datamodels.datamodelPagination import PaginationParams, PaginatedResponse, PaginationMetadata, normalize_pagination_dict # Configure logger logger = logging.getLogger(__name__) def _applyFiltersAndSort(items: List[Dict[str, Any]], paginationParams: Optional[PaginationParams]) -> List[Dict[str, Any]]: """ Apply filters and sorting to a list of items. This is used when we can't do server-side filtering in the database (e.g., SysAdmin view). Args: items: List of dictionaries to filter/sort paginationParams: Pagination parameters with filters and sort Returns: Filtered and sorted list """ if not paginationParams: return items result = items.copy() # Apply filters if paginationParams.filters: filters = paginationParams.filters # Handle general search searchTerm = filters.get('search', '').lower() if filters.get('search') else None if searchTerm: def matchesSearch(item: Dict[str, Any]) -> bool: for value in item.values(): if value is not None and searchTerm in str(value).lower(): return True return False result = [item for item in result if matchesSearch(item)] # Handle field-specific filters for field, filterValue in filters.items(): if field == 'search': continue # Already handled if isinstance(filterValue, dict) and 'operator' in filterValue: operator = filterValue.get('operator', 'equals') value = filterValue.get('value') else: operator = 'equals' value = filterValue if value is None or value == '': continue def matchesFilter(item: Dict[str, Any], f: str, op: str, v: Any) -> bool: itemValue = item.get(f) if itemValue is None: return False # Convert to string for comparison if needed itemStr = str(itemValue).lower() valueStr = str(v).lower() if op in ('equals', 'eq'): return itemStr == valueStr elif op == 'contains': return valueStr in itemStr elif op == 'startsWith': return itemStr.startswith(valueStr) elif op == 'endsWith': return itemStr.endswith(valueStr) elif op in ('gt', 'gte', 'lt', 'lte'): try: itemNum = float(itemValue) valueNum = float(v) if op == 'gt': return itemNum > valueNum elif op == 'gte': return itemNum >= valueNum elif op == 'lt': return itemNum < valueNum elif op == 'lte': return itemNum <= valueNum except (ValueError, TypeError): return False elif op == 'in': if isinstance(v, list): return itemStr in [str(x).lower() for x in v] return False elif op == 'notIn': if isinstance(v, list): return itemStr not in [str(x).lower() for x in v] return True return True result = [item for item in result if matchesFilter(item, field, operator, value)] # Apply sorting if paginationParams.sort: for sortField in reversed(paginationParams.sort): fieldName = sortField.field ascending = sortField.direction == 'asc' def getSortKey(item: Dict[str, Any]): value = item.get(fieldName) if value is None: return (1, '') # Nulls last if isinstance(value, bool): return (0, not value if ascending else value) if isinstance(value, (int, float)): return (0, value) return (0, str(value).lower()) result = sorted(result, key=getSortKey, reverse=not ascending) return result router = APIRouter( prefix="/api/users", tags=["Manage Users"], responses={404: {"description": "Not found"}} ) # ============================================================================ # OPTIONS ENDPOINTS (for dropdowns) # ============================================================================ @router.get("/options", response_model=List[Dict[str, Any]]) @limiter.limit("60/minute") def get_user_options( request: Request, context: RequestContext = Depends(getRequestContext) ) -> List[Dict[str, Any]]: """ Get user options for select dropdowns. MULTI-TENANT: mandateId from X-Mandate-Id header determines scope. Returns standardized format: [{ value, label }] """ try: appInterface = interfaceDbApp.getInterface(context.user) if context.mandateId: result = appInterface.getUsersByMandate(str(context.mandateId), None) users = result.items if hasattr(result, 'items') else result elif context.isSysAdmin: users = appInterface.getAllUsers() else: raise HTTPException(status_code=403, detail="Access denied") return [ {"value": user.id, "label": user.fullName or user.username or user.email or user.id} for user in users ] except HTTPException: raise except Exception as e: logger.error(f"Error getting user options: {str(e)}") raise HTTPException(status_code=500, detail=f"Failed to get user options: {str(e)}") # ============================================================================ # CRUD ENDPOINTS # ============================================================================ @router.get("/", response_model=PaginatedResponse[User]) @limiter.limit("30/minute") def get_users( request: Request, pagination: Optional[str] = Query(None, description="JSON-encoded PaginationParams object"), context: RequestContext = Depends(getRequestContext) ) -> PaginatedResponse[User]: """ Get users with optional pagination, sorting, and filtering. MULTI-TENANT: mandateId from X-Mandate-Id header determines scope. SysAdmin without mandateId sees all users. Query Parameters: - pagination: JSON-encoded PaginationParams object, or None for no pagination Examples: - GET /api/users/ (no pagination - returns all users in mandate) - GET /api/users/?pagination={"page":1,"pageSize":10,"sort":[]} """ try: # Parse pagination parameter paginationParams = None if pagination: try: paginationDict = json.loads(pagination) if paginationDict: paginationDict = normalize_pagination_dict(paginationDict) paginationParams = PaginationParams(**paginationDict) except (json.JSONDecodeError, ValueError) as e: raise HTTPException( status_code=400, detail=f"Invalid pagination parameter: {str(e)}" ) appInterface = interfaceDbApp.getInterface(context.user) # MULTI-TENANT: Use mandateId from context (header) # SysAdmin without mandateId can see all users if context.mandateId: # Get users for specific mandate using getUsersByMandate result = appInterface.getUsersByMandate(str(context.mandateId), paginationParams) # getUsersByMandate returns PaginatedResult if pagination was provided if paginationParams and hasattr(result, 'items'): return PaginatedResponse( items=result.items, pagination=PaginationMetadata( currentPage=result.currentPage, pageSize=result.pageSize, totalItems=result.totalItems, totalPages=result.totalPages, sort=paginationParams.sort, filters=paginationParams.filters ) ) else: # No pagination - result is a list users = result if isinstance(result, list) else result.items if hasattr(result, 'items') else [] return PaginatedResponse( items=users, pagination=None ) elif context.isSysAdmin: # SysAdmin without mandateId sees all users # Get all users via interface method (returns Pydantic User models) allUserModels = appInterface.getAllUsers() # Convert to dictionaries for filtering/sorting cleanedUsers = [u.model_dump() for u in allUserModels] # Apply server-side filtering and sorting filteredUsers = _applyFiltersAndSort(cleanedUsers, paginationParams) # Convert to User objects users = [User(**u) for u in filteredUsers] if paginationParams: import math totalItems = len(users) totalPages = math.ceil(totalItems / paginationParams.pageSize) if totalItems > 0 else 0 startIdx = (paginationParams.page - 1) * paginationParams.pageSize endIdx = startIdx + paginationParams.pageSize paginatedUsers = users[startIdx:endIdx] return PaginatedResponse( items=paginatedUsers, pagination=PaginationMetadata( currentPage=paginationParams.page, pageSize=paginationParams.pageSize, totalItems=totalItems, totalPages=totalPages, sort=paginationParams.sort, filters=paginationParams.filters ) ) else: return PaginatedResponse( items=users, pagination=None ) else: # Non-SysAdmin without mandateId - should not happen (getRequestContext enforces) raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="X-Mandate-Id header is required" ) except HTTPException: raise except Exception as e: logger.error(f"Error getting users: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to get users: {str(e)}" ) @router.get("/{userId}", response_model=User) @limiter.limit("30/minute") def get_user( request: Request, userId: str = Path(..., description="ID of the user"), context: RequestContext = Depends(getRequestContext) ) -> User: """ Get a specific user by ID. MULTI-TENANT: User must be in the same mandate (via UserMandate) or caller is SysAdmin. """ try: appInterface = interfaceDbApp.getInterface(context.user) # Get user without filtering by enabled status user = appInterface.getUser(userId) if not user: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail=f"User with ID {userId} not found" ) # MULTI-TENANT: Verify user is in the same mandate (unless SysAdmin) if context.mandateId and not context.isSysAdmin: userMandate = appInterface.getUserMandate(userId, str(context.mandateId)) if not userMandate: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="User not in your mandate" ) return user except HTTPException: raise except Exception as e: logger.error(f"Error getting user {userId}: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to get user: {str(e)}" ) class CreateUserRequest(BaseModel): """Request body for creating a new user""" username: str email: Optional[str] = None fullName: Optional[str] = None language: str = "en" enabled: bool = True isSysAdmin: bool = False password: Optional[str] = None @router.post("", response_model=User) @limiter.limit("10/minute") def create_user( request: Request, userData: CreateUserRequest = Body(...), context: RequestContext = Depends(getRequestContext) ) -> User: """ Create a new user. MULTI-TENANT: User is created and automatically added to the current mandate. """ appInterface = interfaceDbApp.getInterface(context.user) # Extract fields from request model and call createUser with individual parameters newUser = appInterface.createUser( username=userData.username, password=userData.password, email=userData.email, fullName=userData.fullName, language=userData.language, enabled=userData.enabled, authenticationAuthority=AuthAuthority.LOCAL, isSysAdmin=userData.isSysAdmin ) # MULTI-TENANT: Add user to current mandate via UserMandate with default "user" role if context.mandateId: # Get "user" role ID userRole = appInterface.getRoleByLabel("user") roleIds = [str(userRole.id)] if userRole else [] appInterface.createUserMandate( userId=str(newUser.id), mandateId=str(context.mandateId), roleIds=roleIds ) logger.info(f"Created UserMandate for user {newUser.id} in mandate {context.mandateId}") return newUser @router.put("/{userId}", response_model=User) @limiter.limit("10/minute") def update_user( request: Request, userId: str = Path(..., description="ID of the user to update"), userData: User = Body(...), context: RequestContext = Depends(getRequestContext) ) -> User: """ Update an existing user. MULTI-TENANT: Can only update users in the same mandate (unless SysAdmin). """ appInterface = interfaceDbApp.getInterface(context.user) # Check if the user exists existingUser = appInterface.getUser(userId) if not existingUser: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail=f"User with ID {userId} not found" ) # MULTI-TENANT: Verify user is in the same mandate (unless SysAdmin) if context.mandateId and not context.isSysAdmin: userMandate = appInterface.getUserMandate(userId, str(context.mandateId)) if not userMandate: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="Cannot update user outside your mandate" ) # Update user updatedUser = appInterface.updateUser(userId, userData) if not updatedUser: raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Error updating the user" ) return updatedUser @router.post("/{userId}/reset-password") @limiter.limit("5/minute") def reset_user_password( request: Request, userId: str = Path(..., description="ID of the user to reset password for"), newPassword: str = Body(..., embed=True), context: RequestContext = Depends(getRequestContext) ) -> Dict[str, Any]: """ Reset user password (Admin only). MULTI-TENANT: Can only reset passwords for users in the same mandate (unless SysAdmin). """ try: # Check if current user is admin if not context.isSysAdmin: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="Only administrators can reset passwords" ) # Get user interface appInterface = interfaceDbApp.getInterface(context.user) # Get target user target_user = appInterface.getUser(userId) if not target_user: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="User not found" ) # MULTI-TENANT: Verify user is in the same mandate (unless SysAdmin) if context.mandateId and not context.isSysAdmin: userMandate = appInterface.getUserMandate(userId, str(context.mandateId)) if not userMandate: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="Cannot reset password for user outside your mandate" ) # Validate password strength if len(newPassword) < 8: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="Password must be at least 8 characters long" ) # Reset password success = appInterface.resetUserPassword(userId, newPassword) if not success: raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Failed to reset password" ) # SECURITY: Automatically revoke all tokens for the user after password reset try: revoked_count = appInterface.revokeTokensByUser( userId=userId, authority=None, # Revoke all authorities mandateId=None, # Revoke across all mandates revokedBy=context.user.id, reason="password_reset" ) logger.info(f"Revoked {revoked_count} tokens for user {userId} after password reset") except Exception as e: logger.error(f"Failed to revoke tokens after password reset for user {userId}: {str(e)}") # Don't fail the password reset if token revocation fails # Log password reset try: from modules.shared.auditLogger import audit_logger audit_logger.logSecurityEvent( userId=str(context.user.id), mandateId=str(context.mandateId) if context.mandateId else "system", action="password_reset", details=f"Reset password for user {userId}", ipAddress=request.client.host if request.client else None, success=True ) except Exception: pass return { "message": "Password reset successfully", "user_id": userId } except HTTPException: raise except Exception as e: logger.error(f"Error resetting password: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Password reset failed: {str(e)}" ) @router.post("/change-password") @limiter.limit("5/minute") def change_password( request: Request, currentPassword: str = Body(..., embed=True), newPassword: str = Body(..., embed=True), context: RequestContext = Depends(getRequestContext) ) -> Dict[str, Any]: """ Change current user's password. MULTI-TENANT: User changes their own password (no mandate restriction). """ try: # Get user interface appInterface = interfaceDbApp.getInterface(context.user) # Verify current password if not appInterface.verifyPassword(currentPassword, context.user.passwordHash): raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, detail="Current password is incorrect" ) # Validate new password strength if len(newPassword) < 8: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="New password must be at least 8 characters long" ) # Change password success = appInterface.resetUserPassword(str(context.user.id), newPassword) if not success: raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Failed to change password" ) # SECURITY: Automatically revoke all tokens for the user after password change try: revoked_count = appInterface.revokeTokensByUser( userId=str(context.user.id), authority=None, # Revoke all authorities mandateId=None, # Revoke across all mandates revokedBy=context.user.id, reason="password_change" ) logger.info(f"Revoked {revoked_count} tokens for user {context.user.id} after password change") except Exception as e: logger.error(f"Failed to revoke tokens after password change for user {context.user.id}: {str(e)}") # Don't fail the password change if token revocation fails # Log password change try: from modules.shared.auditLogger import audit_logger audit_logger.logSecurityEvent( userId=str(context.user.id), mandateId=str(context.mandateId) if context.mandateId else "system", action="password_change", details="User changed their own password", ipAddress=request.client.host if request.client else None, success=True ) except Exception: pass return { "message": "Password changed successfully. Please log in again with your new password." } except HTTPException: raise except Exception as e: logger.error(f"Error changing password: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Password change failed: {str(e)}" ) @router.post("/{userId}/send-password-link") @limiter.limit("10/minute") def send_password_link( request: Request, userId: str = Path(..., description="ID of the user to send password setup link"), frontendUrl: str = Body(..., embed=True), context: RequestContext = Depends(getRequestContext) ) -> Dict[str, Any]: """ Send password setup/reset link to a user (admin function). MULTI-TENANT: Can only send to users in the same mandate (unless SysAdmin). This allows admins to send a magic link to users to set or reset their password. Used when creating users without password or to help users who forgot their password. Args: userId: ID of the user to send the link to frontendUrl: The frontend URL to use in the magic link """ try: from modules.shared.configuration import APP_CONFIG # Get user interface appInterface = interfaceDbApp.getInterface(context.user) # Get target user targetUser = appInterface.getUser(userId) if not targetUser: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="User not found" ) # MULTI-TENANT: Verify user is in the same mandate (unless SysAdmin) if context.mandateId and not context.isSysAdmin: userMandate = appInterface.getUserMandate(userId, str(context.mandateId)) if not userMandate: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="Cannot send password link to user outside your mandate" ) # Check if user has an email if not targetUser.email: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="User has no email address configured" ) # Use root interface for token operations rootInterface = getRootInterface() # Generate reset token token, expires = rootInterface.generateResetTokenAndExpiry() # Set reset token (don't clear password - user might have one already) rootInterface.setResetToken(userId, token, expires, clearPassword=False) # Send email with magic link baseUrl = frontendUrl.rstrip("/") magicLink = f"{baseUrl}/reset?token={token}" expiryHours = int(APP_CONFIG.get("Auth_RESET_TOKEN_EXPIRY_HOURS", "24")) try: from modules.services import Services services = Services(targetUser) emailSubject = "PowerOn - Passwort setzen" emailBody = f""" Hallo {targetUser.fullName or targetUser.username}, Ein Administrator hat einen Link zum Setzen Ihres Passworts angefordert. Ihr Benutzername: {targetUser.username} Klicken Sie auf den folgenden Link, um Ihr Passwort zu setzen: {magicLink} Dieser Link ist {expiryHours} Stunden gültig. Falls Sie diese Anforderung nicht erwartet haben, kontaktieren Sie bitte Ihren Administrator. """ emailSent = services.messaging.sendEmailDirect( recipient=targetUser.email, subject=emailSubject, message=emailBody, userId=str(targetUser.id) ) if not emailSent: logger.warning(f"Failed to send password setup email to {targetUser.email}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Failed to send email" ) except HTTPException: raise except Exception as emailErr: logger.error(f"Error sending password setup email: {str(emailErr)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to send email: {str(emailErr)}" ) # Log the action try: from modules.shared.auditLogger import audit_logger audit_logger.logSecurityEvent( userId=str(context.user.id), mandateId=str(context.mandateId) if context.mandateId else "system", action="send_password_link", details=f"Sent password setup link to user {userId} ({targetUser.email})" ) except Exception: pass logger.info(f"Password setup link sent to {targetUser.email} for user {targetUser.username} by admin {context.user.username}") return { "message": f"Password setup link sent to {targetUser.email}", "userId": userId, "email": targetUser.email } except HTTPException: raise except Exception as e: logger.error(f"Error sending password link: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to send password link: {str(e)}" ) @router.delete("/{userId}", response_model=Dict[str, Any]) @limiter.limit("10/minute") def delete_user( request: Request, userId: str = Path(..., description="ID of the user to delete"), context: RequestContext = Depends(getRequestContext) ) -> Dict[str, Any]: """ Delete a user. MULTI-TENANT: Can only delete users in the same mandate (unless SysAdmin). """ appInterface = interfaceDbApp.getInterface(context.user) # Check if the user exists existingUser = appInterface.getUser(userId) if not existingUser: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail=f"User with ID {userId} not found" ) # MULTI-TENANT: Verify user is in the same mandate (unless SysAdmin) if context.mandateId and not context.isSysAdmin: userMandate = appInterface.getUserMandate(userId, str(context.mandateId)) if not userMandate: raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail="Cannot delete user outside your mandate" ) # Delete UserMandate entries for this user first userMandates = appInterface.getUserMandates(userId) for um in userMandates: appInterface.deleteUserMandate(userId, str(um.mandateId)) success = appInterface.deleteUser(userId) if not success: raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Error deleting the user" ) return {"message": f"User with ID {userId} successfully deleted"}