Verify OAuth2 ID tokens before trusting claims

The compliance portal OAuth callback accepted ID tokens after only
parsing claims, without checking the signature, issuer, audience, or
expiry. Add RS256 verification helpers to the JOSE package, enforce
those checks in ParseIDTokenIdentity, and thread JWKS, issuer, and
client ID through the token response and callback handler.

Signed-off-by: Bryan Frimin <bryan@probo.com>
This commit is contained in:
Bryan Frimin
2026-07-15 14:38:37 +02:00
parent 4e73bd6a97
commit 48dba254ca
6 changed files with 711 additions and 4 deletions

View File

@@ -29,6 +29,7 @@ import (
"encoding/json"
"fmt"
"math/big"
"strings"
)
type (
@@ -103,3 +104,106 @@ func SignJWT(privateKey *rsa.PrivateKey, kid string, claims any) (string, error)
return signingInput + "." + signatureB64, nil
}
// RSAPublicKeyFromJWK reconstructs an RSA public key from a JWK.
func RSAPublicKeyFromJWK(jwk JWK) (*rsa.PublicKey, error) {
if jwk.KeyType != "RSA" {
return nil, fmt.Errorf("cannot convert jwk to rsa public key: unsupported key type %q", jwk.KeyType)
}
nBytes, err := base64.RawURLEncoding.DecodeString(jwk.N)
if err != nil {
return nil, fmt.Errorf("cannot decode rsa modulus: %w", err)
}
eBytes, err := base64.RawURLEncoding.DecodeString(jwk.E)
if err != nil {
return nil, fmt.Errorf("cannot decode rsa exponent: %w", err)
}
return &rsa.PublicKey{
N: new(big.Int).SetBytes(nBytes),
E: int(new(big.Int).SetBytes(eBytes).Int64()),
}, nil
}
// PublicKeyFromJWKS returns the RSA public key matching the given key ID.
func PublicKeyFromJWKS(jwks *JWKS, kid string) (*rsa.PublicKey, error) {
for _, key := range jwks.Keys {
if key.KeyID == kid {
return RSAPublicKeyFromJWK(key)
}
}
return nil, fmt.Errorf("cannot find signing key %q in jwks", kid)
}
// VerifyJWT verifies an RS256 JWT signature and returns the decoded payload.
func VerifyJWT(raw string, pubKey *rsa.PublicKey) ([]byte, error) {
parts := strings.Split(raw, ".")
if len(parts) != 3 {
return nil, fmt.Errorf("cannot verify jwt: invalid format")
}
headerJSON, err := base64.RawURLEncoding.DecodeString(parts[0])
if err != nil {
return nil, fmt.Errorf("cannot decode jwt header: %w", err)
}
var header JWTHeader
if err := json.Unmarshal(headerJSON, &header); err != nil {
return nil, fmt.Errorf("cannot parse jwt header: %w", err)
}
if header.Algorithm != "RS256" {
return nil, fmt.Errorf("cannot verify jwt: unsupported algorithm %q", header.Algorithm)
}
payload, err := base64.RawURLEncoding.DecodeString(parts[1])
if err != nil {
return nil, fmt.Errorf("cannot decode jwt payload: %w", err)
}
signature, err := base64.RawURLEncoding.DecodeString(parts[2])
if err != nil {
return nil, fmt.Errorf("cannot decode jwt signature: %w", err)
}
signedContent := parts[0] + "." + parts[1]
hash := sha256.Sum256([]byte(signedContent))
if err := rsa.VerifyPKCS1v15(pubKey, crypto.SHA256, hash[:], signature); err != nil {
return nil, fmt.Errorf("cannot verify jwt signature: %w", err)
}
return payload, nil
}
// VerifyJWTWithJWKS verifies an RS256 JWT using the matching key from a JWKS.
func VerifyJWTWithJWKS(raw string, jwks *JWKS) ([]byte, error) {
parts := strings.Split(raw, ".")
if len(parts) != 3 {
return nil, fmt.Errorf("cannot verify jwt: invalid format")
}
headerJSON, err := base64.RawURLEncoding.DecodeString(parts[0])
if err != nil {
return nil, fmt.Errorf("cannot decode jwt header: %w", err)
}
var header JWTHeader
if err := json.Unmarshal(headerJSON, &header); err != nil {
return nil, fmt.Errorf("cannot parse jwt header: %w", err)
}
if header.KeyID == "" {
return nil, fmt.Errorf("cannot verify jwt: missing key id")
}
pubKey, err := PublicKeyFromJWKS(jwks, header.KeyID)
if err != nil {
return nil, err
}
return VerifyJWT(raw, pubKey)
}

View File

@@ -297,3 +297,266 @@ func TestJWTHeader_JSON(t *testing.T) {
},
)
}
func TestRSAPublicKeyFromJWK(t *testing.T) {
t.Parallel()
key := testRSAKey(t)
jwk := jose.RSAPublicKeyToJWK(&key.PublicKey, "kid-1")
t.Run(
"round trips rsa public key",
func(t *testing.T) {
t.Parallel()
pubKey, err := jose.RSAPublicKeyFromJWK(jwk)
require.NoError(t, err)
assert.Equal(t, key.N, pubKey.N)
assert.Equal(t, key.E, pubKey.E)
},
)
t.Run(
"rejects unsupported key type",
func(t *testing.T) {
t.Parallel()
_, err := jose.RSAPublicKeyFromJWK(jose.JWK{KeyType: "EC"})
require.Error(t, err)
},
)
}
func TestPublicKeyFromJWKS(t *testing.T) {
t.Parallel()
key := testRSAKey(t)
jwks := &jose.JWKS{
Keys: []jose.JWK{
jose.RSAPublicKeyToJWK(&key.PublicKey, "kid-1"),
jose.RSAPublicKeyToJWK(&key.PublicKey, "kid-2"),
},
}
t.Run(
"finds matching key",
func(t *testing.T) {
t.Parallel()
pubKey, err := jose.PublicKeyFromJWKS(jwks, "kid-2")
require.NoError(t, err)
assert.Equal(t, key.E, pubKey.E)
},
)
t.Run(
"errors when kid is missing",
func(t *testing.T) {
t.Parallel()
_, err := jose.PublicKeyFromJWKS(jwks, "missing")
require.Error(t, err)
},
)
}
func TestVerifyJWT(t *testing.T) {
t.Parallel()
key := testRSAKey(t)
t.Run(
"verifies signed jwt",
func(t *testing.T) {
t.Parallel()
claims := map[string]string{"sub": "test"}
token, err := jose.SignJWT(key, "kid-1", claims)
require.NoError(t, err)
payload, err := jose.VerifyJWT(token, &key.PublicKey)
require.NoError(t, err)
var decoded map[string]string
err = json.Unmarshal(payload, &decoded)
require.NoError(t, err)
assert.Equal(t, "test", decoded["sub"])
},
)
t.Run(
"rejects malformed jwt",
func(t *testing.T) {
t.Parallel()
_, err := jose.VerifyJWT("", &key.PublicKey)
require.Error(t, err)
_, err = jose.VerifyJWT("only-one-part", &key.PublicKey)
require.Error(t, err)
_, err = jose.VerifyJWT("two.parts", &key.PublicKey)
require.Error(t, err)
_, err = jose.VerifyJWT("too.many.parts.here", &key.PublicKey)
require.Error(t, err)
},
)
t.Run(
"rejects tampered payload",
func(t *testing.T) {
t.Parallel()
token, err := jose.SignJWT(key, "kid-1", map[string]string{"sub": "test"})
require.NoError(t, err)
parts := strings.Split(token, ".")
parts[1] = base64.RawURLEncoding.EncodeToString([]byte(`{"sub":"evil"}`))
tampered := strings.Join(parts, ".")
_, err = jose.VerifyJWT(tampered, &key.PublicKey)
require.Error(t, err)
},
)
t.Run(
"rejects tampered header",
func(t *testing.T) {
t.Parallel()
token, err := jose.SignJWT(key, "kid-1", map[string]string{"sub": "test"})
require.NoError(t, err)
parts := strings.Split(token, ".")
parts[0] = base64.RawURLEncoding.EncodeToString([]byte(`{"alg":"HS256","typ":"JWT","kid":"kid-1"}`))
tampered := strings.Join(parts, ".")
_, err = jose.VerifyJWT(tampered, &key.PublicKey)
require.Error(t, err)
},
)
t.Run(
"rejects unsupported algorithm",
func(t *testing.T) {
t.Parallel()
cases := []struct {
name string
alg string
}{
{name: "hs256", alg: "HS256"},
{name: "none", alg: "none"},
{name: "lowercase rs256", alg: "rs256"},
}
for _, tc := range cases {
t.Run(
tc.name,
func(t *testing.T) {
t.Parallel()
header := base64.RawURLEncoding.EncodeToString(
[]byte(`{"alg":"` + tc.alg + `","typ":"JWT","kid":"kid-1"}`),
)
payload := base64.RawURLEncoding.EncodeToString([]byte(`{"sub":"test"}`))
token := header + "." + payload + ".c2ln"
_, err := jose.VerifyJWT(token, &key.PublicKey)
require.Error(t, err)
},
)
}
},
)
t.Run(
"rejects signature from different key",
func(t *testing.T) {
t.Parallel()
otherKey := testRSAKey(t)
token, err := jose.SignJWT(otherKey, "kid-1", map[string]string{"sub": "test"})
require.NoError(t, err)
_, err = jose.VerifyJWT(token, &key.PublicKey)
require.Error(t, err)
},
)
}
func TestVerifyJWTWithJWKS(t *testing.T) {
t.Parallel()
key := testRSAKey(t)
jwks := &jose.JWKS{
Keys: []jose.JWK{
jose.RSAPublicKeyToJWK(&key.PublicKey, "kid-1"),
},
}
t.Run(
"verifies signed jwt",
func(t *testing.T) {
t.Parallel()
token, err := jose.SignJWT(key, "kid-1", map[string]string{"sub": "test"})
require.NoError(t, err)
payload, err := jose.VerifyJWTWithJWKS(token, jwks)
require.NoError(t, err)
var decoded map[string]string
err = json.Unmarshal(payload, &decoded)
require.NoError(t, err)
assert.Equal(t, "test", decoded["sub"])
},
)
t.Run(
"rejects missing key id",
func(t *testing.T) {
t.Parallel()
header := base64.RawURLEncoding.EncodeToString([]byte(`{"alg":"RS256","typ":"JWT"}`))
payload := base64.RawURLEncoding.EncodeToString([]byte(`{"sub":"test"}`))
token := header + "." + payload + ".c2ln"
_, err := jose.VerifyJWTWithJWKS(token, jwks)
require.Error(t, err)
},
)
t.Run(
"rejects unknown key id",
func(t *testing.T) {
t.Parallel()
token, err := jose.SignJWT(key, "unknown-kid", map[string]string{"sub": "test"})
require.NoError(t, err)
_, err = jose.VerifyJWTWithJWKS(token, jwks)
require.Error(t, err)
},
)
t.Run(
"rejects token signed with key outside jwks",
func(t *testing.T) {
t.Parallel()
otherKey := testRSAKey(t)
token, err := jose.SignJWT(otherKey, "kid-1", map[string]string{"sub": "test"})
require.NoError(t, err)
_, err = jose.VerifyJWTWithJWKS(token, jwks)
require.Error(t, err)
},
)
}