Files
url_shortening_service/site/links/auth.py
T
westfarn 630b770c12
Deploy Beta / unit-tests (push) Successful in 4s
Deploy Beta / docker (push) Successful in 13s
Deploy Beta / deploy-beta (push) Successful in 2m38s
Implement v1 URL shortener (Bearer API, public 302, landing, CI) (#2)
## Summary

- Standalone Django 6 shortener: Bearer `/api/links/` (create/list/detail/disable) and public `GET /<code>` 302
- Host split, target-host allowlist, named rotatable tokens; `short_url` from `PUBLIC_SHORT_URL`
- Landing page, DEBUG-only `/debug/` mint form, Django admin
- Docker/compose (host **8005**), Gitea CI like monica_site (PR tests, beta on merge, prod button)
- Caller contract in `API.md`

Closes #1. Infra follow-up: [server-infra#22](ai_ml_operations/server-infra#22).

## Test plan
- [ ] `cd site && uv run python manage.py test`
- [ ] `docker compose up --build` → http://127.0.0.1:8005/
- [ ] `POST /api/links/` with `Bearer monica:dev-only-token` → 201
- [ ] `GET /<code>` → 302 to allowlisted https URL
- [ ] No Bearer → 401; non-allowlisted host → 400
- [ ] `/debug/` only when `DEBUG=true`

Reviewed-on: #2
2026-08-30 04:55:33 -07:00

65 lines
2.1 KiB
Python

"""Bearer token auth for /api/. The lock that keeps a public API host closed."""
from __future__ import annotations
import hmac
from collections.abc import Callable
from functools import wraps
from django.conf import settings
from django.http import HttpRequest, JsonResponse
from django.views.decorators.csrf import csrf_exempt
def parse_bearer(request: HttpRequest) -> str | None:
header = request.META.get("HTTP_AUTHORIZATION") or ""
if not header.startswith("Bearer "):
return None
token = header[7:].strip()
return token or None
def authenticate_token(raw_token: str | None) -> str | None:
"""Return the configured token name, or None if no match.
Accepts either ``name:secret`` (as callers send) or the bare secret.
Always compares against every configured token (constant-time).
"""
configured = list(getattr(settings, "SHORTENER_API_TOKENS", []) or [])
if not configured or not raw_token:
return None
matched_name: str | None = None
for name, secret in configured:
full = f"{name}:{secret}"
if hmac.compare_digest(raw_token, full) or hmac.compare_digest(raw_token, secret):
matched_name = name
# Keep looping so compare_digest runs for every token.
return matched_name
def token_name_for_request(request: HttpRequest) -> str | None:
return authenticate_token(parse_bearer(request))
def require_bearer(view: Callable) -> Callable:
"""Decorator: 503 if no tokens configured, 401 if missing/wrong Bearer."""
@csrf_exempt
@wraps(view)
def wrapper(request, *args, **kwargs):
configured = list(getattr(settings, "SHORTENER_API_TOKENS", []) or [])
if not configured:
return JsonResponse({"detail": "Service unavailable"}, status=503)
name = token_name_for_request(request)
if not name:
response = JsonResponse({"detail": "Unauthorized"}, status=401)
response["WWW-Authenticate"] = "Bearer"
return response
request.token_name = name
return view(request, *args, **kwargs)
return wrapper