"""Reverse proxy for admin-configured terminal servers. Routes: GET / — list terminals the user has access to * /{server_id}/{path:path} — proxy request to terminal server """ import logging import posixpath from urllib.parse import unquote import aiohttp from fastapi import APIRouter, Depends, Request, Response, WebSocket from fastapi.responses import JSONResponse, StreamingResponse from starlette.background import BackgroundTask from open_webui.utils.auth import get_verified_user from open_webui.utils.access_control import has_connection_access from open_webui.models.groups import Groups from open_webui.models.users import Users log = logging.getLogger(__name__) router = APIRouter() STREAMING_CONTENT_TYPES = ('application/octet-stream', 'image/', 'application/pdf') STRIPPED_RESPONSE_HEADERS = frozenset(('transfer-encoding', 'connection', 'content-encoding', 'content-length')) def _sanitize_proxy_path(path: str) -> str | None: """Sanitize a proxy path to prevent directory traversal / SSRF. Returns the cleaned path, or None if the path is invalid. Trailing slashes are preserved — many upstream frameworks treat ``/path`` and ``/path/`` differently. """ decoded = unquote(path) had_trailing_slash = decoded.endswith('/') normalized = posixpath.normpath(decoded) # Remove any leading slashes that would reset the base cleaned = normalized.lstrip('/') # Reject if normpath resolved to parent traversal or current-dir only if cleaned.startswith('..') or cleaned == '.': return None # Restore trailing slash if the original path had one if had_trailing_slash and cleaned and not cleaned.endswith('/'): cleaned += '/' return cleaned @router.get('/') async def list_terminal_servers(request: Request, user=Depends(get_verified_user)): """Return terminal servers the authenticated user has access to.""" connections = request.app.state.config.TERMINAL_SERVER_CONNECTIONS or [] user_group_ids = {group.id for group in Groups.get_groups_by_member_id(user.id)} return [ { 'id': connection.get('id', ''), 'url': connection.get('url', ''), 'name': connection.get('name', ''), } for connection in connections if connection.get('enabled', True) and has_connection_access(user, connection, user_group_ids) ] PROXY_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] @router.api_route('/{server_id}/{path:path}', methods=PROXY_METHODS) async def proxy_terminal( server_id: str, path: str, request: Request, user=Depends(get_verified_user), ): """Proxy a request to the admin terminal server identified by *server_id*.""" connections = request.app.state.config.TERMINAL_SERVER_CONNECTIONS or [] connection = next((c for c in connections if c.get('id') == server_id), None) if connection is None: return JSONResponse({'error': f"Terminal server '{server_id}' not found"}, status_code=404) user_group_ids = {group.id for group in Groups.get_groups_by_member_id(user.id)} if not has_connection_access(user, connection, user_group_ids): return JSONResponse({'error': 'Access denied'}, status_code=403) base_url = (connection.get('url') or '').rstrip('/') if not base_url: return JSONResponse({'error': 'Terminal server URL not configured'}, status_code=503) safe_path = _sanitize_proxy_path(path) if safe_path is None: return JSONResponse({'error': 'Invalid path'}, status_code=400) target_url = f'{base_url}/{safe_path}' # Route through orchestrator policy endpoint if policy_id is set policy_id = connection.get('policy_id') if policy_id: target_url = f'{base_url}/p/{policy_id}/{safe_path}' if request.query_params: target_url += f'?{request.query_params}' headers = {'X-User-Id': user.id} cookies = {} auth_type = connection.get('auth_type', 'bearer') if auth_type == 'bearer': headers['Authorization'] = f'Bearer {connection.get("key", "")}' elif auth_type == 'session': cookies = request.cookies headers['Authorization'] = f'Bearer {request.state.token.credentials}' elif auth_type == 'system_oauth': cookies = request.cookies oauth_token = request.headers.get('x-oauth-access-token', '') if oauth_token: headers['Authorization'] = f'Bearer {oauth_token}' # auth_type == "none": no Authorization header content_type = request.headers.get('content-type') if content_type: headers['Content-Type'] = content_type body = await request.body() session = aiohttp.ClientSession( timeout=aiohttp.ClientTimeout(total=300, connect=10), trust_env=True, ) try: upstream_response = await session.request( method=request.method, url=target_url, headers=headers, cookies=cookies, data=body or None, ) upstream_content_type = upstream_response.headers.get('content-type', '') filtered_headers = { key: value for key, value in upstream_response.headers.items() if key.lower() not in STRIPPED_RESPONSE_HEADERS } # Stream binary responses directly if any(t in upstream_content_type for t in STREAMING_CONTENT_TYPES): async def cleanup(): await upstream_response.release() await session.close() return StreamingResponse( content=upstream_response.content.iter_any(), status_code=upstream_response.status, headers=filtered_headers, background=BackgroundTask(cleanup), ) # Buffer text/JSON responses response_body = await upstream_response.read() status_code = upstream_response.status await upstream_response.release() await session.close() return Response(content=response_body, status_code=status_code, headers=filtered_headers) except Exception as error: await session.close() log.exception('Terminal proxy error: %s', error) return JSONResponse({'error': f'Terminal proxy error: {error}'}, status_code=502) # --------------------------------------------------------------------------- # WebSocket proxy for interactive terminal sessions # --------------------------------------------------------------------------- async def _resolve_authenticated_connection(ws: WebSocket, server_id: str): """Authenticate a WebSocket via first-message auth and resolve the terminal server. The client must send ``{"type": "auth", "token": ""}`` as its first message after connecting. Returns ``(user, connection)`` on success, or ``None`` after closing *ws* with an appropriate error code. """ import asyncio import json from open_webui.utils.auth import decode_token # First-message authentication try: raw = await asyncio.wait_for(ws.receive_text(), timeout=10.0) payload = json.loads(raw) if payload.get('type') != 'auth': await ws.close(code=4001, reason='Expected auth message') return None token = payload.get('token', '') data = decode_token(token) if data is None or 'id' not in data: await ws.close(code=4001, reason='Invalid token') return None user = Users.get_user_by_id(data['id']) if user is None: await ws.close(code=4001, reason='User not found') return None except (asyncio.TimeoutError, json.JSONDecodeError): await ws.close(code=4001, reason='Auth timeout or invalid payload') return None except Exception: await ws.close(code=4001, reason='Invalid token') return None # Resolve terminal server connections = ws.app.state.config.TERMINAL_SERVER_CONNECTIONS or [] connection = next((c for c in connections if c.get('id') == server_id), None) if connection is None: await ws.close(code=4004, reason='Terminal server not found') return None user_group_ids = {group.id for group in Groups.get_groups_by_member_id(user.id)} if not has_connection_access(user, connection, user_group_ids): await ws.close(code=4003, reason='Access denied') return None return user, connection @router.websocket('/{server_id}/api/terminals/{session_id}') async def ws_terminal( ws: WebSocket, server_id: str, session_id: str, ): """Proxy an interactive WebSocket terminal session to a terminal server. Uses first-message auth: the client sends ``{"type": "auth", "token": ""}`` as its first message. The proxy validates the JWT, then connects to the upstream terminal server and authenticates with the server's API key. """ await ws.accept() result = await _resolve_authenticated_connection(ws, server_id) if result is None: return user, connection = result base_url = (connection.get('url') or '').rstrip('/') if not base_url: await ws.close(code=4003, reason='Terminal server URL not configured') return # Build upstream WebSocket URL (no token in URL) ws_base = base_url.replace('https://', 'wss://').replace('http://', 'ws://') # Route through orchestrator policy endpoint if policy_id is set policy_id = connection.get('policy_id') upstream_params = {} # For orchestrator-backed servers, pass user_id upstream_params['user_id'] = user.id import urllib.parse if policy_id: upstream_url = f'{ws_base}/p/{policy_id}/api/terminals/{session_id}' else: upstream_url = f'{ws_base}/api/terminals/{session_id}' if upstream_params: upstream_url += f'?{urllib.parse.urlencode(upstream_params)}' session = aiohttp.ClientSession() try: async with session.ws_connect(upstream_url) as upstream: import asyncio import json as _json # First-message auth to upstream terminal server auth_type = connection.get('auth_type', 'bearer') if auth_type == 'bearer': key = connection.get('key', '') await upstream.send_str(_json.dumps({'type': 'auth', 'token': key})) async def _client_to_upstream(): """Forward client → upstream.""" try: while True: msg = await ws.receive() if msg['type'] == 'websocket.disconnect': break elif 'bytes' in msg and msg['bytes']: await upstream.send_bytes(msg['bytes']) elif 'text' in msg and msg['text']: await upstream.send_str(msg['text']) except Exception: pass async def _upstream_to_client(): """Forward upstream → client.""" try: async for msg in upstream: if msg.type == aiohttp.WSMsgType.BINARY: await ws.send_bytes(msg.data) elif msg.type == aiohttp.WSMsgType.TEXT: await ws.send_text(msg.data) elif msg.type in ( aiohttp.WSMsgType.CLOSE, aiohttp.WSMsgType.ERROR, ): break except Exception: pass await asyncio.gather( _client_to_upstream(), _upstream_to_client(), return_exceptions=True, ) except Exception as e: log.exception('Terminal WebSocket proxy error: %s', e) finally: await session.close() try: await ws.close() except Exception: pass