Table of Contents

Class JwksFetcher

Namespace
KernLab.Claim.Client.Jose
Assembly
KernLab.Claim.Client.dll

JWKS 拉取缓存(契约 §4:本地验签零网络依赖——仅在 kid 未命中时刷新一次; 缓存最小间隔内的强制刷新被抑制,防抖)。

public sealed class JwksFetcher
Inheritance
JwksFetcher
Inherited Members

Constructors

JwksFetcher(HttpClient, string, TimeSpan?)

构造(httpClient 由调用方持有生命周期)。

public JwksFetcher(HttpClient httpClient, string jwksUri, TimeSpan? minRefreshInterval = null)

Parameters

httpClient HttpClient
jwksUri string
minRefreshInterval TimeSpan?

Methods

FindAsync(string, CancellationToken)

kid 定位(未命中触发一次刷新重查;仍无命中 null)。

public Task<ClientJwk?> FindAsync(string kid, CancellationToken cancellationToken = default)

Parameters

kid string
cancellationToken CancellationToken

Returns

Task<ClientJwk>

GetKeysAsync(CancellationToken)

全量 keyset(轮换宽限窗内多 key 并存——验证侧全数接受)。

public Task<IReadOnlyList<ClientJwk>> GetKeysAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

Task<IReadOnlyList<ClientJwk>>

RefreshAsync(bool, CancellationToken)

拉取并替换缓存。

public Task RefreshAsync(bool force, CancellationToken cancellationToken = default)

Parameters

force bool
cancellationToken CancellationToken

Returns

Task