带有.NET Core App的Identity Server 4

dotnet new web

或者，您可以通过使用空模板选择ASP.NET Core Web应用程序项目，从Visual Studio中实现相同目的。

dotnet add package IdentityServer4

您已经成功安装了IdS4软件包，现在打开项目的Startup.cs文件并在ConfigureServices()函数中添加以下代码。请记住，以下示例代码仅是一个空列表，因此您需要确保您的应用中具有有效的内存资源和客户端列表。

services.AddIdentityServer()
                .AddInMemoryClients(new List())
                .AddInMemoryApiResources(new List())
                .AddInMemoryIdentityResources(new List())
                .AddInMemoryPersistedGrants()
                .AddTestUsers(new List())
                .AddDeveloperSigningCredential();

上面的代码将包括IdS4依赖关系，现在您需要使用下面的代码片段更新Configure方法。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {            
            app.UseHttpsRedirection();            
            app.UseIdentityServer();
        }

让我们了解配置，我们使用.AddDeveloperSigningCredential()扩展方法使用默认签名证书的.AddIdentityServer()添加了IdS4依赖关系。然后我们用.UseIdentityServer() 扩展方法更新了Configure()方法，这里我们实际上是启用OpenIdConnect端点。请在下面查看IdS4提供的端点列表：

using IdentityServer4.Hosting;

public class MyCustomEndpoint : IEndpointHandler
    {
       public async Task ProcessAsync(HttpContext 
                                                        context)
        {
         // ToDo: Here you can add your custom business-specific 
                  logic
        }
    }

POST /connect/token

Headers:
Content-Type: application/x-www-form-urlencoded

Body:
grant_type=password&scope=api1&client_id=testClient&client_secret=testSecret&
username=test.user&password=testPassword

上面的请求将为您提供accessToken，因此现在您可以使用此访问令牌与REST API请求一起传递。

dotnet add package IdentityServer4.AccessTokenValidation

此NuGet提供JWT和参考(Reference)令牌验证中间件，对于参考(Reference)令牌验证，它也提供缓存。要验证您的访问令牌，您需要在ConfigureService方法中添加以下代码：

services.AddAuthentication("Bearer")
    .AddIdentityServerAuthentication("Bearer", options =>
    {
        options.ApiName = "api1";
        options.Authority = "https://localhost:44385";
    });

这里Authority是IdentityServer4的URL，ApiName是来自IdS4配置的访问令牌Audience和API资源名称。

public void Configure(IApplicationBuilder app)
{
    app.UseAuthentication();
    app.UseAuthorization();
}

如果您查看业务需求，经过身份验证的用户并不总是被授权访问所有资源。因此，要允许访问授权用户，您可以实现基于策略的授权。例如，如果您决定授权用户（如果该用户的accessToken包含特定范围），则可以使用.AddPolicy()方法创建简单的策略。您需要使用以下示例代码更新ConfigureServices方法。

services.AddAuthorization(option =>
            {
                option.AddPolicy("MyPolicy", p =>
               {
                   p.RequireAuthenticatedUser();
                   p.RequireClaim(JwtClaimTypes.Scope, 
                      new List
                        {
                         "api1.read",
                         "api1.write:
                        }
                      );
               });
            });

现在，您的API受IdS4身份验证提供程序的保护，因此，使用[Authorize]属性修饰的所有端点都将受到保护。要调用这些REST端点，您需要使用Authorization头传递一个accessToken。

GET /api/v1.0/getuser

Headers:
Authorization: Bearer 

注意：我们已经在.NET项目中实现/集成了IdS4，但尚未引入用户界面，因此，要为IdS4项目添加UI，可以从QuickStart文件夹中复制粘贴代码。