* fix(rbac): stack-gate analyst table access via data_packages exclusively
Previously analysts could see a table in ``agnes catalog`` /
``/api/sync/manifest`` either by:
1. being in a group with ``resource_grants(group, 'table', id)``, or
2. being in a group with ``resource_grants(group, 'data_package', …)``
for a package containing the table.
Path 1 leaked: admins who minted a per-table grant without ever
wrapping the table in a data_package still shipped the table to
analysts — directly contradicting the unified-stack mental model
("the stack is the unit of access"). User report:
"i když to admin nedal do data package tak to by default uživatelé
dostali to by se nemělo stát".
New policy: analyst visibility is strictly stack-gated. A table is
visible iff at least one data_package containing it is in the
analyst's stack (required ∪ subscribed). Admin god-mode and the three
internal data-source tables (agnes_sessions / _telemetry / _audit
with row-level RBAC) keep their existing carve-outs.
Touched surfaces:
* ``src/rbac.can_access_table`` + ``get_accessible_tables`` —
routed through ``StackResolver.stack(user, DATA_PACKAGE)`` +
``data_package_tables`` join instead of ``resource_grants(table)``.
* ``app/api/sync._build_direct_tables_section`` — always returns
``[]`` (key kept for older CLI destructuring); per-table grants
no longer manifest.
* Standardised 403 detail across ``/api/data/*``, ``/api/query``,
``/api/v2/sample``, ``/api/v2/scan``, ``/api/v2/schema``:
``Table 'X' is not in your stack. Ask an admin to add it to a
Data Package you have access to (Required or in your stack),
then run `agnes pull` to refresh.`` Single source of truth lives
in ``src.rbac.table_not_in_stack_message`` so the wording stays
consistent across CLI surfaces.
UX side: ``/catalog/t/<id>`` (table detail page) dropped the four
editorial sections (Sample questions, What's inside, Things to know,
Pairs well with) per user feedback — the page's job is now
"what is this table, where do I find it" (hero + parent packages).
Tests:
* ``tests/conftest.grant_table_via_package`` / ``revoke_table_via_package``
— shared helpers that wrap a table in an auto-named data_package +
grant the package required to a custom group. Replaces the legacy
per-test ``_grant_table_to_analyst`` table-grant pattern.
* All 17 previously-failing legacy tests (test_access_control,
test_journey_rbac, test_audit_gap_*, test_rbac, …) migrated to use
the new helper; logic stays the same.
* ``tests/fixtures/analyst_bootstrap._grant_table_access`` updated
to wrap via data_package so the ``test_pat`` fixture's "two table
grants" semantics still ship parquets through ``agnes init``.
* New ``tests/test_table_not_in_stack_message.py`` locks in the
standardised 403 detail across the data + check-access endpoints.
5204 tests passing (added 1).
* fix(catalog): first-demo UX feedback — required-first grouping + longer card description
Two minor polish items from the 2026-05-19 stakeholder demo:
1. Required packages cluster at the top of the Browse grid instead of
being interleaved by ``created_at``. Sort key
``(requirement != 'required', name)`` runs before the adapter
call in both /catalog (data_packages) and /corporate-memory
(memory_domains) so the required block is visible without
scrolling. Regression test pins the order via
``data-id="…"`` position in rendered HTML.
2. ``.stack-card__desc`` line clamp bumped 2 → 4 lines. Two-line clamp
trailed almost every admin-authored description off in "…" before
the second clause, forcing a click-through to read it. The detail
page (/catalog/p/<slug>) keeps the unclamped body for longer
content.
* release: 0.55.3 — stack-gated analyst RBAC (BREAKING) + first-demo UX polish + #345 A/B/C/D + #347 UI consistency
181 lines
7.2 KiB
Python
181 lines
7.2 KiB
Python
"""Tests for src/rbac.py — table access via resource_grants (v19+).
|
|
|
|
``can_access_table`` and ``get_accessible_tables`` are thin wrappers over
|
|
``app.auth.access.can_access`` / ``is_user_admin``. Admin group members see
|
|
everything; non-admin users see only tables with a matching
|
|
``resource_grants(group, "table", id)`` row via any of their groups.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
|
|
import pytest
|
|
|
|
|
|
@pytest.fixture
|
|
def setup_db(tmp_path, monkeypatch):
|
|
monkeypatch.setenv("DATA_DIR", str(tmp_path))
|
|
from src.db import SYSTEM_ADMIN_GROUP, get_system_db
|
|
from src.repositories.user_group_members import UserGroupMembersRepository
|
|
from src.repositories.user_groups import UserGroupsRepository
|
|
from src.repositories.users import UserRepository
|
|
|
|
conn = get_system_db()
|
|
UserRepository(conn).create(id="admin1", email="admin@test.com", name="Admin")
|
|
UserRepository(conn).create(id="user1", email="user@test.com", name="User")
|
|
|
|
admin_gid = conn.execute(
|
|
"SELECT id FROM user_groups WHERE name = ?", [SYSTEM_ADMIN_GROUP]
|
|
).fetchone()[0]
|
|
UserGroupMembersRepository(conn).add_member("admin1", admin_gid, source="system_seed")
|
|
|
|
# Custom group + grant: user1 ∈ analysts, analysts can see "orders"
|
|
analysts = UserGroupsRepository(conn).create(
|
|
name="analysts", description="test group", created_by="test",
|
|
)
|
|
UserGroupMembersRepository(conn).add_member(
|
|
"user1", analysts["id"], source="admin", added_by="test",
|
|
)
|
|
conn.execute(
|
|
"INSERT INTO table_registry (id, name) VALUES (?, ?)",
|
|
["orders", "orders"],
|
|
)
|
|
conn.execute(
|
|
"INSERT INTO table_registry (id, name) VALUES (?, ?)",
|
|
["salaries", "salaries"],
|
|
)
|
|
# Stack-gated RBAC: wrap 'orders' in an auto data_package and grant the
|
|
# package to the analysts group with required=true so it lands in the
|
|
# user's stack automatically. Per-table grants on resource_grants are
|
|
# no longer consulted for analyst visibility.
|
|
from src.repositories.data_packages import DataPackagesRepository
|
|
pkgs = DataPackagesRepository(conn)
|
|
pkg_id = pkgs.create(
|
|
name="orders-pkg", slug="orders-pkg",
|
|
description=None, icon=None, color=None,
|
|
created_by="test",
|
|
)
|
|
pkgs.add_table(pkg_id, "orders", added_by="test")
|
|
conn.execute(
|
|
"""INSERT INTO resource_grants
|
|
(id, group_id, resource_type, resource_id, requirement)
|
|
VALUES (?, ?, 'data_package', ?, 'required')""",
|
|
[str(uuid.uuid4()), analysts["id"], pkg_id],
|
|
)
|
|
|
|
conn.close()
|
|
yield
|
|
|
|
|
|
class TestCanAccessTable:
|
|
"""Admin shortcut + per-(group, table) grants. No is_public, no
|
|
dataset_permissions, no bucket wildcards — explicit grants only."""
|
|
|
|
def test_admin_sees_every_table(self, setup_db):
|
|
from src.db import get_system_db
|
|
from src.rbac import can_access_table
|
|
conn = get_system_db()
|
|
try:
|
|
admin = {"id": "admin1"}
|
|
assert can_access_table(admin, "orders", conn) is True
|
|
assert can_access_table(admin, "salaries", conn) is True
|
|
# Admin can even ask about tables that don't exist.
|
|
assert can_access_table(admin, "nonexistent", conn) is True
|
|
finally:
|
|
conn.close()
|
|
|
|
def test_non_admin_sees_only_granted_tables(self, setup_db):
|
|
from src.db import get_system_db
|
|
from src.rbac import can_access_table
|
|
conn = get_system_db()
|
|
try:
|
|
user = {"id": "user1"}
|
|
# user1's group "analysts" was granted resource_id='orders'
|
|
assert can_access_table(user, "orders", conn) is True
|
|
# No grant for 'salaries' → denied
|
|
assert can_access_table(user, "salaries", conn) is False
|
|
finally:
|
|
conn.close()
|
|
|
|
def test_no_implicit_public_access(self, setup_db):
|
|
"""Pre-v19 a freshly registered table was implicitly public via
|
|
``is_public DEFAULT true``. v19 removes the column — every
|
|
non-admin access requires an explicit grant. Verify by
|
|
registering a fresh table and asserting denial."""
|
|
from src.db import get_system_db
|
|
from src.rbac import can_access_table
|
|
conn = get_system_db()
|
|
try:
|
|
conn.execute(
|
|
"INSERT INTO table_registry (id, name) VALUES (?, ?)",
|
|
["fresh_table", "fresh_table"],
|
|
)
|
|
user = {"id": "user1"}
|
|
assert can_access_table(user, "fresh_table", conn) is False
|
|
finally:
|
|
conn.close()
|
|
|
|
def test_unknown_user_id_denied(self, setup_db):
|
|
from src.db import get_system_db
|
|
from src.rbac import can_access_table
|
|
conn = get_system_db()
|
|
try:
|
|
assert can_access_table({"id": "ghost"}, "orders", conn) is False
|
|
# No id at all → denied (defensive default).
|
|
assert can_access_table({}, "orders", conn) is False
|
|
finally:
|
|
conn.close()
|
|
|
|
|
|
class TestGetAccessibleTables:
|
|
"""Admin returns None (= "all"); non-admin returns the grant list."""
|
|
|
|
def test_admin_returns_none(self, setup_db):
|
|
from src.db import get_system_db
|
|
from src.rbac import get_accessible_tables
|
|
conn = get_system_db()
|
|
try:
|
|
assert get_accessible_tables({"id": "admin1"}, conn) is None
|
|
finally:
|
|
conn.close()
|
|
|
|
def test_non_admin_returns_grant_list(self, setup_db):
|
|
from src.db import get_system_db
|
|
from src.rbac import get_accessible_tables
|
|
from connectors.internal.access import INTERNAL_TABLES
|
|
conn = get_system_db()
|
|
try:
|
|
tables = get_accessible_tables({"id": "user1"}, conn)
|
|
internal_ids = {t.registry_id for t in INTERNAL_TABLES}
|
|
# Granted tables + auto-appended internal tables (every
|
|
# authenticated user gets the agnes_* row-scoped views).
|
|
assert "orders" in tables
|
|
assert internal_ids <= set(tables)
|
|
assert set(tables) - internal_ids == {"orders"}
|
|
finally:
|
|
conn.close()
|
|
|
|
def test_user_with_no_grants_returns_empty(self, setup_db):
|
|
from src.db import SYSTEM_EVERYONE_GROUP, get_system_db
|
|
from src.repositories.user_group_members import UserGroupMembersRepository
|
|
from src.repositories.users import UserRepository
|
|
from src.rbac import get_accessible_tables
|
|
from connectors.internal.access import INTERNAL_TABLES
|
|
conn = get_system_db()
|
|
try:
|
|
UserRepository(conn).create(id="loner", email="loner@test.com", name="L")
|
|
# Membership in Everyone alone (no grants on it). The user still
|
|
# gets the agnes_* internal tables (row-level RBAC handles the
|
|
# actual security), but no granted tables.
|
|
everyone = conn.execute(
|
|
"SELECT id FROM user_groups WHERE name = ?", [SYSTEM_EVERYONE_GROUP]
|
|
).fetchone()
|
|
if everyone:
|
|
UserGroupMembersRepository(conn).add_member(
|
|
"loner", everyone[0], source="system_seed",
|
|
)
|
|
internal_ids = {t.registry_id for t in INTERNAL_TABLES}
|
|
assert set(get_accessible_tables({"id": "loner"}, conn)) == internal_ids
|
|
finally:
|
|
conn.close()
|