Autorização em produção
RBAC nega por padrão: role desconhecida ou operação sem permissão retorna false. Exceções ou rejeições em when também negam a permissão correspondente. Entretanto, a segurança depende da confiabilidade das roles, dos parâmetros e das operações informados pela aplicação.
Entradas confiáveis
Obtenha a role do usuário por sessão validada ou identidade verificada no servidor, não do corpo ou dos headers da requisição. Verifique a posse do recurso e o escopo do tenant com dados confiáveis; não aceite ownerId informado pelo cliente como prova. Aplique await rbac.can() na operação protegida, inclusive em jobs, endpoints de escrita e métodos de serviço. Autenticação e associação de usuários a roles são responsabilidades da aplicação.
Falhas e erros
Falhas de condições negam a permissão afetada. Middlewares podem propagar erros de infraestrutura conforme o framework (Express e Nest usam next(err)). Trate erros de inicialização ou leitura de banco na aplicação; falha do adapter não significa acesso permitido. Se várias permissões coincidirem, outra condição que retorne true ainda poderá autorizar.
Cache
- A correspondência entre permissões e padrões utiliza caches limitados.
- Resultados condicionais dependentes de
paramssão avaliados a cada chamada, sem cache. addRole()eupdateRoles()reconstruem a herança e invalidam caches relevantes da instância.- Expressões regulares com estado têm
lastIndexreiniciado em verificações repetidas, inclusive com flagsg/y.
Meça o desempenho com suas próprias roles e operações. O repositório oferece npm run bench e npm run bench:micro, mas os resultados dependem do ambiente; não são garantias de throughput.
Armazenamento e concorrência
Os adapters SQL vinculam parâmetros de dados e validam/escapam identificadores. Defina schema e chaves únicas coerentes com a estratégia de upsert. Informe um tenant correto a cada requisição. Cada instância guarda um snapshot em memória; após alterações externas, recarregue e use updateRoles() ou reconstrua a instância. Em serviços distribuídos, coordene a atualização entre processos.