Repository navigation
test(api): conformidad CLS por posición con identidad OIDC real (#150) - #294
Open
eribertocz wants to merge 2 commits into
Open
eribertocz wants to merge 2 commits into
eribertocz wants to merge 2 commits into
Conversation
- `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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
[Claude]
Closes #150 · Refs #144 #151 #69 #71 #128
Base apilada:
claude/144-conformance(PR #293, aún sin fusionar). Reutiliza su targetsemantic_conformance, su servidor OIDC restringido y su fixture. Al fusionar #293 hay que reapuntar este PR amain.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).importe_total,filas→[100.30, 2]reserva_centinela(restringida) → 404 neutro ·margen(soloview_masked) → 422masked_unsupportedciudad→El Alto 0.20,La Paz 100.10ciudadconfidencial → 403usage: group·secreto_centinela→ 404 neutrociudad = La Paz→[100.10, 1]ciudadconfidencial → 403usage: filter·nota IS NULL(restringida) → 404 neutroimporte_total > 1por ciudad → soloLa Paz 100.10margen→ 403usage: filter· sobrereserva_centinela→ 404 neutroimporte_totaldesc →La Paz,El Altomargen→ 403usage: orderEn cada caso se comprueba: estado, código y uso denegado; que el rechazo no trae
result,receiptni 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/deniedoquery/failurepara el enmascarado decidido).audited()añadecentinelaysecretoa 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 deventas.yamlconciudadconfidencial. Se crea durante el caso y se borra también si falla (Drop, comoMembers). Niventas.yamlni los datos cambian.a_masked_projection_is_only_explained_and_a_visible_null_is_no_maskcubre el criterio 2:view_maskedconcede solo la proyección tipada:explainmarcadecision.masked = ["m"]sin resultado ni valor, y la ejecución la rechaza entera (filamargende la tabla).ventas_notas.observaciondevuelve[["n","0.20"],[null,"100.10"]]conmasked: 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 queRunsmide (bi.semantic.run.phase.duration) leídas conInMemoryMetricExporter:ciudadconfidencial) registran soloprepare.refused×7 ymasked_unsupported×1.executeyassemble, así que el instrumento ve una ejecución cuando la hay.El arnés gana
harness_runs(pool, analytics, runs);harness_withlo usa sin cambiar su comportamiento.Separación pedida: la frontera y el plan se prueban en proceso (
semantic_query); la API real, ensemantic_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):
gateway.ts: se toma la frontera autorizada antes de cargar; se descarta el bypass dev.security.go: se toman la denegación por defecto y la separación campos/filas.Alternativas descartadas:
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
executeen 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 rolbi_runtimerestringido, DuckLake sembrado conventas.sql, servidor sin dev-auth). El proyecto queda idéntico al original después.100.30en vez de100.10) yDenied("project")en vez degrouphacen fallar la matriz; ambas revertidas.127.0.0.2a un puerto reenviado por Podman se agota. En local se omiteBI_CONFORMANCE_CLIENT_ADDR, que es opcional; en CI (Linux) se usa.Sin dependencias nuevas.
🤖 Generated with Claude Code