Skip to content

[G2] Auditoría: consulta paginada estable con filtros acotados (#160) - #244

Merged
eribertocz merged 2 commits into
mainfrom
claude/160-audit-pages
Oct 24, 2026
Merged

eribertocz merged 2 commits into
mainfrom
claude/160-audit-pages

Conversation

@eribertocz

Copy link
Copy Markdown
Owner

[Claude]

Closes #160. Refs #159, #161, #128. Apilado sobre #243 (excepción documentada de RUSTSEC-2026-0387); se reapunta a main cuando #243 se integre.

Qué hace

Añade audit::pages::AuditPages: el repositorio interno de lectura paginada del registro de auditoría. No abre endpoint; lo expondrá #161 con su propio permiso y su propia auditoría.

  • Conexión: la única entrada es AuditPages::new(AuditReader, CursorKey). Cada página toma su conexión de AuditReader::acquire() ([G2] Auditoría: conexión lectora separada y privilegios mínimos #159), que comprueba el rol en cada entrega. No acepta pool, URL ni otra conexión, y no conserva ninguna entre páginas.
  • Plazo: 5000 ms monotónicos por página, medidos desde antes de pedir la conexión. Dentro de la transacción BEGIN READ ONLY, cada sentencia lleva set_config('statement_timeout', <lo que queda>, true). Si la página falla o se interrumpe, la conexión se cierra (detach()) y no vuelve al pool. Pasado el plazo nunca se devuelve página, aunque ya se haya decodificado.
  • Petición: PageQuery = Filters + Limit (1..200, 50 por defecto).
    • Actor: 1–128 bytes [A-Za-z0-9_.:-]; su Debug está ocultado.
    • Acción: el enum cerrado vigente (query en el wire).
    • Instantes: RFC 3339 en UTC con Z; from incluido, to excluido, y se exige from < to.
  • SQL: cuatro sentencias estáticas, una por combinación de filtros indexados (todas / actor / acción / actor+acción).
    • Valores siempre enlazados, LIMIT limit+1 para saber si hay más, sin OFFSET.
    • El rango compara occurred_at como texto normalizado a 9 decimales, exacto al nanosegundo, porque timestamptz redondearía a microsegundos.
  • Instantánea lógica: la primera página lee el audit_head confirmado con un SELECT simple, sin bloqueo. Todas las páginas se quedan en ese tope o por debajo, así que lo añadido durante la caminata ni aparece ni la desplaza. Leer no espera al appender.
  • Cursor v1: 89 bytes en base64url (119 caracteres; se rechaza antes de decodificar si supera 1024). Contiene versión, última secuencia, tope, caducidad, huella HMAC de filtros y límite, y una etiqueta HMAC-SHA256 con dominios separados.
    • Caduca 15 minutos después de la primera página y no se renueva.
    • Clave propia CursorKey (32 bytes de getrandom, sin alternativa constante, Debug ocultado), distinta de ContextKey.
    • Rechazos: cursor_invalid (malformado, editado u otra clave, indistinguibles), cursor_version, cursor_expired, cursor_mismatch. Se comprueba antes de pedir conexión.
  • Salida: {"events":[...],"next_cursor":...}, contada mientras se escribe. Si no cabe en 4 194 304 bytes devuelve BudgetExceeded, sin truncar. Un evento almacenado inválido hace fallar la página sin repetir su contenido.
  • Observabilidad: tracing con event_code y conteos, y métricas OTel opcionales bi.audit.page.duration y bi.audit.page.requests con result de vocabulario cerrado. Nunca se registran actores, cursores ni filas.

Amenazas

  • Qué se protege: el registro de auditoría frente a lecturas con credenciales equivocadas, cursores forjados o editados para saltar filtros o ampliar el rango, consultas que retengan conexiones o bloqueen al escritor, y fugas en logs o errores.
  • Cómo:
    • el rol lector se verifica en cada entrega;
    • el cursor está autenticado y ligado a filtros y límite;
    • plazo doble (cliente y PostgreSQL), con descarte de la conexión;
    • SQL estático parametrizado;
    • errores de vocabulario cerrado.
  • Cómo se prueba: ver la tabla siguiente, con PostgreSQL real y rol lector real.

Criterio → prueba

Criterio Prueba
Caminata estable y completa 7 eventos en páginas 3→3→1; la misma cadena de cursores es repetible; los eventos 8/9 añadidos entre páginas no entran en la caminata iniciada en 7. proptest: cualquier recorrido visita cada evento una vez y en orden
Filtros y límites límites 1..8 con cada filtro y combinación; cadena vacía; rango from/to exacto al nanosegundo
Cursor proptest: cualquier byte editado se rechaza; otra clave, otra versión, caducado y otros filtros o límite dan su código; huella inyectiva (proptest)
Presupuesto cabe exacto y se rechaza con un byte menos (proptest), sin truncar
Plazo 300 ms con un lock tardan 301 ms y la conexión no vuelve al pool; con el pool agotado se corta a los 5,015 s
Solo el lector el dueño, el runtime y el superusuario se rechazan como lector; grant → rechazo → revoke → recuperación, incluido DDL persistente
Sin bloquear al escritor leer no espera al appender
Sin eco ni secretos un evento almacenado inválido falla sin eco; logs y métricas sin actor, cursor ni filas
Plan EXPLAIN con 2000 eventos: Index Scan using audit_actor_sequence … Index Cond: (actor = $6 AND sequence > $1 AND sequence <= $2), sin Sort ni Seq Scan; acción denial con valores → Bitmap Index Scan on audit_action_sequence

Verificación

Windows 11 con PostgreSQL propio. Desde backend:

cargo fmt --all --check                                                       OK
cargo clippy --locked -j 4 -p bi-server --no-default-features --features dev-auth,postgres-tests --all-targets -- -D warnings   OK
cargo clippy ... --features postgres-tests --all-targets -- -D warnings       OK
cargo test ... --lib audit::                                                  34 OK (21 nuevos, 4 proptest)
cargo test ... --features postgres-tests --test postgres --test audit         14 OK (+1 ignorada: medición) / 30 OK
cargo test ... --features dev-auth,postgres-tests --test postgres             33 OK (+1 ignorada)
cargo build --locked -j 4 -p bi-server --no-default-features                  OK
cargo deny --locked check                                                     advisories/bans/licenses/sources ok

Latencia (debug, 2000 eventos, p50/p95 en ms):

Caso p50 p95
Primera página en frío 73,6 91,7
En caliente, limit 50 8,6 11,0
Página siguiente 8,2 11,1
Limit 200 14,0 18,4
Filtro por actor 7,4 9,6

Notas

🤖 Generated with Claude Code

Claude Code and others added 2 commits October 24, 2026 08:06
…t 0.5 vía openidconnect)

No existe versión corregida alcanzable: openidconnect 4.0.1 (última) fija
p256/p384 0.13 -> elliptic-curve 0.13 -> crypto-bigint 0.5.5, y el arreglo
solo está en 0.7.6. El servidor solo verifica firmas ES256 públicas del JWKS;
no tiene clave privada EC ni ruta de firma, ECDH o descifrado. Mismo criterio
que RUSTSEC-2023-0071 (rsa). Se retira cuando openidconnect pase a
elliptic-curve >= 0.14 (#70).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…esto (#160)

Repositorio interno AuditPages sobre AuditReader (#159): caminata por
sequence con tope capturado en la primera página, cursor v1 HMAC-SHA256
(caduca a los 15 min, ligado a filtros y límite), plazo de 5 s por página
en cliente y en PostgreSQL, y JSON de 4 MiB como máximo sin truncar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@eribertocz

Copy link
Copy Markdown
Owner Author

[Codex]

Veredicto: Aprobado sobre bef1c061099eaeb98f80b38c7303698d4d5b72f3, contra #160. #243 ya está integrado y este PR fue reapuntado a main antes de borrar su rama base. El árbol de fusión calculado incorpora exactamente los ocho archivos de #160 sobre main.

Lectura de seguridad/SQL/cursor/concurrencia y comprobación de todos los criterios:

  • Única entrada AuditReader; acquire y revalidación en cada página, sin pool/URL alternativos. Rechazo de owner/runtime/superusuario y grant→rechazo→revoke→recuperación, incluido DDL persistente.
  • Siete eventos 3→3→1 y máximo inicial estable frente al append de 8/9; límites, filtros combinados y extremos UTC exactos al nanosegundo; SQL estático con valores enlazados y sin OFFSET. Lectura de audit_head sin bloquear al appender.
  • HMAC-SHA256 con dominios separados y clave dedicada, filtros/limit ligados, caducidad sin renovación, límite de entrada previo a decode, errores tipados y sin eco. Propiedades de alteración, ámbito, presupuesto y recorrido.
  • Deadline total desde antes de acquire, statement_timeout remanente y descarte al fallar; codificación dentro de 4 MiB, exacto cabe y un byte menos rechaza. Evento inválido falla cerrado. EXPLAIN real prueba los índices; métricas y logs de vocabulario cerrado. Sigue siendo repositorio interno, sin HTTP/UI ni afirmar verificación criptográfica de toda la cadena.

Ejecutado en worktree aislado, PostgreSQL 18 y roles reales propios, Rust fijado, DuckDB precompilado, CARGO_TARGET_DIR=C:/t/codex, debug line-tables-only y -j 4:

cargo test --locked -j 4 -p bi-server --no-default-features --features dev-auth,postgres-tests --lib audit::                 34 OK
cargo test [mismas opciones] --test postgres --test audit -- --test-threads=2                                           33 + 30 OK, 1 medición ignorada
cargo clippy --locked -j 4 -p bi-server --no-default-features --features dev-auth,postgres-tests --all-targets -- -D warnings  OK
cargo build --locked -j 4 -p bi-server --no-default-features                                                               OK
cargo fmt --all --check; git diff --check                                                                                 OK

Aceptación adicional temporal codex_cancelled_page_does_not_recycle_active_statement: cancelar el future mientras PostgreSQL espera un lock real no devuelve una conexión activa como ociosa; el trabajo abandonado termina dentro del presupuesto original y la siguiente página recupera 1/2/3. 1 OK. Guardada fuera y retirada del worktree; no se incorpora código del revisor al producto. La medición de latencia entregada fue revisada, no repetida; sí se ejecutó el test EXPLAIN y los presupuestos.

Ocho checks del mismo head verdes, sin dependientes. Squash con Claude como coautor.

✅ Hecho: lectura interna paginada de #160 verificada · 🔍 Verificación: pruebas reales, propiedades, cancelación y CI verde · ➡️ Siguiente: #161 conserva su propia conformidad pendiente; no se habilita HTTP ni se cierra #71/G2.

@eribertocz
eribertocz merged commit 7a8cfc1 into main Oct 24, 2026
8 checks passed
@eribertocz
eribertocz deleted the claude/160-audit-pages branch October 24, 2026 14:10
eribertocz added a commit that referenced this pull request Oct 25, 2026
Corrige la preparación del pool sin debilitar el rechazo de cursores antes de adquirir conexión. Refs #128, #244.

Co-authored-by: Claude Code <claude-code@bi-platform.invalid>
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.

[G2] Auditoría: consulta paginada estable con filtros acotados

1 participant