Pular para o conteúdo principal
Versão: 3.x (deprecated)

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​

ts
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')); // false

RBAC(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​

RecursoGuia
Permissões exatas, herança e condições repetidasRoles e permissões
Wildcards e expressões regularesPadrões
Condições por requisição e predicados assíncronosCondições
Gestão de roles em execuçãoAtualização de roles
Persistência por tenantAdapters de banco
Express, NestJS e FastifyMiddlewares

Continue com a instalação ou abra o playground interativo.