Table of Contents

Class TokenClient

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

token 获取客户端——client_credentials / authorization_code / refresh / revocation (Basic 认证缺省,RFC 6749 §2.3.1;端点可经 discovery 或直给)。

public sealed class TokenClient
Inheritance
TokenClient
Inherited Members

Constructors

TokenClient(HttpClient)

构造(httpClient 由调用方持有;BaseAddress 可空——方法传绝对端点)。

public TokenClient(HttpClient httpClient)

Parameters

httpClient HttpClient

TokenClient(HttpClient, ECDsa)

构造(DPoP 形态——WP11:dpopKey 在位 = 全请求自动携 proof (htm/htu/iat/jti [+ath]);access token 签发即 cnf.jkt 绑定)。

public TokenClient(HttpClient httpClient, ECDsa dpopKey)

Parameters

httpClient HttpClient
dpopKey ECDsa

Methods

AuthorizationCodeAsync(string, string, string, string, string, string, CancellationToken)

authorization_code(PKCE verifier 必带)。

public Task<TokenResponse> AuthorizationCodeAsync(string tokenEndpoint, string clientId, string clientSecret, string code, string redirectUri, string codeVerifier, CancellationToken cancellationToken = default)

Parameters

tokenEndpoint string
clientId string
clientSecret string
code string
redirectUri string
codeVerifier string
cancellationToken CancellationToken

Returns

Task<TokenResponse>

BuildAuthorizeUrl(string, string, string, string, string, string)

authorize URL 构造(PKCE S256;verifier 由调用方生成并保留到换取)。

public static string BuildAuthorizeUrl(string authorizationEndpoint, string clientId, string redirectUri, string scope, string state, string codeVerifier)

Parameters

authorizationEndpoint string
clientId string
redirectUri string
scope string
state string
codeVerifier string

Returns

string

ClientCredentialsAsync(string, string, string, string?, CancellationToken)

client_credentials。

public Task<TokenResponse> ClientCredentialsAsync(string tokenEndpoint, string clientId, string clientSecret, string? scope = null, CancellationToken cancellationToken = default)

Parameters

tokenEndpoint string
clientId string
clientSecret string
scope string
cancellationToken CancellationToken

Returns

Task<TokenResponse>

DeviceAuthorizeAsync(string, string, string?, string?, CancellationToken)

设备授权发起(WP9——RFC 8628 §3.1;public 客户端 secret 留空 = client_id 仅表单形态)。

public Task<DeviceAuthorization> DeviceAuthorizeAsync(string deviceAuthorizationEndpoint, string clientId, string? clientSecret, string? scope = null, CancellationToken cancellationToken = default)

Parameters

deviceAuthorizationEndpoint string
clientId string
clientSecret string
scope string
cancellationToken CancellationToken

Returns

Task<DeviceAuthorization>

DeviceTokenAsync(string, string, string?, string, CancellationToken)

设备轮询换取(WP9——一次轮询;错误不抛而以 DevicePollResult 返回—— authorization_pending / slow_down 是轮询循环的正常形态,调用方按 Error 分支续轮询/退避)。

public Task<DevicePollResult> DeviceTokenAsync(string tokenEndpoint, string clientId, string? clientSecret, string deviceCode, CancellationToken cancellationToken = default)

Parameters

tokenEndpoint string
clientId string
clientSecret string
deviceCode string
cancellationToken CancellationToken

Returns

Task<DevicePollResult>

NewCodeVerifier()

PKCE verifier 生成(43–128 字符 CSPRNG——RFC 7636 §4.1)。

public static string NewCodeVerifier()

Returns

string

RefreshAsync(string, string, string, string, CancellationToken)

refresh_token。

public Task<TokenResponse> RefreshAsync(string tokenEndpoint, string clientId, string clientSecret, string refreshToken, CancellationToken cancellationToken = default)

Parameters

tokenEndpoint string
clientId string
clientSecret string
refreshToken string
cancellationToken CancellationToken

Returns

Task<TokenResponse>

RevokeAsync(string, string, string, string, CancellationToken)

撤销(RFC 7009——无效 token 亦 200)。

public Task RevokeAsync(string revocationEndpoint, string clientId, string clientSecret, string token, CancellationToken cancellationToken = default)

Parameters

revocationEndpoint string
clientId string
clientSecret string
token string
cancellationToken CancellationToken

Returns

Task