Jamdesk Documentation logo

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:

  1. 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)
  2. Seu navegador abre em dashboard.jamdesk.com/cli-auth
  3. Você se autentica usando qualquer método de login do dashboard (e-mail/senha, Google, GitHub)
  4. O dashboard envia suas credenciais de volta ao servidor local da CLI
  5. 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.

Expected output
$ 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.com

Ambientes 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.

Expected output
$ 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.com

Como funcionam as sessões

As credenciais são armazenadas em ~/.jamdeskrc como JSON com permissões 0600 (somente leitura e escrita pelo proprietário):

~/.jamdeskrc
{
  "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 ~/.jamdeskrc

As 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.

O que vem a seguir?

Deploy pela CLI

Faça o deploy da sua documentação pelo terminal

Visão geral da CLI

Todos os comandos da CLI de relance