aula prática · autenticação e papéis
Um console para ver por dentro como um agente eve verifica identidade. O agente envia o token de sessão, recebe slugs verificados e toma a própria decisão.
GET /api/v1/identity?organizationId=<org> Authorization: Bearer <token de sessão>
{ "authenticated": true,
"organizationId": "<org>",
"userId": "<id>",
"roles": ["<slug local>"] }Compara os slugs com a própria regra e decide se executa a ferramenta.
Estrutura da chamada, sem dados de contas.
Só a sessão Better Auth validada determina quem é o usuário. IDs e e-mails enviados pelo chamador são ignorados.
A API devolve apenas slugs de papel. Cada agente mantém a própria regra do que cada papel pode fazer.
401 para token inválido, 403 para conta suspensa. Erro ou papel ausente significa negar.
Atribuições, suspensões e alterações de papéis ficam na trilha de auditoria.
fluxo da aula
Cadastro
Cada aluno cria uma conta com e-mail e senha no próprio Access, via Better Auth.
Sincronização
O administrador traz as contas reais para o console de usuários.
Atribuição
Papéis personalizados, com slug imutável, são atribuídos a cada conta.
Consulta
O agente eve encaminha o token de sessão, recebe os slugs e decide.
privilégio e papel