Saltar a contenido

0009. Autorización: root sólo lectura; permisos por endpoint pendientes

Estado: Aceptado Fecha: 2026-10-05 Autor: David Garcia Módulo(s) afectado(s): app/core/permisos.py, app/core/exceptions_handlers.py

Contexto

Identidad emite a root (administrador de la plataforma) un token sin permisos: su acceso es por rol (ADR 0023 transversal; ADR 0037 de identidad). Este servicio debe decidir qué puede hacer root con datos de negocio de una empresa. Además, el claim permisos de los demás usuarios hoy trae el código de la acción sin el menú (crear, no pedidos.crear), así que no identifica sobre qué recurso aplica.

Decisión

  • root sólo lee en este servicio. Un método distinto de GET, HEAD u OPTIONS responde 403.
  • La regla va en la dependencia autorizar, declarada en el router padre: un endpoint nuevo queda cubierto sin tener que declararla.
  • La regla va por método HTTP, no por endpoint.
  • Los permisos por endpoint quedan pendientes hasta que identidad emita códigos que incluyan el menú. Hasta entonces, cualquier usuario autenticado que no sea root puede leer y escribir en su empresa.

Alternativas descartadas

  • root con acceso total — un administrador de la plataforma no es un usuario de negocio; un pedido creado por él no tiene responsable.
  • Bloquear a root por completo — pierde el soporte y la auditoría.
  • Interpretar hoy el claim permisos — crear no dice si es crear un pedido o una visita: concedería de más.
  • Declarar la regla en cada endpoint — basta olvidar uno para abrirlo.

Consecuencias

  • Mientras los permisos por endpoint estén pendientes, la autorización es sólo por autenticación y empresa: no debe exponerse a usuarios finales sin cerrar este punto.
  • Un endpoint de lectura que use POST (por ejemplo, una búsqueda) queda bloqueado para root; se resuelve cuando aparezca.
  • Una revocación tarda hasta 15 minutos en reflejarse (ADR 0007).

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.