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¶
rootsólo lee en este servicio. Un método distinto deGET,HEADuOPTIONSresponde 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
rootpuede leer y escribir en su empresa.
Alternativas descartadas¶
rootcon acceso total — un administrador de la plataforma no es un usuario de negocio; un pedido creado por él no tiene responsable.- Bloquear a
rootpor completo — pierde el soporte y la auditoría. - Interpretar hoy el claim
permisos—crearno 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 pararoot; 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.