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.
- 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
- O CLI pede um código e mostra um de 6 caracteres.
- A pessoa, com sessão iniciada, confirma-o na página
/binda ArduMaker. - 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.