Skip to content

~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.

2.4 KB
Raw Blame
# allow: no-sut-import — black-box HTTP test; drives real routes through the Flask test client
"""Test API v1 authentication guard."""

import pytest


class TestApiV1Auth:
    """Test that /api/v1/ endpoints require authentication."""

    def test_unauthenticated_returns_401(self, client):
        """Requests with no username (no g.current_user, no session) get 401."""
        response = client.get("/api/v1/")
        assert response.status_code == 401
        data = response.get_json() or {}
        # FastAPI's require_auth raises HTTPException(401, detail=...);
        # the message is exposed under "detail" (Flask used "error").
        assert (data.get("detail") or data.get("error")) == (
            "Authentication required"
        )

    def test_empty_username_rejected(self):
        """require_auth rejects an empty-string username.

        A signed empty-username session can't be injected through the
        Starlette TestClient (sessions are signed), so exercise the guard
        directly: an empty/whitespace username is falsy and must 401.
        """
        from unittest.mock import MagicMock
        from fastapi import HTTPException
        from local_deep_research.web.dependencies.auth import require_auth

        req = MagicMock()
        req.session = {"username": ""}
        with pytest.raises(HTTPException) as exc:
            require_auth(req)
        assert exc.value.status_code == 401

    def test_authenticated_via_g_current_user(self, authenticated_client):
        """A request with g.current_user set passes the auth guard."""
        response = authenticated_client.get("/api/v1/")
        # Should not be 401 — may be 200 or other status depending on
        # downstream logic, but the auth guard itself should pass.
        assert response.status_code != 401

    def test_authenticated_via_session(self, authenticated_client):
        """A request with a valid session username passes the auth guard."""
        # authenticated_client already has a registered user in the session
        response = authenticated_client.get("/api/v1/")
        assert response.status_code != 401

    def test_health_endpoint_no_auth_required(self, client):
        """The /api/v1/health endpoint does not use @api_access_control."""
        response = client.get("/api/v1/health")
        # Health should return 200 even without authentication
        assert response.status_code == 200