轻量级身份认证和授权管理插件 MiniAuth-优快云博客

MiniAuth - 轻量级 ASP.NET Core Identity 管理插件

MiniAuth 是一款专为 ASP.NET Core 开发者设计的轻量级身份认证和授权管理插件。它可以帮助您快速为新项目或现有项目添加完整的用户管理系统，包括用户认证、角色管理和权限控制等功能。

🌟 核心优势

🔧 一行代码集成

只需在您的项目中添加一行代码，即可获得完整的 Identity 系统：

builder.Services.AddMiniAuth();

📦 开箱即用

兼容性强：支持基于 JWT、Cookie、Session 的 .NET Identity
部署灵活：适用于 API、SPA、MVC、Razor Page 等多种应用类型
多数据库支持：Oracle、SQL Server、MySQL 等 EF Core 数据库
非侵入式设计：不影响现有数据库结构和项目架构
跨平台：支持 Linux、macOS 环境部署

🖥️ 直观的管理界面

MiniAuth 提供了美观且功能齐全的后台管理界面，让您可以轻松管理用户、角色和权限。

登录界面

MiniAuth 界面展示

Endpoints 管理

User 管理

Roles 管理

⚡ 快速入门

安装

从 NuGet 安装包：

dotnet add package MiniAuth

基础配置

在 [Program.cs](file://c:\Users\Jeffrey\Downloads\API-CS\API_C#\sdk\feieyun-dotnet-sdk\samples\Console.Sample\Program.cs) 中添加服务：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMiniAuth(); // 添加这一行

var app = builder.Build();
await app.RunAsync();

访问管理界面：http(s)://yourhost/miniauth/index.html

默认管理员账户：

用户名：admin@mini-software.github.io
密码：E7c4f679-f379-42bf-b547-684d456bc37f

JWT 认证配置

对于前后端分离项目，可以轻松切换到 JWT 认证：

builder.Services.AddMiniAuth(options =>
{
    options.AuthenticationType = MiniAuthOptions.AuthType.BearerJwt;
    options.JWTKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your-secret-key"));
});

🔐 灵活的身份验证

Cookie 认证（默认）

适合传统的 Web 应用程序，提供无缝的用户体验。

`JWT` 认证

适用于现代 SPA 和移动应用程序，支持 Token 刷新机制。

登录示例

fetch('/miniauth/login', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        username: 'admin@mini-software.github.io',
        password: 'E7c4f679-f379-42bf-b547-684d456bc37f',
        remember: false
    })
})

🛠️ 高度可定制

自定义数据库

支持使用自定义的 DbContext、用户和角色类：

app.UseMiniAuth<YourDbContext, YourIdentityUser, YourIdentityRole>();

自定义路由前缀

builder.Services.AddMiniAuth(options =>
{
    options.RoutePrefix = "YourCustomPrefix";
});

禁用内置登录

如果您希望使用自己的登录逻辑：

builder.Services.AddMiniAuth(options =>
{
    options.LoginPath = "/Identity/Account/Login";
    options.DisableMiniAuthLogin = true;
});

🌍 国际化支持

MiniAuth 提供多种语言文档：

📊 社区和支持

GitHub Stars:
NuGet 下载量:
.NET 版本要求: >= 6.0
github 项目地址：https://github.com/mini-software/MiniAuth

加入我们的社区：

QQ群(1群): 813100564
QQ群(2群): 579033769
QQ群(3群): 625362917

您的 Star、赞助、推荐能帮助 MiniAuth 成长！