第16章 使用ASP.NET Core Identity - Identity Server 4 中文文档(v1.0.0)

注意

对于任何先决条件（例如模板），首先要查看概述。

IdentityServer旨在提供灵活性，其中一部分允许您为用户及其数据（包括账户密码）使用所需的任何数据库。如果您从新的用户数据库开始，那么ASP.NET Identity是您可以选择的一个选项。本快速入门显示了如何在IdentityServer中使用ASP.NET Identity。

本快速入门使用ASP.NET Identity的方法是为IdentityServer Host创建一个新项目。这个新项目将取代我们在之前的快速入门中构建的先前IdentityServer项目。这个新项目的原因是由于使用ASP.NET身份时UI资产的差异（主要是登录和注销的差异）。此解决方案中的所有其他项目（针对客户端和API）将保持不变。

注意

本快速入门假设您熟悉ASP.NET Identity的工作原理。如果不是，建议您先了解它。

16.1 ASP.NET身份的新项目

第一步是为您的解决方案添加ASP.NET Identity的新项目。我们提供了一个模板，其中包含ASP.NET Identity与IdentityServer所需的最小UI资产。您最终将删除IdentityServer的旧项目，但是您需要迁移一些项目。

首先创建一个将使用ASP.NET Identity的新IdentityServer项目：

cd quickstart/src
dotnet new is4aspid -n IdentityServerAspNetIdentity

当提示“seed”用户数据库时，选择“Y”表示“是”。这将使用我们的“alice”和“bob”用户填充用户数据库。他们的密码是“Pass123$”。

注意

该模板使用Sqlite作为用户的数据库，并在模板中预先创建EF迁移。如果您希望使用其他数据库提供程序，则需要更改代码中使用的提供程序并重新创建EF迁移。

16.2 检查新项目

在您选择的编辑器中打开新项目，并检查生成的代码。一定要看看：

16.2.1 IdentityServerAspNetIdentity.csproj

请注意对IdentityServer4.AspNetIdentity的引用。此NuGet包中包含IdentityServer的ASP.NET Identity集成组件。

16.2.2 Startup.cs

在ConfigureServices中，注意必要的AddDbContext<ApplicationDbContext>和调用以配置ASP.NET Identity。AddIdentity<ApplicationUser, IdentityRole>

另请注意，您在之前的快速入门中完成的大部分相同IdentityServer配置已经完成。模板使用内存中的样式用于客户端和资源，这些样式来自Config.cs。

最后，注意添加新的AddAspNetIdentity<ApplicationUser>。 AddAspNetIdentity添加集成层以允许IdentityServer访问ASP.NET Identity用户数据库的用户数据。当IdentityServer必须将用户的声明添加到令牌时，这是必需的。

16.2.3 Config.cs

Config.cs包含硬编码的内存客户端和资源定义。为了使相同的客户端和API与之前的快速入门保持一致，我们需要将旧IdentityServer项目中的配置数据复制到此项目中。现在就这样做，然后Config.cs看起来像这样：

public static class Config
{
    public static IEnumerable<IdentityResource> GetIdentityResources()
    {
        return new List<IdentityResource>
        {
            new IdentityResources.OpenId(),
            new IdentityResources.Profile(),
        };
    }

    public static IEnumerable<ApiResource> GetApis()
    {
        return new List<ApiResource>
        {
            new ApiResource("api1", "My API")
        };
    }

    public static IEnumerable<Client> GetClients()
    {
        return new List<Client>
        {
            new Client
            {
                ClientId = "client",

                // no interactive user, use the clientid/secret for authentication
                AllowedGrantTypes = GrantTypes.ClientCredentials,

                // secret for authentication
                ClientSecrets =
                {
                    new Secret("secret".Sha256())
                },

                // scopes that client has access to
                AllowedScopes = { "api1" }
            },
            // resource owner password grant client
            new Client
            {
                ClientId = "ro.client",
                AllowedGrantTypes = GrantTypes.ResourceOwnerPassword,

                ClientSecrets =
                {
                    new Secret("secret".Sha256())
                },
                AllowedScopes = { "api1" }
            },
            // OpenID Connect hybrid flow client (MVC)
            new Client
            {
                ClientId = "mvc",
                ClientName = "MVC Client",
                AllowedGrantTypes = GrantTypes.Hybrid,

                ClientSecrets =
                {
                    new Secret("secret".Sha256())
                },

                RedirectUris           = { "http://localhost:5002/signin-oidc" },
                PostLogoutRedirectUris = { "http://localhost:5002/signout-callback-oidc" },

                AllowedScopes =
                {
                    IdentityServerConstants.StandardScopes.OpenId,
                    IdentityServerConstants.StandardScopes.Profile,
                    "api1"
                },

                AllowOfflineAccess = true
            },
            // JavaScript Client
            new Client
            {
                ClientId = "js",
                ClientName = "JavaScript Client",
                AllowedGrantTypes = GrantTypes.Code,
                RequirePkce = true,
                RequireClientSecret = false,

                RedirectUris =           { "http://localhost:5003/callback.html" },
                PostLogoutRedirectUris = { "http://localhost:5003/index.html" },
                AllowedCorsOrigins =     { "http://localhost:5003" },

                AllowedScopes =
                {
                    IdentityServerConstants.StandardScopes.OpenId,
                    IdentityServerConstants.StandardScopes.Profile,
                    "api1"
                }
            }
        };
    }
}

此时，您不再需要旧的IdentityServer项目。

16.2.4 Program.cs文件和SeedData.cs

Program.cs中的Main比大多数ASP.NET Core项目略有不同。请注意这是如何查找名为/ seed的命令行参数，该参数用作为ASP.NET Identity数据库中的用户设定种子的标志。

查看SeedData类的代码，了解如何创建数据库以及创建第一个用户。

16.2.5 AccountController

要在此模板中检查的最后一个代码是AccountController。这包含与之前的快速入门和模板略有不同的登录和注销代码。请注意使用ASP.NET Identity SignInManager<ApplicationUser>和UserManager<ApplicationUser>来自ASP.NET Identity来验证凭据和管理身份验证会话。

其余大部分代码与之前的快速入门和模板相同。

16.3 使用MVC客户端登录

此时，您应该运行所有现有客户端和模板。一个例外是ResourceOwnerClient -密码将需要更新，更新password为Pass123$。

启动MVC客户端应用程序，您应该能够单击“安全”链接以登录。

您应该被重定向到ASP.NET Identity登录页面。使用新创建的用户登录：

登录后，您会看到正常的同意页面。获得同意后，您将被重定向回MVC客户端应用程序，其中应列出您的用户声明。

您还应该能够单击“使用应用程序标识调用API”来代表用户调用API：

现在，您正在使用IdentityServer中的ASP.NET身份用户。

16.4 少了什么东西？

此模板中的大部分代码与我们提供的其他快速入门和模板类似。您将注意到此模板中缺少的一件事是用户注册，密码重置以及您可能期望从Visual Studio ASP.NET Identity模板中获得的其他内容的UI代码。

鉴于需求的多样性和使用ASP.NET Identity的不同方法，我们的模板明确地不提供这些功能。您应该知道ASP.NET Identity如何充分地将这些功能添加到项目中。或者，您可以基于Visual Studio ASP.NET Identity模板创建新项目，并将您在这些快速入门中了解到的IdentityServer功能添加到该项目中。

github地址