NetCore專案實戰篇04---整合IdentityService4

阿新 • • 發佈：2020-05-08

大家都知道我們的專案中已有web api,現在可以正式訪問，不論任何人只要通過輸入對應的api網址就可以訪問到我們的api 資源，這樣是很不安全的，我們需求對當前使用者進行身份驗證，因此我們在專案中使用IdentityServer4來對受保護資源並實現身份驗證和/或授權，直接開始上程式碼，這些程式碼直接可以在你的專案中使用，並跑起來。

1、新建一個空的.netcore web專案，並引入IdentityService4的NuGet包。

2、在專案中增加一個config.cs檔案

 public class Config
    {
        public static IEnumerable<Client> GetClients()
        {
            return new List<Client>
            {
                new Client
                {
                    ClientId="iphone",
                    ClientSecrets = new List<Secret>
                    {
                        new Secret("secret".Sha256())
                    },
                    RefreshTokenExpiration = TokenExpiration.Sliding,
                    AllowOfflineAccess = true,
                    RequireClientSecret = false,
                    AllowedGrantTypes = new List<string>{"sms_suth_code"},
                    AlwaysIncludeUserClaimsInIdToken = true,
                    AllowedScopes = new List<string>
                    {
                        "gateway_api",
                        IdentityServerConstants.StandardScopes.OpenId,
                        IdentityServerConstants.StandardScopes.Profile,
                        IdentityServerConstants.StandardScopes.OfflineAccess,
                    },

                },
                new Client
                {
                    ClientId="android",
                    ClientSecrets = new List<Secret>
                    {
                        new Secret("secret".Sha256())
                    },
                    RefreshTokenExpiration = TokenExpiration.Sliding,
                    AllowOfflineAccess = true,
                    RequireClientSecret = false,
                    AllowedGrantTypes = new List<string>{"sms_auth_code"},
                    AlwaysIncludeUserClaimsInIdToken = true,
                    AllowedScopes = new List<string>
                    {
                        "gateway_api",
                        IdentityServerConstants.StandardScopes.OpenId,
                        IdentityServerConstants.StandardScopes.Profile,
                        IdentityServerConstants.StandardScopes.OfflineAccess,
                    },

                }
            };
        }
        public static IEnumerable<IdentityResource> GetIdentityResources()
        {
            return new List<IdentityResource>
            {
                new IdentityResources.OpenId(),
                new IdentityResources.Profile(),
            };
        }
        public static IEnumerable<ApiResource> GetApiResources()
        {
            return new List<ApiResource>
            {
                new ApiResource("gateway_api","user service")
            };
        }
        
    }

3、在專案中新增類SmsAuthCodeValidator該類主要是實現IdentityServer4元件中的IextensionGrantValidator介面ValidateAsync()的方法，在該方法寫上自己的驗證邏輯，這裡我們只用戶在登入時輸入的手機號和驗證碼進行了校驗，當然在校驗時會呼叫使用者模組的api,也就是我們_userService.CheckOrCreate(phone)方法，服務之前如何發現和呼叫這裡不展開，下節介紹。SmsAuthCodeValidator程式碼如下

public class SmsAuthCodeValidator : IExtensionGrantValidator
    {
        private readonly IAuthCodeService _authCodeService;
        private readonly IUserService _userService;
        public SmsAuthCodeValidator(IAuthCodeService authCodeService, IUserService userService)
        {
            _authCodeService = authCodeService;
            _userService = userService;
        }
        public string GrantType => "sms_auth_code";

        public async Task ValidateAsync(ExtensionGrantValidationContext context)
        {
            var phone = context.Request.Raw["phone"];
            var code = context.Request.Raw["auth_code"];
            var error = new GrantValidationResult(TokenRequestErrors.InvalidGrant);
            if(!string.IsNullOrEmpty(phone)&& !string.IsNullOrEmpty(code))
            {
                //使用者檢查
                _authCodeService.Validate(phone, code);
                //使用者註冊
                var userId = await _userService.CheckOrCreate(phone);
                if(userId <=0)
                {
                    context.Result = error;
                    return;
                }

                context.Result = new GrantValidationResult(userId.ToString(), GrantType);
            }
            else
            {
                context.Result = error;

            }

            
        }
    }

4、在SmsAuthCodeValidator類我們引用了兩個本地的服務，一個是對驗證碼進行校驗的AuthCodeService類，一個是對手機號進行校驗的UserService，也就是在這個類中對使用者服務模組進行的手機號校驗。現將這兩個程式碼的程式碼寫上

public interface IAuthCodeService
    {
        /// <summary>
        /// 驗證
        /// </summary>
        /// <param name="phone">手機號</param>
        /// <param name="authCone">驗證碼</param>
        /// <returns></returns>
        bool Validate(string phone, string authCone);
    }


public class AuthCodeService : IAuthCodeService
    {
        public bool Validate(string phone, string authCone)
        {
            return true;
        }
    }

public interface IUserService
    {
        /// <summary>
        /// 檢查手機是否註冊，如果沒有就建立
        /// </summary>
        /// <param name="phone"></param>
        Task<int> CheckOrCreate(string phone);
    }

public class UserService : IUserService
    {
        
        public async Task<int> CheckOrCreate(string phone)
        {
          
            return 1;

        }
    }

5、最後我們需要增加IdentityServer4中介軟體，並對我們的服務進行配置

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.AddIdentityServer()
                .AddExtensionGrantValidator<SmsAuthCodeValidator>()
                .AddDeveloperSigningCredential()
                .AddInMemoryClients(Config.GetClients())
                .AddInMemoryIdentityResources(Config.GetIdentityResources())
                .AddInMemoryApiResources(Config.GetApiResources());
            services.AddSingleton(new HttpClient());
            services.AddScoped<IAuthCodeService, AuthCodeService>()
                .AddScoped<IUserService, UserService>();

            services.AddMvc();
        }

        // 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();
            }
            app.UseIdentityServer();
            app.UseMvc();
        }
    }

5、生成並啟動該專案，通過postman訪問，需求增加如下六個引數

6、如果沒有問題的話我們會獲取到系統反饋給我們的token值，返回結果如下：

{
    "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjlhMjJlN2E3Zjg1ZmY5MjNiMTJmM2Nm
NGZkMGM3YzYzIiwidHlwIjoiSldUIn0.eyJuYmYiOjE1ODg5MjE2MjUsImV4cCI6
MTU4ODkyNTIyNSwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDoxMTEwIiwiYXVkIjpb
Imh0dHA6Ly9sb2NhbGhvc3Q6MTExMC9yZXNvdXJjZXMiLCJnYXRld2F5X2FwaSJd
LCJjbGllbnRfaWQiOiJhbmRyb2lkIiwic3ViIjoiMyIsImF1dGhfdGltZSI6MTU4
ODkyMTYyNSwiaWRwIjoibG9jYWwiLCJzY29wZSI6WyJvcGVua
WQiLCJwcm9maWxlIiwiZ2F0ZXdheV9hcGkiLCJvZmZsaW5lX2FjY2VzcyJdLCJhb
XIiOlsic21zX2F1dGhfY29kZSJdfQ.pyEKOe08jiqtg1rgcf0UGO0hmfEhI5a2cIXw
_-YgXdLVceKa14Jhyy8Ezgom3ipNlci5FwmN-p5ro_3ORtzreU0qxhiCzI5kyPgLRP
lOO8cFykYKY4yQOCD_z2LohSxyvAsTPn0B75_iodujGPQAB4Outs9uAjcHXAnxjBkn
DKl6L5uu609ZaugG4X6T2xx0ZDU-VftrrmB-YX5oe6FU70R4jsRLayL8nrM-u-Q_We
UIfY04M91REX9HqneOGyxSDj2Qku22pC68dlIYQNGhBlYUnSqRMkk39Pe9UmjO8dSp
qqBMtHBEwCQn3cMzG7UbP5gB6F2GgTICUBERbxxwRA",
    "expires_in": 3600,
    "token_type": "Bearer",
    "refresh_token": "f3051fa24cebf7cbfa73b55563a283bb3c15b129c8c5ff732324a653a7c6eff1"
}

7、懷著好奇的心我們來看看這個access_token的值反饋給我們的是什麼，其實他就是JWT（Json Web Token)，解析成json格式如下

 {
 alg: "RS256",

 kid: "9a22e7a7f85ff923b12f3cf4fd0c7c63",

 typ: "JWT"

}.
{
 nbf: 1588921625,

 exp: 1588925225,

 iss: "http://localhost:1110",

 aud: [
  "http://localhost:1110/resources",

  "gateway_api"

 ],

 client_id: "android",

 sub: "3",

 auth_time: 1588921625,

 idp: "local",

 scope: [
  "openid",

  "profile",

  "gateway_api",

  "offline_access"

 ],

 amr: [
  "sms_auth_code"

 ]

}. 
[signature]

順便學習一下JWT吧：

HTTP提供了一套標準的身份驗證框架：伺服器可以用來針對客戶端的請求傳送質詢(challenge)，客戶端根據質詢提供身份驗證憑證。質詢與應答的工作流程如下：伺服器端向客戶端返回401（Unauthorized，未授權）狀態碼，並在WWW-Authenticate頭中新增如何進行驗證的資訊，其中至少包含有一種質詢方式。然後客戶端可以在請求中新增Authorization頭進行驗證，其Value為身份驗證的憑證資訊。

Bearer認證（也叫做令牌認證）是一種HTTP認證方案，其中包含的安全令牌的叫做Bearer Token。因此Bearer認證的核心是Token。那如何確保Token的安全是重中之重。一種方式是使用Https，另一種方式就是對Token進行加密簽名。而JWT就是一種比較流行的Token編碼方式。可以看出JWT有三部分組成：

<header>.<payload>.<signature>

Header：由alg和typ組成，alg是algorithm的縮寫，typ是type的縮寫，指定token的型別。該部分使用Base64Url編碼。
Payload：主要用來儲存資訊，包含各種宣告，同樣該部分也由BaseURL編碼。
Signature：簽名，使用伺服器端的金鑰進行簽名。以確保Token未被篡改。

下一篇我們將介紹閘道器，通過閘道器來訪問我們的使用者模組的api資源，並整合IdentitySer

NetCore專案實戰篇04---整合IdentityService4

NetCore專案實戰篇04---整合IdentityService4

NetCore專案實戰篇05---新增Ocelot閘道器並整合identity server4認證

NetCore專案實戰篇02---全域性異常處理

NetCore專案實戰篇06---服務註冊與發現之consul

NetCore專案實戰篇07---服務保護之polly

springmvc 專案完整示例04 整合mybatis mybatis所需要的jar包 mybatis配置檔案 sql語句 mybatis應用

webpack構建react專案----實戰篇

weex專案實戰篇（二）

weex專案實戰篇（一）

【SSH網上商城專案實戰01】整合Struts2、Hibernate4.3和Spring4.2

專案實戰篇-餐館管理系統—MFC,PHP,MySql:2.登陸功能的實現

某課網Spring Boot 2.0深度實踐之核心技術專案實戰篇

用ABP只要加人即可馬上加快專案進展(二) - 分工篇 - BDD實戰篇 - .NET Core裡跑Specflow - 可以跑整合測試和單元測試

使用Jenkins與Docker持續整合與釋出NetCore專案(實操篇)

構建NetCore應用框架之實戰篇（一）：什麽是框架，如何設計一個框架

構建NetCore應用框架之實戰篇索引

構建NetCore應用框架之實戰篇（四）：BitAdminCore框架1.0登錄功能細化及技術選型

《SpringBoot從入門到放棄》之第（八）篇——SpringBoot整合Mybatis（大型專案開發技術首選）

【SSH網上商城專案實戰07】Struts2和Json的整合

04：專案實戰一：part04

NetCore專案實戰篇04---整合IdentityService4

相關推薦