Administração em resumo
Dois escopos, deliberadamente separados
| Escopo | Opera sobre | Alcançável por |
|---|---|---|
| Plataforma | Todas as organizações | Apenas administradores de plataforma |
| Organização | A configuração e os usuários de uma organização | Os administradores dela |
Operações de plataforma cruzam fronteiras entre organizações e rodam sob um escopo de autorização inteiramente distinto. Um administrador de organização não as alcança, por mais privilegiado que seja dentro da sua.
Ciclo de vida
| Estado | Acesso | Dados | Reversível |
|---|---|---|---|
| Ativa | Normal | Retidos | — |
| Suspensa | Bloqueado | Retidos | Sim |
| Excluída | Bloqueado | Retidos, exclusão reversível | Sim |
A suspensão é a ferramenta certa para uma retenção de cobrança ou conformidade: reversível e não destrutiva.
O problema de inicialização
Uma organização nova não tem usuários. A entrada no sistema não consegue criar o primeiro, porque resolve organizações das quais o usuário já é membro — que para uma organização nova são nenhuma.
Por isso o primeiro administrador é concedido explicitamente, nomeando uma identidade no seu provedor de identidade. Apenas o identificador do provedor é fornecido; os detalhes são lidos do provedor, então quem chama não pode fabricar uma identidade.
Conceder a um grupo costuma ser melhor — a participação então acompanha seu processo existente de entradas e saídas.
Depois dessa concessão, a organização se administra sozinha.
Identidade é espelhada, nunca criada
| Caminho | Cria |
|---|---|
| Entrada no sistema | Um usuário, na primeira autenticação numa organização que ele alcança |
| Espelhamento administrativo | Um usuário, a partir de uma identidade nomeada do provedor |
| Sincronização de grupos | Grupos, do provedor |
Não há caminho que crie um usuário a partir de entrada arbitrária — aplicado no nível do banco de dados, não apenas no código.
Instantâneos de configuração
Um instantâneo armazena uma configuração. Não há aplicar, restaurar, reverter ou comparar. É um registro, não um mecanismo de recuperação — não planeje um procedimento de recuperação em torno dele.
A seguir
Última verificação no commit d3c2586b (2026-08-03)