👁 Image
Identity.Base.Roles 0.8.10

Identity.Base.Roles

Full documentation lives at . This README highlights the basics for quick reference.

Role-based access control primitives for Identity Base. Includes:

• EF Core entities and configuration for roles, permissions, role-permission associations, user-role links, and audit entries.
• Configuration binding for role/permission definitions and default role assignments.
• Services for role assignment and permission resolution.
• ClaimsPrincipal helpers for parsing and checking identity.permissions claims.
• Optional DbContext (IdentityRolesDbContext) with convenience registration helpers.

Usage

// Register RBAC services and configure the provided DbContext
var rolesBuilder = services.AddIdentityRoles(
 configuration,
 configureDbContext: (sp, options) =>
 {
 var connectionString = sp.GetRequiredService<IConfiguration>().GetConnectionString("Primary")
 ?? throw new InvalidOperationException("ConnectionStrings:Primary must be set.");

 options.UseNpgsql(connectionString); // or UseSqlServer(connectionString)
 });

// Or map an existing DbContext that implements IRoleDbContext
rolesBuilder.UseDbContext<AppDbContext>();

// Map endpoints when building the app
app.MapIdentityRolesUserEndpoints();

// During startup
await app.Services.SeedIdentityRolesAsync(); // host-controlled migrations must run first

Consumers opt in explicitly; no additional tables are created unless the package is referenced and configured.