啟動
IdentityServer的啟動是中間件和服務的組合來實現的。 所有配置都在你的啟動類(Startup.cs)中完成。
配置服務
通過以下方式調用將IdentityServer服務添加到DI系統:
public void ConfigureServices(IServiceCollection services)
{
var builder = services.AddIdentityServer();
}
這將返回一個生成器對象,而這個對象又有一些方便的方法來連接其他的服務。
密鑰
-
AddSigningCredential
添加一個簽名密鑰服務,該服務將指定的密鑰提供給各種令牌創建/驗證服務。 您可以傳入X509Certificate2
,SigningCredential
或對證書存儲區中證書的引用。 -
AddDeveloperSigningCredential
在啟動時創建臨時密鑰。 這是僅用於開發場景,當您沒有證書使用。 生成的密鑰將被保存到文件系統,以便在服務器重新啟動之間保持穩定(可以通過傳遞false來禁用)。 這解決了在開發期間client / api元數據緩存不同步的問題。 -
AddValidationKey
添加驗證令牌的密鑰。 它們將被內部令牌驗證器使用,並將顯示在發現文檔中。 您可以傳入X509Certificate2
,SigningCredential
或對證書存儲區中證書的引用。 這對於關鍵的轉換場景很有用。
內存存儲配置
各種“in-memory“配置API允許從配置對象的內存列表配置IdentityServer。 這些“in-memory”的集合可以在宿主應用程序中進行硬編碼,也可以從配置文件或數據庫動態加載。 但是,在設計時,只有托管應用程序啟動時才會創建這些集合。
使用這些配置API可用於原型設計,開發和/或測試時不需要在運行時動態查詢配置數據的數據庫。 如果配置很少改變,這種配置方式也可能適用於生產方案,或者如果必須更改值,則需要重新啟動應用程序並不方便。
-
AddInMemoryClients
添加基於IClientStore
和ICorsPolicyService
的內存集合注冊實現,以注冊客戶端配置對象。 -
AddInMemoryIdentityResources
添加基於IResourceStore
的IdentityResource
的內存集合注冊實現,以注冊身份驗證資源。 -
AddInMemoryApiResources
添加基於IResourceStore
的ApiResource
的內存集合注冊實現,以注冊API資源。
測試存儲
TestUser
類在IdentityServer中模擬用戶,憑據和聲明。 TestUser
的使用與使用“in-memory”存儲類似,因為它適用於原型開發和/或測試。 生產中不推薦使用TestUser
。
AddTestUsers
基於TestUserStore
的TestUser
對象的集合注冊實現。 還注冊IProfileService
和IResourceOwnerPasswordValidator
的實現。
額外服務
-
AddExtensionGrantValidator
添加用於擴展授權的IExtensionGrantValidator
實現。 -
AddSecretParser
添加用於解析客戶端或API資源憑證的ISecretParser
實現。 -
AddSecretValidator
添加ISecretValidator
實現,以針對憑證存儲驗證客戶端或API資源憑證。 -
AddResourceOwnerValidator 添加
IResourceOwnerPasswordValidator`實現,用於驗證資源所有者密碼憑據授權類型的用戶憑證。 -
AddProfileService 添加
IProfileService以實現連接到您的自定義用戶配置文件存儲。
DefaultProfileService`類提供了默認實現,它依靠身份驗證cookie作為唯一的令牌發放源。 -
AddAuthorizeInteractionResponseGenerator
添加IAuthorizeInteractionResponseGenerator
實現來在授權端點定制邏輯,以便顯示用戶錯誤,登錄,同意或任何其他自定義頁面的UI。 AuthorizeInteractionResponseGenerator類提供了一個默認的實現,因此如果需要增加現有的行為,可以考慮從這個現有的類派生。 -
AddCustomAuthorizeRequestValidator
添加ICustomAuthorizeRequestValidator
實現,以在授權端點定制請求參數驗證。 -
AddCustomTokenRequestValidator
添加ICustomTokenRequestValidator
實現來定制令牌端點處的請求參數驗證。 -
AddRedirectUriValidator
添加IRedirectUriValidator
實現來自定義重定向URI驗證。 -
AddAppAuthRedirectUriValidator
添加一個“AppAuth”(OAuth 2.0 for Native Apps)兼容的重定向URI驗證器(進行嚴格的驗證,但也允許隨機端口為http://127.0.0.1)。 -
AddJwtBearerClientAuthentication
使用JWT對客戶機認證的支持。
緩存
客戶端和資源配置數據經常被IdentityServer使用。 如果從數據庫或其他外部存儲裝載此數據,那么頻繁地重新加載相同的數據代價可能是昂貴的。
-
AddInMemoryCaching
要使用下面描述的任何緩存,必須在DI中注冊ICache的實現。 此API注冊基於ASP.NET Core的ICache 的MemoryCache默認內存緩存實現。 -
AddClientStoreCache
注冊一個IClientStore
裝飾器實現,它將維護客戶端配置對象的內存緩存。 緩存持續時間可以在IdentityServerOptions
上的緩存配置選項上配置。 -
AddResourceStoreCache
注冊一個IResourceStore
裝飾器實現,它將維護IdentityResource
和ApiResource
配置對象的內存緩存。 緩存持續時間可以在IdentityServerOptions
上的緩存配置選項上配置。 -
AddCorsPolicyCache
注冊一個ICorsPolicyService
裝飾器實現,它將維護一個CORS策略服務評估結果的內存緩存。 緩存持續時間可以在IdentityServerOptions上的緩存配置選項上配置。
可以進一步定制緩存:
默認緩存依賴於ICache
ICache<T>
的默認實現依賴於.NET提供的IMemoryCache
接口(和MemoryCache
實現)。 如果您希望自定義內存中的緩存行為,則可以替換依賴注入系統中的IMemoryCache
實現。
配置中間件
您需要通過以下方式調用將IdentityServer添加到管道中:
public void Configure(IApplicationBuilder app)
{
app.UseIdentityServer();
}
UseIdentityServer
包含對UseAuthentication
的調用,所以沒有必要同時調用這兩個。
中間件沒有額外的配置。
請注意,添加順序在管道配置中很重要。 例如,您需要在添加MVC中間件之前添加IdentitySever。