Administrando organizações
Dois escopos distintos, deliberadamente separados.
| Escopo | Opera sobre | Operador típico |
|---|---|---|
| Administração de plataforma | Todas as organizações | Quem opera a plataforma |
| Administração de organização | A configuração e os usuários de uma organização | O cliente |
A administração de plataforma cruza fronteiras entre organizações e por isso roda sob um escopo de autorização inteiramente distinto. Um administrador de organização, por mais privilegiado que seja dentro da sua, não a alcança.
Organizações
Uma organização é um espaço de trabalho isolado. O isolamento é aplicado no banco de dados, então uma consulta não consegue devolver linhas de outra organização mesmo que o código da aplicação esqueça de filtrar.
Provisionar uma organização a cria e semeia seu catálogo de permissões, para que papéis possam ser compostos imediatamente, sem um passo separado.
Ciclo de vida
| Estado | Significado |
|---|---|
| Ativa | Operação normal |
| Suspensa | Acesso bloqueado; dados retidos |
| Excluída | Excluída de forma reversível |
A suspensão é reversível e não destrutiva, o que a torna utilizável para retenções de cobrança ou conformidade sem risco aos dados.
Concedendo o primeiro administrador
Uma organização nova não tem usuários, e o caminho habitual — um usuário entra e é provisionado automaticamente — não consegue inicializá-la, porque a entrada resolve organizações das quais o usuário já é membro.
Por isso a administração de plataforma concede o primeiro administrador explicitamente, nomeando uma identidade no provedor de identidade. Apenas o identificador do provedor é fornecido; os detalhes da identidade são lidos do próprio provedor, então quem chama não pode fabricar uma identidade que não exista lá.
Depois dessa primeira concessão, a organização se administra sozinha.
Instantâneos de configuração
Um instantâneo armazena uma configuração fornecida por quem chama, recuperável depois.
Não há operação de aplicar, restaurar, reverter ou comparar. Um instantâneo é um registro, não um mecanismo de recuperação — reverter uma mudança de configuração significa fazer a mudança inversa você mesmo.
Não planeje um procedimento de recuperação em torno deles.
Conselhos
- Mantenha os dois escopos separados no seu modelo operacional. Administração de plataforma é trabalho de infraestrutura; de organização é trabalho de cliente.
- Suspenda em vez de excluir quando o acesso precisa parar mas os dados precisam sobreviver.
- Registre o que você mudou antes de uma grande mudança de configuração, especialmente em perfis de comparação, onde o efeito é sobre dados e não apenas sobre configuração.
A seguir
Última verificação no commit d3c2586b (2026-08-03)