晋级历程请看,不再对IdentityServer4做相关介绍

在微软Tech Summit 20一7 大会上和豪门大饱眼福了壹门学科《.NET Core
在腾讯财付通的市四级应用开拓实践》,个中入眼是基于ASP.NET
Core营造可扩充的高品质公司级API网关,以开源的API网关Ocelot为根基结合自个儿的作业特色,当天课程唯有四十分钟,有繁多内容都尚未进行,接下去就用一篇小小说来聊下Ocelot
的贯彻原理,大家在利用的进程中也能够1并来孝敬。 总体来说那是二个ASP.NET
Core
高等编制程序的始末,从前在民众号里已经发过不少各位朋友写的小说,前天都会在那篇文章中援引,让您更深刻学习。

连带知识点

不再对IdentityServer四做连锁介绍,今日头条上曾经有人出了相关的泛滥成灾小说,不了然的可以看一下:

蟋蟀大神的:菜肴学习编制程序-IdentityServer4

晓晨Master:IdentityServer4

以及Identity,Claim等连锁知识:

Savorboard:ASP.NET Core 之 Identity
入门(一)
ASP.NET
Core 之 Identity
入门(二)

图片 1

创建IndentityServer4 服务

创建2个名称为QuickstartIdentityServer的ASP.NET Core Web 空项目(asp.net
core ②.0),端口6000

图片 2

图片 3

NuGet包:

图片 4

修改Startup.cs 设置使用IdentityServer:

public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            // configure identity server with in-memory stores, keys, clients and scopes
            services.AddIdentityServer()
                .AddDeveloperSigningCredential()
                .AddInMemoryIdentityResources(Config.GetIdentityResourceResources())
                .AddInMemoryApiResources(Config.GetApiResources())
                .AddInMemoryClients(Config.GetClients())
                .AddResourceOwnerValidator<ResourceOwnerPasswordValidator>()
                .AddProfileService<ProfileService>();
        }

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

            app.UseIdentityServer();
        }
    }

添加Config.cs配置IdentityResource,ApiResource以及Client:

 public class Config
    {
        public static IEnumerable<IdentityResource> GetIdentityResourceResources()
        {
            return new List<IdentityResource>
            {
                new IdentityResources.OpenId(), //必须要添加,否则报无效的scope错误
                new IdentityResources.Profile()
            };
        }
        // scopes define the API resources in your system
        public static IEnumerable<ApiResource> GetApiResources()
        {
            return new List<ApiResource>
            {
                new ApiResource("api1", "My API")
            };
        }

        // clients want to access resources (aka scopes)
        public static IEnumerable<Client> GetClients()
        {
            // client credentials client
            return new List<Client>
            {
                new Client
                {
                    ClientId = "client1",
                    AllowedGrantTypes = GrantTypes.ClientCredentials,

                    ClientSecrets = 
                    {
                        new Secret("secret".Sha256())
                    },
                    AllowedScopes = { "api1",IdentityServerConstants.StandardScopes.OpenId, //必须要添加,否则报forbidden错误
                  IdentityServerConstants.StandardScopes.Profile},

                },

                // resource owner password grant client
                new Client
                {
                    ClientId = "client2",
                    AllowedGrantTypes = GrantTypes.ResourceOwnerPassword,

                    ClientSecrets = 
                    {
                        new Secret("secret".Sha256())
                    },
                    AllowedScopes = { "api1",IdentityServerConstants.StandardScopes.OpenId, //必须要添加,否则报forbidden错误
                  IdentityServerConstants.StandardScopes.Profile }
                }
            };
        }
    }

因为要动用登陆的时候要动用数据中保留的用户展开认证,要实IResourceOwnerPasswordValidator接口:

public class ResourceOwnerPasswordValidator : IResourceOwnerPasswordValidator
    {
        public ResourceOwnerPasswordValidator()
        {

        }

        public async Task ValidateAsync(ResourceOwnerPasswordValidationContext context)
        {
            //根据context.UserName和context.Password与数据库的数据做校验,判断是否合法
            if (context.UserName=="wjk"&&context.Password=="123")
            {
                context.Result = new GrantValidationResult(
                 subject: context.UserName,
                 authenticationMethod: "custom",
                 claims: GetUserClaims());
            }
            else
            {

                 //验证失败
                 context.Result = new GrantValidationResult(TokenRequestErrors.InvalidGrant, "invalid custom credential");
            }
        }
        //可以根据需要设置相应的Claim
        private Claim[] GetUserClaims()
        {
            return new Claim[]
            {
            new Claim("UserId", 1.ToString()),
            new Claim(JwtClaimTypes.Name,"wjk"),
            new Claim(JwtClaimTypes.GivenName, "jaycewu"),
            new Claim(JwtClaimTypes.FamilyName, "yyy"),
            new Claim(JwtClaimTypes.Email, "977865769@qq.com"),
            new Claim(JwtClaimTypes.Role,"admin")
            };
        }
    }

IdentityServer提供了接口访问用户音讯,然而默许再次来到的数据唯有sub,正是上边安装的subject:
context.UserName,要赶回越多的音信,必要贯彻IProfileService接口:

public class ProfileService : IProfileService
    {
        public async Task GetProfileDataAsync(ProfileDataRequestContext context)
        {
            try
            {
                //depending on the scope accessing the user data.
                var claims = context.Subject.Claims.ToList();

                //set issued claims to return
                context.IssuedClaims = claims.ToList();
            }
            catch (Exception ex)
            {
                //log your error
            }
        }

        public async Task IsActiveAsync(IsActiveContext context)
        {
            context.IsActive = true;
        }

context.Subject.Claims就是前面完结IResourceOwnerPasswordValidator接口时claims:
GetUserClaims()给到的数据。
其余,经过调节和测试发现,显示试行ResourceOwnerPasswordValidator
里的ValidateAsync,然后施行ProfileService里的IsActiveAsync,GetProfileDataAsync。

运维项目,使用postman进行呼吁就能够得到到token:

图片 5

再用token获取相应的用户消息:

图片 6

token认证服务一般是与web程序分其余,下边创造的QuickstartIdentityServer项目就一定于服务端,我们须要写作业逻辑的web程序就一定于客户端。当用户请求web程序的时候,web程序拿着用户已经报到获得的token去IdentityServer服务端校验。

 

创建web应用

成立一个名叫API的ASP.NET Core Web 空项目(asp.net core 二.0),端口500一。

NuGet包:

图片 7

修改Startup.cs 设置使用IdentityServer进行校验:

public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvcCore(option=>
            {
                option.Filters.Add(new TestAuthorizationFilter());
            }).AddAuthorization()
                .AddJsonFormatters();

            services.AddAuthentication("Bearer")
                .AddIdentityServerAuthentication(options =>
                {
                    options.Authority = "http://localhost:5000";
                    options.RequireHttpsMetadata = false;

                    options.ApiName = "api1";
                });
        }

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

            app.UseMvc();
        }
    }

创建IdentityController:

[Route("[controller]")]
    public class IdentityController : ControllerBase
    {
        [HttpGet]
        [Authorize]
        public IActionResult Get()
        {
            return new JsonResult("Hello Word");
        }

    }

独家运营QuickstartIdentityServer,API项目。用生成的token访问API:

图片 8

透过上述顺序,已经能够做三个光景端分离的报到成效。

其实,web应用程序中大家平时索要获得当前用户的连锁音信进行操作,比方记录用户的局部操作日志等。从前说过IdentityServer提供了接口/connect/userinfo来获取用户的相干音信。在此之前笔者的主见也是web程序中拿着token去恳求这一个接口来获取用户新闻,并且第三遍获得后做相应的缓冲。可是以为有些奇异,IdentityServer不容许未有想到那或多或少,不荒谬的做法应该是校验通过会将用户的音讯重临的web程序中。难题又来了,要是IdentityServer真的是那样做的,web程序该怎么获取到呢,查了法定文书档案也未尝找到。然后就拿着”Claim”关键字查了一通(在此以前没理解过ASP.NET
Identity),最终通过HttpContext.User.Claims取到了安装的用户音信:

修改IdentityController :

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

    }

图片 9

笔者在github上的地点https://github.com/geffzhang
招待互粉,Ocelot在github的地方 https://github.com/TomPallister/Ocelot
, 相当给力的是在课程当天做到了.NET Core
二.0的晋升,升级进程请看https://github.com/TomPallister/Ocelot/issues/114
。前几日自己花了半钟头就把本人的此外1个POC项目Nanofabric  
https://github.com/geffzhang/NanoFabric 进级到了.NET Core 贰.0,
那几个POC项目也是自身的享用的品类的原型,能够如此说.NET Core 二.0
十二月份行业内部宣布,经过3个月时间的前进,社区生态已经都早就办好了备选,开垦新项目方可选用.NET
Core 二,Ocelot 是二个集成社区新疆中国广播公司大美丽开源项目标象征。

权力决定

IdentityServer四也提供了权力管理的效用,大致看了一眼,未有完结本人想要(没耐心去钻探)。
自个儿需求的是本着不同的模块,成效定义权限码(字符串),各种权限码对应相应的魔法权限。当用户展开呼吁的时候,判定用户是或不是有所相应成效的权限(是不是授予了对应的权杖字符串编码),来落成权限决定。

IdentityServer的校验是通过Authorize本性来判断相应的Controller或Action是还是不是需求校验。那里也透过自定义性子来兑现权力的校验,并且是在原本的Authorize特性上开始展览扩大。可行的方案承接AuthorizeAttribute,重写。可是在.net
core中提醒未有OnAuthorization方法可实行重写。最后参考的ABP的做法,过滤器和特色共同利用。

新建TestAuthorizationFilter.cs

public class TestAuthorizationFilter : IAuthorizationFilter
    {
        public void OnAuthorization(AuthorizationFilterContext context)
        {
            if (context.Filters.Any(item => item is IAllowAnonymousFilter))
            {
                return;
            }

            if (!(context.ActionDescriptor is ControllerActionDescriptor))
            {
                return;
            }
            var attributeList = new List<object>();
            attributeList.AddRange((context.ActionDescriptor as ControllerActionDescriptor).MethodInfo.GetCustomAttributes(true));
            attributeList.AddRange((context.ActionDescriptor as ControllerActionDescriptor).MethodInfo.DeclaringType.GetCustomAttributes(true));
            var authorizeAttributes = attributeList.OfType<TestAuthorizeAttribute>().ToList();
            var claims = context.HttpContext.User.Claims;
            // 从claims取出用户相关信息,到数据库中取得用户具备的权限码,与当前Controller或Action标识的权限码做比较
            var userPermissions = "User_Edit";
            if (!authorizeAttributes.Any(s => s.Permission.Equals(userPermissions)))
            {
                context.Result = new JsonResult("没有权限");
            }
            return;

        }
    }

新建TestAuthorizeAttribute

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
    public class TestAuthorizeAttribute: AuthorizeAttribute
    {

        public string Permission { get; set; }

        public TestAuthorizeAttribute(string permission)
        {
            Permission = permission;
        }

    }

将IdentityController
[Authorize]改为[TestAuthorize(“User_Edit”)],再运行API项目。

因而修改权限码,验证是不是起功用

图片 10

除去运用过滤器和特色结合使用,貌似还有别的方法,有空再研商。

正文中的源码

图片 11

图片 12

职业的火速发展,发生的不行多的对外的服务接口,分散在团队的顺序地点要求张开联合的军管,而且我们的条件是linux和windows的混杂情形,我们的目标是联合在公司的Linux景况,.NET
Core对于.NET 手艺共青团和少先队来讲是叁个丰硕棒的才干,而且.NET
Core自己的架构相当好,质量就越来越好了。

图片 13

图片 14

那里列出了Ocelot目前支撑的天性:

  • Routing
    • 用户能够钦命上游请求之间的照耀,并将其转会到下游服务上的两样UENVISIONL。
  • Service Discovery
    • Ocelot能够查看你的劳动意识,并找到它应当转载下游请求的劳务。它能够在那一个劳务中间实行负载平衡。.
  • Authentication using IdentityServer

    • 您能够将端点标志为已证实,并运用IdentityServer承载标识对您的用户张开身份验证.
  • Authorisation using Claims
    • 假若利用 bearer tokens, 能够应用 claims 标志特定
      endpoints是授权的
  • Claims Transformation
    • Ocelot提供了一种语法来退换给下游请求,并将宣示数据增加到标题,U瑞鹰L参数,别的评释等等
  • Quality of service
    • Retries, circuit breaker, timeouts etc.
  • Request / Correlation Ids
  • Caching
  • Logging
  • Custom Middleware

更详实的始末参看文书档案 https://github.com/TomPallister/Ocelot/wiki 

上边介绍了Ocelot的效益特色,接下去我们进入介绍Ocelot
的兑现原理分析,宗旨是是ASP.NET Core Middleware 以及 ASP.NET Core
DependencyInjection:

图片 15

ASP.NET Core 古板的ASP.NET
在架设上有极大的革新,特别的模块化,下图形象的求证了他们中间分化,Application
和 Middleware 是平等的,比方ASP.NET Core
MVC也是三个Middleware,通过Middleware那样的结构大家格外轻巧的扩张大家的应用程序。

图片 16

Ocelot正是利用Middleware来形成网关的具备机能,各种小功能正是一个Middleware,具体能够看代码
https://github.com/TomPallister/Ocelot/blob/develop/src/Ocelot/Middleware/OcelotMiddlewareExtensions.cs
,Ocelot 是怎么着把各类Middleware串起来共同完毕3个API网关的功力。 asp.net
core 格外抢眼的宏图,把Middleware抽象成了一个委托RequestDelegate,
ASP.NET Core 的每一种 Request 都会经过种种所注册的 Middleware,Response
也是逐2遍传,以先进后出的章程管理每一个封包:

图片 17

具体内容参考: ASP.NET Core HTTP
管道中的这一个事儿

什么样1分钟从头营造3个 ASP.NET Core
中间件

我们在Middleware的编制程序进度中供给关心HttpContext 以及管道的注册者和塑造者
ApplicationBuilder。

 图片 18

ASP.NET Core 使用了大气的 DI (Dependency Injection)
设计,同样大家在Ocelot的宏图中也采取了大量的DI设计,具体参看源码https://github.com/TomPallister/Ocelot/blob/develop/src/Ocelot/DependencyInjection/ServiceCollectionExtensions.cs 

注册 Service 有分二种办法:

  • Transient  每趟注入时,都再也 new 一个新的实业。
  • Scoped    每一个 Request 都重新 new 五个新的实体。
  • Singleton 程序运行后会 new 一个实体。也正是运维时期只会有一个实体。

下边这张图来源https://blog.johnwu.cc/article/asp-net-core-dependency-injection.html
,形象的示范了目的生命周期。

图片 19

  • A 为 Singleton
  • B 为 Scoped
  • C 为 Transient

地方介绍完了Ocelot开拓的基本原理,近日Ocelot 由一七 个Middleware
来产生,在各种Middleware的内部贯彻上还有涉及到多数事业的学问,本篇作品先不做张开,后续写现实的稿子详细分析。接下来大家的话说什么样自定义扩大,在大家的体系中至关心注重要在六个方面进行了扩展:

壹、自定义扩张API 接口验证

图片 20

Ocelot 默许扶助基于IdentityServer肆的证实,必要自定义表达,能够参考
https://github.com/TomPallister/Ocelot/pull/110,增多自定义的表达,然则.net
core 二.0 认证部分基本上海重机厂写了。

二、自定义伸张下游通信协议

图片 21

Ocelot
暗许扶助Http的广播发表,在大家的实在项目中有不少老的服务是RPC调用,使用的是私人住房的Relay通信框架,在API网关上急需做协议转变,自动将Http的乞求改变到Relay的tcp通信。

三、自定义管控台

图片 22

ocelot 有保管API,能够依照拂理API 做自定义的田间管控台,github 有个
https://github.com/dbarkwell/Ocelot.ConfigEditor,这些项目落到实处了asp.net
core mvc 的在线编辑路由。

相关文章