.Net Core 3.0 IdentityServer4 快速入门

时间 2019-11-18

标签 core 3.0 identityserver4 identityserver 快速入门繁體版

原文原文链接

.Net Core 3.0 IdentityServer4 快速入门

1、简介

　　IdentityServer4是用于ASP.NET Core的OpenID Connect和OAuth 2.0框架。html

　　将IdentityServer4部署到您的应用中具有以下特色：前端

　　1）、认证服务web

　　2）、单点登录json

　　3）、API访问控制后端

　　4）、联合网关api

　　5）、专一于定制浏览器

　　6）、成熟的开源系统安全

　　7）、免费和商业支持服务器

2、总体部署

　　目前大多数的应用程序或多或少看起来是上图所示这样的，最多见的交互场景有（浏览器与Web应用程序、Web应用程序与WebApi通信、本地应用程序狱WebApi通信、基于浏览器的应用程序与WebApi 通信、基本服务器的应用程序与WebApi通信、WebApi与WebApi通信）app

　　前端、中间层、后端各个层级为了保护资源常常要针对相同的用户仓储区实现身份认证和受权，可是若是咱们把这些基本的安全功能统一颁发给一个安全令牌服务，就能够没必要再让这些应用和端点之间重复实现这些基础安全功能，重组应用程序以支持安全令牌服务将会引导出如下体系结构和协议

　　这样的设计将会把安全问题分为两个部分：（身份验证和API访问）

3、IdentityServer4如何提供帮助

　　IdentityServer是将规范兼容的OpenID Connect和OAuth 2.0端点添加到任意ASP.NET Core应用程序的中间件。一般，您构建（或从新使用）包含登陆和注销页面的应用程序，IdentityServer中间件会向其添加必要的协议头，以便客户端应用程序能够与其对话使用这些标准协议。

4、术语

　 1）、Users（用户）：用户是使用已注册的客户端访问资源的人

　 2）、Clients（客户端）：客户端就是从identityserver请求令牌的软件（你能够理解为一个app便可），既能够经过身份认证令牌来验证识别用户身份，又能够经过受权令牌来访问服务端的资源。可是客户端首先必须在申请令牌前已经在identityserver服务中注册过。实际客户端不只能够是Web应用程序，app或桌面应用程序（你就理解为pc端的软件便可），SPA，服务器进程等

　　3)、Resources（资源）：

　　资源就是你想用identityserver保护的东东，能够是用户的身份数据或者api资源。
　　每个资源都有一个惟一的名称，客户端使用这个惟一的名称来肯定想访问哪个资源（在访问以前，实际identityserver服务端已经配置好了哪一个客户端能够访问哪一个资源，因此你没必要理解为客户端只要指定名称他们就能够随便访问任何一个资源）。

　　用户的身份信息实际由一组claim组成，例如姓名或者邮件都会包含在身份信息中（未来经过identityserver校验后都会返回给被调用的客户端）。

　　API资源就是客户端想要调用的功能（一般以json或xml的格式返回给客户端，例如webapi，wcf,webservice），一般经过webapi来创建模型，可是不必定是webapi，我刚才已经强调可使其余类型的格式，这个要看具体的使用场景了。

　　4）、Identity Token（身份令牌）：

　　一个身份令牌指的就是对认证过程的描述。它至少要标识某个用户（Called the sub aka subject claim）的主身份信息，和该用户的认证时间和认证方式。可是身份令牌能够包含额外的身份数据，具体开发者能够自行设定，可是通常状况为了确保数据传输的效率，开发者通常不作过多额外的设置，你们也能够根据使用场景自行决定。

　　5）、Access Token（访问令牌）：

　　访问令牌容许客户端访问某个 API 资源。客户端请求到访问令牌，而后使用这个令牌来访问 API资源。访问令牌包含了客户端和用户（若是有的话，这取决于业务是否须要，但一般没必要要）的相关信息，API经过这些令牌信息来授予客户端的数据访问权限。

5、代码快速入门 (使用客户端凭据保护)

　　1）、IdentityServer

　　　　a)、定义Api资源和客户端

　　　　　　Api 是您系统中要保护的资源，资源的定义能够经过多种方式

　　　　　　客户端代码中的ClientId和ClientSecret你能够视为应用程序自己的登陆名和密码，它将您的应用程序标识到IdentityServer 服务器，以便它知道哪一个应用程序正在尝试与其链接

using IdentityServer4.Models;
using System.Collections.Generic;

namespace IdentityServer
{
    public static class Config
    {
        public static IEnumerable<ApiResource> Apis
            => new List<ApiResource>
        {
            new ApiResource("api1","My API")
        };

        public static IEnumerable<Client> Clients =>
            new List<Client>
            {
                new Client
                {
                    ClientId="client",
                    AllowedGrantTypes =GrantTypes.ClientCredentials,
                    ClientSecrets={
                    new Secret("aju".Sha256())
                    },
                    AllowedScopes={ "api1"}
                }
            };
    }
}

View Code

　　　　b)、配置IdentityServer

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace IdentityServer
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
            var builder = services.AddIdentityServer()
                .AddInMemoryApiResources(Config.Apis)
                .AddInMemoryClients(Config.Clients);
            builder.AddDeveloperSigningCredential();
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseIdentityServer();

            //app.UseRouting();

            //app.UseEndpoints(endpoints =>
            //{
            //    endpoints.MapGet("/", async context =>
            //    {
            //        await context.Response.WriteAsync("Hello World!");
            //    });
            //});
        }
    }
}

View Code

　　　　c)、测试（若是配置合适，在浏览器访问 http://localhost:5000/.well-known/openid-configuration 出现以下表示配置OK）

　　首次启动时，IdentityServer将为您建立一个开发人员签名密钥，该文件名为tempkey.rsa。您无需将该文件签入源代码管理中，若是不存在该文件将被从新建立。

　　　　d)、所需的包

　　2）、添加Api资源

　　a)、添加一个名为IdentityController的控制器

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using System.Linq;

namespace Api.Controllers
{
    [Route("identity")]
    [Authorize]
    public class IdentityController : ControllerBase
    {
        public IActionResult Get()
        {
            return new JsonResult(from c in User.Claims select new { c.Type, c.Value });
        }
    }
}

View Code

　　b)、配置（将身份认证服务添加到DI，并将身份验证中间件添加到管道）　　　　

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace Api
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddAuthentication("Bearer").AddJwtBearer("Bearer", options =>
            {
                options.Authority = "http://localhost:5000";
                options.RequireHttpsMetadata = false;
                options.Audience = "api1";
            });
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            app.UseAuthentication();//认证
            app.UseAuthorization();//受权


            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }
    }
}

View Code

　　　AddAuthentication：将身份认证服务添加到DI比配置Bearer为默认

　　　AddAuthentication：将身份认证服务添加到管道中，以便对主机的每次调用都将自动执行身份验证

　　　AddAuthentication：添加受权中间件，以确保匿名客户端没法访问咱们的API资源

　　　http://localhost:5001/identity 在浏览器上访问应返回401状态代码。这意味着您的API须要凭据，而且如今受IdentityServer保护。

　　c)、所需的包

　3）、建立客户端（已控制台的形式）

using IdentityModel.Client;
using Newtonsoft.Json.Linq;
using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace Client
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // Console.WriteLine("Hello World!");
            var client = new HttpClient();
            var disco = await client.GetDiscoveryDocumentAsync("http://localhost:5000");
            if (disco.IsError)
            {
                Console.WriteLine(disco.Error);
                return;
            }
            var tokenResponse = await client.RequestClientCredentialsTokenAsync(new ClientCredentialsTokenRequest
            {
                Address = disco.TokenEndpoint,
                ClientId = "client",
                ClientSecret = "aju",
                Scope = "api1"
            });
            if (tokenResponse.IsError)
            {
                Console.WriteLine(tokenResponse.Error);
                return;
            }
            Console.WriteLine(tokenResponse.Json);
            Console.WriteLine("\n\n");
            //call api

            var apiClient = new HttpClient();
            apiClient.SetBearerToken(tokenResponse.AccessToken);
            var response = await apiClient.GetAsync("http://localhost:5001/identity");
            if (!response.IsSuccessStatusCode)
            {
                Console.WriteLine(response.StatusCode);
            }
            else
            {
                var content = await response.Content.ReadAsStringAsync();
                Console.WriteLine(JArray.Parse(content));
            }
            Console.ReadLine();
        }
    }
}

View Code

　 a)、所需的包

　4）、使用客户端访问Api资源

6、参考文献

　　http://docs.identityserver.io/en/latest/index.html

　若是对您有帮助，请点个推荐（让更多须要的人看到哦）