fix(tenant): prevent api_key encryption loss on tenant settings update

When a tenant setting is updated via PUT /tenants/kv/{key} (e.g.,
retrieval-config, parser-engine-config), the GORM AfterFind-decrypted
plaintext api_key was silently written back to the database because
db.Updates() does not trigger the BeforeSave hook.

Guard the repository's UpdateTenant to skip writing plaintext api_key
back to the database. Pre-encrypted values (enc:v1:… from CreateTenant
/ UpdateAPIKey) are written as-is; AfterFind-decrypted plaintext is
blanked so GORM skips the column entirely.

Closes #798
This commit is contained in:
ochan.kwon
2026-03-25 11:22:31 +09:00
committed by lyingbug
parent be6e289bc9
commit 8d8cc051be
3 changed files with 286 additions and 2 deletions
+23 -2
View File
@@ -3,10 +3,12 @@ package repository
import (
"context"
"errors"
"strings"
"github.com/Tencent/WeKnora/internal/logger"
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/types/interfaces"
"github.com/Tencent/WeKnora/internal/utils"
"gorm.io/gorm"
"gorm.io/gorm/clause"
)
@@ -93,9 +95,28 @@ func (r *tenantRepository) SearchTenants(ctx context.Context, keyword string, te
return tenants, total, nil
}
// UpdateTenant updates tenant
// UpdateTenant updates tenant.
// Handles api_key carefully because db.Updates() does not trigger the BeforeSave
// GORM hook. Without this guard, AfterFind-decrypted plaintext would silently
// overwrite the encrypted value in the database.
//
// Strategy:
// - enc:v1:… (pre-encrypted by CreateTenant / UpdateAPIKey): write as-is.
// - plaintext (decrypted by AfterFind): blank it so GORM skips the column.
// - SYSTEM_AES_KEY not set: write as-is (encryption disabled).
//
// The caller's in-memory struct is always restored after the write.
func (r *tenantRepository) UpdateTenant(ctx context.Context, tenant *types.Tenant) error {
return r.db.WithContext(ctx).Model(&types.Tenant{}).Where("id = ?", tenant.ID).Updates(tenant).Error
origAPIKey := tenant.APIKey
if key := utils.GetAESKey(); key != nil && tenant.APIKey != "" &&
!strings.HasPrefix(tenant.APIKey, utils.EncPrefix) {
// Plaintext from AfterFind — do not write back; let the DB keep its
// existing encrypted value untouched.
tenant.APIKey = ""
}
err := r.db.WithContext(ctx).Model(&types.Tenant{}).Where("id = ?", tenant.ID).Updates(tenant).Error
tenant.APIKey = origAPIKey
return err
}
// DeleteTenant deletes tenant
@@ -0,0 +1,168 @@
package repository
import (
"context"
"testing"
"time"
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/utils"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"gorm.io/driver/sqlite"
"gorm.io/gorm"
)
const testAESKey = "01234567890123456789012345678901" // 32 bytes
// setupTestDB creates an in-memory SQLite database with tenant table.
func setupTestDB(t *testing.T) *gorm.DB {
t.Helper()
db, err := gorm.Open(sqlite.Open(":memory:"), &gorm.Config{})
require.NoError(t, err)
require.NoError(t, db.AutoMigrate(&types.Tenant{}))
return db
}
// insertTenantRaw inserts a tenant row with the given api_key value directly,
// bypassing GORM hooks, to simulate an already-encrypted row in the DB.
func insertTenantRaw(t *testing.T, db *gorm.DB, id uint64, apiKey string) {
t.Helper()
now := time.Now()
err := db.Exec(
"INSERT INTO tenants (id, name, api_key, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)",
id, "test-tenant", apiKey, "active", now, now,
).Error
require.NoError(t, err)
}
// readAPIKeyRaw reads the raw api_key value from the database, bypassing GORM hooks.
func readAPIKeyRaw(t *testing.T, db *gorm.DB, id uint64) string {
t.Helper()
var apiKey string
err := db.Raw("SELECT api_key FROM tenants WHERE id = ?", id).Scan(&apiKey).Error
require.NoError(t, err)
return apiKey
}
func TestUpdateTenant_PreservesEncryptedAPIKey(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", testAESKey)
db := setupTestDB(t)
key := utils.GetAESKey()
require.NotNil(t, key)
// Encrypt a known api_key and insert it directly into the DB.
originalPlaintext := "sk-my-secret-api-key"
encrypted, err := utils.EncryptAESGCM(originalPlaintext, key)
require.NoError(t, err)
insertTenantRaw(t, db, 1, encrypted)
// Verify the raw DB value is encrypted.
rawBefore := readAPIKeyRaw(t, db, 1)
assert.True(t, isEncrypted(rawBefore), "api_key should be encrypted in DB before update")
// Simulate what happens in the application:
// 1. Load tenant (AfterFind decrypts api_key)
var tenant types.Tenant
require.NoError(t, db.First(&tenant, 1).Error)
assert.Equal(t, originalPlaintext, tenant.APIKey, "AfterFind should decrypt api_key")
// 2. Modify a non-key field (simulating a config update via UpdateTenantKV)
tenant.Description = "updated description"
// 3. Save via repository's UpdateTenant
repo := NewTenantRepository(db)
require.NoError(t, repo.UpdateTenant(context.Background(), &tenant))
// 4. Verify: raw DB value must still be encrypted AND unchanged (no unnecessary re-encryption)
rawAfter := readAPIKeyRaw(t, db, 1)
assert.True(t, isEncrypted(rawAfter), "api_key must remain encrypted in DB after update")
assert.Equal(t, rawBefore, rawAfter, "api_key column should not be touched when only other fields change")
// 5. Verify: the in-memory struct should still have the decrypted value
assert.Equal(t, originalPlaintext, tenant.APIKey, "caller's struct should retain decrypted value")
// 6. Verify: round-trip — re-read from DB and decrypt
var reloaded types.Tenant
require.NoError(t, db.First(&reloaded, 1).Error)
assert.Equal(t, originalPlaintext, reloaded.APIKey, "re-loaded api_key should decrypt correctly")
assert.Equal(t, "updated description", reloaded.Description, "description should be updated")
}
func TestUpdateTenant_PreEncryptedAPIKeyIsWritten(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", testAESKey)
db := setupTestDB(t)
key := utils.GetAESKey()
require.NotNil(t, key)
// Insert a tenant with an initial encrypted api_key.
initialEncrypted, err := utils.EncryptAESGCM("sk-old-key", key)
require.NoError(t, err)
insertTenantRaw(t, db, 4, initialEncrypted)
// Simulate CreateTenant / UpdateAPIKey path:
// The service layer manually encrypts BEFORE calling repo.UpdateTenant.
newEncrypted, err := utils.EncryptAESGCM("sk-new-key", key)
require.NoError(t, err)
tenant := &types.Tenant{ID: 4, APIKey: newEncrypted}
repo := NewTenantRepository(db)
require.NoError(t, repo.UpdateTenant(context.Background(), tenant))
// The pre-encrypted value should be written to DB as-is.
rawAfter := readAPIKeyRaw(t, db, 4)
assert.Equal(t, newEncrypted, rawAfter, "pre-encrypted api_key should be written to DB")
// Round-trip: decrypt should yield the new key.
var reloaded types.Tenant
require.NoError(t, db.First(&reloaded, 4).Error)
assert.Equal(t, "sk-new-key", reloaded.APIKey)
}
func TestUpdateTenant_LegacyPlaintextNotOverwritten(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", testAESKey)
db := setupTestDB(t)
// Insert a tenant with a plaintext api_key (legacy row, pre-encryption era).
insertTenantRaw(t, db, 2, "sk-legacy-plaintext-key")
// Load tenant — AfterFind returns plaintext as-is (no enc:v1: prefix).
var tenant types.Tenant
require.NoError(t, db.First(&tenant, 2).Error)
assert.Equal(t, "sk-legacy-plaintext-key", tenant.APIKey)
// Update a non-key field via repository.
tenant.Description = "migrated"
repo := NewTenantRepository(db)
require.NoError(t, repo.UpdateTenant(context.Background(), &tenant))
// Legacy plaintext should NOT be overwritten — the column should remain untouched.
rawAfter := readAPIKeyRaw(t, db, 2)
assert.Equal(t, "sk-legacy-plaintext-key", rawAfter, "legacy plaintext api_key should remain untouched")
}
func TestUpdateTenant_NoEncryptionWithoutAESKey(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", "")
db := setupTestDB(t)
insertTenantRaw(t, db, 3, "sk-no-encryption")
var tenant types.Tenant
require.NoError(t, db.First(&tenant, 3).Error)
assert.Equal(t, "sk-no-encryption", tenant.APIKey)
tenant.Description = "no key env"
repo := NewTenantRepository(db)
require.NoError(t, repo.UpdateTenant(context.Background(), &tenant))
// Without SYSTEM_AES_KEY, api_key should remain as-is (no guard needed).
rawAfter := readAPIKeyRaw(t, db, 3)
assert.Equal(t, "sk-no-encryption", rawAfter)
}
func isEncrypted(s string) bool {
return len(s) > len(utils.EncPrefix) && s[:len(utils.EncPrefix)] == utils.EncPrefix
}
+95
View File
@@ -0,0 +1,95 @@
package utils
import (
"strings"
"testing"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
const testAESKey = "01234567890123456789012345678901" // 32 bytes
func TestEncryptAESGCM(t *testing.T) {
key := []byte(testAESKey)
t.Run("encrypts plaintext with enc:v1: prefix", func(t *testing.T) {
encrypted, err := EncryptAESGCM("sk-secret-key", key)
require.NoError(t, err)
assert.True(t, strings.HasPrefix(encrypted, EncPrefix))
assert.NotEqual(t, "sk-secret-key", encrypted)
})
t.Run("returns empty string as-is", func(t *testing.T) {
encrypted, err := EncryptAESGCM("", key)
require.NoError(t, err)
assert.Equal(t, "", encrypted)
})
t.Run("returns already encrypted string as-is (idempotent)", func(t *testing.T) {
first, err := EncryptAESGCM("sk-secret-key", key)
require.NoError(t, err)
second, err := EncryptAESGCM(first, key)
require.NoError(t, err)
assert.Equal(t, first, second, "re-encrypting should be a no-op")
})
t.Run("returns plaintext when key is nil", func(t *testing.T) {
encrypted, err := EncryptAESGCM("sk-secret-key", nil)
require.NoError(t, err)
assert.Equal(t, "sk-secret-key", encrypted)
})
}
func TestDecryptAESGCM(t *testing.T) {
key := []byte(testAESKey)
t.Run("round-trip encrypt then decrypt", func(t *testing.T) {
original := "sk-my-secret-api-key"
encrypted, err := EncryptAESGCM(original, key)
require.NoError(t, err)
decrypted, err := DecryptAESGCM(encrypted, key)
require.NoError(t, err)
assert.Equal(t, original, decrypted)
})
t.Run("returns legacy plaintext as-is (no enc:v1: prefix)", func(t *testing.T) {
decrypted, err := DecryptAESGCM("sk-legacy-plaintext", key)
require.NoError(t, err)
assert.Equal(t, "sk-legacy-plaintext", decrypted)
})
t.Run("returns empty string as-is", func(t *testing.T) {
decrypted, err := DecryptAESGCM("", key)
require.NoError(t, err)
assert.Equal(t, "", decrypted)
})
t.Run("returns as-is when key is nil", func(t *testing.T) {
decrypted, err := DecryptAESGCM("enc:v1:something", nil)
require.NoError(t, err)
assert.Equal(t, "enc:v1:something", decrypted)
})
}
func TestGetAESKey(t *testing.T) {
t.Run("returns key when SYSTEM_AES_KEY is 32 bytes", func(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", testAESKey)
key := GetAESKey()
assert.Equal(t, []byte(testAESKey), key)
})
t.Run("returns nil when SYSTEM_AES_KEY is not set", func(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", "")
key := GetAESKey()
assert.Nil(t, key)
})
t.Run("returns nil when SYSTEM_AES_KEY is wrong length", func(t *testing.T) {
t.Setenv("SYSTEM_AES_KEY", "too-short")
key := GetAESKey()
assert.Nil(t, key)
})
}