Autorização previsível
@rbac/rbac é uma biblioteca TypeScript de controle de acesso baseado em papéis (RBAC) para Node.js. Defina operações permitidas para cada role, herde permissões de outras roles e consulte se uma operação está autorizada.
A biblioteca implementa autorização, não autenticação: sua aplicação identifica o usuário, determina a role confiável e fornece o contexto. O RBAC retorna uma decisão, e sua aplicação precisa aplicá-la.
Uma decisão completa
import RBAC from '@rbac/rbac';
const rbac = RBAC()({
viewer: { can: ['documents:read'] },
editor: { inherits: ['viewer'], can: ['documents:edit'] }
});
console.log(await rbac.can('editor', 'documents:read')); // true
console.log(await rbac.can('viewer', 'documents:edit')); // false
console.log(await rbac.can('unknown', 'documents:read')); // falseRBAC(config)(roles) retorna uma instância com can(), addRole() e updateRoles(). Mesmo para permissões incondicionais, as verificações retornam uma promise. Roles desconhecidas e permissões ausentes são negadas por padrão.
Recursos disponíveis
| Recurso | Guia |
|---|---|
| Permissões exatas, herança e condições repetidas | Roles e permissões |
| Wildcards e expressões regulares | Padrões |
| Condições por requisição e predicados assíncronos | Condições |
| Gestão de roles em execução | Atualização de roles |
| Persistência por tenant | Adapters de banco |
| Express, NestJS e Fastify | Middlewares |
Continue com a instalação ou abra o playground interativo.