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
httpClientHttpClient
TokenClient(HttpClient, ECDsa)
构造(DPoP 形态——WP11:dpopKey 在位 = 全请求自动携 proof
(htm/htu/iat/jti [+ath]);access token 签发即 cnf.jkt 绑定)。
public TokenClient(HttpClient httpClient, ECDsa dpopKey)
Parameters
httpClientHttpClientdpopKeyECDsa
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
tokenEndpointstringclientIdstringclientSecretstringcodestringredirectUristringcodeVerifierstringcancellationTokenCancellationToken
Returns
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
authorizationEndpointstringclientIdstringredirectUristringscopestringstatestringcodeVerifierstring
Returns
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
tokenEndpointstringclientIdstringclientSecretstringscopestringcancellationTokenCancellationToken
Returns
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
deviceAuthorizationEndpointstringclientIdstringclientSecretstringscopestringcancellationTokenCancellationToken
Returns
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
tokenEndpointstringclientIdstringclientSecretstringdeviceCodestringcancellationTokenCancellationToken
Returns
NewCodeVerifier()
PKCE verifier 生成(43–128 字符 CSPRNG——RFC 7636 §4.1)。
public static string NewCodeVerifier()
Returns
RefreshAsync(string, string, string, string, CancellationToken)
refresh_token。
public Task<TokenResponse> RefreshAsync(string tokenEndpoint, string clientId, string clientSecret, string refreshToken, CancellationToken cancellationToken = default)
Parameters
tokenEndpointstringclientIdstringclientSecretstringrefreshTokenstringcancellationTokenCancellationToken
Returns
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
revocationEndpointstringclientIdstringclientSecretstringtokenstringcancellationTokenCancellationToken