Usuários

Users (Gestão de Usuários)

A feature Users é responsável pela administração centralizada de usuários dentro do sistema IAM. Ela permite o cadastro, manutenção, associação de permissões e consulta de dados dos usuários autenticados, garantindo controle e rastreabilidade sobre quem pode acessar os recursos da plataforma.

Visão Geral

A funcionalidade de Users contempla os principais fluxos relacionados à gestão de identidade digital dos usuários, permitindo que administradores configurem e acompanhem os acessos conforme as políticas de segurança da organização. Os principais pilares da funcionalidade incluem:

👤 1. Criação de Usuário

Permite o cadastro de novos usuários no sistema, definindo atributos como nome, e-mail, identificadores internos, e associando permissões ou grupos já no momento da criação.

📝 2. Edição de Usuário

Oferece a capacidade de atualizar dados cadastrais dos usuários, como nome, e-mail ou status de ativação, bem como alterar suas permissões ou associações de grupo conforme mudanças de função ou necessidade organizacional.

🗑️ 3. Exclusão de Usuário

Possibilita a remoção controlada de usuários do sistema. A exclusão pode ser lógica (desativação) ou física, de acordo com as diretrizes de retenção de dados e políticas de conformidade.

📋 4. Listagem e Consulta

Fornece mecanismos para listar todos os usuários cadastrados, com suporte a filtros por status, grupo, permissões e outros atributos. Também permite a consulta detalhada de um usuário específico.

🔐 5. Associação de Permissões

Habilita a vinculação direta de permissões (roles) a um usuário, seja individualmente ou via grupos, definindo o escopo de acesso a recursos e funcionalidades do sistema.

🙋‍♂️ 6. Obter Dados do Usuário Autenticado

Permite que o próprio usuário autenticado consulte suas informações pessoais e permissões ativas, promovendo transparência e confiança no controle de acessos.

Segurança

Todos os fluxos da feature Users seguem boas práticas de segurança, incluindo:

Controle de acesso baseado em roles (RBAC) para operações sensíveis
Auditoria de alterações em dados e permissões
Validações robustas para evitar inconsistências cadastrais

Integração com IAM

A feature Users é um núcleo do módulo IAM e se integra diretamente com:

O sistema de autenticação (Auth) para definição de identidade
A gestão de roles, permissões e grupos para controle de acesso
O módulo de auditoria e compliance, garantindo rastreabilidade em todas as ações sobre usuários

Para detalhes sobre os endpoints, formatos de payload, e comportamentos esperados de cada operação, consulte os menus específicos desta seção.