Pular para o conteúdo principal

Acesso e Permissões

Como gerir usuários, grupos e garantir a segurança da aplicação.

Introdução​

A segurança é um dos pilares fundamentais de qualquer aplicação. Seja para uma aplicação interna simples ou um sistema complexo com milhares de usuários externos via API.

O Netuno oferece, nativamente, um sistema robusto de Controle de Acessos e Permissões, fornecendo as ferramentas necessárias para gerir a segurança de forma centralizada e eficiente. E elimina a necessidade de desenvolver essas funcionalidades do zero.

Entre os principais mecanismos de segurança destacam-se:

  • Gestão de usuários e grupos.
  • Controle de permissões aos dados à gestão de dados.
  • Histórico detalhado das tentativas de autenticação.
  • Bloqueio por IP automático após tentativas de acesso falhadas consecutivamente.
  • Autenticação integrada com LDAP, Google, GitHub, Discord, etc.
  • Módulo de autenticação JWT para front-end.
  • Entre outros...

Gestão de Usuários​

Trata-se da administração das contas individuais que acessam a plataforma. Cada usuário, serviço ou integração que precisa entrar no sistema deve possuir um registro de usuário único.

Na área de gestão de usuários do Netuno, você tem controle total sobre o ciclo de vida dessas contas:

  • Criação: Cadastro de novos membros da equipe ou clientes.
  • Manutenção: Atualização de e-mails, alteração de senhas e dados cadastrais.
  • Controle de Acesso: Bloqueio rápido de contas (desativação) sem necessidade de exclusão dos dados históricos.
Guia Visual

Para obter informações detalhadas sobre a Gestão de Usuários, consulte o Guia da Interface: Usuários e Grupos

Gestão de Grupos​

A definição de regras de autorização é feita por meio de Grupos, que estabelecem quais menus, formulários, serviços e dados cada usuário tem permissão para acessar ou manipular. Em vez de configurar permissões individualmente, o ideal é definir as regras no Grupo e, em seguida, associar os usuários a ele. Esse procedimento garante:

  • Escalabilidade: Facilidade de gerir centenas de usuários.
  • Segurança: Menor risco de conceder acessos indevidos acidentalmente.
  • Organização: Separação clara entre Administradores, Gestores, Supervisores e usuários em geral.

O Netuno já traz grupos nativos como dev e admin, e fornece total autonomia para criar grupos personalizados para atender às regras de negócio da sua aplicação.

Guia Visual

Para obter informações detalhadas sobre a Gestão de Grupos, consulte o Guia da Interface: Usuários e Grupos

Controle de Permissões de Dados​

Para garantir a funcionalidade de um grupo, é crucial estabelecer quais dados ele está autorizado a manipular. No Netuno, o controle de acesso é detalhado e aplicado diretamente aos Formulários (tabelas) da sua aplicação.

O sistema utiliza uma matriz de permissões que possibilita definir, para cada funcionalidade, se um determinado grupo possui a devida autorização para:

  • Ler: Apenas visualizar os registros.
  • Escrever: Inserir e editar registros no banco de dados.
  • Deletar: Remover registros permanentemente.

Essa flexibilidade assegura a proteção dos dados sensíveis, pois cada colaborador tem acesso restrito apenas às informações essenciais para a execução de suas tarefas.

Histórico de Autenticação​

O Netuno garante a integridade do sistema através do registro automático de todas as tentativas de autenticação. Esse registro de segurança funciona como uma "caixa preta", sendo crucial para a auditoria de todos os acessos ao sistema, tanto os bem-sucedidos quanto os inválidos.

O sistema monitora e armazena detalhadamente as seguintes informações de cada tentativa de login de usuário:

  • IP de Origem: O endereço de rede de onde partiu a solicitação.
  • Data e Hora: O momento exato da ação.
  • Status: Se o acesso foi permitido, negado ou bloqueado.

Como Visualizar o Histórico​

  1. Acesse o menu Configuração > Usuários.
  2. Localize o usuário desejado e clique em Editar.
  3. Role até a seção Authentication History (Histórico de Autenticação).
  4. Clique no ícone de Relógio (🕒) para abrir a lista completa de acessos daquele usuário.

Bloqueio Automático​

O Netuno possui um sistema de segurança ativo, que bloqueia o IP de origem quando atividades suspeitas são detectadas (exemplo: múltiplas senhas incorretas consecutivas).

Configurando as Regras de Bloqueio​

Essa regra é definida nos arquivos de configuração do ambiente da sua aplicação "development.json" ou "production.json".

1. Localize o arquivo de configuração​

Na raiz do seu projeto, navegue até a pasta config. Abra o arquivo correspondente ao ambiente que deseja proteger:

  • Para desenvolvimento: development.json

  • Para produção: production.json

2. Insira o código de proteção​

Dentro do arquivo JSON, localize a seção auth. Se ela não existir, insira o bloco attempts conforme o exemplo abaixo:

{
  "auth": {
    "attempts": {
        "interval": 60,
        "maxFails": 3
    }
  }
}

3. Entendendo os parâmetros​

  • interval: Janela de tempo em minutos (exemplo: 60 minutos = 1 hora).

  • maxFails: Número máximo de falhas permitidas dentro desse intervalo antes do bloqueio.

4. Comportamento do sistema​

  • Após o bloqueio automático, o usuário fica impedido de acessar a aplicação.

  • Por padrão, o sistema está configurado para três tentativas inválidas com o bloqueio por uma hora. Após este período as tentativas são liberadas novamente.

  • Este processo pode ser configurado conforme a necessidade da sua aplicação.

Desbloqueio por Interface do Netuno​

Se um usuário for bloqueado acidentalmente, apenas um administrador pode liberar o acesso diretamente pelo Back-Office, sem precisar acessar o banco de dados.

  1. Acesse o menu da aplicação no modo "Visualizar", e clique na seção de Usuário;
  2. No campo de "Editar um usuário existente", pesquise pelo cadastro do usuário bloqueado;
  3. Na seção de "Histórico de Autenticação", verifique se o status "Access" exibe o ícone de "Cadeado" na cor verde;
  4. Clique neste ícone para desbloquear o usuário, após esta ação será exibida uma mensagem de sucesso;
  5. A liberação é imediata, permitindo que o usuário tente efetuar login novamente.

O status "Access" do usuário exibirá os ícones "white_check_mark" (verde, indicando acesso liberado) e "Cadeado" (laranja, sinalizando que as tentativas de acesso negado foram desbloqueadas).

Essa condição será alterada apenas após o usuário, efetuar um login com sucesso.

Autenticações Integradas​

Sua aplicação pode exigir métodos mais sofisticados de entrada, especialmente se você estiver construindo um aplicativo móvel ou integrando-se a uma rede corporativa.

O Netuno foi projetado para ser flexível e se integrar ao ecossistema da sua organização. Além do login padrão (usuário e senha), a plataforma oferece suporte a diversos protocolos de autenticação de mercado.

Isso permite implementar estratégias de Single Sign-On (Login Único), onde os usuários acessam o sistema utilizando credenciais que já possuem, centralizando a gestão de acessos.

Ambientes Corporativos: Compatibilidade com diretórios de usuários (como LDAP e Active Directory), ideal para intranet e sistemas internos.

Login Social (OAuth): Possibilidade de integração com provedores como Google, Microsoft, GitHub, entre outros, facilitando o cadastro e acesso em aplicações públicas.

Autenticação via Token (JWT)​

Para projetos que utilizam um Front-end dedicado (como sites em React, Vue.js ou aplicativos Mobile), a tela de login tradicional do Netuno não é utilizada. Nesses cenários, adota-se o padrão JWT (JSON Web Token).

O Netuno oferece um serviço nativo que gera e valida esses tokens automaticamente, garantindo segurança e eficiência na comunicação via API.

Guia Visual

Para obter mais informações sobre como implementar e configurar o JWT nos seus arquivos de configuração, consulte Guia de Autenticação JWT

Conclusão​

Dominar os recursos de segurança do Netuno é fundamental para a saúde do seu projeto. Ao utilizar corretamente as ferramentas de gestão de usuários, de grupos e monitoramento de histórico, você construiu um ambiente que equilibra proteção de dados com facilidade de uso.

Com isso você garante que seu sistema no Netuno seja:

  • Seguro: Protegendo informações sensíveis contra acessos não autorizados.

  • Organizado: Estabelecendo hierarquias e responsabilidades claras.

  • Escalável: Pronto para crescer com integrações modernas.

Mantenha as boas práticas: Revise periodicamente as permissões dos grupos e verifique o histórico de acessos para manter seu ambiente saudável.