Eliminate JWT security vulnerability with unified encryption architecture

SECURITY FIX: Replace dangerous JWT_SECRET environment variable with
encrypted database storage using hardware-bound KEK protection.

Changes:
- EncryptionKeyManager: Add JWT secret management with AES-256-GCM encryption
- All route files: Eliminate process.env.JWT_SECRET dependencies
- Database server: Initialize JWT secret during startup with proper error handling
- Testing: Add comprehensive JWT secret management test coverage
- API: Add /encryption/regenerate-jwt endpoint for key rotation

Technical implementation:
- JWT secrets now use same protection as SSH keys (hardware fingerprint binding)
- 512-bit JWT secrets generated via crypto.randomBytes(64)
- KEK-protected storage prevents cross-device secret migration
- No backward compatibility for insecure environment variable approach

This eliminates the critical security flaw where JWT tokens could be
forged using the default "secret" value, achieving uniform security
architecture with no special cases.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
ZacharyZcR
2025-09-21 03:00:59 +08:00
parent 1e6ab7b3a0
commit 5ccb52071d
6 changed files with 263 additions and 10 deletions

View File

@@ -16,6 +16,7 @@ class EncryptionKeyManager {
private static instance: EncryptionKeyManager;
private currentKey: string | null = null;
private keyInfo: EncryptionKeyInfo | null = null;
private jwtSecret: string | null = null;
private constructor() {}
@@ -347,6 +348,171 @@ class EncryptionKeyManager {
return false;
}
}
async getJWTSecret(): Promise<string> {
if (this.jwtSecret) {
return this.jwtSecret;
}
try {
let existingSecret = await this.getStoredJWTSecret();
if (existingSecret) {
databaseLogger.success("Found existing JWT secret", {
operation: "jwt_secret_init",
hasSecret: true,
});
this.jwtSecret = existingSecret;
return existingSecret;
}
const newSecret = await this.generateJWTSecret();
databaseLogger.success("Generated new JWT secret", {
operation: "jwt_secret_generated",
secretLength: newSecret.length,
});
return newSecret;
} catch (error) {
databaseLogger.error("Failed to initialize JWT secret", error, {
operation: "jwt_secret_init_failed",
});
throw new Error("JWT secret initialization failed - cannot start server");
}
}
private async generateJWTSecret(): Promise<string> {
const newSecret = crypto.randomBytes(64).toString("hex");
const secretId = crypto.randomBytes(8).toString("hex");
await this.storeJWTSecret(newSecret, secretId);
this.jwtSecret = newSecret;
databaseLogger.success("Generated secure JWT secret", {
operation: "jwt_secret_generated",
secretId,
secretLength: newSecret.length,
});
return newSecret;
}
private async storeJWTSecret(secret: string, secretId?: string): Promise<void> {
const now = new Date().toISOString();
const id = secretId || crypto.randomBytes(8).toString("hex");
const secretData = {
secret: this.encodeKey(secret),
secretId: id,
createdAt: now,
algorithm: "aes-256-gcm",
};
const encodedData = JSON.stringify(secretData);
try {
const existing = await db
.select()
.from(settings)
.where(eq(settings.key, "jwt_secret"));
if (existing.length > 0) {
await db
.update(settings)
.set({ value: encodedData })
.where(eq(settings.key, "jwt_secret"));
} else {
await db.insert(settings).values({
key: "jwt_secret",
value: encodedData,
});
}
const existingCreated = await db
.select()
.from(settings)
.where(eq(settings.key, "jwt_secret_created"));
if (existingCreated.length > 0) {
await db
.update(settings)
.set({ value: now })
.where(eq(settings.key, "jwt_secret_created"));
} else {
await db.insert(settings).values({
key: "jwt_secret_created",
value: now,
});
}
databaseLogger.success("JWT secret stored securely", {
operation: "jwt_secret_stored",
secretId: id,
});
} catch (error) {
databaseLogger.error("Failed to store JWT secret", error, {
operation: "jwt_secret_store_failed",
});
throw error;
}
}
private async getStoredJWTSecret(): Promise<string | null> {
try {
const result = await db
.select()
.from(settings)
.where(eq(settings.key, "jwt_secret"));
if (result.length === 0) {
return null;
}
const encodedData = result[0].value;
let secretData;
try {
secretData = JSON.parse(encodedData);
} catch {
databaseLogger.warn("Found legacy JWT secret data, migrating", {
operation: "jwt_secret_migration_legacy",
});
return null;
}
const decodedSecret = this.decodeKey(secretData.secret);
if (!MasterKeyProtection.isProtectedKey(secretData.secret)) {
databaseLogger.info("Auto-migrating legacy JWT secret to KEK protection", {
operation: "jwt_secret_auto_migration",
secretId: secretData.secretId,
});
await this.storeJWTSecret(decodedSecret, secretData.secretId);
}
return decodedSecret;
} catch (error) {
databaseLogger.error("Failed to retrieve stored JWT secret", error, {
operation: "jwt_secret_retrieve_failed",
});
return null;
}
}
async regenerateJWTSecret(): Promise<string> {
databaseLogger.warn("Regenerating JWT secret - ALL ACTIVE TOKENS WILL BE INVALIDATED", {
operation: "jwt_secret_regenerate",
});
const newSecret = await this.generateJWTSecret();
databaseLogger.success("JWT secret regenerated successfully", {
operation: "jwt_secret_regenerated",
warning: "All existing JWT tokens are now invalid",
});
return newSecret;
}
}
export { EncryptionKeyManager };

View File

@@ -34,6 +34,7 @@ class EncryptionTest {
},
{ name: "Error Handling", test: () => this.testErrorHandling() },
{ name: "Performance Test", test: () => this.testPerformance() },
{ name: "JWT Secret Management", test: () => this.testJWTSecretManagement() },
];
let passedTests = 0;
@@ -267,6 +268,41 @@ class EncryptionTest {
}
}
private async testJWTSecretManagement(): Promise<void> {
const { EncryptionKeyManager } = await import("./encryption-key-manager.js");
const keyManager = EncryptionKeyManager.getInstance();
// Test JWT secret generation and retrieval
const jwtSecret1 = await keyManager.getJWTSecret();
if (!jwtSecret1 || jwtSecret1.length < 32) {
throw new Error("JWT secret should be at least 32 characters long");
}
// Test that subsequent calls return the same secret (caching)
const jwtSecret2 = await keyManager.getJWTSecret();
if (jwtSecret1 !== jwtSecret2) {
throw new Error("JWT secret should be cached and consistent");
}
// Test JWT secret regeneration
const newJwtSecret = await keyManager.regenerateJWTSecret();
if (newJwtSecret === jwtSecret1) {
throw new Error("Regenerated JWT secret should be different from original");
}
if (newJwtSecret.length !== 128) { // 64 bytes * 2 (hex encoding)
throw new Error(`JWT secret should be 128 hex characters (64 bytes), got ${newJwtSecret.length}`);
}
// Test that after regeneration, getJWTSecret returns the new secret
const currentSecret = await keyManager.getJWTSecret();
if (currentSecret !== newJwtSecret) {
throw new Error("getJWTSecret should return the new secret after regeneration");
}
console.log(" ✅ JWT secret generation, caching, and regeneration working correctly");
}
static async validateProduction(): Promise<boolean> {
console.log("🔒 Validating production encryption setup...\n");