mirror of
https://github.com/lrnselfreliance/wrolpi.git
synced 2026-11-22 07:56:18 -05:00
A phone's sign-in sheet only shows "Done" once the OS re-probes and gets the genuine success reply. The Controller now remembers each client (by hotspot IP) that has loaded the portal page and answers its later probes with the reply each OS expects (Apple "Success" HTML, Android 204, Windows "Microsoft Connect Test", ...). The set is cleared when the hotspot starts so a new session shows the page again. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
66 lines
2.6 KiB
Python
66 lines
2.6 KiB
Python
"""
|
|
Captive portal routes: the landing page hotspot clients see, and the OS connectivity probes
|
|
which are redirected to it.
|
|
|
|
These live at bare paths (not under /api/) because phones request fixed URLs such as
|
|
`http://captive.apple.com/hotspot-detect.html`; the hotspot's DNS points those hostnames here.
|
|
"""
|
|
import logging
|
|
from pathlib import Path
|
|
|
|
from fastapi import APIRouter, HTTPException, Request
|
|
from fastapi.responses import RedirectResponse, Response
|
|
from fastapi.templating import Jinja2Templates
|
|
|
|
from controller.lib.admin import get_hotspot_device, get_hotspot_ssid
|
|
from controller.lib.captive_portal import (
|
|
PORTAL_PATH,
|
|
PROBE_PATHS,
|
|
PROBE_SUCCESS_RESPONSES,
|
|
acknowledge_client,
|
|
get_hotspot_ip,
|
|
is_captive_portal_enabled,
|
|
is_client_acknowledged,
|
|
)
|
|
from controller.lib.config import is_docker_mode
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
router = APIRouter()
|
|
|
|
templates = Jinja2Templates(directory=str(Path(__file__).parent.parent / "templates"))
|
|
|
|
# Phones must re-probe every time; a cached redirect would show a stale portal.
|
|
NO_STORE = {"Cache-Control": "no-store"}
|
|
|
|
|
|
@router.get(PORTAL_PATH, include_in_schema=False)
|
|
async def portal(request: Request):
|
|
"""The landing page: this WROLPi's address and links to WROLPi and the Controller."""
|
|
if is_docker_mode():
|
|
raise HTTPException(status_code=404)
|
|
ip = get_hotspot_ip(get_hotspot_device())
|
|
if not ip:
|
|
# Hotspot is down; a page with the wrong address is worse than none.
|
|
raise HTTPException(status_code=404)
|
|
# The phone has seen the address; let its next probe succeed so it offers "Done".
|
|
acknowledge_client(request.client.host if request.client else None)
|
|
context = {"ip": ip, "ssid": get_hotspot_ssid()}
|
|
return templates.TemplateResponse(request, "portal.html", context, headers=NO_STORE)
|
|
|
|
|
|
async def probe(request: Request):
|
|
"""
|
|
A connectivity probe. Anything but the expected reply makes the phone show the portal, so
|
|
redirect until this client has loaded the portal page, then give the reply it expects.
|
|
"""
|
|
if not is_captive_portal_enabled():
|
|
raise HTTPException(status_code=404)
|
|
if is_client_acknowledged(request.client.host if request.client else None):
|
|
status, media_type, body = PROBE_SUCCESS_RESPONSES[request.url.path]
|
|
return Response(content=body, status_code=status, media_type=media_type, headers=NO_STORE)
|
|
return RedirectResponse(url=PORTAL_PATH, status_code=302, headers=NO_STORE)
|
|
|
|
|
|
for _path in PROBE_PATHS:
|
|
router.add_api_route(_path, probe, methods=["GET", "HEAD"], include_in_schema=False)
|