"OpenID Connect發現端點" 的客戶端庫作為httpclient的擴展方法提供。該 方法返回一個 對象,該對象具有發現文檔的各種元素的強類型和弱類型訪問器。 在訪問文檔內容之前,應始終檢查 和`Error`屬性。 例: 可以使用以下屬性訪問標準元素: 自定義元素(或標準屬性未涵蓋的元素) ...
OpenID Connect發現端點的客戶端庫作為httpclient的擴展方法提供。該GetDiscoveryDocumentAsync
方法返回一個DiscoveryResponse
對象,該對象具有發現文檔的各種元素的強類型和弱類型訪問器。
在訪問文檔內容之前,應始終檢查IsError
和Error
屬性。
例:
var client = new HttpClient();
var disco = await client.GetDiscoveryDocumentAsync("https://demo.identityserver.io");
if (disco.IsError) throw new Exception(disco.Error);
可以使用以下屬性訪問標準元素:
var tokenEndpoint = disco.TokenEndpoint;
var keys = disco.KeySet.Keys;
自定義元素(或標準屬性未涵蓋的元素)可以像這樣訪問:
// returns string or null
var stringValue = disco.TryGetString("some_string_element");
// return a nullable boolean
var boolValue = disco.TryGetBoolean("some_boolean_element");
// return array (maybe empty)
var arrayValue = disco.TryGetStringArray("some_array_element");
// returns JToken
var rawJson = disco.TryGetValue("some_element);
1.1 發現政策
預設情況下,發現響應在返回到客戶端之前已經過驗證,驗證包括:
- 強制使用HTTPS(localhost地址除外)
- 強制發行人與當局匹配
- 強制協議端點與許可權位於同一DNS名稱上
- 強制執行密鑰集的存在
可以使用DiscoveryPolicy
類修改所有標準驗證規則,例如禁用頒發者名稱檢查:
var disco = await client.GetDiscoveryDocumentAsync(new DiscoveryDocumentRequest
{
Address = "https://demo.identityserver.io",
Policy =
{
ValidateIssuerName = false
}
});
策略衝突錯誤會將DiscoveryResponse
上的ErrorType
屬性設置為PolicyViolation
。
1.2 緩存發現文檔
您應該定期更新發現文檔的本地副本,以便能夠對伺服器上的配置更改作出響應。這對於使用自動旋轉鍵進行良好的播放尤其重要。
該DiscoveryCache
類可以幫助你。
以下代碼將設置緩存,在第一次需要時檢索文檔,然後將其緩存24小時:
var cache = new DiscoveryCache("https://demo.identityserver.io");
然後,您可以像這樣訪問文檔:
var disco = await cache.GetAsync();
if (disco.IsError) throw new Exception(disco.Error);
您可以使用該CacheDuration
屬性指定緩存持續時間,也可以通過將DiscoveryPolicy
傳遞給構造函數來指定自定義發現策略。
1.2.1 緩存和HttpClient實例
預設情況下,發現緩存將在HttpClient
每次訪問發現端點時創建新實例。您可以通過兩種方式修改此行為,方法是將預先創建的實例傳入構造函數,或者通過提供將HttpClient
在需要時返回的函數。
以下代碼將在DI中設置發現緩存,並將使用HttpClientFactory
以創建客戶端:
services.AddSingleton<IDiscoveryCache>(r =>
{
var factory = r.GetRequiredService<IHttpClientFactory>();
return new DiscoveryCache(Constants.Authority, () => factory.CreateClient());
});