Migrate all test files from SetupTestDB/db.DB pattern to per-test transactions: - Replace SetupTestDB(t) with SetupTestTx(t) for context + transaction - Replace db.DB.Query/QueryRow/Exec with tx.Query/QueryRow/Exec - Replace context.Background() with context from SetupTestTx - Replace defer rows.Close() pattern with explicit rows.Close() - Add testdb.SeedBaseline(pool) to all TestMain functions - Wire db.Conn = db.NewPoolProxy(pool) in all TestMain functions Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
285 lines
8.6 KiB
Go
285 lines
8.6 KiB
Go
//go:build test
|
|
// +build test
|
|
|
|
package auth
|
|
|
|
// Package auth contains tests for JWT generation, verification, and JTI revocation.
|
|
//
|
|
// Test Coverage:
|
|
// - generateJTI: UUID v4 format validation, uniqueness
|
|
// - GenerateToken: returns non-empty token and JTI, JTI matches claim
|
|
// - VerifyToken: returns correct user_id/role/JTI, rejects revoked/missing JTI
|
|
// - RevokeJTI: adds to revoked set, IsJTIRevoked reflects changes
|
|
// - CleanupRevokedJTIs: removes expired JTIs, keeps valid ones
|
|
|
|
import (
|
|
"context"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
|
|
"crussell/testutils/testtx"
|
|
)
|
|
|
|
// =============================================================================
|
|
// generateJTI Tests
|
|
// =============================================================================
|
|
|
|
// TestGenerateJTI_Format verifies that generateJTI returns a valid UUID v4 string
|
|
// in the format: 8-4-4-4-12 hexadecimal digits with version and variant bits set.
|
|
func TestGenerateJTI_Format(t *testing.T) {
|
|
jti, err := generateJTI()
|
|
if err != nil {
|
|
t.Fatalf("generateJTI() failed: %v", err)
|
|
}
|
|
|
|
// UUID v4 format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
|
|
parts := strings.Split(jti, "-")
|
|
if len(parts) != 5 {
|
|
t.Errorf("expected 5 parts in UUID, got %d: %s", len(parts), jti)
|
|
}
|
|
|
|
// Check each part length: 8-4-4-4-12
|
|
expectedLengths := []int{8, 4, 4, 4, 12}
|
|
for i, part := range parts {
|
|
if len(part) != expectedLengths[i] {
|
|
t.Errorf("part %d expected length %d, got %d (jti=%s)", i, expectedLengths[i], len(part), jti)
|
|
}
|
|
}
|
|
|
|
// Check version nibble (4xxx) in the third group
|
|
if len(parts[2]) > 0 && parts[2][0] != '4' {
|
|
t.Errorf("expected version 4 UUID, got version %c in jti=%s", parts[2][0], jti)
|
|
}
|
|
|
|
// Check variant bits (8xxx, 9xxx, axxx, or bxxx) in the fourth group
|
|
if len(parts[3]) > 0 {
|
|
c := parts[3][0]
|
|
if c != '8' && c != '9' && c != 'a' && c != 'b' {
|
|
t.Errorf("expected variant bits 10xx, got %c in jti=%s", c, jti)
|
|
}
|
|
}
|
|
}
|
|
|
|
// TestGenerateJTI_Unique generates 100 JTIs and verifies all are unique.
|
|
func TestGenerateJTI_Unique(t *testing.T) {
|
|
seen := make(map[string]bool)
|
|
for i := 0; i < 100; i++ {
|
|
jti, err := generateJTI()
|
|
if err != nil {
|
|
t.Fatalf("generateJTI() failed at iteration %d: %v", i, err)
|
|
}
|
|
if seen[jti] {
|
|
t.Errorf("duplicate JTI generated at iteration %d: %s", i, jti)
|
|
}
|
|
seen[jti] = true
|
|
}
|
|
|
|
if len(seen) != 100 {
|
|
t.Errorf("expected 100 unique JTIs, got %d", len(seen))
|
|
}
|
|
}
|
|
|
|
// =============================================================================
|
|
// GenerateToken Tests
|
|
// =============================================================================
|
|
|
|
// TestGenerateToken_ReturnsJTI verifies that GenerateToken returns both a
|
|
// non-empty token string and a non-empty JTI string.
|
|
func TestGenerateToken_ReturnsJTI(t *testing.T) {
|
|
token, jti, err := GenerateToken("user-001", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
if token == "" {
|
|
t.Error("expected non-empty token")
|
|
}
|
|
if jti == "" {
|
|
t.Error("expected non-empty JTI")
|
|
}
|
|
}
|
|
|
|
// TestGenerateToken_JTIInClaims decodes the generated token and verifies
|
|
// the "jti" claim matches the returned JTI value.
|
|
func TestGenerateToken_JTIInClaims(t *testing.T) {
|
|
token, jti, err := GenerateToken("user-002", "admin")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
decoded, err := TokenAuth.Decode(token)
|
|
if err != nil {
|
|
t.Fatalf("failed to decode token: %v", err)
|
|
}
|
|
|
|
var claimJTI string
|
|
if err := decoded.Get("jti", &claimJTI); err != nil {
|
|
t.Fatalf("failed to get jti claim: %v", err)
|
|
}
|
|
|
|
if claimJTI != jti {
|
|
t.Errorf("expected jti claim %q, got %q", jti, claimJTI)
|
|
}
|
|
}
|
|
|
|
// =============================================================================
|
|
// VerifyToken Tests
|
|
// =============================================================================
|
|
|
|
// TestVerifyToken_ReturnsJTI creates a token, verifies it, and checks the
|
|
// returned user_id, role, and JTI match the expected values.
|
|
func TestVerifyToken_ReturnsJTI(t *testing.T) {
|
|
ctx, _ := testtx.SetupTestTx(t)
|
|
token, jti, err := GenerateToken("user-003", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
userID, role, returnedJTI, err := VerifyToken(token, ctx)
|
|
if err != nil {
|
|
t.Fatalf("VerifyToken() failed: %v", err)
|
|
}
|
|
|
|
if userID != "user-003" {
|
|
t.Errorf("expected userID 'user-003', got %q", userID)
|
|
}
|
|
if role != "verified_email" {
|
|
t.Errorf("expected role 'verified_email', got %q", role)
|
|
}
|
|
if returnedJTI != jti {
|
|
t.Errorf("expected JTI %q, got %q", jti, returnedJTI)
|
|
}
|
|
}
|
|
|
|
// TestVerifyToken_RevokedJTI creates a token, revokes its JTI, and verifies
|
|
// that VerifyToken returns an error containing "token revoked".
|
|
func TestVerifyToken_RevokedJTI(t *testing.T) {
|
|
ctx, _ := testtx.SetupTestTx(t)
|
|
token, jti, err := GenerateToken("user-004", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
RevokeJTI(ctx, jti, time.Now().Add(30*24*time.Hour))
|
|
|
|
_, _, _, err = VerifyToken(token, ctx)
|
|
if err == nil {
|
|
t.Fatal("expected error for revoked JTI, got nil")
|
|
}
|
|
if !strings.Contains(err.Error(), "token revoked") {
|
|
t.Errorf("expected 'token revoked' error, got: %v", err)
|
|
}
|
|
}
|
|
|
|
// TestVerifyToken_MissingJTI creates a token without a "jti" claim (using
|
|
// TokenAuth.Encode directly) and verifies that VerifyToken returns an error
|
|
// containing "invalid jti claim".
|
|
func TestVerifyToken_MissingJTI(t *testing.T) {
|
|
_, tokenString, err := TokenAuth.Encode(map[string]interface{}{
|
|
"user_id": "user-005",
|
|
"role": "verified_email",
|
|
"exp": time.Now().Add(30 * 24 * time.Hour).Unix(),
|
|
})
|
|
if err != nil {
|
|
t.Fatalf("failed to create token without JTI: %v", err)
|
|
}
|
|
|
|
_, _, _, err = VerifyToken(tokenString, context.Background())
|
|
if err == nil {
|
|
t.Fatal("expected error for missing JTI, got nil")
|
|
}
|
|
if !strings.Contains(err.Error(), "invalid jti claim") {
|
|
t.Errorf("expected 'invalid jti claim' error, got: %v", err)
|
|
}
|
|
}
|
|
|
|
// =============================================================================
|
|
// RevokeJTI / IsJTIRevoked Tests
|
|
// =============================================================================
|
|
|
|
// TestRevokeJTI_AddsToSet verifies that calling RevokeJTI adds the JTI to the
|
|
// revoked set, and IsJTIRevoked returns true for it.
|
|
func TestRevokeJTI_AddsToSet(t *testing.T) {
|
|
ctx, _ := testtx.SetupTestTx(t)
|
|
_, jti, err := GenerateToken("user-006", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
if IsJTIRevoked(ctx, jti) {
|
|
t.Fatal("JTI should not be revoked before calling RevokeJTI")
|
|
}
|
|
|
|
RevokeJTI(ctx, jti, time.Now().Add(30*24*time.Hour))
|
|
|
|
if !IsJTIRevoked(ctx, jti) {
|
|
t.Error("expected IsJTIRevoked to return true after RevokeJTI")
|
|
}
|
|
}
|
|
|
|
// TestIsJTIRevoked_NonExistent verifies that checking a non-existent JTI
|
|
// returns false.
|
|
func TestIsJTIRevoked_NonExistent(t *testing.T) {
|
|
ctx, _ := testtx.SetupTestTx(t)
|
|
if IsJTIRevoked(ctx, "nonexistent-jti-12345") {
|
|
t.Error("expected IsJTIRevoked to return false for non-existent JTI")
|
|
}
|
|
}
|
|
|
|
// =============================================================================
|
|
// CleanupRevokedJTIs Tests
|
|
// =============================================================================
|
|
|
|
// TestCleanupRevokedJTIs_RemovesExpired adds a JTI with a past expiry time,
|
|
// runs CleanupRevokedJTIs, and verifies the JTI is removed from the set.
|
|
func TestCleanupRevokedJTIs_RemovesExpired(t *testing.T) {
|
|
ctx, tx := testtx.SetupTestTx(t)
|
|
_, jti, err := GenerateToken("user-007", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
// Add with future expiry so IsJTIRevoked sees it
|
|
RevokeJTI(ctx, jti, time.Now().Add(1*time.Hour))
|
|
|
|
if !IsJTIRevoked(ctx, jti) {
|
|
t.Fatal("JTI should be in revoked set after RevokeJTI")
|
|
}
|
|
|
|
// Directly update the DB to set expiry in the past
|
|
_, err = tx.Exec(ctx,
|
|
"UPDATE revoked_jtis SET expires_at = NOW() - INTERVAL '1 hour' WHERE jti = $1", jti)
|
|
if err != nil {
|
|
t.Fatalf("failed to expire JTI: %v", err)
|
|
}
|
|
|
|
CleanupRevokedJTIs(ctx)
|
|
|
|
if IsJTIRevoked(ctx, jti) {
|
|
t.Error("expected expired JTI to be removed after cleanup")
|
|
}
|
|
}
|
|
|
|
// TestCleanupRevokedJTIs_KeepsValid adds a JTI with a future expiry time,
|
|
// runs CleanupRevokedJTIs, and verifies the JTI is still in the set.
|
|
func TestCleanupRevokedJTIs_KeepsValid(t *testing.T) {
|
|
ctx, _ := testtx.SetupTestTx(t)
|
|
_, jti, err := GenerateToken("user-008", "verified_email")
|
|
if err != nil {
|
|
t.Fatalf("GenerateToken() failed: %v", err)
|
|
}
|
|
|
|
// Add with future expiry
|
|
RevokeJTI(ctx, jti, time.Now().Add(30*24*time.Hour))
|
|
|
|
if !IsJTIRevoked(ctx, jti) {
|
|
t.Fatal("JTI should be in revoked set before cleanup")
|
|
}
|
|
|
|
CleanupRevokedJTIs(ctx)
|
|
|
|
if !IsJTIRevoked(ctx, jti) {
|
|
t.Error("expected valid (future expiry) JTI to remain after cleanup")
|
|
}
|
|
}
|