Lumen.Authorization 3.0.1

dotnet add package Lumen.Authorization --version 3.0.1
                    
NuGet\Install-Package Lumen.Authorization -Version 3.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Lumen.Authorization" Version="3.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Lumen.Authorization" Version="3.0.1" />
                    
Directory.Packages.props
<PackageReference Include="Lumen.Authorization" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Lumen.Authorization --version 3.0.1
                    
#r "nuget: Lumen.Authorization, 3.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Lumen.Authorization@3.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Lumen.Authorization&version=3.0.1
                    
Install as a Cake Addin
#tool nuget:?package=Lumen.Authorization&version=3.0.1
                    
Install as a Cake Tool

Lumen.Authorization

Pluggable role-based authorization library for ASP.NET Core (.NET 8). Manages Permissions, Profiles (roles), and User↔Profile assignments, backed by SQL Server and exposed via a mountable Backoffice UI.

Packages

Package Purpose
Lumen.Authorization Core: domain, CQRS handlers, EF Core persistence, DI root
Lumen.Authorization.Contracts Public interfaces (IUserPermissionService, IUserIdAccessor) and exported events
Lumen.Authorization.Migrations EF Core migrations for the Lumen schema; hosted service applies them on startup
Lumen.Authorization.AspNetCore ASP.NET Core glue: [RequirePermission], policy provider, discovery, enforcement
Lumen.Authorization.Backoffice Razor Class Library with Profiles & Permissions management UI

Minimum wiring in Program.cs

// Umbrella: registers core, migrations, enforcement, and discovery in one call
builder.Services.AddLumenAuthorization(builder.Configuration);

// Optional: mountable Backoffice UI
builder.Services.AddLumenBackoffice();

// ...

app.UseStaticFiles();      // serves _content/Lumen.Authorization.Backoffice/
app.UseAuthentication();
app.UseAuthorization();
app.MapLumenBackoffice("/lumen");

SQL Server is required. Provide the connection string via IConfiguration["ConnectionStrings:DefaultConnection"] or use the string overload: AddLumenAuthorization("Server=...;Database=...;").

Protecting an endpoint

// Convention: permission code = "Controller.Action"
[RequirePermission]
public IActionResult Index() { ... }

// Explicit code
[RequirePermission("Profiles.Delete")]
public IActionResult Delete(Guid id) { ... }

Repository & documentation

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Lumen.Authorization:

Package Downloads
Lumen.Authorization.Migrations

EF Core migrations for the Lumen authorization schema (SQL Server). Includes a hosted service that applies migrations automatically on startup. Add this package alongside Lumen.Authorization to enable schema management.

Lumen.Authorization.AspNetCore

ASP.NET Core integration for Lumen.Authorization: [RequirePermission] attribute, IAuthorizationRequirementData-based policy enforcement, dynamic PermissionPolicyProvider, PermissionAuthorizationHandler, IUserIdAccessor/ClaimsUserIdAccessor, and the AddLumenAuthorization() umbrella that wires core, migrations, and enforcement in one call.

Lumen.Authorization.Migrations.PostgreSQL

EF Core migrations for the Lumen authorization schema (PostgreSQL). Includes a hosted service that applies migrations automatically on startup. Add this package alongside Lumen.Authorization when targeting PostgreSQL.

Lumen.Authorization.Backoffice

Razor Class Library providing a mountable Backoffice UI for Lumen.Authorization. Includes controllers, ViewComponents, and CSS for managing Permissions, Profiles, and User↔Profile assignments. Mount via AddLumenBackoffice() + MapLumenBackoffice("/lumen").

Lumen.Identity

Core of Lumen.Identity: user domain (User, tokens, lockout), JWT/HS256 with refresh-token rotation, BCrypt, email confirmation, password reset, and integration bridges (IAuthorizationUserSource, IUserDirectory) for Lumen.Authorization. DI entry-point: AddLumenIdentity().

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.1 194 7/15/2026
3.0.0 250 7/14/2026
2.0.0 167 7/14/2026
1.1.0 306 7/6/2026
1.0.0 179 7/5/2026