using System; using System.Text; using System.Text.Json; using System.Threading.Tasks; namespace CarpaNet.OAuth.Crypto; /// /// Creates client assertion JWTs for private_key_jwt authentication (RFC 7523). /// public static class ClientAssertion { /// /// The client assertion type URN. /// public const string AssertionType = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"; /// /// Creates a client assertion JWT. /// /// The client ID. /// The token endpoint URL or issuer. /// The signing key pair. /// Optional key ID to include in the header. /// A signed JWT for client authentication. /// /// On browser platforms, use instead. /// public static string Create(string clientId, string audience, DPoPKeyPair keyPair, string? keyId = null) { var (headerBase64, payloadBase64) = BuildComponents(clientId, audience, keyPair, keyId); var signingInput = $"{headerBase64}.{payloadBase64}"; var signature = keyPair.SignData(Encoding.UTF8.GetBytes(signingInput)); var signatureBase64 = Pkce.Base64UrlEncode(signature); return $"{signingInput}.{signatureBase64}"; } /// /// Creates a client assertion JWT asynchronously. Works on all platforms including browser. /// /// The client ID. /// The token endpoint URL or issuer. /// The signing key pair. /// Optional key ID to include in the header. /// A signed JWT for client authentication. public static async Task CreateAsync(string clientId, string audience, DPoPKeyPair keyPair, string? keyId = null) { var (headerBase64, payloadBase64) = BuildComponents(clientId, audience, keyPair, keyId); var signingInput = $"{headerBase64}.{payloadBase64}"; var signature = await keyPair.SignDataAsync(Encoding.UTF8.GetBytes(signingInput)).ConfigureAwait(false); var signatureBase64 = Pkce.Base64UrlEncode(signature); return $"{signingInput}.{signatureBase64}"; } private static (string HeaderBase64, string PayloadBase64) BuildComponents( string clientId, string audience, DPoPKeyPair keyPair, string? keyId) { var now = DateTimeOffset.UtcNow; // Build header var header = new JwtHeader { Alg = keyPair.Algorithm, Typ = "JWT", Kid = string.IsNullOrEmpty(keyId) ? null : keyId }; // Build payload var payload = new ClientAssertionPayload { Iss = clientId, Sub = clientId, Aud = audience, Jti = Pkce.GenerateNonce(16), Iat = now.ToUnixTimeSeconds(), Exp = now.AddMinutes(1).ToUnixTimeSeconds() }; var headerJson = JsonSerializer.Serialize(header, OAuthJsonContext.Default.JwtHeader); var payloadJson = JsonSerializer.Serialize(payload, OAuthJsonContext.Default.ClientAssertionPayload); var headerBase64 = Pkce.Base64UrlEncode(Encoding.UTF8.GetBytes(headerJson)); var payloadBase64 = Pkce.Base64UrlEncode(Encoding.UTF8.GetBytes(payloadJson)); return (headerBase64, payloadBase64); } }