重組前檢查點:根目錄 main package

internal/jwk/jwk.go

@@ -0,0 +1,26 @@
+// Package jwk 提供簽發 JWT（ID Token／Access Token）所用金鑰的資料模型，
+// 以及其 RFC 7517 JWK／JWKS 公開表示法，供 /.well-known/jwks.json 發佈。
+package jwk
+
+// JWK 參數的註冊值（RFC 7517 的 kty／use、RFC 7518 的 alg）。
+const (
+	KeyTypeRSA = "RSA"   // kty：金鑰類型
+	KeyUseSig  = "sig"   // use：簽章用途
+	AlgRS256   = "RS256" // alg：RSASSA-PKCS1-v1_5 搭配 SHA-256
+)
+
+// JWK 為單一把金鑰的公開形式（RFC 7517），僅含 RP 驗證 JWT 簽章所需的
+// 參數；私有參數（d、p、q、dp、dq、qi）依規範與安全考量絕不序列化。
+type JWK struct {
+	Kty string `json:"kty"`           // 金鑰類型（RSA）
+	Use string `json:"use"`           // 用途（sig）
+	Kid string `json:"kid"`           // 金鑰 ID，對應 JWT header 的 kid
+	Alg string `json:"alg,omitempty"` // 建議演算法（RS256）
+	N   string `json:"n"`             // RSA modulus，base64url 無填充
+	E   string `json:"e"`             // RSA 公開指數，同上（65537 時為 "AQAB"）
+}
+
+// JWKS 為 JWK Set（RFC 7517 §5），/.well-known/jwks.json 的回應格式。
+type JWKS struct {
+	Keys []JWK `json:"keys"`
+}