Shipeng.Authentication.JwtBearer
4.1.1
dotnet add package Shipeng.Authentication.JwtBearer --version 4.1.1
NuGet\Install-Package Shipeng.Authentication.JwtBearer -Version 4.1.1
<PackageReference Include="Shipeng.Authentication.JwtBearer" Version="4.1.1" />
<PackageVersion Include="Shipeng.Authentication.JwtBearer" Version="4.1.1" />
<PackageReference Include="Shipeng.Authentication.JwtBearer" />
paket add Shipeng.Authentication.JwtBearer --version 4.1.1
#r "nuget: Shipeng.Authentication.JwtBearer, 4.1.1"
#:package Shipeng.Authentication.JwtBearer@4.1.1
#addin nuget:?package=Shipeng.Authentication.JwtBearer&version=4.1.1
#tool nuget:?package=Shipeng.Authentication.JwtBearer&version=4.1.1
Shipeng.Authentication.JwtBearer
Shipeng.Authentication.JwtBearer 是 Shipeng 系列中专门面向 ASP.NET Core JWT Bearer 认证的 NuGet 包。它把 JWT 密钥配置、令牌生成、Bearer 认证注册和常见 Claim 处理从基础包中拆出来，适合只需要认证能力的 Web API、后台管理系统、微服务网关和业务服务引用。
安装
dotnet add package Shipeng.Authentication.JwtBearer
适用场景
- ASP.NET Core Web API 需要签发和校验 JWT。
- 后台管理系统、SaaS 服务、开放平台接口需要 Bearer Token 认证。
- 多个服务需要复用同一套 JWT 加密、过期时间、Issuer、Audience 配置。
- 项目只需要认证能力，不希望把 MongoDB、SqlSugar、支付、第三方平台等能力一起引用进来。
主要类型
JWTAuthorizationServiceCollectionExtensions：面向IServiceCollection的认证注册扩展入口，用于把 JWT Bearer 认证接入 ASP.NET Core DI 和认证管道。JWTEncryption：JWT 令牌创建与解析工具，负责根据配置生成 token、读取声明、处理过期时间和签名密钥。
基本用法
using Shipeng.Foundation.Authorization;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthorization();
// 按项目中的扩展方法接入 JWT Bearer，配置项来自 appsettings.json 或 IConfiguration。
// builder.Services.AddJWTBearer(builder.Configuration);
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();
app.Run();
配置建议
- 密钥必须使用生产环境独立密钥，不要把开发密钥提交到仓库。
- 过期时间按业务风险设置：后台管理系统通常较短，内部服务通信可以结合刷新机制。
- Issuer 和 Audience 建议明确配置，避免多个系统之间 token 被误用。
- HTTPS 是必需前提，JWT 只负责签名和声明，不负责传输加密。
引用关系
本包引用 Shipeng.Foundation，并只额外引入 JWT/认证相关依赖。需要数据库、支付、日志、对象映射能力时，请按需引用对应的 Shipeng.* 包。
API Reference / API 索引
nuget.org 当前只会直接渲染包的 README 和 Release Notes，不会把包内 docs/API_REFERENCE.md 自动显示成一个独立页面标签。完整公开 API 索引已经随 NuGet 包打入 docs/API_REFERENCE.md，也可以在源码仓库中查看。
如果你正在 NuGet 页面阅读本文，请优先看本 README 的“主要类型”和示例；下载包后可在包内容中打开 docs/API_REFERENCE.md 查看完整公开类型、方法、属性和构造函数签名。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. |
-
net10.0
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 10.0.9)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.19.1)
- Shipeng.Foundation (>= 4.1.1)
- System.IdentityModel.Tokens.Jwt (>= 8.19.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
4.1.1 / 2026-06-30
English:
- Split the original monolithic foundation library into focused Shipeng.* NuGet packages so applications can reference only the capabilities they actually need.
- Added Shipeng.DatabaseMaintenance for SQL Server and MongoDB database maintenance. It supports non-destructive cleanup preview, SqlSugar entity scanning, MongoDB collection scanning from configuration or source declarations, keep lists, ignored prefixes, empty-scan protection, missing table preview, controlled SqlSugar CodeFirst table creation, SQL Server schema difference preview, safe missing-column creation, safe changed-column synchronization, explicit execution switches, and confirmation-code protected destructive/schema-changing execution.
- Improved Shipeng.Payment with a unified payment abstraction for WeChat, Alipay, UnionPay, Cloud QuickPass, bank gateways, and profit-sharing scenarios. WeChat Pay V3 remains the concrete built-in implementation; other channels expose stable provider contracts and explicit placeholders so applications can add real vendor SDK implementations without changing business code.
- Centralized common NuGet metadata in Directory.Build.props: target framework, version, authors, repository, license, README, XML documentation, warning policy, and release notes.
- Every package includes README.md, XML IntelliSense documentation, and docs/API_REFERENCE.md inside the generated nupkg.
- Updated README files to explain that nuget.org renders README and Release Notes directly but does not expose packaged docs/API_REFERENCE.md as a separate page tab.
- Release build validation: all projects build and pack successfully for net10.0 with 0 warnings and 0 errors.
中文：
- 将早期单体基础库拆分为职责更清晰的 Shipeng.* NuGet 包，业务项目可以按需引用认证、MongoDB、SqlSugar、EF Core、数据库索引、数据库维护、第三方集成、日志、映射、支付和混合分页能力。
- 新增 Shipeng.DatabaseMaintenance，用于 SQL Server 和 MongoDB 数据库维护。支持冗余表/集合预览清理、SqlSugar 实体扫描、MongoDB 配置集合扫描、源码集合声明扫描、保留名单、忽略前缀、空扫描保护、缺失表预览、受控 CodeFirst 自动建表、SQL Server 结构差异预览、缺失字段补齐、安全字段同步、显式执行开关和确认码保护。
- 增强 Shipeng.Payment，新增统一支付抽象，覆盖微信、支付宝、银联、云闪付、银行网关和分账场景。微信支付 V3 是当前内置可用实现；其他通道提供稳定 Provider 契约和明确占位实现，方便业务项目接入真实厂商 SDK。
- 将公共 NuGet 元数据统一集中到 Directory.Build.props，避免各项目 PropertyGroup 重复和不一致。
- 每个包都打入 README.md、XML IntelliSense 文档和 docs/API_REFERENCE.md。
- 所有 README 都补充说明：nuget.org 会直接显示 README 和 Release Notes，但不会把包内 docs/API_REFERENCE.md 自动显示为独立标签页。
- 已验证 Release 构建和打包，目标框架 net10.0，0 警告，0 错误。