轻量级身份认证和授权管理插件 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提供了美观且功能齐全的后台管理界面，让您可以轻松管理用户、角色和权限。

• 登录界面

• Endpoints 管理

• User 管理

• Roles 管理

⚡ 快速入门

安装

从 NuGet 安装包：

dotnetaddpackage MiniAuth

基础配置

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

varbuilder=WebApplication.CreateBuilder(args);builder.Services.AddMiniAuth();// 添加这一行varapp=builder.Build();awaitapp.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=newSymmetricSecurityKey(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提供多种语言文档：

• English
• 简体中文
• 繁體中文
• 日本語
• 한국어
• Español

📊 社区和支持

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

加入我们的社区：

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

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