Autorização previsível
@rbac/core é 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 { createRBAC } from '@rbac/core';
const rbac = createRBAC({ roles: {
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')); // falsecreateRBAC({ roles, ...options }) 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.
Identidade visual
O logo completo do RBAC e o ícone de escudo e cadeado são SVGs vetoriais com fundo transparente e sem dependências de fontes externas. A identidade visual utiliza azul #2563EB e azul-escuro #0F172A; o site também inclui uma versão com letras claras para a navegação em fundo escuro.