API REST

Autenticación#

La API usa autenticación JWT con dos tokens:

Login#

POST /endpoint/login
Content-Type: application/json

{
  "username": "operador1",
  "password": "mi_password",
  "version": "1.2"
}

Respuesta exitosa (200):

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs..."
}

Renovar token#

POST /endpoint/refresh
Authorization: Bearer <refresh_token>

Usar la API#

Todas las peticiones autenticadas requieren el header:

Authorization: Bearer <access_token>

Endpoints de la API#

Todos los endpoints están bajo el prefijo configurado en profile.yaml (por defecto /endpoint).

Conexión y sincronización#

OTP (One-Time Passwords)#

Listeners#

Agentes#

Comandos y consola#

Tareas#

Chat#

Descargas#

Capturas de pantalla#

Credenciales#

Targets#

Túneles#

Servicios#

Endpoints dinámicos#

Los extenders pueden registrar endpoints adicionales en tiempo de ejecución usando:

• RegisterEndpoint(method, path, handler) — Endpoint autenticado
• RegisterPublicEndpoint(method, path, handler) — Endpoint público

Estos endpoints se registran bajo el mismo prefijo y son accesibles mientras el extender esté cargado.

WebSocket#

La comunicación en tiempo real se realiza via WebSocket:

wss://servidor:4321/endpoint/connect?otp=<token>

El WebSocket se establece usando un OTP (One-Time Password) generado previamente. A través de él, el servidor envía notificaciones de:

• Nuevos agentes
• Resultados de tareas
• Mensajes de chat
• Actualizaciones de estado
• Eventos de listeners

Códigos de respuesta#

Manejo de errores#

Las respuestas de error siguen el formato:

{
  "message": "Descripción del error",
  "ok": false
}