微服务（入门四）：identityServer的简单使用（客户端受权+密码受权）

时间  2019-11-07
标签 微服 入门 identityserver 简单 使用 客户端 受权 密码 繁體版
原文   原文链接

IdentityServer简介（摘自Identity官网）html

IdentityServer是将符合规范的OpenID Connect和OAuth 2.0端点添加到任意ASP.NET核心应用程序的中间件，一般，您构建（或从新使用）一个包含登陆和注销页面的应用程序（可能还包括赞成，具体取决于您的须要），IdentityServer中间件向其添加必要的协议头，以便客户端应用程序可使用这些标准协议与之对话。web

托管应用程序能够像您但愿的那样复杂，但咱们一般建议经过只包含与身份验证相关的UI来尽量地保持攻击面小。api

 

 client               ：客户端，从identityServer请求令牌，用户对用户身份校验，客户端必须先从identityServer中注册，而后才能请求令牌。浏览器

 sources           ：每一个资源都有本身惟一的名称，就是文中所定义的api1服务名称，indentity会验证断定是否有访问该资源的权限。服务器

 access Token  ：访问令牌，由identityServer服务器签发的，客户端使用该令牌进行访问拥有权限的apiapp

 

 

OAuth 2.0四种受权模式（GrantType）ide

  •  客户端模式(client_credentials)
  •  密码模式(password)
  •  受权码模式(authorization_code)
  •  简化模式(implicit)

做用微服务

  • 单点登陆

        在多个应用程序当中进行统一登陆或者注销。post

  • api访问控制
    • 为各类类型的客户端（如服务器到服务器、Web应用程序、SPA和本机/移动应用程序）颁发API访问令牌。
  • 联盟网关

          支持外部身份提供商，如Azure Active Directory、Google、Facebook等。这将使您的应用程序不了解如何链接到这些外部提供商的详细信息。网站

开发准备

   开发环境             :vs2019 

   identityServer4：2.4.0

  netcore版本       ：2.1

客户端受权模式介绍

客户端模式的话是属于identityServer保护API的最基础的方案，咱们定义个indentityServer服务以及一个须要保护的API服务，

当客户端直接访问api的话，因为咱们的api服务添加了authorization认证，因此必需要到identityServer放服务器上拿到访问令牌，客户端凭借该令牌去对应api服务当中获取想要获得的数据。

添加IdentityServer项目

  1.首先添加新项目，建立ASP.NET Core Web 应用程序  建立一个名称为identityServer4test的项目，选择项目类型API  项目进行建立。

 

2.从程序包管理器控制台或者ngGet下载IdentityServer4

  2.1 程序包管理器控制台：install-package IdentityServer4

  2.2 NuGet 的话在对应的程序集，选择nuget输入IdentityServer4选择对应的版本进行下载安装

  

 

 

3.添加Identity Server4 配置

   资源定义能够经过多种方式实现，具体的请查阅官方api文档：https://identityserver4.readthedocs.io/en/latest/quickstarts/1_client_credentials.html

 注：1.ApiResource("api1","My Api")，其中api1表明你的惟一资源名称，在 AllowedScopes = { "api1" }当中必须配置上才能够进行访问

 

using IdentityServer4.Models;
using IdentityServer4.Test;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace IdentityServer4Test.IndntityConfig
{
    public class IdentityServerConfig
    {
        /// <summary>
        /// 添加api资源
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<ApiResource> GetResources()
        {
            return new List<ApiResource>
            {
　　　　　　　　　 
                new ApiResource("api1","My Api")
            };
        }
        /// <summary>
        /// 添加客户端，定义一个能够访问此api的客户端
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<Client> GetClients()
        {
            return new List<Client>
                {
                    new Client
                    {
                        ///
                        ClientId = "client",

                        // 没有交互性用户，使用 客户端模式 进行身份验证。
                        AllowedGrantTypes = GrantTypes.ClientCredentials,
                       
                        // 用于认证的密码
                        ClientSecrets =
                        {
                            new Secret("123454".Sha256())
                        },
                        // 客户端有权访问的范围（Scopes）
                        AllowedScopes = { "api1" }
                    }
 
                };

        }
    }
}

 

4.在startUp当中注入IdentityServer4 服务

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using IdentityServer4.Models;
using IdentityServer4.Test;
using IdentityServer4Test.IndntityConfig;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;

namespace IdentityServer4Test
{
    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.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
            // 在DI容器中注入identityServer服务
            services.AddIdentityServer()
         
        .AddInMemoryApiResources(IdentityServerConfig.GetResources())//添加配置的api资源
        .AddInMemoryClients(IdentityServerConfig.GetClients())//添加客户端，定义一个能够访问此api的客户端
            .AddDeveloperSigningCredential();
            

        }
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            //添加identityserver中间件到http管道
            app.UseIdentityServer();
            //app.UseMvc();
        }
    }
}

5.此时启动程序输入 http://localhost:3322/.well-known/openid-configuration能够获得以下网站，这是identity Server4 提供的配置文档

6.用postMan请求获取access_token

  

标注：body 当中的参数

        grant_type    ：对应api AllowedGrantTypes 类型表示受权模式

        client_id        ： 对应clentID 

        client_secret： 客户端秘钥

       

7.拿到token之后就能够根据token去访问咱们的服务程序，服务程序，首先也是建立一个webApi程序，而且从NuGet下载所需的依赖

  •    IdentityServer4.AccessTokenValidation（程序报管理器的话加上install-package IdentityServer4.AccessTokenValidation）

  7.1 配置authentication，而且添加    app.UseAuthentication();到http管道当中

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;

namespace IndentityServerClientTest
{
    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.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
             //注入authentication服务
            services.AddAuthentication("Bearer")
            
               .AddIdentityServerAuthentication(options =>
               {
                   options.Authority = "http://localhost:3322";//IdentityServer服务地址
                   options.ApiName = "api1"; //服务的名称，对应Identity Server当中的Api资源名称，若是客户端获得的token能够访问此api的权限才能够访问，不然会报401错误
                   options.RequireHttpsMetadata = false;
               });

        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            //添加authentication中间件到http管道
            app.UseAuthentication();
            app.UseMvc();
        }
    }
}

7.2 引用Microsoft.AspNetCore.Authorization;命名空间，添加authorize认证

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;

namespace IndentityServerClientTest.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    [Authorize]
    public class ValuesController : ControllerBase
    {
        // GET api/values
        [HttpGet]
        public ActionResult<IEnumerable<string>> Get()
        {
            return new string[] { "value1", "value2" };
        }

        // GET api/values/5
        [HttpGet("{id}")]
        public ActionResult<string> Get(int id)
        {
            return "value";
        }

        // POST api/values
        [HttpPost]
        public void Post([FromBody] string value)
        {
        }

        // PUT api/values/5
        [HttpPut("{id}")]
        public void Put(int id, [FromBody] string value)
        {
        }

        // DELETE api/values/5
        [HttpDelete("{id}")]
        public void Delete(int id)
        {
        }

        // DELETE api/values/5
        [Route("send")]
        [HttpGet]
        public string send()
        {
            return "成功了";

        }

    }
}

7.3. 直接访问的话会报401错误

 

7.4 在请求头当中添加Authorization 参数，参数值为Bearer加上空格 加上我们刚才获取到的access_token 请求成功！~~

 密码受权                                                         

  

官方介绍

 OAuth2.0资源全部者密码受权容许客户端向令牌服务发送用户名和密码，并获取表明该用户的访问令牌。

 除了不能承载浏览器的遗留应用程序以外，规范一般建议不要使用资源全部者密码授予。通常来讲，当您想要对用户进行身份验证并请求访问令牌时，最好使用交互式OpenID链接流之一。

 然而，这种受权类型容许咱们将用户的概念引入到QuickStartIdentityServer，这就是咱们展现它的缘由。

 1.配置可访问的用户信息以及受权模式

   新添加一个client模式而且更改AllowedGrantTypes 类型为“GrantTypes.ResourceOwnerPassword” 

 

 

using IdentityServer4.Models;
using IdentityServer4.Test;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace IdentityServer4Test.IndntityConfig
{
    public class IdentityServerConfig
    {
        /// <summary>
        /// 添加api资源
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<ApiResource> GetResources()
        {
            return new List<ApiResource>
            {
                new ApiResource("api1","My Api")
            };
        }
        /// <summary>
        /// 添加客户端，定义一个能够访问此api的客户端
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<Client> GetClients()
        {
            return new List<Client>
                {
                    new Client
                    {
                        ///
                        ClientId = "client",

                        // 没有交互性用户，使用 客户端模式 进行身份验证。
                        AllowedGrantTypes = GrantTypes.ClientCredentials,
                       
                        // 用于认证的密码
                        ClientSecrets =
                        {
                            new Secret("123454".Sha256())
                        },
                        // 客户端有权访问的范围（Scopes）
                        AllowedScopes = { "api1" }
                    }
                    ,
                    new Client
                    {
                        ClientId = "client1",


                        AllowedGrantTypes = GrantTypes.ResourceOwnerPassword,
                       
                        // 用于认证的密码
                        ClientSecrets =
                        {
                            new Secret("laozheng".Sha256())
                        },
                        RequireClientSecret=false,
                        // 客户端有权访问的范围（Scopes）
                        AllowedScopes = { "api1" }
                    }
                };

        }

        public static List<TestUser> GetTestUsers()
        {
            return new List<TestUser> {
                new TestUser{
                    SubjectId="1",
                    Password="111",
                    Username="111",
                }
            };
        }
    }
}

1.1 修改startup.cs文件

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using IdentityServer4.Models;
using IdentityServer4.Test;
using IdentityServer4Test.IndntityConfig;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;

namespace IdentityServer4Test
{
    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.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
            // 在DI容器中注入identityServer服务
            services.AddIdentityServer()
         
        .AddInMemoryApiResources(IdentityServerConfig.GetResources())
        .AddInMemoryClients(IdentityServerConfig.GetClients())
        .AddTestUsers(IdentityServerConfig.GetTestUsers())
            .AddDeveloperSigningCredential();
            

        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            //添加identityserver中间件到http管道
            app.UseIdentityServer();
            //app.UseMvc();
        }
    }
}

 

2.获取token

 

 

3.经过刚才获取到的token访问接口

 

 

 

 

 

快速入口：微服务（入门一）：netcore安装部署consul

快速入口： 微服务（入门二）：netcore经过consul注册服务

快速入口： 微服务（入门三）：netcore ocelot api网关结合consul服务发现

快速入口：微服务（入门四）：identityServer的简单使用（客户端受权） 

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程