Files
2026-09-18 23:35:22 -03:00

30 KiB
Raw Permalink Blame History

M GAP (Gestión de Activos y Permisos)

M GAP es una plataforma integral de Gestión de Riesgos, Activos y Control de Acceso, diseñada para cumplimiento normativo (ISO 27001, PCI-DSS, BCRA). Centraliza la gestión de activos, identifica vulnerabilidades asociadas a amenazas y aplica controles para mitigar riesgos operativos y de ciberseguridad.


Características Principales

  • Gestión de Activos (Recursos): Inventario, clasificación por tipo e impacto, asignación a áreas y usuarios con trazabilidad histórica.
  • Gestión de Amenazas: Registro de amenazas con nivel de amenaza, clasificación por tipo y vinculación a vulnerabilidades.
  • Gestión de Vulnerabilidades: Control de vulnerabilidades con severidad y vinculación a recursos y amenazas.
  • Gestión de Riesgos: Cálculo automático del riesgo inherente y residual según la metodología documentada en Cálculo de Riesgo.
  • Controles Mitigantes: Asignación histórica de controles a riesgos, con nivel de control y estados de vida (Planificado / En revisión / Implementado).
  • Control de Acceso: Autorización de la aplicación mediante cuatro roles de sistema fijos, independiente del modelo de permisos del dominio GRC.
  • Auditoría: Registro histórico de cambios con trazabilidad de usuario, dirección IP y timestamp.
  • Notificaciones: Alertas automáticas por vencimiento de permisos y asignaciones para el usuario autenticado.
  • Dashboards y Reportes: Dashboard principal, dashboards temáticos, reportes de permisos y cobertura, exportación a Excel/PDF y exportación CSV en listados.
  • Backups: Copias de seguridad generadas con compresión y cifrado, además de carga, descarga y restauración.

Stack Tecnológico

Capa Tecnología
Backend Laravel 11 (PHP 8.2+)
Frontend React 18 + Inertia.js v2
UI Material UI (MUI) v5 + Tailwind CSS
Build Vite
Base de datos MySQL (principal)
Autorización spatie/laravel-permission con tablas auth_*
Rutas frontend Ziggy (route() global)

Requisitos previos

Para ejecutar M-GAP en Windows se requiere:

  • Windows 10/11
  • XAMPP
  • PHP 8.2 o superior
  • MySQL/MariaDB
  • Composer
  • Node.js y npm
  • Git
  • 7-Zip (requerido para la funcionalidad de backups)

Verificar instalación

Abrir una terminal y ejecutar:

php -v
composer -V
node -v
npm -v
git --version

### XAMPP

Instalar XAMPP y abrir el panel de control.

Para M-GAP es necesario iniciar:

- MySQL

Apache no es necesario para ejecutar la aplicación, ya que Laravel utiliza
su propio servidor de desarrollo mediante `php artisan serve`.

Se puede utilizar phpMyAdmin para crear y administrar la base de datos.



## Instalación

```bash
git clone <URL_DEL_REPOSITORIO>
cd m-gap

composer install
npm install

cp .env.example .env
php artisan key:generate

# Configurar las variables DB_* de MySQL en .env
php artisan migrate --seed

npm run dev
# En otra terminal:
php artisan serve
# La aplicación estará disponible en http://localhost:8000

MySQL es la base de datos principal del proyecto. El archivo .env.example incluye SQLite como configuración inicial de ejemplo; al copiarlo, completar las variables DB_* con la conexión MySQL correspondiente. Los tests utilizan SQLite en memoria mediante phpunit.xml.

Para levantar el stack completo de desarrollo (servidor Laravel, worker de cola, logs de Pail y Vite):

composer run dev

Seeders

php artisan db:seed                              # Ejecuta DatabaseSeeder completo
php artisan db:seed --class=GrcDemoSeeder        # Datos demo GRC base
php artisan db:seed --class=DatosDemoSeeder      # Ampliación de datos demo
php artisan db:seed --class=RolesSistemaSeeder   # Roles y usuarios del sistema
php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder # Dataset masivo alternativo
php artisan migrate:refresh --seed               # Reconstruye la base y carga DatabaseSeeder

DatabaseSeeder ejecuta, en este orden:

  1. Crea test@example.com si todavía no existe.
  2. Ejecuta GrcDemoSeeder con los datos GRC base.
  3. Ejecuta DatosDemoSeeder con datos demo adicionales y relaciones históricas.
  4. Ejecuta RolesSistemaSeeder con los roles de autenticación y usuarios de ejemplo.

DatosDemoSeeder requiere los datos base que aporta GrcDemoSeeder; para evitar dependencias incompletas, se recomienda ejecutar php artisan db:seed mediante DatabaseSeeder en lugar de invocarlo de forma aislada. DashboardMassiveSeeder es un dataset alternativo, requiere una base de negocio vacía y se ejecuta una sola vez por ciclo de migraciones. Los seeders demo solo están habilitados en entornos local y testing; en otros entornos DatabaseSeeder se limita a crear los roles del sistema sin cuentas demo.

Credenciales de desarrollo por defecto, todas con contraseña Password@1:

Usuario Rol del sistema
test@example.com administrador
visor@example.com visor
consultor@example.com consultor
pendiente@example.com pendiente

Los usuarios registrados mediante el formulario público reciben el rol consultor por defecto.

Los seeders coordinan sus asignaciones históricas para no duplicar a Roberto Fernández como responsable de Sistemas y Ciberseguridad.

Los seeders son idempotentes dentro de un mismo ciclo de migraciones. Repetir php artisan db:seed sin refrescar la base no duplica pivotes históricos ni sobrescribe cambios manuales sobre registros existentes. También se preservan las contraseñas y los roles de sistema ya asignados. RolesSistemaSeeder solo asigna el rol predeterminado correspondiente a cada cuenta demo que todavía no tenga ningún rol.

La tabla seeder_runs registra las cargas no repetibles: protege los eventos demo de GrcDemoSeeder y DatosDemoSeeder, marca el dataset estándar como excluyente del masivo y protege la carga completa de DashboardMassiveSeeder. Al ejecutar php artisan migrate:refresh --seed, todas las tablas se reconstruyen, seeder_runs vuelve a crearse vacía y se cargan nuevamente todos los datos incluidos en DatabaseSeeder. Para usar el dataset masivo en lugar del demo estándar, ejecutar php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder. Ambos datasets calculan sus riesgos con la metodología documentada después de crear las relaciones históricas y los controles.


Comandos Disponibles

Comando Descripción
php artisan serve Servidor de desarrollo local
composer run dev Laravel server + queue + Pail + Vite en paralelo
npm run dev Servidor de desarrollo Vite
npm run build Build de producción
php artisan migrate:refresh --seed Reconstruir la base y volver a cargar DatabaseSeeder
php artisan db:seed Ejecutar DatabaseSeeder de forma idempotente
php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder Reconstruir la base con el dataset masivo alternativo para dashboards
php artisan test Ejecutar todos los tests PHPUnit
php artisan test --filter=RiesgoManagementTest Tests específicos de riesgos
php artisan riesgos:recalcular Recalcular los scores de riesgos activos
php artisan backup:create {--frequency=} Crear un backup cifrado de la base de datos
php artisan backup:restore {backupId} Restaurar un backup desde CLI
php artisan permission:cache-reset Limpiar la caché de roles y permisos
vendor/bin/pint Formatear código PHP con Laravel Pint

Los comandos riesgos:recalcular y backup:create están programados en routes/console.php. El primero se ejecuta diariamente y el segundo cada minuto. backup:create lee la configuración de backup_settings (frecuencia, is_active, run_time, run_day) y ejecuta el backup solo cuando coincide el día y la hora configurados. Las invocaciones manuales con --frequency=manual siempre se ejecutan ignorando la configuración.

Para que las tareas programadas se ejecuten, algo tiene que invocar php artisan schedule:run cada minuto. En este proyecto se usa una tarea del Programador de tareas de Windows (M-GAP Backup Scheduler) que ejecuta backup-scheduler.bat cada minuto a través de un launcher oculto (backup-scheduler-hidden.vbs). En Linux se usaría cron ejecutando el mismo comando.

La run_time se interpreta en la zona horaria de APP_TIMEZONE (definida en .env).

Cálculo de Riesgo ISO 27001

El sistema calcula automáticamente el nivel de riesgo inherente y residual para cada riesgo registrado.

Fórmula

P_inherente = A + V
P_residual  = max(0, P_inherente - C)

R_inherente = P_inherente × I
R_residual  = P_residual × I

Donde:

Variable Descripción Escala
A Nivel de amenaza 1-4
V Severidad de vulnerabilidad 0-4
C Efectividad total de controles implementados 1-4, con máximo 4
I Impacto del recurso 1-4

Nivel de Amenaza (A)

Nivel Valor
Bajo 1
Medio 2
Alto 3
Crítico 4

Severidad de Vulnerabilidad (V)

Severidad Valor
Baja 1
Media 2
Alta 3
Crítica 4

Regla V=0: cuando la relación histórica recurso-vulnerabilidad no está vigente (la fecha de fin fue alcanzada o no existe la relación), la severidad de vulnerabilidad se considera 0.

Impacto del Recurso (I)

Impacto Valor
Bajo 1
Medio 2
Alto 3
Crítico 4

Efectividad de Controles (C)

La efectividad se obtiene desde controles.nivel_de_control, no desde un valor independiente en el pivot:

Nivel de control Valor
Débil 1
Parcial 2
Fuerte 4
  • Solo se contabilizan controles con estado Implementado y sin fecha_fin en la asignación riesgo_control.
  • Si hay múltiples controles activos, se suman sus valores y el total se limita a un máximo de 4.
  • El calculador aplica LOWER() antes de comparar, por lo que acepta cualquier capitalización (fuerte, FUERTE, Fuerte, etc.).

Clasificación del Resultado (R)

Rango de R Nivel de Riesgo
0 - 4 Bajo
5 - 9 Medio
10 - 19 Alto
20 - 32 Crítico

El rango máximo teórico es 32 (A=4, V=4, C=0, I=4).

Ejemplo Práctico

Recurso: Base de Datos Tarjetas (Impacto = Crítico -> I=4)
Amenaza: Exposición de PAN (Nivel = Crítico -> A=4)
Vulnerabilidad: DB sin cifrado en reposo (Severidad = Crítica -> V=4)
Control: Tokenización PCI-DSS (Implementado, nivel Fuerte -> C=4)

P_inherente = 4 + 4 = 8
P_residual  = max(0, 8 - 4) = 4

R_inherente = 8 x 4 = 32 -> Crítico
R_residual  = 4 x 4 = 16 -> Alto

Recálculo Automático

Los scores se recalculan cuando:

  • Se crea un nuevo riesgo.
  • Se edita un riesgo mediante sus operaciones de gestión.
  • Se asocia, actualiza o desasocia un control del riesgo.
  • Se actualiza el nivel de una amenaza; se recalculan inmediatamente todos sus riesgos activos relacionados.
  • Se actualiza la severidad de una vulnerabilidad; se recalculan inmediatamente todos sus riesgos activos relacionados.
  • Se ejecuta php artisan riesgos:recalcular, programado diariamente.

El comando php artisan riesgos:recalcular mantiene su función como recálculo global y mecanismo de reconciliación para todos los riesgos activos.


Validación de Enums Canónicos

Los campos enumerados están validados en backend (Laravel Rule::in / in:) y frontend (Yup .oneOf). Valores no canónicos rechazan con error de validación. Las opciones de combo se centralizan en resources/js/constants/enums.js (módulo compartido) para ESTADOS_CONTROL y NIVELES_CONTROL.

Campo Valores válidos Archivos backend Archivos frontend
controles.estado Implementado | En revisión | Planificado ControlController, ControlGestionController Controles/Create.jsx, Edit.jsx, Gestionar.jsx
controles.nivel_de_control fuerte | parcial | debil ControlController, ControlGestionController Controles/Create.jsx, Edit.jsx, Gestionar.jsx
amenazas.nivel_de_amenaza Bajo | Medio | Alto | Crítico AmenazaController, AmenazaGestionController Amenazas/Create.jsx, Gestionar.jsx
amenazas.fuente Interna | Externa AmenazaController, AmenazaGestionController Amenazas/Create.jsx, Gestionar.jsx
amenazas.origen Humana | Natural | Ambiental | Tecnológica AmenazaController, AmenazaGestionController Amenazas/Create.jsx, Gestionar.jsx
vulnerabilidades.severidad Baja | Media | Alta | Crítica StoreVulnerabilidadRequest, VulnerabilidadGestionController Vulnerabilidades/Create.jsx, Gestionar.jsx
vulnerabilidades.fuente Interna | Externa | Ambas StoreVulnerabilidadRequest, VulnerabilidadGestionController Vulnerabilidades/Create.jsx, Gestionar.jsx
recursos.impacto Bajo | Medio | Alto | Crítico RecursoController, RecursoGestionController Recursos/Create.jsx, Gestionar.jsx
permisos.estado 1 | 0 PermisoController, PermisoGestionController Permisos/Create.jsx

Longitudes Máximas Canónicas

Los campos de texto tienen longitudes máximas validadas en backend (max:) y frontend (.max() + inputProps maxLength). Se aplican tanto al alta (store) como a la edición (update).

Campo Límite Archivos principales
nombre, apellido 35 Controllers, Create.jsx, Edit.jsx, Gestionar.jsx
correo, telefono 35 AreaController, UsuarioController, Create.jsx, Edit.jsx, Gestionar.jsx
descripcion, justificacion, accion 185 Controllers, Create.jsx, Edit.jsx, Gestionar.jsx
documento 20 UsuarioController, Usuarios/Create.jsx
direccion, motivo_alta 35 AreaController, Areas/Create.jsx

Control de Acceso

M GAP tiene dos modelos de roles independientes:

  1. Roles del sistema: autorizan acciones en la aplicación y se implementan con spatie/laravel-permission sobre users.
  2. Roles del dominio GRC: forman el modelo de negocio Usuario -> Rol -> Perfil -> Permiso mediante las tablas usuarios, roles, perfiles y permisos. No controlan el login ni la autorización de rutas.

Las tablas de Spatie utilizan el prefijo auth_ (auth_roles, auth_permissions, auth_model_has_roles, entre otras) para evitar colisiones con las tablas de dominio.

Roles del Sistema

Rol Acceso
administrador Acceso total, incluyendo escritura, parametría, backups y seguridad.
visor Lectura de módulos permitidos, exportación CSV, dashboards y reportes. Sin auditorías, notificaciones, backups, tipos ni seguridad.
consultor Dashboards y reportes.
pendiente Pantalla de bienvenida. Sin acceso a módulos. Se asigna a nuevos registros y al cambiar el rol desde administración.
  • Las rutas utilizan el alias role: de RoleMiddleware, registrado en bootstrap/app.php.
  • Los errores HTTP 403 renderizan resources/js/Pages/Error.jsx mediante Inertia.
  • La gestión de roles del sistema se realiza en /seguridad/usuarios, solo para administradores.
  • Un administrador no puede quitarse a sí mismo el rol administrador.
  • HandleInertiaRequests comparte auth.roles con el frontend.
  • resources/js/utils/permissions.js expone useRoles() y useCanWrite().
  • Sidebar.jsx filtra las opciones visibles según el rol, pero la autorización efectiva siempre se valida en el backend.
  • Después de cambiar roles o permisos en código, ejecutar php artisan permission:cache-reset.

Dashboards y Reportes

Dashboards

Ruta Descripción
/tablero Tablero General: métricas generales, distribución de riesgos inherentes/residuales, cobertura de controles y matriz vulnerabilidad × impacto.
/tablero/accesos Métricas de accesos y permisos: usuarios, roles, perfiles por permisos y perfiles por rol.
/tablero/riesgos Análisis de riesgos.
/tablero/cumplimiento Indicadores de cumplimiento: controles, cobertura, treemap con drilldown de recursos por tipo y estado de revisiones.
/tablero/catalogo-activos Catálogo de activos: inventario, distribución por tipo, impacto, áreas y asignaciones.

Los dashboards están disponibles para los tres roles del sistema.

Reportes

Ruta Descripción
/reportes Panel principal de reportes.
/reportes/permisos-efectivos Matriz de permisos efectivos Usuario -> Rol -> Perfil -> Permiso vigente.
/reportes/permisos-nuevos Permisos otorgados en un rango de fechas.
/reportes/permisos-baja Permisos dados de baja.
/reportes/permisos-expiran Permisos próximos a vencer.
/reportes/acceso-recursos Acceso a recursos, usuarios y perfiles, incluyendo recursos sin asignar.
/reportes/relaciones-cobertura Matriz recursos x perfiles y distribución por tipo.

Los reportes contienen filtros interactivos y posibilidad de exportan a Excel y PDF.


Notificaciones

NotificacionService genera alertas bajo demanda al cargar páginas Inertia autenticadas, deduplicadas sin repetir el mismo título dentro de siete días, para:

  • Permisos de perfiles vencidos o próximos a vencer.
  • Asignaciones de recursos, áreas y perfiles vencidas o próximas a vencer.
  • Relaciones cuya fecha de vencimiento está dentro de los próximos siete días.

Las notificaciones se vinculan al usuario de login mediante la correspondencia users.email = usuarios.correo. El contador y las notificaciones recientes se comparten a todo usuario autenticado; la página de notificaciones está disponible solo para administrador.

Endpoints principales:

Método Ruta Descripción
GET /notificaciones Colección completa filtrada y ordenada en el servidor, con búsqueda local y paginación en el navegador de 10 filas.
GET /notificaciones/count Contador y notificaciones recientes.
POST /notificaciones/{id}/leer Marcar una notificación como leída.
POST /notificaciones/leer-todas Marcar todas como leídas.

Auditoría

El trait App\Traits\LogsAuditoria registra automáticamente operaciones de creación, actualización y eliminación en auditorias.

  • Guarda acción, tabla, identificador, valores anterior y nuevo en JSON, usuario e IP.
  • Se utiliza en los modelos de dominio de áreas, amenazas, controles, perfiles, permisos, recursos, riesgos, roles, tipos, usuarios y vulnerabilidades.
  • Si no hay usuario autenticado, utiliza user_id = 1 como fallback.
  • El listado y los endpoints de exportación están disponibles solo para administrador. En la interfaz, CSV, XLSX y PDF exportan todos los registros filtrados localmente con las columnas, el orden y los valores formateados visibles en la tabla, sin controles de acciones.

Backups

Requisito para Backups

Las funciones de backup utilizan 7-Zip para generar archivos comprimidos con cifrado AES-256.

Instalar 7-Zip y verificar que el ejecutable esté disponible según la configuración utilizada por el proyecto.

Por defecto el proyecto busca C:/Program Files/7-Zip/7z.exe. Si 7-Zip se instaló en otra ubicación, configurar BACKUP_7ZIP_PATH en .env.

El password de cifrado (BACKUP_PASSWORD) debe estar definido en .env; sin este valor, el comando backup:create rechaza la operación.

El módulo de backups está disponible únicamente para administrador.

  • backup:create genera un dump de MySQL, lo comprime y lo cifra mediante 7-Zip AES-256.
  • Los backups generados por el comando se registran como backups completados; los archivos subidos desde la interfaz se aceptan como ZIP con SQL y la interfaz no verifica que estén cifrados.
  • La frecuencia puede configurarse como diaria, semanal o mensual desde /backups, incluyendo la hora (run_time) y el día de la semana/mes (run_day).
  • El scheduler invoca backup:create cada minuto. El comando consulta backup_settings y solo ejecuta cuando coinciden el día y la hora configurados. La tarea M GAP Backup Scheduler ejecuta php artisan schedule:run cada minuto vía backup-scheduler.bat (lanzado oculto por backup-scheduler-hidden.vbs).
  • Se conservan hasta 15 copias exitosas por defecto (BACKUP_RETENTION en .env). Al superar el límite, la copia más antigua se elimina automáticamente. La interfaz muestra un aviso antes de crear o subir una nueva copia cuando ya se alcanzó el límite.
  • La interfaz permite listar, crear, subir, descargar, restaurar y eliminar backups.
  • php artisan backup:restore {backupId} restaura un backup desde CLI e intenta crear antes un dump temporal de seguridad. Ese dump no se registra como backup persistente y la restauración continúa aunque no pueda crearse.

Rutas principales:

Método Ruta Descripción
GET /backups Listado y configuración.
POST /backups Crear backup.
POST /backups/upload Subir backup.
POST /backups/{backup}/restore Restaurar backup desde la interfaz.
GET /backups/{backup}/download Descargar backup.
DELETE /backups/{backup} Eliminar backup.
PUT /backups/settings Actualizar configuración.

Estructura del Proyecto

m-gap/
├── app/
│   ├── Console/Commands/        # RecalculateRiesgos, BackupCreateCommand, BackupRestoreCommand
│   ├── Http/Controllers/        # CRUD, gestión, dashboards y reportes
│   ├── Http/Middleware/         # HandleInertiaRequests
│   ├── Http/Requests/           # Validaciones FormRequest
│   ├── Http/Resources/          # Resources API
│   ├── Models/                  # Modelos Eloquent
│   ├── Services/                # Servicios como NotificacionService
│   ├── Support/                 # RiskCalculator, HistoricalPeriod, AreaResponsibilityHistory, BackupRetention
│   └── Traits/                  # LogsAuditoria
├── config/permission.php        # Configuración de Spatie y tablas auth_*
├── database/
│   ├── migrations/              # Incluye 2026_08_20_000002_create_seeder_runs_table.php
│   └── seeders/                 # DatabaseSeeder, GrcDemoSeeder, DatosDemoSeeder, RolesSistemaSeeder, DashboardMassiveSeeder y Concerns/SeedsSafely
├── resources/js/
│   ├── Components/              # Componentes reutilizables y combos
│   ├── constants/               # enums.js (ESTADOS_CONTROL, NIVELES_CONTROL)
│   ├── Layouts/                 # AuthenticatedLayout
│   ├── Pages/                   # Páginas Inertia
│   ├── context/                 # AlertContext
│   ├── service/                 # api.js y fetchers de combos
│   ├── theme/                   # MGAP-Theme.js
│   └── utils/                   # permissions, exportUtils, date y filtros
├── routes/
│   ├── web.php                  # Rutas principales
│   ├── api.php                  # Endpoints JSON auxiliares
│   ├── auth.php                 # Rutas de autenticación (Breeze)
│   └── console.php              # Programación de comandos
└── tests/
    ├── Feature/                 # Tests de integración
    └── Unit/                    # Tests unitarios

Convenciones

  • Los módulos CRUD suelen utilizar Index.jsx para listados, Create.jsx para altas y Gestionar.jsx para fichas editables y relaciones históricas.
  • Algunos módulos incluyen también Edit.jsx; los módulos de tipos comparten Generic/Gestionar.jsx cuando corresponde.
  • Las relaciones many-to-many utilizan pivots con fechas históricas (fecha_inicio, fecha_identificacion y fecha_fin).
  • Las relaciones históricas se finalizan conservando el registro del pivot, en lugar de eliminarlo.
  • El índice de áreas muestra un único responsable vigente. Una responsabilidad está vigente cuando fecha_inicio <= ahora y fecha_fin es nula o posterior a ahora; si existen períodos históricos superpuestos, el vigente con la fecha_inicio más reciente es el canónico.
  • Las entidades con historial siguen una política de preservación: se rechaza la eliminación cuando existen registros asociados (protegido por constraints FK). No se utilizan SoftDeletes ni se marca la entidad como inactiva.
  • Los formularios de alta no incluyen campos de riesgo inherente o residual; esos valores se calculan en backend.

Rutas

Las rutas web se agrupan por autenticación y rol. Los módulos de lectura suelen estar disponibles para administrador y visor; las operaciones de escritura, backups y seguridad requieren administrador. Auditorías y notificaciones son exclusivas de administrador.

Módulos de Dominio

Los siguientes módulos comparten el patrón general: áreas, amenazas, controles, vulnerabilidades, permisos, roles, perfiles, usuarios y recursos.

Operaciones de lectura:

Método Ruta Descripción
GET /{modulo} Colección completa filtrada y ordenada en el servidor, con búsqueda local y paginación en el navegador de 10 filas.
GET /{modulo}/export Exportación CSV del servidor en los módulos que exponen este endpoint; el CSV local exporta todos los registros filtrados con las columnas y el formato de la tabla visible, sin acciones.
GET /{modulo}/{entidad}/gestionar Ficha de la entidad y relaciones históricas.

Operaciones de escritura, solo para administradores:

Método Ruta Descripción
GET /{modulo}/create Formulario de alta.
POST /{modulo} Crear entidad.
PUT / DELETE /{modulo}/{entidad} Actualizar o eliminar entidad, cuando aplica.
PUT /{modulo}/{entidad}/campo Actualizar un campo individual.
POST /{modulo}/{entidad}/{relacion} Asociar una relación histórica.
PUT /{modulo}/{entidad}/{relacion}/{pivotId} Actualizar una asignación.
DELETE /{modulo}/{entidad}/{relacion}/{pivotId} Finalizar una asignación conservando el historial.

Relaciones gestionadas por módulo:

Módulo Relaciones
areas usuarios, recursos
amenazas vulnerabilidades
controles riesgos
vulnerabilidades amenazas, recursos
permisos perfiles
roles usuarios, perfiles
perfiles roles, permisos, recursos
usuarios areas, roles, recursos
recursos usuarios, areas, perfiles, vulnerabilidades

Riesgos

Riesgos utiliza una edición específica porque sus puntajes se calculan automáticamente:

Método Ruta Descripción
GET /riesgos Listado de riesgos.
GET /riesgos/create Formulario de alta.
POST /riesgos Crear riesgo y calcular sus puntajes.
GET /riesgos/{riesgo}/gestionar Ficha del riesgo y controles asociados.
PUT /riesgos/{riesgo}/campo Actualizar un campo individual.
DELETE /riesgos/{riesgo} Eliminar o preservar según las reglas del módulo.
POST /riesgos/{riesgo}/controles Asociar control.
PUT /riesgos/{riesgo}/controles/{pivotId} Actualizar asignación de control.
DELETE /riesgos/{riesgo}/controles/{pivotId} Finalizar asignación de control.

Riesgos no tiene ruta update general ni endpoint de exportación CSV en el servidor; su listado sí exporta CSV local. La edición se realiza campo a campo.

Parametros, auditoría y operaciones especiales

Módulo Rutas principales Acceso
Tipos /tipos-usuarios, /tipos-recursos, /tipos-controles, /tipos-amenazas, /tipos-vulnerabilidades Solo administrador; CRUD, gestionar y campo. tipos-vulnerabilidades no tiene update general.
Auditorías /auditorias, /auditorias/export Solo administrador.
Notificaciones /notificaciones, /notificaciones/count, /notificaciones/{id}/leer, /notificaciones/leer-todas Solo administrador.
Catálogo /tablero/catalogo-activos Los tres roles.
Asignación de usuarios /asignar-usuario y endpoints store/detach + update Lectura para administrador y visor; escritura solo administrador.
Seguridad /seguridad/usuarios, PUT /seguridad/usuarios/{user}/rol Solo administrador.
Perfil /profile Usuario autenticado: consultar, actualizar o eliminar su perfil.

API Auxiliar

Los endpoints de API requieren auth:sanctum y son consumidos principalmente desde resources/js/service/api.js:

Método Ruta Descripción
GET /api/user Usuario autenticado.
GET /api/combos/areas Combo de áreas.
GET /api/combos/roles Combo de roles.
GET /api/combos/perfiles Combo de perfiles.
GET /api/combos/tipos-usuarios Combo de tipos de usuario.
GET /api/combos/tipos-recursos Combo de tipos de recurso.
GET /api/combos/tipos-controles Combo de tipos de control.
GET /api/combos/tipos-amenazas Combo de tipos de amenaza.
GET /api/combos/amenazas Combo de amenazas.
GET /api/combos/recursos Combo de recursos.
GET /api/combos/vulnerabilidades Combo de vulnerabilidades.
GET /api/combos/controles Combo de controles.
GET /api/usuarios/buscar Búsqueda de usuarios del dominio.

Desarrollado por Mauro Joannas y Rodrigo Legoff - Matriz de gestion para los activos y permisos (M GAP)