"""Users, roles and permissions. These turn auth on for the controller they run against, and the API cannot turn it off again (the last admin cannot be removed). Run them only against a throwaway controller, and set LED_AUTH_TEST=1 to confirm: LED_AUTH_TEST=1 python -m pytest test_auth.py --host 127.0.0.1:8091 """ import os import time import uuid import pytest import requests TIMEOUT = 10 ADMIN_PW = "admin-pass-1234" OP_PW = "operator-pass-1234" def _base(host): return host if host.startswith("http") else f"http://{host}" @pytest.fixture(scope="module") def host(request): h = request.config.getoption("--host") or os.environ.get("LED_HOST") if not h: pytest.skip("no controller: pass --host or set LED_HOST") if os.environ.get("LED_AUTH_TEST") != "1": pytest.skip("auth tests switch auth on for good: set LED_AUTH_TEST=1 on a throwaway controller") return _base(h) def anon(host): s = requests.Session() s.headers.update({"User-Agent": "pytest/requests", "Accept": "application/json"}) s.base = host return s def call(s, method, path, **kw): kw.setdefault("timeout", TIMEOUT) return s.request(method, s.base + path, **kw) def login(host, user, pw): s = anon(host) r = call(s, "POST", "/auth/login", json={"username": user, "password": pw}) assert r.status_code == 200, r.text return s @pytest.fixture(scope="module") def admin(host): """Creates the first admin (open while no user exists), then signs in as them.""" st = call(anon(host), "GET", "/auth").json() if st.get("enabled"): pytest.skip("this controller already has users: run against a fresh one") name = "admin" + uuid.uuid4().hex[:6] r = call(anon(host), "POST", "/auth/users", json={"username": name, "password": ADMIN_PW, "role": "admin"}) assert r.status_code == 200, r.text return login(host, name, ADMIN_PW) def test_open_until_first_user(host): s = anon(host) st = call(s, "GET", "/auth").json() if st["enabled"]: pytest.skip("auth already on") assert call(s, "GET", "/presets").status_code == 200 created = call(s, "POST", "/presets", json={"name": "auth-open-" + uuid.uuid4().hex[:6]}) assert created.status_code in (200, 201), created.text def test_signed_out_reads_and_edits(host, admin): s = anon(host) assert call(s, "GET", "/presets").status_code == 200 # guest role: view assert call(s, "GET", "/zones").status_code == 200 assert call(s, "POST", "/presets", json={"name": "nope"}).status_code == 401 # signed out: login required assert call(s, "GET", "/auth/users").status_code == 401 # users area is not in the guest role def test_signed_out_has_no_settings_or_users(host, admin): s = anon(host) assert call(s, "GET", "/settings").status_code == 401 # guest role: no settings view assert call(s, "GET", "/db/user").status_code == 401 def test_viewer_does_not_see_wifi_password(host, admin): role = "view" + uuid.uuid4().hex[:6] perms = {"presets": 1, "sequences": 1, "zones": 1, "groups": 1, "devices": 1, "outputs": 1, "patterns": 1, "sim": 1, "settings": 1, "users": 0} assert call(admin, "POST", "/auth/roles", json={"name": role, "perms": perms}).status_code == 200 user = "v" + uuid.uuid4().hex[:6] assert call(admin, "POST", "/auth/users", json={"username": user, "password": OP_PW, "role": role}).status_code == 200 viewer = login(host, user, OP_PW) r = call(viewer, "GET", "/settings") assert r.status_code == 200 assert "ap_password" not in r.json() assert call(viewer, "PUT", "/settings", json={"global_brightness": 10}).status_code == 403 def test_password_hashes_never_returned(host, admin): for path in ("/auth/users", "/db/user", "/auth"): text = call(admin, "GET", path).text assert "hash" not in text and "salt" not in text, path def test_wrong_password_refused(host, admin): r = call(anon(host), "POST", "/auth/login", json={"username": "nobody-here", "password": "x" * 9}) assert r.status_code == 401 def test_admin_can_edit(host, admin): r = call(admin, "POST", "/presets", json={"name": "auth-admin-" + uuid.uuid4().hex[:6]}) assert r.status_code in (200, 201), r.text def test_custom_role_and_its_limits(host, admin): role = "op" + uuid.uuid4().hex[:6] perms = {"presets": 1, "sequences": 2, "zones": 1, "groups": 1, "devices": 1, "outputs": 1, "patterns": 1, "sim": 1, "settings": 0, "users": 0} assert call(admin, "POST", "/auth/roles", json={"name": role, "perms": perms}).status_code == 200 user = "u" + uuid.uuid4().hex[:6] assert call(admin, "POST", "/auth/users", json={"username": user, "password": OP_PW, "role": role}).status_code == 200 op = login(host, user, OP_PW) assert call(op, "POST", "/presets", json={"name": "x"}).status_code == 403 # view only on presets assert call(op, "GET", "/auth/users").status_code == 403 # no users area assert call(op, "POST", "/sequences/1/play", json={"zone_id": "1"}).status_code not in (401, 403) # control assert call(op, "POST", "/sequences", json={}).status_code == 403 # editing sequences needs edit # raising the role takes effect at once, for a session that already exists perms["sequences"] = 3 assert call(admin, "PUT", f"/auth/roles/{role}", json={"perms": perms}).status_code == 200 assert call(op, "POST", "/sequences", json={}).status_code != 403 # logging out drops the session assert call(op, "POST", "/auth/logout").status_code == 200 assert call(op, "GET", "/auth/users").status_code == 401 def test_admin_role_is_fixed(host, admin): perms = {a: 3 for a in ["presets", "sequences", "zones", "groups", "devices", "outputs", "patterns", "sim", "settings", "users"]} perms["users"] = 2 assert call(admin, "PUT", "/auth/roles/admin", json={"perms": perms}).status_code == 400 assert call(admin, "DELETE", "/auth/roles/admin").status_code == 400 def test_last_manager_cannot_be_removed(host, admin): me = call(admin, "GET", "/auth").json()["user"] assert me r = call(admin, "DELETE", f"/auth/users/{me}") assert r.status_code == 400, r.text def test_unknown_area_in_perms_refused(host, admin): r = call(admin, "POST", "/auth/roles", json={"name": "bad" + uuid.uuid4().hex[:4], "perms": {"nope": 3}}) assert r.status_code == 400 def test_login_lockout(host, admin): s = anon(host) codes = [call(s, "POST", "/auth/login", json={"username": "nobody-x", "password": "wrong-wrong"}).status_code for _ in range(6)] assert 429 in codes and codes[-1] == 429, codes # the lock is per username: the admin can still sign in while the other name is locked me = call(admin, "GET", "/auth").json()["user"] assert call(anon(host), "POST", "/auth/login", json={"username": me, "password": ADMIN_PW}).status_code == 200 time.sleep(31) # the first lock is 30 seconds assert call(anon(host), "POST", "/auth/login", json={"username": "nobody-x", "password": "wrong-wrong"}).status_code == 401