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 成长!