Solução de problemas de acesso

Os poucos pontos que travam FDEs novos durante o Acesso. Para o resto, veja a página geral de Solução de problemas.

Meu código de convite diz que já foi usado

Convites são de uso único — o primeiro khal fde enroll bem-sucedido o consome. Se tem certeza de que é sua primeira tentativa, talvez já esteja cadastrado(a): rode khal fde status. Caso contrário, peça um novo ao admin — não dá para “desusar” um convite.

O `khal fde ssh` diz que ainda não fui aprovado(a)

Esperado, não é erro. O lease de SSH fica bloqueado pelo Deploy Ledger até um lead aprovar — a workstation existir e estar acessível são passos diferentes. Avise quem está te onboardando (guia do admin). Enquanto espera, khal fde status e khal fde ssh --dry-run funcionam e não alteram nada.

Qual --target eu uso?

Um rótulo de ambiente, não uma URL — dev, hml ou prod. FDEs novos usam --target dev. hml/prod pertencem a engajamentos específicos de cliente e vêm do seu lead. Veja a escada de ambientes.

Gerar um convite falha ou diz acesso negado

khal fde invite create é só para superadmin e só aceita endereços @namastex.ai. Não é superadmin? Peça a um. Email fora do @namastex.ai? Também é um não definitivo — sem contorno.

Não sei em que ponto do processo eu estou

khal fde status

Rode a qualquer momento, do convite até a conexão — mostra seu estado atual e nunca altera nada.

🤖 Prompt para colar no seu agente

TASK: Use `fde-start-here/access/troubleshooting.mdx` para desbloquear um FDE ou admin travado no meio do Acesso, verificando com a saída atual dos comandos antes de assumir uma correção.
CONTEXT: Leia esta página e o guia específico para onde ela aponta (admin ou engenheiro) antes de recomendar uma correção.
SAFE FIRST COMMANDS: `khal fde status`, `khal fde ssh --dry-run`, `khal --version` (nenhum altera estado).
EVIDENCE: comando, exit status, saída sanitizada (redija códigos de convite e hostnames), o que prova, próxima ação segura. Nunca rode de novo um comando que altera estado (enroll, instance, invite create) de forma especulativa.

Gere um convite e aprove o acesso