最新ITfoxtec Identity NuGet包文档位置及使用说明查询

算力阿峰

2026-9-27

ITfoxtec Identity NuGet包文档说明

最新版ITfoxtec Identity NuGet包有官方维护的精简实用文档，完全覆盖你要求的初始化操作流程、核心API说明，不需要仅通过示例项目反向提取用法。

文档核心覆盖范围

全场景初始化流程：覆盖SAML2、OIDC两类主流协议下，身份提供商(IdP)、服务提供商(SP)两类角色的从NuGet包安装到配置生效的全步骤指引，每一步配置项都标注了必填属性、可选属性的作用、取值规范。
完整核心API说明：梳理了请求构造、断言/令牌解析、会话管理、Claims映射转换、签名验签等核心模块的所有公开API，包含参数说明、返回值定义、适用场景、常见报错的触发原因与处理方案。

基础初始化参考示例

// 安装NuGet包后，在Program.cs中完成服务注册
builder.Services.AddITfoxtecIdentitySaml2(spConfig =>
{
    // 配置当前SP的实体ID
    spConfig.EntityId = "https://your-domain.com/Saml2";
    // 配置对接的IdP基础信息
    spConfig.IdentityProviderSettings.EntityId = "https://idp-provider.com/EntityId";
    spConfig.IdentityProviderSettings.SingleSignOnDestination = new Uri("https://idp-provider.com/login");
    spConfig.IdentityProviderSettings.SigningCertificate = IdpSigningCert;
    // 配置当前SP的签名证书
    spConfig.SigningCertificate = SpSigningCert;
});

// 中间件配置
app.UseHttpsRedirection();
app.UseRouting();
// 按顺序添加身份验证、授权中间件
app.UseAuthentication();
app.UseAuthorization();
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");