"""Web-based Login Flow v2 provisioning routes. Provides browser endpoints for provisioning Nextcloud app passwords via Login Flow v2. Used by Astrolabe's "Enable Semantic Search" flow to chain OAuth (bearer token) with Login Flow v2 (app password) in a single user interaction. Flow: 1. GET /app/provision?redirect_uri=... → Initiates LFv2, redirects to NC login 2. User clicks "Grant access" on Nextcloud's login page 3. MCP server background task polls and stores app password 4. GET /app/provision/status?id=... → Returns completion status (JSON) 5. User returns to Astrolabe settings (via redirect_uri or navigation) """ import asyncio import logging import os import secrets import time from urllib.parse import urlparse from starlette.requests import Request from starlette.responses import HTMLResponse, JSONResponse, RedirectResponse from nextcloud_mcp_server.auth.login_flow import LoginFlowV2Client from nextcloud_mcp_server.auth.storage import get_shared_storage from nextcloud_mcp_server.config import get_nextcloud_ssl_verify, get_settings logger = logging.getLogger(__name__) # In-memory store for web provision sessions (short-lived, no persistence needed) # Maps provision_id → session data _provision_sessions: dict[str, dict] = {} # Session TTL: 20 minutes (matches Nextcloud's Login Flow v2 timeout) _SESSION_TTL = 1200 def _cleanup_expired_sessions() -> None: """Remove expired provision sessions.""" now = time.time() expired = [k for k, v in _provision_sessions.items() if v["expires_at"] < now] for k in expired: del _provision_sessions[k] def _validate_redirect_uri(redirect_uri: str) -> bool: """Validate that redirect_uri is a reasonable URL (not javascript: etc).""" try: parsed = urlparse(redirect_uri) return parsed.scheme in ("http", "https") and bool(parsed.netloc) except Exception: return False async def _poll_and_store(provision_id: str) -> None: """Background task: poll Login Flow v2 and store app password on completion.""" session = _provision_sessions.get(provision_id) if not session: return settings = get_settings() nextcloud_host = settings.nextcloud_host if not nextcloud_host: session["status"] = "expired" return flow_client = LoginFlowV2Client( nextcloud_host=nextcloud_host, verify_ssl=get_nextcloud_ssl_verify(), ) poll_endpoint = session["poll_endpoint"] poll_token = session["poll_token"] user_id = session.get("user_id") # Poll every 2 seconds for up to 20 minutes max_attempts = 600 for _ in range(max_attempts): if provision_id not in _provision_sessions: return # Session was cleaned up try: result = await flow_client.poll(poll_endpoint, poll_token) except Exception as e: logger.warning( f"Login Flow v2 poll error for provision {provision_id}: {e}" ) await asyncio.sleep(2) continue if result.status == "completed": # Store the app password storage = await get_shared_storage() effective_user_id = user_id or result.login_name or "unknown" if not result.app_password: session["status"] = "expired" logger.error( f"Login Flow v2 completed but no app_password (provision_id={provision_id})" ) return await storage.store_app_password_with_scopes( user_id=effective_user_id, app_password=result.app_password, scopes=None, # All scopes username=result.login_name, ) session["status"] = "completed" session["username"] = result.login_name logger.info( f"Login Flow v2 web provision completed for user {effective_user_id} " f"(provision_id={provision_id})" ) return if result.status == "expired": session["status"] = "expired" logger.warning( f"Login Flow v2 web provision expired (provision_id={provision_id})" ) return await asyncio.sleep(2) # Timed out session["status"] = "expired" logger.warning( f"Login Flow v2 web provision timed out (provision_id={provision_id})" ) async def provision_page(request: Request) -> RedirectResponse | HTMLResponse: """Initiate Login Flow v2 and redirect to Nextcloud's login page. GET /app/provision?redirect_uri=...&user_id=... Initiates Login Flow v2, starts background polling, and redirects the browser to Nextcloud's login/grant page. After the user grants access, the background task stores the app password. The user then navigates back to the redirect_uri (Astrolabe settings). """ _cleanup_expired_sessions() redirect_uri = request.query_params.get("redirect_uri", "") user_id = request.query_params.get("user_id", "") if not redirect_uri or not _validate_redirect_uri(redirect_uri): return HTMLResponse( content=_render_error("Missing or invalid redirect_uri parameter."), status_code=400, ) # Check if user already has an app password — skip straight to redirect if user_id: storage = await get_shared_storage() existing = await storage.get_app_password_with_scopes(user_id) if existing: logger.info(f"User {user_id} already has app password, skipping provision") return RedirectResponse(redirect_uri) # Initiate Login Flow v2 settings = get_settings() nextcloud_host = settings.nextcloud_host if not nextcloud_host: return HTMLResponse( content=_render_error("Nextcloud host not configured on server."), status_code=500, ) try: flow_client = LoginFlowV2Client( nextcloud_host=nextcloud_host, verify_ssl=get_nextcloud_ssl_verify(), ) init_response = await flow_client.initiate( user_agent="Astrolabe Background Sync" ) except Exception as e: logger.error(f"Failed to initiate Login Flow v2 for web provision: {e}") return HTMLResponse( content=_render_error(f"Failed to start login flow: {e}"), status_code=502, ) # Create provision session provision_id = secrets.token_urlsafe(32) _provision_sessions[provision_id] = { "status": "pending", "login_url": init_response.login_url, "poll_endpoint": init_response.poll_endpoint, "poll_token": init_response.poll_token, "redirect_uri": redirect_uri, "user_id": user_id, "created_at": time.time(), "expires_at": time.time() + _SESSION_TTL, } # Start background polling task asyncio.create_task(_poll_and_store(provision_id)) logger.info( f"Login Flow v2 web provision initiated (provision_id={provision_id}, " f"user_id={user_id or 'unknown'}), redirecting to NC login" ) # Redirect to Nextcloud's Login Flow v2 login page. # The login_url may use the internal Docker hostname (http://app/...). # Replace with the public Nextcloud URL for the browser. login_url = init_response.login_url public_issuer = os.getenv("NEXTCLOUD_PUBLIC_ISSUER_URL", "") if public_issuer and nextcloud_host: # Extract just scheme+host from NEXTCLOUD_HOST for matching # (NC may omit default ports, e.g. http://app:80 → http://app) parsed = urlparse(nextcloud_host) internal_origin = f"{parsed.scheme}://{parsed.hostname}" if internal_origin in login_url: login_url = login_url.replace(internal_origin, public_issuer.rstrip("/")) return RedirectResponse(login_url) async def provision_status(request: Request) -> JSONResponse: """Check provision session status. GET /app/provision/status?id=... Returns JSON: {"status": "pending"|"completed"|"expired", "username": "..."} """ provision_id = request.query_params.get("id", "") session = _provision_sessions.get(provision_id) if not session: return JSONResponse( { "status": "not_found", "message": "Provision session not found or expired", }, status_code=404, ) response: dict = {"status": session["status"]} if session["status"] == "completed": response["username"] = session.get("username") # Clean up completed session after status is read _provision_sessions.pop(provision_id, None) return JSONResponse(response) # ── HTML rendering helpers ──────────────────────────────────────────────── def _render_error(message: str) -> str: """Render an error page.""" return f"""
{message}