> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# O que significa acesso para um FDE

> Acesso é uma workstation real na nuvem, não um login.

"Acesso" para um FDE não é uma conta em painel — é dar `ssh` na sua própria workstation Ubuntu com sudo completo, na infraestrutura da KHAL. Esta página é o mapa; os dois guias por papel são os runbooks.

<Note>
  Todo comando é a CLI `khal fde` (do `app-kit`), sempre conversando com `platform.khal.ai`. `--target` é um **rótulo de ambiente** (`dev`, `hml`, `prod`), nunca uma URL.
</Note>

## Dois papéis, um fluxo

* **Admin/superadmin** — gera seu convite e, depois, aprova o lease de SSH.
* **Você (engenheiro(a))** — resgata o convite, solicita a workstation, conecta.

Sem atalhos: sem convite não há workstation, sem aprovação não há SSH.

## O fluxo

<Steps>
  <Step title="Admin gera um convite">Um código de uso único que inicializa sua identidade.</Step>
  <Step title="Você se cadastra">Resgata o convite e entrega sua chave pública SSH — `khal fde enroll`.</Step>
  <Step title="Você solicita uma workstation">`khal fde instance` provisiona uma VM real — clonada, iniciada, na Tailscale.</Step>
  <Step title="Admin aprova">A workstation existe, mas o lease de SSH fica bloqueado até ser aprovado.</Step>
  <Step title="Você conecta">`khal fde ssh`. Veja `khal fde status` a qualquer momento.</Step>
</Steps>

## Antes de começar

Instale a CLI `khal` — veja [Instale seu toolchain de FDE](/pt-BR/fde-engineer/khal-cli).

## Escolha seu papel

<CardGroup cols={2}>
  <Card title="Sou o admin" icon="user-shield" href="/pt-BR/fde-start-here/access/admin-guide">
    Gere um convite e aprove a workstation.
  </Card>

  <Card title="Sou o(a) novo(a) engenheiro(a)" icon="terminal" href="/pt-BR/fde-start-here/access/engineer-guide">
    Resgate, solicite, conecte.
  </Card>
</CardGroup>

Travou? [Troubleshooting de acesso](/pt-BR/fde-start-here/access/troubleshooting).

<Accordion title="🤖 Prompt para colar no seu agente">
  ```text theme={null}
  TASK: Use `fde-start-here/access/overview.mdx` para orientar um novo FDE ou admin, depois direcione para o guia do papel específico antes de rodar qualquer coisa.
  CONTEXT: Página de orientação, não um runbook — os comandos estão nos guias de admin e de engenheiro que ela linka.
  SAFE FIRST COMMANDS: `khal fde status`, `khal --version` (nenhum altera estado).
  EVIDENCE: Confirme o papel (admin ou engenheiro) antes de recomendar um comando, depois siga o prompt de agente daquela página.
  ```
</Accordion>