Autenticação e tokens

O Jiraya usa três tipos de credencial: a sessão do navegador, o token de acesso pessoal, que a CLI e o daemon usam, e o token de execução, que cada agente recebe enquanto trabalha.

Sessão do navegadorCopiar link da seção

No navegador, você entra com e-mail, senha e o código da verificação em duas etapas, gerado por um aplicativo autenticador. Os códigos de recuperação, criados ao ativar a verificação, substituem o aplicativo se você perder o acesso a ele.

Trocar ou redefinir a senha encerra as suas outras sessões do navegador. Os tokens de acesso pessoal continuam valendo.

Tokens de acesso pessoalCopiar link da seção

O token de acesso pessoal começa com jir_ e dá acesso à sua conta pela CLI e pela API, sem pedir a verificação em duas etapas. Trate-o como uma senha.

Há duas formas de criar um:

• Pela CLI: jiraya login abre o navegador, você confirma o login e a CLI recebe um token válido por 90 dias.
• Pela interface: em Configurações › Tokens de API, dê um nome ao token e escolha a validade: 30 dias, 90 dias, 1 ano ou sem expiração. O token aparece uma única vez; copie e guarde antes de fechar a janela.

Um daemon em execução renova o próprio token quando ele está perto de expirar, então uma máquina sempre ligada não precisa de login a cada 90 dias.

Entrar com um tokenCopiar link da seção

Em máquinas sem navegador, crie o token na interface e entre com ele:

$jiraya login --token

Sem valor, a CLI pede o token no terminal, e ele não fica no histórico do shell. Depois, rode jiraya setup --workspace <slug> para registrar a máquina.

Conferir e sairCopiar link da seção

O logout só apaga a cópia local. Para invalidar o token, revogue-o em Configurações › Tokens de API. Se suspeitar de vazamento, revogue os tokens e rode jiraya login de novo em cada máquina: trocar a senha não revoga tokens.

Onde o token ficaCopiar link da seção

A CLI guarda o token em ~/.jiraya/config.json, com permissão de leitura só para o seu usuário. Com --profile <nome>, em ~/.jiraya/profiles/<nome>/config.json.

Usar o token na APICopiar link da seção

Envie o token no cabeçalho Authorization:

$curl -H "Authorization: Bearer $JIRAYA_TOKEN" https://api.jiraya.io/api/me

Variáveis de ambienteCopiar link da seção

As variáveis têm prioridade sobre o que está em config.json. São úteis em scripts e em CI:

JIRAYA_WORKSPACE_ID escolhe o workspace dos comandos, mas não onde o jiraya setup registra a máquina: para isso, use --workspace.

Tokens de execuçãoCopiar link da seção

Cada execução de agente recebe um token próprio, criado pelo servidor quando o daemon pega a execução. O daemon o entrega à ferramenta de IA em JIRAYA_TOKEN, junto com JIRAYA_WORKSPACE_ID, JIRAYA_AGENT_ID e JIRAYA_TASK_ID.

• O token vale só para aquele agente, naquele workspace, e é apagado quando a execução termina.
• Dentro de uma execução, a CLI jiraya usa só esse token e nunca recorre ao token guardado no seu config.json. Assim, o que o agente faz fica registrado como do agente.
• Você não cria nem revoga tokens de execução: o ciclo deles acompanha a execução.

Veja o que isso protege, e o que não protege, no Modelo de segurança.