源碼模塊:Volo.Abp.IdentityServer
初始化IdentityServer4
在ABP的分離部署模式中,有一個類庫專門處理IdentityServer4,作為認證授權服務器。首先將IdentityServer設為啟動項目,修改appsettings.json里面的ConnectionStrings節點,然后再Nuget管理器控制台中運行Update-Database,完成數據遷移。有一個數據種子生成器類 IdentityServerDataSeedContributor 專門處理初始化IdentityServer。
1. 依賴
默認的IdentityServer4主要依賴於 Volo.Abp.Account.Web.IdentityServer 這個Nuget包來支持基於IdentityServer4的登錄和登出。從源碼可以看到,這個包又依賴於AbpAccountWebModule、AbpIdentityServerDomainModule。前者處理登錄界面,后者處理IdentityServer4(其實就是基於原生的IdentityServer4做了一層集成處理)。IdentityServerSupportedLoginModel、IdentityServerSupportedLogoutModel是僅有的兩個類用於處理登錄登出的,這里面涉及到大量的IdentityServer4的相關處理,可以好好看看。
初始化 Api服務器以及Web界面服務器
這兩個東西就是.HttpApi.Host項目以及.Web.Host項目,主要就是修改appsettings.json里面的ConnectionStrings節點就可以了。在這里要特別說下需要部署redis,應該api項目依賴於它。而在Web項目中,需要配置OpenId Connect身份認證
private void ConfigureAuthentication(ServiceConfigurationContext context, IConfiguration configuration) { context.Services.AddAuthentication(options => { options.DefaultScheme = "Cookies"; options.DefaultChallengeScheme = "oidc"; }) .AddCookie("Cookies", options => { options.ExpireTimeSpan = TimeSpan.FromDays(365); }) .AddOpenIdConnect("oidc", options => { options.Authority = configuration["AuthServer:Authority"]; options.RequireHttpsMetadata = false; options.ResponseType = OpenIdConnectResponseType.CodeIdToken; options.ClientId = configuration["AuthServer:ClientId"]; options.ClientSecret = configuration["AuthServer:ClientSecret"]; options.SaveTokens = true; options.GetClaimsFromUserInfoEndpoint = true; options.Scope.Add("role"); options.Scope.Add("email"); options.Scope.Add("phone"); options.Scope.Add("ABPModuleSample_WithUI"); options.ClaimActions.MapJsonKey(AbpClaimTypes.UserName, "name"); options.ClaimActions.DeleteClaim("name"); }); }
雖然也有一個控制器,但是這個控制器並沒有使用,主要還是web應用程序,即Pages目錄下的Index.cshtml頁面來處理,調用ChallengeAsync方法,直接重定向到指定AuthenticationScheme 的中間件。
總結
.Web.Host 項目使用OpenId Connect身份認證從.IdentityServer獲取當前用戶的身份和訪問令牌. 然后使用訪問令牌調用 .HttpApi.Host. HTTP API 服務器使用bearer token驗證訪問令牌獲取當前用戶聲明並授權用戶.
參考: