# Copyright (c) 2025 Patrick Motsch # All rights reserved. """ Routes for Microsoft authentication. """ from fastapi import APIRouter, HTTPException, Request, Response, status, Depends, Body, Query from fastapi.responses import HTMLResponse, RedirectResponse, JSONResponse import logging import json from typing import Dict, Any, Optional import msal import httpx from modules.shared.configuration import APP_CONFIG from modules.interfaces.interfaceDbApp import getInterface, getRootInterface from modules.datamodels.datamodelUam import AuthAuthority, User, ConnectionStatus, UserConnection from modules.datamodels.datamodelSecurity import Token from modules.auth import getCurrentUser, limiter, SECRET_KEY, ALGORITHM from modules.auth import createAccessToken, setAccessTokenCookie, createRefreshToken, setRefreshTokenCookie from modules.auth.tokenManager import TokenManager from modules.shared.timeUtils import createExpirationTimestamp, getUtcTimestamp, parseTimestamp # Configure logger logger = logging.getLogger(__name__) # Create router router = APIRouter( prefix="/api/msft", tags=["Security Microsoft"], responses={ 404: {"description": "Not found"}, 400: {"description": "Bad request"}, 401: {"description": "Unauthorized"}, 403: {"description": "Forbidden"}, 500: {"description": "Internal server error"} } ) # Microsoft OAuth configuration CLIENT_ID = APP_CONFIG.get("Service_MSFT_CLIENT_ID") CLIENT_SECRET = APP_CONFIG.get("Service_MSFT_CLIENT_SECRET") TENANT_ID = APP_CONFIG.get("Service_MSFT_TENANT_ID", "common") REDIRECT_URI = APP_CONFIG.get("Service_MSFT_REDIRECT_URI") AUTHORITY = f"https://login.microsoftonline.com/{TENANT_ID}" # Validate configuration at module load if not CLIENT_ID: logger.warning("Service_MSFT_CLIENT_ID is not configured") if not CLIENT_SECRET: logger.warning("Service_MSFT_CLIENT_SECRET is not configured") if not REDIRECT_URI: logger.warning("Service_MSFT_REDIRECT_URI is not configured") if CLIENT_SECRET and CLIENT_SECRET.startswith(("PROD_ENC:", "INT_ENC:", "DEV_ENC:")): logger.warning("Service_MSFT_CLIENT_SECRET appears to be encrypted - ensure decryption is working") SCOPES = [ "User.Read", # Read user profile "Mail.ReadWrite", # Read and write mail "Mail.Send", # Send mail "Files.ReadWrite.All", # Read and write files (SharePoint/OneDrive) "Sites.ReadWrite.All", # Read and write SharePoint sites # Teams Bot: Meeting and chat access (requires admin consent) "OnlineMeetings.Read.All", # Read Teams meeting details "Chat.ReadWrite", # Read and write Teams chat messages "ChatMessage.Send", # Send messages to Teams meeting chats ] # NOTE: Sites.ReadWrite.All, Files.ReadWrite.All, and Teams scopes require admin consent. # An admin must grant consent ONCE at: /api/msft/adminconsent # After that, all users can connect without individual admin approval. @router.get("/login") @limiter.limit("5/minute") def login( request: Request, state: str = Query("login", description="State parameter to distinguish between login and connection flows"), connectionId: Optional[str] = Query(None, description="Connection ID for connection flow") ) -> RedirectResponse: """Initiate Microsoft login""" try: # Create MSAL app msal_app = msal.ConfidentialClientApplication( CLIENT_ID, authority=AUTHORITY, client_credential=CLIENT_SECRET ) # Generate auth URL with state - use state as is if it's already JSON, otherwise create new state try: # Try to parse state as JSON to check if it's already encoded json.loads(state) state_param = state # Use state as is if it's valid JSON except json.JSONDecodeError: # If not JSON, create new state object state_param = json.dumps({ "type": state, "connectionId": connectionId }) # If a specific connection is targeted, set login_hint/domain_hint to preselect that account login_kwargs = {} if connectionId: try: rootInterface = getRootInterface() # Fetch the connection by ID directly using interface method connection = rootInterface.getUserConnectionById(connectionId) if connection: login_hint = connection.externalEmail or connection.externalUsername if login_hint: login_kwargs["login_hint"] = login_hint # Derive domain hint from email/UPN if "@" in login_hint: domain = login_hint.split("@", 1)[1] # Use common MSAL guidance: pass domain_hint to reduce account switching login_kwargs["domain_hint"] = domain # When targeting a specific account, avoid account picker login_kwargs["prompt"] = "login" # force re-auth for that account only else: # Fall back to default behavior if connection not found login_kwargs["prompt"] = "select_account" except Exception: login_kwargs["prompt"] = "select_account" else: # Generic login/connect flow: allow choosing account login_kwargs["prompt"] = "select_account" # MSAL automatically adds openid, profile, offline_access - we just need to provide our business scopes auth_url = msal_app.get_authorization_request_url( scopes=SCOPES, # Only our business scopes - MSAL adds the required ones automatically redirect_uri=REDIRECT_URI, state=state_param, **login_kwargs ) return RedirectResponse(auth_url) except Exception as e: logger.error(f"Error initiating Microsoft login: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to initiate Microsoft login: {str(e)}" ) @router.get("/adminconsent") @limiter.limit("5/minute") def adminconsent(request: Request) -> RedirectResponse: """Initiate Microsoft Admin Consent flow. An Azure AD admin must visit this URL once to grant consent for the entire tenant. After admin consent, all users can connect without individual approval. """ try: adminConsentRedirectUri = REDIRECT_URI.replace("/auth/callback", "/adminconsent/callback") adminConsentUrl = ( f"{AUTHORITY}/adminconsent" f"?client_id={CLIENT_ID}" f"&redirect_uri={adminConsentRedirectUri}" ) logger.info(f"Redirecting to admin consent URL for tenant: {TENANT_ID}") return RedirectResponse(adminConsentUrl) except Exception as e: logger.error(f"Error generating admin consent URL: {str(e)}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Failed to generate admin consent URL: {str(e)}" ) @router.get("/adminconsent/callback") def adminconsent_callback( admin_consent: Optional[str] = Query(None), tenant: Optional[str] = Query(None), error: Optional[str] = Query(None), error_description: Optional[str] = Query(None), request: Request = None ) -> HTMLResponse: """Handle Microsoft Admin Consent callback""" try: if error: logger.error(f"Admin consent error: {error} - {error_description}") return HTMLResponse( content=f"""
Error: {error}
Description: {error_description or 'No description provided'}
Please contact your administrator.
""", status_code=400 ) if admin_consent == "True" and tenant: logger.info(f"Admin consent granted for tenant: {tenant}") return HTMLResponse( content=f"""The application has been granted admin consent for tenant: {tenant}
All users in this tenant can now use the application without individual consent.
You can close this window.
""" ) else: logger.warning(f"Admin consent callback received unexpected parameters: admin_consent={admin_consent}, tenant={tenant}") return HTMLResponse( content=f"""Admin Consent: {admin_consent or 'Not provided'}
Tenant: {tenant or 'Not provided'}
""" ) except Exception as e: logger.error(f"Error in admin consent callback: {str(e)}", exc_info=True) return HTMLResponse( content=f"""{str(e)}
""", status_code=500 ) @router.get("/auth/callback") async def auth_callback(code: str, state: str, request: Request, response: Response) -> HTMLResponse: """Handle Microsoft OAuth callback""" try: # Parse state state_data = json.loads(state) state_type = state_data.get("type", "login") connection_id = state_data.get("connectionId") user_id = state_data.get("userId") # Get user ID from state logger.info(f"Processing Microsoft auth callback: state_type={state_type}, connection_id={connection_id}, user_id={user_id}") # Create MSAL app msal_app = msal.ConfidentialClientApplication( CLIENT_ID, authority=AUTHORITY, client_credential=CLIENT_SECRET ) # Get token from code - MSAL automatically handles the required scopes token_response = msal_app.acquire_token_by_authorization_code( code, scopes=SCOPES, # Only our business scopes - MSAL adds the required ones automatically redirect_uri=REDIRECT_URI ) if "error" in token_response: error_code = token_response.get('error') error_description = token_response.get('error_description', 'No description provided') error_uri = token_response.get('error_uri', '') logger.error( f"Token acquisition failed: {error_code} - {error_description} | " f"CLIENT_ID: {CLIENT_ID[:8]}... | " f"REDIRECT_URI: {REDIRECT_URI} | " f"TENANT_ID: {TENANT_ID}" ) # Provide more helpful error message based on error code if error_code == "invalid_client": error_msg = "Invalid client credentials. Please check CLIENT_ID and CLIENT_SECRET configuration." elif error_code == "invalid_grant": error_msg = "Invalid authorization code or redirect URI mismatch." else: error_msg = f"Authentication failed: {error_description or error_code}" return HTMLResponse( content=f"""{error_msg}
Error code: {error_code}
Please contact support if this issue persists.
""", status_code=400 ) # Get user info using the access token headers = { 'Authorization': f"Bearer {token_response['access_token']}", 'Content-Type': 'application/json' } async with httpx.AsyncClient() as client: user_info_response = await client.get( "https://graph.microsoft.com/v1.0/me", headers=headers ) if user_info_response.status_code != 200: logger.error(f"Failed to get user info: {user_info_response.text}") raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="Failed to get user info from Microsoft" ) user_info = user_info_response.json() logger.info(f"Got user info from Microsoft: {user_info.get('userPrincipalName')}") if state_type == "login": # Handle login flow rootInterface = getRootInterface() user = rootInterface.getUserByUsername(user_info.get("userPrincipalName")) if not user: logger.info(f"Creating new user for {user_info.get('userPrincipalName')}") # Create new user if doesn't exist user = rootInterface.createUser( username=user_info.get("userPrincipalName"), email=user_info.get("mail"), fullName=user_info.get("displayName"), authenticationAuthority=AuthAuthority.MSFT, externalId=user_info.get("id"), externalUsername=user_info.get("userPrincipalName"), externalEmail=user_info.get("mail") ) # Create token token = Token( userId=user.id, # Use local user's ID authority=AuthAuthority.MSFT, tokenAccess=token_response["access_token"], tokenRefresh=token_response.get("refresh_token", ""), tokenType=token_response.get("token_type", "bearer"), expiresAt=createExpirationTimestamp(token_response.get("expires_in", 0)), createdAt=getUtcTimestamp() ) # Save access token (no connectionId) appInterface = getInterface(user) appInterface.saveAccessToken(token) # Create JWT token data # MULTI-TENANT: Token does NOT contain mandateId anymore jwt_token_data = { "sub": user.username, "userId": str(user.id), "authenticationAuthority": AuthAuthority.MSFT.value # NO mandateId in token - stateless multi-tenant design } # Create JWT access token jwt_token, jwt_expires_at = createAccessToken(jwt_token_data) # Create refresh token refresh_token, _refresh_expires = createRefreshToken(jwt_token_data) # Decode token to get jti for database record from jose import jwt payload = jwt.decode(jwt_token, SECRET_KEY, algorithms=[ALGORITHM]) jti = payload.get("jti") # Create JWT token with matching id # MULTI-TENANT: Token model no longer has mandateId field jwt_token_obj = Token( id=jti, userId=user.id, authority=AuthAuthority.MSFT, tokenAccess=jwt_token, tokenType="bearer", expiresAt=jwt_expires_at.timestamp(), createdAt=getUtcTimestamp() # NO mandateId - Token is not mandate-bound ) # Save JWT access token appInterface.saveAccessToken(jwt_token_obj) # Convert token to dict and ensure proper timestamp handling token_dict = jwt_token_obj.model_dump() # Remove datetime conversion logic - models now handle this automatically # The token model already returns float timestamps # Create HTML response html_response = HTMLResponse( content=f"""