Skip to content

test(api): conformidad CLS por posición con identidad OIDC real (#150) - #294

Open
eribertocz wants to merge 2 commits into
claude/144-conformancefrom
claude/150-cls-conformance
Open

eribertocz wants to merge 2 commits into
claude/144-conformancefrom
claude/150-cls-conformance

Conversation

@eribertocz

Copy link
Copy Markdown
Owner

[Claude]

Closes #150 · Refs #144 #151 #69 #71 #128

Base apilada: claude/144-conformance (PR #293, aún sin fusionar). Reutiliza su target semantic_conformance, su servidor OIDC restringido y su fixture. Al fusionar #293 hay que reapuntar este PR a main.

Qué se hizo

Solo pruebas, sin cambios de producto, autorizador ni motor.

API real: tests/semantic_conformance.rs (sin dev-auth, Keycloak + PostgreSQL restringido + DuckLake reales)

each_position_answers_the_oracle_when_granted_and_refuses_whole_when_not: tabla parametrizada para el visor A (oidc-norte).

Posición Concedido → oráculo exacto de A Prohibido → rechazo entero
Selección importe_total, filas → [100.30, 2] reserva_centinela (restringida) → 404 neutro · margen (solo view_masked) → 422 masked_unsupported
GROUP por ciudad → El Alto 0.20, La Paz 100.10 ciudad confidencial → 403 usage: group · secreto_centinela → 404 neutro
WHERE ciudad = La Paz → [100.10, 1] sobre ciudad confidencial → 403 usage: filter · nota IS NULL (restringida) → 404 neutro
HAVING importe_total > 1 por ciudad → solo La Paz 100.10 sobre margen → 403 usage: filter · sobre reserva_centinela → 404 neutro
ORDER importe_total desc → La Paz, El Alto por margen → 403 usage: order

En cada caso se comprueba: estado, código y uso denegado; que el rechazo no trae result, receipt ni ninguna cifra de A; los canarios (centinela, secreto, cifras de B y globales) ausentes de la respuesta; y el evento auditado de esa petición (actor = A; query/success, denial/denied o query/failure para el enmascarado decidido). audited() añade centinela y secreto a lo que ningún evento puede contener, también en los casos previos de #144.

GROUP y WHERE posicionales: la fixture no tiene ninguna dimensión confidencial, y con una restringida el rechazo es el 404 neutro sin posición (la proyección se deniega antes que el grupo). Para que GROUP y WHERE sean el uso que decide, el target añade metrics/ciudad_confidencial.yaml: una copia de ventas.yaml con ciudad confidencial. Se crea durante el caso y se borra también si falla (Drop, como Members). Ni ventas.yaml ni los datos cambian.

a_masked_projection_is_only_explained_and_a_visible_null_is_no_mask cubre el criterio 2:

  • view_masked concede solo la proyección tipada: explain marca decision.masked = ["m"] sin resultado ni valor, y la ejecución la rechaza entera (fila margen de la tabla).
  • Un NULL visible no es máscara: ventas_notas.observacion devuelve [["n","0.20"],[null,"100.10"]] con masked: false.

No se implementa ni se habilita la ejecución enmascarada.

Frontera antes del motor: tests/semantic_query.rs (en proceso, dev-auth)

a_use_refused_at_any_position_never_reaches_execution: el código HTTP y el evento solos no demuestran que no hubo ejecución, así que se usa una evidencia que la composición ya produce, las fases que Runs mide (bi.semantic.run.phase.duration) leídas con InMemoryMetricExporter:

  • Los 8 rechazos (las mismas posiciones, con ciudad confidencial) registran solo prepare.
  • Sus códigos son exactamente refused ×7 y masked_unsupported ×1.
  • Control: una consulta concedida sí registra execute y assemble, así que el instrumento ve una ejecución cuando la hay.

El arnés gana harness_runs(pool, analytics, runs); harness_with lo usa sin cambiar su comportamiento.

Separación pedida: la frontera y el plan se prueban en proceso (semantic_query); la API real, en semantic_conformance. El servidor de producción no expone sus métricas a un cliente externo (OTLP push), por eso la frontera se demuestra en proceso.

Diseño y referentes

Referentes heredados de la especificación aceptada (lecturas del 2026-10-17, sin investigación nueva):

  • Cube gateway.ts: se toma la frontera autorizada antes de cargar; se descarta el bypass dev.
  • Rill security.go: se toman la denegación por defecto y la separación campos/filas.

Alternativas descartadas:

  • Añadir una dimensión confidencial a la fixture compartida: cambiaría el catálogo que usa Playwright.
  • Leer el log del servidor en CI: frágil.

Modelo de amenazas (breve)

Se protegen las columnas y métricas no concedidas frente a un visor autenticado que las nombra en cualquier posición: selección, GROUP, WHERE, HAVING u ORDER. El riesgo es una respuesta más amplia (filtro o grupo omitido), un valor enmascarado ejecutado o un nombre oculto filtrado en el error o la auditoría. Se prueba con un rechazo entero por posición, con canarios en la respuesta y en la auditoría, y con la ausencia de la fase execute en cada rechazo.

Verificación local

  • cargo fmt --all --check ✔
  • cargo clippy -p bi-server --all-targets --features "postgres-tests dev-auth" -- -D warnings ✔ y --test semantic_conformance ✔
  • cargo deny --locked check ✔ (advisories, bans, licenses, sources)
  • cargo test -p bi-server --features "postgres-tests dev-auth" --test semantic_query: 14/14 (PostgreSQL 18 real)
  • cargo test -p bi-server --no-default-features --features postgres-tests --test semantic_conformance -- --test-threads=1: 5/5 contra una réplica local del job OIDC (Podman: Keycloak 26.4.7, PostgreSQL 18 con rol bi_runtime restringido, DuckLake sembrado con ventas.sql, servidor sin dev-auth). El proyecto queda idéntico al original después.
  • Mutaciones: una cifra del oráculo alterada (100.30 en vez de 100.10) y Denied("project") en vez de group hacen fallar la matriz; ambas revertidas.
  • En Windows, conectar desde 127.0.0.2 a un puerto reenviado por Podman se agota. En local se omite BI_CONFORMANCE_CLIENT_ADDR, que es opcional; en CI (Linux) se usa.

Sin dependencias nuevas.

🤖 Generated with Claude Code

Claude Code and others added 2 commits October 25, 2026 23:16
- `semantic_conformance`: selección, GROUP, WHERE, HAVING y ORDER, cada
  uno concedido (oráculo exacto de A) y prohibido (403 con el uso
  denegado, 404 neutro o `masked_unsupported`), con canarios fuera de
  respuestas y auditoría; `view_masked` solo explica la proyección y un
  NULL visible no es máscara. Un modelo temporal con `ciudad`
  confidencial da los rechazos posicionales de GROUP y WHERE.
- `semantic_query`: la frontera en proceso, con las fases que el
  servidor ya mide: cada rechazo registra solo `prepare`; el control
  concedido llega a `execute`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant