Punto de entrada
Todas las peticiones pasan por el Nginx API Gateway en el puerto 8010. Cada microservicio expone su documentación interactiva OpenAPI (Swagger UI) en la ruta /docs de su puerto interno.
Rutas por microservicio
| Prefijo (Gateway) | Microservicio interno | Puerto interno |
|---|
/authentication/ | authentication | 8000 |
/authorization/ | authorization | 8000 |
/integrations/ | integrations | 8000 |
/clients/ | clients | 8000 |
/logs/ → /public/ | b2b-logs | 8000 |
/reports/ | b2b-reports | 8000 |
/orphans/ | b2b-orphans | 8000 |
/images/ | Nginx (estático) | — |
/profile-picture/ | Nginx (estático) | — |
Endpoints principales por dominio
Authentication (/authentication/)
| Método | Endpoint | Descripción |
|---|
POST | /local/login | Login con credenciales locales |
POST | /okta/login | Inicio de flujo Okta OAuth |
POST | /token/refresh | Renovar token JWT |
GET | /user/me | Datos del usuario autenticado |
PUT | /user/password | Cambiar contraseña |
Authorization (/authorization/)
| Método | Endpoint | Descripción |
|---|
GET | /role/ | Listar roles |
POST | /role/ | Crear rol |
GET | /permission/ | Listar permisos |
POST | /permission/assign | Asignar permiso a rol |
Clients (/clients/)
| Método | Endpoint | Descripción |
|---|
GET | /hosts/ | Listar hosts/clientes |
POST | /hosts/ | Registrar nuevo host |
GET | /hosts/{id} | Detalle de host |
Integrations (/integrations/)
| Método | Endpoint | Descripción |
|---|
GET | /zabbix/hosts | Hosts de Zabbix (desde caché Redis) |
GET | /zabbix/alerts | Alertas activas de Zabbix |
GET | /hosts/ | Inventario de hosts |
Reports (/reports/)
| Método | Endpoint | Descripción |
|---|
GET | /reports/ | Listar reportes generados |
GET | /reports/{id} | Descargar reporte específico |
Para la especificación completa de cada endpoint, accede a /docs del microservicio correspondiente (disponible en entornos de desarrollo/QA).
Autenticación de peticiones
Todas las peticiones autenticadas requieren el header:
Authorization: Bearer <JWT>
El AuthInterceptor del frontend agrega este header automáticamente.
