IdentityServer4實現(xiàn).Net Core API接口權限認證(快速入門)
什么是IdentityServer4
官方解釋:IdentityServer4是基于ASP.NET Core實現(xiàn)的認證和授權框架,是對OpenID Connect和OAuth 2.0協(xié)議的實現(xiàn)。
通俗來講,就是服務端對需要認證授權的資源(客戶端請求資源)在外層使用IdentityServer4框架進行封裝加殼,用戶只能通過獲取IdentityServer4頒發(fā)的Token令牌才能進行資源訪問。
下面開始進入正題,如何快速搭建實現(xiàn)API接口鑒權。
準備:1.下載準備NetCore sdk環(huán)境
2.本文開發(fā)環(huán)境為VS2019,部分代碼可能和之前的版本不同。
第一步,新建權限認證服務項目,本文以Net Core API項目模板為例(也可以選擇其他模板)
第二步,添加IdentityServer4 Nuget程序包。不同版本依賴的NetCoe sdk環(huán)境不同,需手動選擇合適版本。
這里提醒一下,有些同學的系統(tǒng)可能添加Nuget程序包時,發(fā)現(xiàn)無法找到程序包。我們這里找出了解決方法,點擊Nuget程序包添加頁面的右上角設置按鈕,看到如下頁面,手動添加如下的nuget.org,然后重新搜索即可。
第三步,添加IdentityServer4配置管理類。本文以用戶密碼授權模式為例。
public class Config { /// <summary> /// 定義資源范圍 /// </summary> public static IEnumerable<ApiResource> GetApiResources() { return new List<ApiResource> { new ApiResource("api1", "我的第一個API") }; } /// <summary> /// 定義訪問的資源客戶端 /// </summary> /// <returns></returns> public static IEnumerable<Client> GetClients() { return new List<Client> { new Client{ ClientId="client",//定義客戶端ID ClientSecrets= { new Secret("secret".Sha256())//定義客戶端秘鑰 }, AllowedGrantTypes=GrantTypes.ResourceOwnerPassword,//授權方式為用戶密碼模式授權,類型可參考GrantTypes枚舉 AllowedScopes={ "api1"}//允許客戶端訪問的范圍 } }; } /// <summary> /// 這個方法是來規(guī)范tooken生成的規(guī)則和方法的。一般不進行設置,直接采用默認的即可。 /// </summary> /// <returns></returns> public static IEnumerable<IdentityResource> GetIdentityResources() { return new IdentityResource[] { new IdentityResources.OpenId() }; } }
第四步,Startup啟動類中注冊服務中間件
// This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) { services.AddIdentityServer()//注冊服務 .AddDeveloperSigningCredential() .AddInMemoryApiResources(Config.GetApiResources())//配置類定義的授權范圍 .AddInMemoryClients(Config.GetClients())//配置類定義的授權客戶端 .AddTestUsers(new List<TestUser> { new TestUser { Username = "Admin", Password = "123456", SubjectId = "001", IsActive = true } });//模擬測試用戶,這里偷懶了,用戶可以單獨管理,最好不要直接在這里New services.AddControllers(); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseIdentityServer();//添加中間件 app.UseHttpsRedirection(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); }
應用程序默認的端口號有兩種:1.http://localhost:5000 2.https://localhost:5001.
到這里,Identityserver4鑒權服務已經(jīng)簡單搭建完成。我們直接在VS中啟動項目。并在端口號后面加上/.well-known/openid-configuration,出現(xiàn)如下頁面則表示配置成功。
第五步,PostMan模擬請求獲取token(當然這一步非必須,對postman感興趣的同學可以試一試)
我們都知道IdentityServer4需要客戶端先訪問鑒權服務獲取token令牌,才能進一步訪問加權的服務器資源。我們這里先通過PostMan模擬客戶端請求,獲取Token。(postman工具大家可以網(wǎng)上下載,也可以使用谷歌自帶的postman插件)
1.使用postman請求token時,有個地方需要注意下:
很多同學在使用https請求時,即請求https://localhost:5001,會發(fā)現(xiàn)無法成功。因為postman默認把SSL證書認證打開了,我們可以手動關閉掉。找到postman頁面右上方的小扳手圖標,進入設置頁面找到ssl關掉即可。當然同學們直接使用http://localhost:5000請求就無需設置SSL.
2.請求參數(shù)
這里的參數(shù)value就是我們在鑒權服務配置類設置的client和TestUser信息。
Grant_Type為授權類型,本文我們使用的是用戶密碼模式,所以這里填password.
這里我們看到,我們已成功模擬請求獲取了Token。大功告成,鑒權服務已驗證可用,我們趕緊去發(fā)布部署吧。
第六步,鑒權服務發(fā)布部署。
.Net Core發(fā)布模式有三種:
1.框架依賴+可移植
2.框架依賴+運行時環(huán)境(帶可執(zhí)行程序exe)
3.獨立部署
簡單來說,框架依賴模式發(fā)布的程序包,都需要部署環(huán)境自帶.net core等運行環(huán)境;而獨立部署則不需要考慮,發(fā)布包已經(jīng)包含了運行環(huán)境,直接部署即可。
下面本文以框架依賴+可移植發(fā)布,做簡單介紹。
發(fā)布完成后,我們會在發(fā)布路徑中看到程序dll.我們找到發(fā)布路徑,通過CMD命令窗口:dotnet xxx.dll可直接啟動。
如上,則表示啟動成功。(如果其他發(fā)布模式,直接雙擊發(fā)布包中可執(zhí)行exe文件即可啟動)
鑒權服務部署完成后,我們API接口如何使用呢,下面開始正式介紹。
第一步:新建Web Api項目
添加Nuget程序包
第二步:配置啟動類
public void ConfigureServices(IServiceCollection services) { //注冊服務 services.AddAuthentication("Bearer") .AddIdentityServerAuthentication(x => { x.Authority = "http://localhost:5000";//鑒權服務地址 x.RequireHttpsMetadata = false; x.ApiName = "api1";//鑒權范圍 }); services.AddControllers(); } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseAuthentication();//添加鑒權認證 app.UseHttpsRedirection(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); }
應用程序默認的端口號有兩種:1.http://localhost:5000 2.https://localhost:5001.為了避免端口號沖突被占用,我們可以在Program類中修改應用程序啟動端口號。
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseUrls("http://*:5555");//設置啟動端口號 webBuilder.UseStartup<Startup>(); });
第三步:創(chuàng)建API DEMO
[Route("api/[controller]")] [ApiController] public class TestController : ControllerBase { // GET: api/Test /// <summary> /// 方法加權 /// </summary> /// <returns></returns> [Authorize] [HttpGet] public IEnumerable<string> Get() { return new string[] { "value1", "value2" }; } /// <summary> /// 方法未加權 可直接訪問 /// </summary> /// <param name="id"></param> /// <returns></returns> // GET: api/Test/5 [HttpGet("{id}", Name = "Get")] public string Get(int id) { return "value"; } /// <summary> /// 開放獲取token API 接口 /// </summary> /// <returns></returns> [HttpGet("GetToken")] public async Task<string> GetToken() { var client = new HttpClient(); var tokenResponse = await client.RequestPasswordTokenAsync(new PasswordTokenRequest { Address = "http://localhost:5000/connect/token", ClientId = "client", ClientSecret = "secret", Scope = "api1", UserName = "Admin", Password = "123456", }); if (tokenResponse.IsError) { return tokenResponse.Error; } return tokenResponse.AccessToken; } }
1.接口方法上加上:
[Authorize]
相當于對接口加權,只有被授權的用戶才能訪問(即獲取token的用戶)。此時上文中接口api/Test由于被加權,請求時會報錯;但是api/Test/1接口未加權,仍可正常請求。
那么我們?nèi)绾尾拍茉L問被加權的接口呢???Go Next
2.我們這里開放了獲取Token的接口GetToken(類似于上文中通過PostMan獲取Token)
訪問被加權的API接口,我們這里需要先請求獲取Token,然后請求加權接口時帶上token參數(shù)。
3.請求加權接口
請求加權接口時帶上Token,接口請求成功!
OK,關于如何快速開發(fā)和調(diào)試基于IdentityServer4框架的API接口鑒權服務,至此我們已介紹完畢。
小弟不才,本文中有考慮不周全或錯誤的地方,歡迎大家指正。
(如果有的同學想通過IIS部署API應用程序,這里有個地方需要注意下,需要在IIS(功能視圖——模塊)中添加AspNetCoreModule模塊。具體原因本文就不在這里介紹了。)
到此這篇關于IdentityServer4實現(xiàn).Net Core API接口權限認證(快速入門)的文章就介紹到這了,更多相關.Net Core API權限認證內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
ASP.NET?MVC實現(xiàn)登錄后跳轉(zhuǎn)到原界面
這篇文章介紹了ASP.NET?MVC實現(xiàn)登錄后跳轉(zhuǎn)到原界面的方法,文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-09-09System.Timers.Timer定時執(zhí)行程序示例代碼
如果是某個邏輯功能的定時,可以將code放到邏輯功能的類的靜態(tài)構造函數(shù)中,在該邏輯類第一次執(zhí)行時,靜態(tài)構造函數(shù)會被調(diào)用,則定時自然啟動2013-06-06一個ASP.NET的MYSQL的數(shù)據(jù)庫操作類自己封裝的
這篇文章主要介紹了一個ASP.NET的MYSQL的數(shù)據(jù)庫操作類自己封裝的,在數(shù)據(jù)庫操作類中的連接字符串中記得加上charset=utf8 需要的朋友可以參考下2014-08-08淺談Asp.net Mvc之Action如何傳多個參數(shù)的方法
本篇文章主要介紹了Asp.net Mvc之Action如何傳多個參數(shù)的方法,具有一定的參考價值,感興趣的小伙伴們可以參考一下。2017-08-08