ASP.NET Core3.1使用Identity Server4建立Authorization Server-1

果凍棟吖發表於2020-07-13
ASP.NETIDEServer

前言

網上關於Identity Server4的資料有挺多的，之前是一直看楊旭老師的，最近專案中有使用到，在使用.NET Core3.1的時候有一些不同。所以在此記錄一下。

預備知識: https://www.cnblogs.com/cgzl/p/9405796.html

本文內容參考

如楊旭老師所說，官方文件真的很詳細，有時間建議大家看下官方文件。

建立Authorization Server

建立ASP.Net Core專案使用空模板。

專案建立之後，執行方式改為使用控制檯執行而不是IIS Express,以便檢視各種debug資訊。

這個已成為習慣，也是學習楊老師的，確實比較方便，當然如果不喜歡可以不設定，只需要埠號配置的時候對應好就可以的。


修改後檔案程式碼為：

{ 
  "profiles": { 
    "IdentityServer4.AuthServer": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

埠號為5000，此時執行程式，會顯示出Hello World!，預設的，沒有修改。

安裝Identity Server4

點選安裝就好啦。

配置Identity Server4

API和客戶端

API的配置和之前有所不同，之前是ApiResources，現在分為ApiResources和ApiScopes，後續會說到。

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

namespace IdentityServer4.AuthServer.Configuration
{
    public class InMemoryConfiguration
    {
        /// <summary>
        /// Api Scopes
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<ApiScope> ApiScopes()
        {
            return new List<ApiScope>
            {
                new ApiScope("scope1","scope1")
            };
        }
        /// <summary>
        /// ApiResources
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<ApiResource> ApiResources()
        { 
            return new[]
            {
                new ApiResource
                {
                    Name = "api1",
                    DisplayName = "My Api1",
                    Scopes = { "scope1" }
                } 
            };
        }
        /// <summary>
        /// Clients
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<Client> Clients()
        {
            return new[]
            { 
                new Client
                {
                    ClientId = "client",
                    AllowedGrantTypes = GrantTypes.ResourceOwnerPasswordAndClientCredentials, 
                    ClientSecrets =
                    {
                        new Secret("secret".Sha256())
                    }, 
                    AllowedScopes = { "scope1" }
                }
            };
        }
        /// <summary>
        /// Users
        /// </summary>
        /// <returns></returns>
        public static IEnumerable<TestUser> Users()
        {
            return new[]
            {
                new TestUser
                {
                    SubjectId = "1",
                    Username = "mail@qq.com",
                    Password = "password"
                }
            };
        }
    }
}

ApiScopes: 這個應該怎麼翻譯我也不清楚，API範圍？如果沒理解錯的話，就是給之前的ApiResources進行了一個分組。授權的時候會驗證Scope。

ApiResources:比如官網的第一個demo，可能會有疑問，你怎麼知道我是api1呢？其實，就沒有驗證，只要有授權碼就可以訪問的。如果說，我只要api1的話，那就用到ApiResources了，生產環境中，也必然是需要用到的。

載入資源和客戶端

修改Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentityServer()
        .AddDeveloperSigningCredential()
        .AddTestUsers(InMemoryConfiguration.Users().ToList())
        .AddInMemoryClients(InMemoryConfiguration.Clients())
        .AddInMemoryApiScopes(InMemoryConfiguration.ApiScopes())
        .AddInMemoryApiResources(InMemoryConfiguration.ApiResources());
}

當然，也需要app.UseIdentityServer();

首次啟動時，Identity Server4將建立一個開發人員簽名金鑰，該檔名為tempkey.rsa。不必將該檔案簽入原始碼管理中，如果不存在該檔案將被重新建立。也就是AddDeveloperSigningCredential()。 這個方法只適合用於Identity Server4在單個機器執行, 如果是生產環境你得使用AddSigningCredential()這個方法.

執行一下，發現並沒有什麼改變，不過開啟:http://localhost:5000/.well-known/openid-configuration，則應該看到所謂的發現文件。發現文件是身份伺服器中的標準端點。客戶端和API將使用發現文件來下載必要的配置資料。

獲取Token

開啟Postman，按照配置的輸入然後試一下

獲取到Token,控制檯輸出如下：

這裡是有使用者的資訊的，但是我們可以把使用者資訊去掉，然後GrantType改為client_credentials，我們設定的是 ResourceOwnerPasswordAndClientCredentials 這個GrantType，所以使用使用者名稱密碼以及使用ClientCredentials都可以。

不過此時控制檯會有區別，沒有使用者資訊了。

美化美化UI

Identity Server 4 提供了一套QuickStart UI

https://github.com/IdentityServer/IdentityServer4.Quickstart.UI

此儲存庫包含UI所需的控制器，模型，檢視和CSS檔案。只需下載/克隆並將其複製到Web專案中即可。

開啟專案根目錄，執行Powershell，然後輸入命令:

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/IdentityServer/IdentityServer4.Quickstart.UI/main/getmain.ps1'))

不過可能你會遇到我前三次那種錯誤，嗯，訪問不了，那就全域性或者先下載下來人工貼上過去吧~

好了以後我們的專案是醬紫的：

由於有wwwroot下很多靜態檔案, 所以asp.net core 需要啟用服務靜態檔案的功能: 修改Startup的Configure方法

先看修改前的樣子吧

        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!");
                });
            });
        }

修改後

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

            app.UseIdentityServer();

            app.UseStaticFiles();

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllerRoute(
                   name: "default",
                   pattern: "{controller=Home}/{action=Index}/{id?}"
               );
            });
        }

是不是拋異常了？

因為我們現在有UI了，所以不要忘記在ConfigureServices裡面註冊MVC。

        public void ConfigureServices(IServiceCollection services)
        {
            
            services.AddControllersWithViews();

            services.AddIdentityServer()
              .AddDeveloperSigningCredential()
              .AddTestUsers(InMemoryConfiguration.Users().ToList())
              .AddInMemoryClients(InMemoryConfiguration.Clients())
              .AddInMemoryApiScopes(InMemoryConfiguration.ApiScopes())
              .AddInMemoryApiResources(InMemoryConfiguration.ApiResources());
        }

然後執行一下試試:

登入一下~

好了，現在我們已經可以登入成功了。

登入介面可以自定義的~，OK，今天就到這裡

計劃

接下來會說一下

  • 建立我們的API專案並使用Token測試介面
  • 建立一個MVC客戶端專案訪問我們的API
  • 建立一個JS(Vue)客戶端訪問我們的API專案

End

推廣下自己的公眾號一個逗逼的程式設計師，主要記錄自己工作中解決問題的思路分享及學習過程中的筆記。絕對不會程式設計師販賣程式設計師的焦慮來割韭菜。

相關文章