Autenticação
Faça login, verifique sessões e veja como a CLI do Jamdesk autentica. Abrange armazenamento de tokens, renovação de sessão, contas de equipe e ambientes CI/CD.
A CLI faz login na sua conta Jamdesk pelo navegador. Faça login antes de fazer o deploy.
Login
jamdesk login
Isso abre o dashboard do Jamdesk no seu navegador. O fluxo:
- A CLI inicia um servidor HTTP local em
127.0.0.1:9876(usa uma porta atribuída pelo sistema operacional se a 9876 estiver ocupada) - Seu navegador abre em
dashboard.jamdesk.com/cli-auth - Você se autentica usando qualquer método de login do dashboard (e-mail/senha, Google, GitHub)
- O dashboard envia suas credenciais de volta ao servidor local da CLI
- As credenciais são armazenadas em
~/.jamdeskrc
A CLI verifica um parâmetro de estado no callback para prevenir falsificação de requisição entre sites (CSRF). O fluxo de login expira após 2 minutos.
$ jamdesk login
ℹ Open this URL in your browser to log in:
https://dashboard.jamdesk.com/cli-auth?port=9876&state=abc123...
ℹ Waiting for authentication...
✔ Logged in as you@example.comAmbientes headless e SSH: A CLI sempre imprime a URL no terminal, mesmo quando não consegue abrir um navegador. Cole a URL em qualquer navegador.
Logout
jamdesk logout
Limpa as credenciais armazenadas em ~/.jamdeskrc. Não faz nada se você não estiver logado.
$ jamdesk logout
✔ Logged out (you@example.com)Whoami
jamdesk whoami
Mostra o e-mail com o qual você está logado. Ele atualiza o token para validar a sessão. Nunca lê um cache local.
Estados possíveis:
$ jamdesk whoami
✔ Logged in as you@example.comComo funcionam as sessões
As credenciais são armazenadas em ~/.jamdeskrc como JSON com permissões 0600 (somente leitura e escrita pelo proprietário):
{
"auth": {
"refreshToken": "AGK...",
"email": "you@example.com",
"uid": "abc123",
"expiresAt": 1700000000000
}
}A CLI usa uma arquitetura de refresh token + ID token:
- Os ID tokens expiram em cerca de 1 hora e são usados nas chamadas de API
- A CLI renova automaticamente os ID tokens com o refresh token armazenado 5 minutos antes da expiração
- Os refresh tokens têm longa duração, mas podem ser revogados (troca de senha, exclusão da conta)
- A CLI limpa a autenticação armazenada quando o refresh token é permanentemente inválido (
TOKEN_EXPIRED,USER_NOT_FOUND,INVALID_REFRESH_TOKEN)
A CLI renova os tokens em todo comando autenticado. Você nunca precisa renová-los manualmente.
Solução de problemas
Um firewall pode estar bloqueando o servidor de callback local da CLI. Copie a URL impressa e abra-a no seu navegador.
A CLI escolhe outra porta quando outro processo usa a 9876. Verifique a URL na saída do terminal.
Seu refresh token não é mais válido. Isso acontece após trocas de senha ou longos períodos de inatividade.
Execute jamdesk login para obter uma nova sessão.
Ambientes headless (SSH, Docker, CI) não conseguem abrir um navegador. Copie a URL do terminal e abra-a em qualquer navegador que consiga alcançar a porta de callback da sua máquina.
Verifique se ~/.jamdeskrc existe e contém uma chave auth:
cat ~/.jamdeskrcAs permissões do arquivo devem ser 0600. Um arquivo ausente pode indicar um problema de permissão no seu diretório home. Verifique com ls -la ~.
Para mais solução de problemas da CLI, consulte o guia da CLI na Central de ajuda.
