# PORTAL-API Bruno

Colección Bruno para probar la API del portal.

## Requisitos

- Aplicación corriendo en `http://localhost:8080`
- Endpoint disponible: `GET /api/health`

## Contenido

- `HealthCheck`: verifica que la API responde con `Hola mundo`.
- `AuthLogin`: login para usuarios humanos de la API.
- `AuthForgotPassword`: solicita el token de recuperación de contraseña por correo.
- `AuthResetPassword`: restablece la contraseña usando el token recibido por correo.
- `AuthMe`: consulta el usuario autenticado.
- `AuthLogout`: cierre de sesión del usuario autenticado.
- `AuthSesionLogin`: login para estudiantes ya autenticados en el portal mediante su sesión CI4 (`ci_session`). Emite un token `portal_user` sin pedir credenciales de la API.
- `SistemaLogin`: login para sistemas (terceros) mediante `api_key` y `api_secret`. Emite un token de larga duración.
- `SistemaMe`: consulta los datos del sistema autenticado.
- `SistemaLogout`: cierre de sesión del sistema autenticado.

## Seed de Prueba

- `ApiUsersSeeder`: crea o actualiza un usuario de prueba con `username = admin`, `email = admin@api.test` y password `secret123`.
- `AuthLogin`: usa `admin@api.test` y `secret123` para probar `POST /api/auth/login`.

## Login de Sistemas

Para probar `SistemaLogin`:

1. Registra un sistema en la tabla `api_sistemas` con un `api_key` único y un `api_secret` guardado hasheado (`password_hash`).
2. Asocia un usuario de la tabla `api_usuarios` con `userable_type = 'sistema'` y `userable_id` igual al `id` del sistema.
3. Completa las variables `api_key` y `api_secret` en el entorno `local`.

El token del sistema se guarda en la variable `token_sistema` y se usa en `SistemaMe` y `SistemaLogout`. La duración del token se configura con `API_JWT_SISTEMA_EXPIRY_DAYS` (por defecto 30 días).

## Login por Sesión del Portal

`AuthSesionLogin` (`POST /api/v1/auth/sesion/login`) emite un token para estudiantes que ya tienen una sesión CI4 activa en el portal (cookie `ci_session` con `log` de `aausuario`). No se piden credenciales de la API ni se crean registros en `api_usuarios`/`api_personas`; el token es de tipo `portal_user` y valida solo contra la tabla de usuarios del portal.

Para probarlo:

1. Inicia sesión en el portal como estudiante en el navegador o deja que Bruno guarde la cookie `ci_session`.
2. Ejecuta `AuthSesionLogin`. El token se guarda en la variable `token` y se usa en `AuthMe` y `AuthLogout`.
3. Si no hay sesión activa del portal, responde `401`.
