ASP.NET Core IdentityServer4 介绍和实际应用

最新推荐文章于 2026-04-15 11:19:29 发布

原创最新推荐文章于 2026-04-15 11:19:29 发布 · 1.5k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#asp.net #后端

一、ASP.NET Core IdentityServer4 介绍

二、ASP.NET Core IdentityServer4 的实际应用

三、ASP.NET Core IdentityServer4 的配置和启动示例

一、ASP.NET Core IdentityServer4 介绍

ASP.NET Core IdentityServer4 是一个开源的身份验证和授权框架，它基于ASP.NET Core构建，并且集成了OpenID Connect和OAuth 2.0标准。IdentityServer4 允许你为你的应用程序提供以下功能：

认证即服务：IdentityServer4 提供了一个集中的登录逻辑和工作流程，适用于所有类型的应用程序，包括Web应用、原生应用、移动应用和服务。
单点登录/注销：多个类型的应用程序可以在一个点进行登录和注销操作，提高了用户体验和安全性。
API 访问控制：IdentityServer4 可以为各种类型的客户端颁发API的访问令牌，如服务器到服务器、Web应用程序、SPA、本地应用和移动应用程序。
联合网关：它支持Azure Active Directory、Google、Facebook等外部身份提供商，这可以保护你的应用程序免受如何连接到这些外部提供商的详细信息的影响。
高度可定制：由于IdentityServer4是一个框架而不是现成的产品或SaaS，因此你可以编写代码以使系统适应你的具体需求。
成熟的开源项目：IdentityServer4使用Apache 2开源协议，允许在其上构建商业产品。它也是.NET Foundation的一部分，它提供治理和法律支持。

二、ASP.NET Core IdentityServer4 的实际应用

在实际应用中，IdentityServer4 通常被用作身份和访问管理的中心组件，尤其是在多客户端或多服务的系统中。以下是一些实际应用的例子：

电商系统：在一个电商系统中，IdentityServer4 可以用于管理用户的登录、订单信息的访问控制，以及API的访问权限。例如，一个电商应用可能需要与多个后端服务（如库存管理、支付处理、物流跟踪等）进行交互，IdentityServer4 可以确保只有经过身份验证和授权的客户端才能访问这些服务。
企业级应用：在企业环境中，IdentityServer4 可以用于实现单点登录（SSO），使员工能够使用相同的凭据登录到多个企业应用。此外，它还可以用于管理API的访问权限，确保敏感数据的安全。
第三方应用集成：如果你的应用需要与外部服务（如社交媒体平台、支付网关等）进行集成，IdentityServer4 可以作为你的应用的身份验证和授权层，确保与外部服务的交互符合OAuth 2.0和OpenID Connect标准。

总的来说，ASP.NET Core IdentityServer4 提供了一个强大且灵活的框架，用于在ASP.NET Core应用程序中实现身份验证和授权。通过合理地配置和使用IdentityServer4，你可以确保你的应用程序的安全性、可维护性和可扩展性。

三、ASP.NET Core IdentityServer4 的配置和启动示例

首先，你需要在你的 ASP.NET Core 项目中安装 IdentityServer4 相关的 NuGet 包。你可以通过 NuGet 包管理器或者 .csproj 文件来安装。

Install-Package IdentityServer4
Install-Package IdentityServer4.EntityFramework
Install-Package IdentityServer4.AspNetIdentity
// 如果使用 Entity Framework 作为存储
Install-Package Microsoft.EntityFrameworkCore.SqlServer
// 如果需要其他的依赖，如测试库等

然后，你可以配置你的 Startup.cs 文件来添加 IdentityServer4 的中间件。

using IdentityServer4.Services;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
// 添加其他必要的命名空间

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 添加数据库上下文（如果你使用 Entity Framework）
        // services.AddDbContext<ApplicationDbContext>(options =>
        //     options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

        // 添加IdentityServer
        var builder = services.AddIdentityServer(options =>
        {
            options.Events.RaiseErrorEvents = true;
            options.Events.RaiseInformationEvents = true;
            options.Events.RaiseFailureEvents = true;
            options.Events.RaiseSuccessEvents = true;

            // 设置签发令牌时使用的密钥
            // 这只是一个示例，通常你会使用更安全的密钥存储方式
            options.KeyManagement.AddDeveloperSigningCredential();
        })
        .AddInMemoryIdentityResources(Config.IdentityResources) // 内存中存储身份资源
        .AddInMemoryApiScopes(Config.ApiScopes) // 内存中存储 API 范围
        .AddInMemoryClients(Config.Clients) // 内存中存储客户端
        // .AddAspNetIdentity<ApplicationUser>() // 如果使用 ASP.NET Core Identity
        // .AddProfileService<ProfileService>() // 如果你需要自定义用户信息
        // .AddTestUsers(TestUsers.Users); // 用于测试的用户（开发时）

        // 其他服务配置...
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        // 添加IdentityServer中间件
        app.UseIdentityServer();

        // 其他中间件配置...

        app.UseRouting();

        // 终结点路由
        app.UseEndpoints(endpoints =>
        {
            // 配置IdentityServer的默认路由
            endpoints.MapDefaultControllerRoute();
            // 其他路由配置...
        });
    }
}

在这个示例中，Config 类应该包含你的身份资源、API 范围和客户端的配置。这是一个简化的示例，通常你会从数据库或其他持久化存储中加载这些配置。

你还需要确保你的项目包含 Config.cs 文件（或类似的文件），其中包含 IdentityServer 所需的配置数据。

// Config.cs 示例
public static class Config
{
    public static IEnumerable<IdentityResource> IdentityResources =>
        new IdentityResource[]
        {
            new IdentityResources.OpenId(),
            new IdentityResources.Profile(),
            // 其他身份资源...
        };

    public static IEnumerable<ApiScope> ApiScopes =>
        new ApiScope[]
        {
            new ApiScope("api1", "My API")
            // 其他 API 范围...
        };

    public static IEnumerable<Client> Clients =>
        new Client[]
        {
            // 这里配置客户端，例如：MVC 客户端、SPA 客户端、机器到机器客户端等
            new Client
            {
                // ... 客户端配置 ...
            }
            // 其他客户端...
        };
}

这只是一个非常基本的示例，用于展示如何开始配置和启动 IdentityServer4。根据你的具体需求，你可能需要添加更多的配置和服务。