fix(ogcore): sistema de permisos por rol + fixes de borrado y timezone #123

Merged
narenas merged 14 commits from devel into main 2026-06-16 17:51:45 +02:00
Collaborator

Resumen

Esta PR implementa la matriz de permisos por rol definida en el documento
de requisitos, corrige varios bugs encontrados durante las pruebas y añade
una suite de tests funcionales que cubren todos los casos.


Sistema de permisos por rol

Implementa control de acceso para los cuatro roles del sistema:

Rol Crear clientes/OUs Borrar OUs Infraestructura (DHCP, Boot, Repos, Commands)
ROLE_SUPER_ADMIN ✅ ✅ cualquiera ✅ lectura y escritura
ROLE_ORGANIZATIONAL_UNIT_ADMIN ✅ ✅ solo las propias 🔒 solo lectura
ROLE_ORGANIZATIONAL_UNIT_OPERATOR 🔒 🔒 🔒 solo lectura
ROLE_ORGANIZATIONAL_UNIT_MINIMAL 🔒 🔒 🔒 solo lectura

Cambios en la API:

  • config/packages/security.yaml: reglas de firewall Symfony para bloquear
    POST a /clients y /organizational-units a roles no autorizados. Incluye
    excepción para que ogLive (ROLE_OGCLIENT_API) pueda consultar clientes por IP.
  • config/api_platform/*.yaml: expresiones security: en BootServer, DhcpServer,
    Command, ImageRepository, Subnet y OrganizationalUnit para restringir operaciones
    de escritura según el rol.
  • src/State/Processor/OrganizationalUnitProcessor.php: bloqueo en POST (solo
    ou-admin y superior) y DELETE (ou-admin solo puede borrar OUs que él creó,
    verificado via campo createdBy de Gedmo Blameable).
  • src/State/Processor/ClientProcessor.php: bloqueo en POST para roles no
    autorizados.
  • src/Security/Voter/OrganizationalUnitVoter.php: voter para verificar
    permisos de visualización según allowedOrganizationalUnits del usuario.

Bugs corregidos

Borrado de clientes sin plantilla de arranque

Los clientes sin PxeTemplate asignada no podían borrarse porque
ClientProcessor llamaba a ogBoot para eliminar el fichero PXE incluso cuando
nunca se había creado uno. Ahora se comprueba getMac() && getTemplate() antes
de la llamada. Se añade también try-catch para manejar errores de ogBoot/DHCP
sin abortar el borrado.

Delete cascade en HardwareProfile

Al borrar un cliente, su HardwareProfile asociado no se eliminaba en cascada,
dejando registros huérfanos. Corregido con cascade: remove en la relación y
migración correspondiente (Version20260615092704).

Provider incorrecto en DELETE de OrganizationalUnit

La operación DELETE tenía configurado OrganizationalUnitProvider como
provider, pero dicho provider no implementaba el caso Delete y devolvía
null, causando un 404 para cualquier usuario. Se elimina el provider
personalizado del DELETE y se usa el proveedor Doctrine por defecto.

Rutas de firewall con prefijo incorrecto

Las reglas access_control usaban ^/api/clients$, pero ogcore recibe las
peticiones sin el prefijo /api/ (que nginx elimina en el proxy inverso).
Corregido a ^/clients$ y ^/organizational-units$.

Bug en DeleteAction de PXE

DeleteAction::__invoke() usaba la variable $content (no definida) en lugar
de $response para comprobar errores. Corregido.

Normalización de timezone en CommandTask

Los campos executionTime, executionDate, lastExecution y nextExecution
en los DTOs de CommandTask no normalizaban el timezone a UTC, causando
inconsistencias al serializar fechas. Corregido en CommandTaskOutput,
CommandTaskScheduleOutput y CommandTaskScheduleInput.

Timeout en sondeo de estado de equipos

Añadido timeout de 5 segundos en el sondeo del estado de todos los equipos
de un aula para evitar bloqueos cuando algún equipo no responde.


Tests

Nueva suite tests/Functional/PermissionsTest.php con 25 tests funcionales
que cubren la matriz completa de permisos:

  • Sección 1 — Clientes (POST): super-admin y ou-admin pueden crear (201);
    ou-operator y ou-minimal reciben 403.
  • Sección 2 — OUs (POST): misma lógica.
  • Sección 3 — OUs (DELETE con autoría): ou-admin puede borrar las suyas (204);
    no puede borrar las de otro usuario (403); super-admin borra cualquiera (204).
  • Sección 4/5 — DHCP Servers / Boot Servers: solo super-admin puede escribir.
  • Sección 6 — Image Repositories: solo super-admin puede crear/borrar.
  • Sección 7 — Commands: solo super-admin puede crear, editar y borrar.

Añadidos también tests en OrganizationalUnitTest para verificar que ou-admin
puede editar OUs que él creó y que ou-operator no puede crear OUs.


Ficheros principales modificados

## Resumen Esta PR implementa la matriz de permisos por rol definida en el documento de requisitos, corrige varios bugs encontrados durante las pruebas y añade una suite de tests funcionales que cubren todos los casos. --- ## Sistema de permisos por rol Implementa control de acceso para los cuatro roles del sistema: | Rol | Crear clientes/OUs | Borrar OUs | Infraestructura (DHCP, Boot, Repos, Commands) | |-----|-------------------|------------|-----------------------------------------------| | `ROLE_SUPER_ADMIN` | ✅ | ✅ cualquiera | ✅ lectura y escritura | | `ROLE_ORGANIZATIONAL_UNIT_ADMIN` | ✅ | ✅ solo las propias | 🔒 solo lectura | | `ROLE_ORGANIZATIONAL_UNIT_OPERATOR` | 🔒 | 🔒 | 🔒 solo lectura | | `ROLE_ORGANIZATIONAL_UNIT_MINIMAL` | 🔒 | 🔒 | 🔒 solo lectura | **Cambios en la API:** - `config/packages/security.yaml`: reglas de firewall Symfony para bloquear POST a `/clients` y `/organizational-units` a roles no autorizados. Incluye excepción para que ogLive (`ROLE_OGCLIENT_API`) pueda consultar clientes por IP. - `config/api_platform/*.yaml`: expresiones `security:` en BootServer, DhcpServer, Command, ImageRepository, Subnet y OrganizationalUnit para restringir operaciones de escritura según el rol. - `src/State/Processor/OrganizationalUnitProcessor.php`: bloqueo en POST (solo ou-admin y superior) y DELETE (ou-admin solo puede borrar OUs que él creó, verificado via campo `createdBy` de Gedmo Blameable). - `src/State/Processor/ClientProcessor.php`: bloqueo en POST para roles no autorizados. - `src/Security/Voter/OrganizationalUnitVoter.php`: voter para verificar permisos de visualización según `allowedOrganizationalUnits` del usuario. --- ## Bugs corregidos ### Borrado de clientes sin plantilla de arranque Los clientes sin `PxeTemplate` asignada no podían borrarse porque `ClientProcessor` llamaba a ogBoot para eliminar el fichero PXE incluso cuando nunca se había creado uno. Ahora se comprueba `getMac() && getTemplate()` antes de la llamada. Se añade también try-catch para manejar errores de ogBoot/DHCP sin abortar el borrado. ### Delete cascade en HardwareProfile Al borrar un cliente, su `HardwareProfile` asociado no se eliminaba en cascada, dejando registros huérfanos. Corregido con `cascade: remove` en la relación y migración correspondiente (`Version20260615092704`). ### Provider incorrecto en DELETE de OrganizationalUnit La operación DELETE tenía configurado `OrganizationalUnitProvider` como provider, pero dicho provider no implementaba el caso `Delete` y devolvía `null`, causando un 404 para cualquier usuario. Se elimina el provider personalizado del DELETE y se usa el proveedor Doctrine por defecto. ### Rutas de firewall con prefijo incorrecto Las reglas `access_control` usaban `^/api/clients$`, pero ogcore recibe las peticiones sin el prefijo `/api/` (que nginx elimina en el proxy inverso). Corregido a `^/clients$` y `^/organizational-units$`. ### Bug en DeleteAction de PXE `DeleteAction::__invoke()` usaba la variable `$content` (no definida) en lugar de `$response` para comprobar errores. Corregido. ### Normalización de timezone en CommandTask Los campos `executionTime`, `executionDate`, `lastExecution` y `nextExecution` en los DTOs de CommandTask no normalizaban el timezone a UTC, causando inconsistencias al serializar fechas. Corregido en `CommandTaskOutput`, `CommandTaskScheduleOutput` y `CommandTaskScheduleInput`. ### Timeout en sondeo de estado de equipos Añadido timeout de 5 segundos en el sondeo del estado de todos los equipos de un aula para evitar bloqueos cuando algún equipo no responde. --- ## Tests Nueva suite `tests/Functional/PermissionsTest.php` con 25 tests funcionales que cubren la matriz completa de permisos: - **Sección 1** — Clientes (POST): super-admin y ou-admin pueden crear (201); ou-operator y ou-minimal reciben 403. - **Sección 2** — OUs (POST): misma lógica. - **Sección 3** — OUs (DELETE con autoría): ou-admin puede borrar las suyas (204); no puede borrar las de otro usuario (403); super-admin borra cualquiera (204). - **Sección 4/5** — DHCP Servers / Boot Servers: solo super-admin puede escribir. - **Sección 6** — Image Repositories: solo super-admin puede crear/borrar. - **Sección 7** — Commands: solo super-admin puede crear, editar y borrar. Añadidos también tests en `OrganizationalUnitTest` para verificar que ou-admin puede editar OUs que él creó y que ou-operator no puede crear OUs. --- ## Ficheros principales modificados
narenas added 14 commits 2026-06-16 17:51:26 +02:00
ogcore-debian-package/pipeline/head This commit looks good Details
testing/ogcore-api/pipeline/head There was a failure building this commit Details
203675e7ad
fix(ogcore): corregir permisos de edición de aulas para ou-admin y ou-operator
- OrganizationalUnitProcessor: tras crear una OU (POST), añade
  automáticamente la nueva OU a allowedOrganizationalUnits del
  usuario creador (si no es SUPER_ADMIN), para que pueda verla
  y editarla de inmediato.
- OrganizationalUnitVoter: amplía la comprobación de
  ORGANIZATIONAL_UNIT_VIEW para incluir descendientes de las OUs
  permitidas, alineando el voter con la lógica de
  UserAllowedOrganizationalUnitExtension.
6d35163b3f fix(ogcore): restringir escritura de infraestructura a ROLE_SUPER_ADMIN
Las operaciones de creacion, edicion y eliminacion de servidores DHCP,
Boot, Subredes, Comandos y Repositorios de imagenes quedan restringidas
a ROLE_SUPER_ADMIN. Las operaciones de lectura siguen accesibles a
cualquier usuario autenticado.
b1903ea321 fix(ogcore): restringir creacion de OUs y clientes a ou-admin y superior
El POST de OrganizationalUnit y Client queda restringido a
ROLE_SUPER_ADMIN o ROLE_ORGANIZATIONAL_UNIT_ADMIN. Los operadores
(ROLE_ORGANIZATIONAL_UNIT_OPERATOR) ya no pueden crear aulas ni
clientes via API.
ab1a7c2d11 fix(ogcore): mover seguridad de creación/borrado a los processors
- ClientProcessor: añade comprobación inline en processCreateOrUpdate
  para bloquear (403) creación de clientes a ROLE_ORGANIZATIONAL_UNIT_OPERATOR
  y roles inferiores. Añade Security al constructor.

- OrganizationalUnitProcessor: mueve el bloqueo de creación al inicio de
  processCreateOrUpdate (antes de validate/save) para que el 403 se devuelva
  sin persistir datos. Separa la lógica de añadir la OU a la lista del usuario.

- OrganizationalUnitProcessor.processDelete: corrige bug de nombre de variable
  ($user apuntaba a una OU); añade comprobación de autoría via createdBy para
  que solo el creador o super-admin pueda borrar la OU (403 en caso contrario).

Motivo del cambio: la expresión security: de API Platform YAML no se evaluaba
antes de la validación del DTO en AP 3.4 para operaciones POST sin provider
explícito, resultando en 422 en lugar del esperado 403.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
06bca9395e fix(ogcore): bloquear creación de clientes y OUs a nivel de firewall
Añade reglas access_control al firewall de Symfony para los endpoints
POST /api/clients y POST /api/organizational-units, restringiendo el
acceso a ROLE_SUPER_ADMIN y ROLE_ORGANIZATIONAL_UNIT_ADMIN.

La comprobación a nivel de firewall se ejecuta antes de que API Platform
procese la petición (antes de deserialización y validación del DTO), lo
que garantiza un HTTP 403 inmediato sin necesidad de que el cuerpo de la
petición sea válido.

Las reglas usan el ancla $ para que no afecten a sub-rutas como
/api/clients/server/reboot, /api/clients/server/boot-client, etc.
5ce29848f1 test(ogcore): añadir suite de tests de permisos por rol
PermissionsTest.php cubre la matriz completa de permisos:

  Sección 1 — Clientes (POST):
    - super-admin / ou-admin pueden crear (201)
    - ou-operator / ou-minimal no pueden (403)

  Sección 2 — OUs (POST):
    - super-admin / ou-admin pueden crear (201)
    - ou-operator / ou-minimal no pueden (403)

  Sección 3 — OUs (DELETE con autoría):
    - ou-admin borra la suya propia (204)
    - ou-admin no borra la de otro usuario (403)
    - super-admin borra cualquiera (204)
    - ou-operator no borra ninguna (403)

  Sección 4 — DHCP Servers:
    - super-admin puede PATCH (200)
    - ou-admin / ou-operator no pueden PATCH ni DELETE (403)

  Sección 5 — Boot Servers:
    - super-admin puede PATCH (200)
    - ou-admin / ou-operator no pueden PATCH ni DELETE (403)

  Sección 6 — Image Repositories:
    - super-admin puede crear (201)
    - ou-admin / ou-operator no pueden crear ni borrar (403)

  Sección 7 — Commands:
    - super-admin puede crear (201)
    - ou-admin / ou-operator no pueden crear, editar ni borrar (403)

OrganizationalUnitTest: reemplaza testOuOperatorCanEditOrganizationalUnitTheyCreated
(que asumía que operadores podían crear OUs) por
testOuOperatorCannotCreateOrganizationalUnit (que verifica el comportamiento correcto).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ogcore-debian-package/pipeline/head This commit looks good Details
testing/ogcore-api/pipeline/head There was a failure building this commit Details
0284654f3e
Añadido un timeout de 5 segundos para detectar el estado de cada equipo en el sondeo del aula completa
cb3a8aa58a fix(ogcore): permitir a ogLive consultar clientes vía API key
Añade regla access_control para que ROLE_OGCLIENT_API pueda hacer GET
en /clients. Sin esta regla, ogLive no puede consultar la configuración
del equipo por IP al arrancar (el catch-all ROLE_USER bloquearía la
petición porque ogclient_api_user no tiene ese rol).

Ya existía la misma excepción para /commands.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ogcore-debian-package/pipeline/head This commit looks good Details
testing/ogcore-api/pipeline/head There was a failure building this commit Details
9d5c230a2d
Merge branch 'fix_permissions' into devel
- Bloqueo POST /api/clients y /api/organizational-units a ou-operator y ou-minimal
- Permiso a ogLive (ROLE_OGCLIENT_API) para GET /clients
- Suite de tests funcionales de permisos por rol (PermissionsTest.php)
ogcore-debian-package/pipeline/head This commit looks good Details
testing/ogcore-api/pipeline/head There was a failure building this commit Details
024f2ace6b
Corregida asociacion de perfil hardware con cliente, se usa delete cascade para que al borrar un cliente, se borre su perfil hardware asociado
testing/ogcore-api/pipeline/head There was a failure building this commit Details
ogcore-debian-package/pipeline/head This commit looks good Details
testing/ogcore-api/pipeline/pr-main Build started... Details
3d0883a0bd
fix(ogcore): corregir rutas de firewall y provider de DELETE en OUs
Dos bugs introducidos en fix_permissions:

1. access_control paths incorrectos: nginx elimina el prefijo /api/ antes
   de llegar a ogcore, por lo que las rutas reales son /clients y
   /organizational-units (sin /api/). Las reglas anteriores con ^/api/clients$
   y ^/api/organizational-units$ nunca coincidían.

2. OrganizationalUnitProvider no manejaba Delete: el switch del provider
   no tenía case para Delete, devolvía null implícitamente y API Platform
   respondía 404 a cualquier usuario que intentara borrar una OU.
   Quitando el provider del DELETE, el proveedor Doctrine por defecto carga
   la entidad correctamente y la expresión security: del YAML puede evaluarse.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
narenas merged commit 87e9896aa6 into main 2026-06-16 17:51:45 +02:00
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: opengnsys/ogcore#123
There is no content yet.