# Sessões e dispositivos

Uma sessão por dispositivo, com o seu IP, fecho individual ou em massa, bloqueio de IPs e autorização do CLI com código.

Fonte: https://ardumaker.com/pt/docs/sesiones-y-dispositivos/

- Categoria: Pagamentos e administração
- Estado: Disponível
- Requisitos: Uma conta ArduMaker
- Ferramentas MCP: Sem ferramentas MCP: usa-se a partir do painel.

## O que permite fazer?

- Ver cada sessão aberta: tipo de cliente, navegador, plataforma, IP, última atividade e se é a atual.
- Fechar uma sessão concreta ou todas menos a atual.
- Bloquear um IP para a própria conta, a partir da lista ou manualmente.
- Autorizar o CLI da ArduMaker noutro equipamento com um código curto.

## Quando convém usar?

Para rever de onde a conta está sendo usada, cortar um equipamento perdido ou alheio, ou ligar um terminal sem escrever a senha nele.

## Como funciona na ArduMaker?

| Aspeto | Sem «lembrar-me» | Com «lembrar-me» |
| --- | --- | --- |
| Token de acesso | 1 dia | 12 h, renova-se sozinho |
| Renovação | Não há | Token de uso único, rotativo |
| Fim da sessão | Quando o token expira | 30 dias sem uso ou 180 dias no total |

- Se chegar um token de renovação já usado, a ArduMaker assume que foi roubado e corta a sessão inteira.
- Mudar a senha fecha todas as outras sessões.
- Um IP bloqueado não pode iniciar sessão nem renovar nessa conta, e as sessões ativas a partir dele são cortadas. Desbloquear não revive o que foi cortado.
- «Ligada agora» significa atividade nos últimos 5 minutos.

### Autorizar um dispositivo

1. O CLI pede um código e mostra um de 6 caracteres.
2. A pessoa, com sessão iniciada, confirma-o na página `/bin` da ArduMaker.
3. O CLI recebe a sua própria sessão, que aparece na lista como mais um dispositivo.

O código expira ao fim de 10 minutos. Ao autorizar um dispositivo chega um email de segurança à conta.

## O que muda realmente?

Cada login cria uma sessão própria com o seu IP inicial. Fechar ou bloquear invalida-a no servidor: o token deixa de servir no pedido seguinte.

## Resultado esperado

A pessoa controla em que equipamentos a conta está aberta e pode cortar qualquer um de imediato. As sessões fechadas ficam visíveis com o motivo.

## Erros e resolução

| Código | O que aconteceu |
| --- | --- |
| `refresh_token_reutilizado` | Um token de renovação foi reutilizado: a sessão foi cortada e é preciso voltar a entrar. |
| `refresh_token_vencido` | 30 dias sem usar a sessão. |
| `ip_bloqueada` | O IP está bloqueado para essa conta. |
| `demasiados_intentos` | 10 renovações falhadas em um minuto a partir desse IP; traz `Retry-After`. |
| `slow_down` | O CLI pediu códigos ou sondou demasiado depressa. |

## Relação com MCP

Não há ferramentas MCP para sessões. Os agentes MCP autorizam-se com o seu próprio fluxo OAuth e não aparecem como sessões da conta. Ver [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Autenticação externa](https://ardumaker.com/pt/docs/autenticacion-externa/)
- [Notificações](https://ardumaker.com/pt/docs/notificaciones/)
- [Servidor MCP](https://ardumaker.com/pt/docs/servidor-mcp/)
- [Permissões do agente MCP](https://ardumaker.com/pt/docs/permisos-mcp/)