# Sesiones y dispositivos

Una sesión por dispositivo, con su IP, cierre individual o masivo, bloqueo de IPs y autorización del CLI con código.

Fuente: https://ardumaker.com/docs/sesiones-y-dispositivos/

- Categoría: Pagos y administración
- Estado: Disponible
- Requisitos: Una cuenta de ArduMaker
- Herramientas MCP: Sin herramientas MCP: se usa desde el panel.

## ¿Qué permite hacer?

- Ver cada sesión abierta: tipo de cliente, navegador, plataforma, IP, última actividad y si es la actual.
- Cerrar una sesión concreta o todas menos la actual.
- Bloquear una IP para la propia cuenta, desde la lista o a mano.
- Autorizar el CLI de ArduMaker en otro equipo con un código corto.

## ¿Cuándo conviene usarlo?

Para revisar desde dónde se usa la cuenta, cortar un equipo perdido o ajeno, o conectar una terminal sin escribir la contraseña en ella.

## ¿Cómo funciona en ArduMaker?

| Aspecto | Sin «recordarme» | Con «recordarme» |
| --- | --- | --- |
| Token de acceso | 1 día | 12 h, se renueva solo |
| Renovación | No hay | Token de un solo uso, rotativo |
| Fin de la sesión | Al vencer el token | 30 días sin uso o 180 días en total |

- Si llega un token de renovación ya usado, ArduMaker asume que fue robado y corta la sesión entera.
- Cambiar la contraseña cierra todas las demás sesiones.
- Una IP bloqueada no puede iniciar sesión ni renovar en esa cuenta, y las sesiones vivas desde ella se cortan. Desbloquear no revive lo cortado.
- «Conectada ahora» significa actividad en los últimos 5 minutos.

### Autorizar un dispositivo

1. El CLI pide un código y muestra uno de 6 caracteres.
2. La persona, con su sesión abierta, lo confirma en la página `/bin` de ArduMaker.
3. El CLI recibe su propia sesión, que aparece en el listado como un dispositivo más.

El código vence a los 10 minutos. Al autorizar un dispositivo llega un correo de seguridad a la cuenta.

## ¿Qué cambia realmente?

Cada inicio de sesión crea una sesión propia con su IP inicial. Cerrar o bloquear la invalida en el servidor: el token deja de servir en el pedido siguiente.

## Resultado esperado

La persona controla en qué equipos está abierta su cuenta y puede cortar cualquiera al instante. Las sesiones cerradas quedan visibles con el motivo.

## Errores y resolución

| Código | Qué pasó |
| --- | --- |
| `refresh_token_reutilizado` | Se reusó un token de renovación: la sesión se cortó y hay que volver a entrar. |
| `refresh_token_vencido` | 30 días sin usar la sesión. |
| `ip_bloqueada` | La IP está bloqueada para esa cuenta. |
| `demasiados_intentos` | 10 renovaciones fallidas en un minuto desde esa IP; trae `Retry-After`. |
| `slow_down` | El CLI pidió códigos o sondeó demasiado rápido. |

## Relación con MCP

No hay herramientas MCP para sesiones. Los agentes MCP se autorizan con su propio flujo OAuth y no aparecen como sesiones de la cuenta. Ver [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Autenticación externa](https://ardumaker.com/docs/autenticacion-externa/)
- [Notificaciones](https://ardumaker.com/docs/notificaciones/)
- [Servidor MCP](https://ardumaker.com/docs/servidor-mcp/)
- [Permisos del agente MCP](https://ardumaker.com/docs/permisos-mcp/)