Pular para o conteúdo principal
Versão: 4.x (latest)

RBAC — escudo e cadeado

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​

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

createRBAC({ 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​

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.

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.