//go:build !windows // +build !windows /* Copyright 2017 The Kubernetes Authors. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package transformation import ( "bytes" "context" "crypto/aes" "encoding/base64" "encoding/binary" "fmt" "math/rand" "os" "path/filepath" "regexp" "strings" "testing" "time" "github.com/google/go-cmp/cmp" clientv3 "go.etcd.io/etcd/client/v3" "golang.org/x/crypto/cryptobyte" apiextensionsclientset "k8s.io/apiextensions-apiserver/pkg/client/clientset/clientset" "k8s.io/apimachinery/pkg/api/meta" metav1 "k8s.io/apimachinery/pkg/apis/meta/v1" "k8s.io/apimachinery/pkg/apis/meta/v1/unstructured/unstructuredscheme" "k8s.io/apimachinery/pkg/runtime/schema" "k8s.io/apimachinery/pkg/util/sets" "k8s.io/apimachinery/pkg/util/wait" "k8s.io/apiserver/pkg/features" genericapiserver "k8s.io/apiserver/pkg/server" encryptionconfigcontroller "k8s.io/apiserver/pkg/server/options/encryptionconfig/controller" "k8s.io/apiserver/pkg/storage/value" aestransformer "k8s.io/apiserver/pkg/storage/value/encrypt/aes" mock "k8s.io/apiserver/pkg/storage/value/encrypt/envelope/testing/v1beta1" utilfeature "k8s.io/apiserver/pkg/util/feature" "k8s.io/client-go/dynamic" "k8s.io/client-go/rest" featuregatetesting "k8s.io/component-base/featuregate/testing" kmsapi "k8s.io/kms/apis/v1beta1" "k8s.io/kubernetes/test/integration" "k8s.io/kubernetes/test/integration/etcd" "k8s.io/kubernetes/test/integration/framework" ) const ( dekKeySizeLen = 2 kmsAPIVersion = "v1beta1" ) type envelope struct { providerName string rawEnvelope []byte plainTextDEK []byte } func (r envelope) prefix() string { return fmt.Sprintf("k8s:enc:kms:v1:%s:", r.providerName) } func (r envelope) prefixLen() int { return len(r.prefix()) } func (r envelope) dekLen() int { // DEK's length is stored in the two bytes that follow the prefix. return int(binary.BigEndian.Uint16(r.rawEnvelope[r.prefixLen() : r.prefixLen()+dekKeySizeLen])) } func (r envelope) cipherTextDEK() []byte { return r.rawEnvelope[r.prefixLen()+dekKeySizeLen : r.prefixLen()+dekKeySizeLen+r.dekLen()] } func (r envelope) startOfPayload(providerName string) int { return r.prefixLen() + dekKeySizeLen + r.dekLen() } func (r envelope) cipherTextPayload() []byte { return r.rawEnvelope[r.startOfPayload(r.providerName):] } func (r envelope) plainTextPayload(secretETCDPath string) ([]byte, error) { block, err := aes.NewCipher(r.plainTextDEK) if err != nil { return nil, fmt.Errorf("failed to initialize AES Cipher: %v", err) } // etcd path of the key is used as the authenticated context - need to pass it to decrypt ctx := context.Background() dataCtx := value.DefaultContext([]byte(secretETCDPath)) aesgcmTransformer, err := aestransformer.NewGCMTransformer(block) if err != nil { return nil, fmt.Errorf("failed to create transformer from block: %v", err) } plainSecret, _, err := aesgcmTransformer.TransformFromStorage(ctx, r.cipherTextPayload(), dataCtx) if err != nil { return nil, fmt.Errorf("failed to transform from storage via AESGCM, err: %w", err) } return plainSecret, nil } // TestKMSProvider is an integration test between KubeAPI, ETCD and KMS Plugin // Concretely, this test verifies the following integration contracts: // 1. Raw records in ETCD that were processed by KMS Provider should be prefixed with k8s:enc:kms:v1:grpc-kms-provider-name: // 2. Data Encryption Key (DEK) should be generated by envelopeTransformer and passed to KMS gRPC Plugin // 3. KMS gRPC Plugin should encrypt the DEK with a Key Encryption Key (KEK) and pass it back to envelopeTransformer // 4. The cipherTextPayload (ex. Secret) should be encrypted via AES CBC transform // 5. Prefix-EncryptedDEK-EncryptedPayload structure should be deposited to ETCD // 6. Direct AES GCM decryption of the cipherTextPayload written with AES CBC transform does not work // 7. Existing AES CBC secrets should be un-enveloped on direct reads from Kube API Server // 8. No-op updates to the secret should cause new AES GCM key to be used // 9. Direct AES GCM decryption works after the new AES GCM key is used func TestKMSProvider(t *testing.T) { defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock ` providerName := "kms-provider" pluginMock := mock.NewBase64Plugin(t, "@kms-provider.sock") test, err := newTransformTest(t, encryptionConfig, false, "", nil) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig\n %s, error: %v", encryptionConfig, err) } defer test.cleanUp() test.secret, err = test.createSecret(testSecret, testNamespace) if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } // Since Data Encryption Key (DEK) is randomly generated (per encryption operation), we need to ask KMS Mock for it. plainTextDEK := pluginMock.LastEncryptRequest() secretETCDPath := test.getETCDPathForResource(test.storageConfig.Prefix, "", "secrets", test.secret.Name, test.secret.Namespace) rawEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read %s from etcd: %v", secretETCDPath, err) } envelopeData := envelope{ providerName: providerName, rawEnvelope: rawEnvelope, plainTextDEK: plainTextDEK, } wantPrefix := "k8s:enc:kms:v1:kms-provider:" if !bytes.HasPrefix(rawEnvelope, []byte(wantPrefix)) { t.Fatalf("expected secret to be prefixed with %s, but got %s", wantPrefix, rawEnvelope) } ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) defer cancel() decryptResponse, err := pluginMock.Decrypt(ctx, &kmsapi.DecryptRequest{Version: kmsAPIVersion, Cipher: envelopeData.cipherTextDEK()}) if err != nil { t.Fatalf("failed to decrypt DEK, %v", err) } dekPlainAsWouldBeSeenByETCD := decryptResponse.Plain if !bytes.Equal(plainTextDEK, dekPlainAsWouldBeSeenByETCD) { t.Fatalf("expected plainTextDEK %v to be passed to KMS Plugin, but got %s", plainTextDEK, dekPlainAsWouldBeSeenByETCD) } plainSecret, err := envelopeData.plainTextPayload(secretETCDPath) if err != nil { t.Fatalf("failed to transform from storage via AESCBC, err: %v", err) } if !strings.Contains(string(plainSecret), secretVal) { t.Fatalf("expected %q after decryption, but got %q", secretVal, string(plainSecret)) } secretClient := test.restClient.CoreV1().Secrets(testNamespace) // Secrets should be un-enveloped on direct reads from Kube API Server. s, err := secretClient.Get(ctx, testSecret, metav1.GetOptions{}) if err != nil { t.Fatalf("failed to get Secret from %s, err: %v", testNamespace, err) } if secretVal != string(s.Data[secretKey]) { t.Fatalf("expected %s from KubeAPI, but got %s", secretVal, string(s.Data[secretKey])) } // write data using AES CBC to simulate a downgrade oldSecretBytes, err := base64.StdEncoding.DecodeString(oldSecret) if err != nil { t.Fatalf("failed to base64 decode old secret, err: %v", err) } oldKeyBytes, err := base64.StdEncoding.DecodeString(oldAESCBCKey) if err != nil { t.Fatalf("failed to base64 decode old key, err: %v", err) } block, err := aes.NewCipher(oldKeyBytes) if err != nil { t.Fatalf("invalid key, err: %v", err) } oldEncryptedSecretBytes, err := aestransformer.NewCBCTransformer(block).TransformToStorage(ctx, oldSecretBytes, value.DefaultContext(secretETCDPath)) if err != nil { t.Fatalf("failed to encrypt old secret, err: %v", err) } oldEncryptedSecretBuf := cryptobyte.NewBuilder(nil) oldEncryptedSecretBuf.AddBytes([]byte(wantPrefix)) oldEncryptedSecretBuf.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) { b.AddBytes([]byte(oldAESCBCKey)) }) oldEncryptedSecretBuf.AddBytes(oldEncryptedSecretBytes) _, err = test.writeRawRecordToETCD(secretETCDPath, oldEncryptedSecretBuf.BytesOrPanic()) if err != nil { t.Fatalf("failed to write old encrypted secret, err: %v", err) } // confirm that direct AES GCM decryption does not work failingRawEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read %s from etcd: %v", secretETCDPath, err) } failingOldEnvelope := envelope{ providerName: providerName, rawEnvelope: failingRawEnvelope, plainTextDEK: oldKeyBytes, } failingOldPlainSecret, err := failingOldEnvelope.plainTextPayload(secretETCDPath) if err == nil { t.Fatalf("AESGCM decryption failure not seen, data: %s", string(failingOldPlainSecret)) } // Existing AES CBC secrets should be un-enveloped on direct reads from Kube API Server. oldSecretObj, err := secretClient.Get(ctx, testSecret, metav1.GetOptions{}) if err != nil { t.Fatalf("failed to read old secret via Kube API, err: %v", err) } if oldSecretVal != string(oldSecretObj.Data[secretKey]) { t.Fatalf("expected %s from KubeAPI, but got %s", oldSecretVal, string(oldSecretObj.Data[secretKey])) } // no-op update should cause new AES GCM key to be used oldSecretUpdated, err := secretClient.Update(ctx, oldSecretObj, metav1.UpdateOptions{}) if err != nil { t.Fatalf("failed to update old secret via Kube API, err: %v", err) } if oldSecretObj.ResourceVersion == oldSecretUpdated.ResourceVersion { t.Fatalf("old secret not updated on no-op write: %s", oldSecretObj.ResourceVersion) } // confirm that direct AES GCM decryption works oldRawEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read %s from etcd: %v", secretETCDPath, err) } oldEnvelope := envelope{ providerName: providerName, rawEnvelope: oldRawEnvelope, plainTextDEK: pluginMock.LastEncryptRequest(), } if !bytes.HasPrefix(oldRawEnvelope, []byte(wantPrefix)) { t.Fatalf("expected secret to be prefixed with %s, but got %s", wantPrefix, oldRawEnvelope) } oldPlainSecret, err := oldEnvelope.plainTextPayload(secretETCDPath) if err != nil { t.Fatalf("failed to transform from storage via AESGCM, err: %v", err) } if !strings.Contains(string(oldPlainSecret), oldSecretVal) { t.Fatalf("expected %q after decryption, but got %q", oldSecretVal, string(oldPlainSecret)) } } // TestECHotReload is an integration test that verifies hot reload of KMS encryption config works. // This test asserts following scenarios: // 1. start at 'kms-provider' // 2. create some secrets // 3. add 'new-kms-provider' as write KMS (this is okay because we only have 1 API server) // 4. wait for config to be observed // 5. run storage migration on secrets // 6. confirm that secrets have the new prefix // 7. remove 'kms-provider' // 8. wait for config to be observed // 9. confirm that reads still work // 10. confirm that cluster wide secret read still works // 11. confirm that api server can restart with last applied encryption config func TestEncryptionConfigHotReload(t *testing.T) { defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() // this makes the test super responsive. It's set to a default of 1 minute. encryptionconfigcontroller.EncryptionConfigFileChangePollDuration = time.Second storageConfig := framework.SharedEtcd() encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock ` genericapiserver.SetHostnameFuncForTests("testAPIServerID") _ = mock.NewBase64Plugin(t, "@kms-provider.sock") var restarted bool test, err := newTransformTest(t, encryptionConfig, true, "", storageConfig) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig\n %s, error: %v", encryptionConfig, err) } defer func() { if !restarted { test.cleanUp() } }() ctx := testContext(t) // the global metrics registry persists across test runs - reset it here so we can make assertions copyConfig := rest.CopyConfig(test.kubeAPIServer.ClientConfig) copyConfig.GroupVersion = &schema.GroupVersion{} copyConfig.NegotiatedSerializer = unstructuredscheme.NewUnstructuredNegotiatedSerializer() rc, err := rest.RESTClientFor(copyConfig) if err != nil { t.Fatal(err) } if err := rc.Delete().AbsPath("/metrics").Do(ctx).Error(); err != nil { t.Fatal(err) } // assert that the metrics we collect during the test run match expectations // NOTE: 2 successful automatic reload resulted from 2 config file updates wantMetricStrings := []string{ `apiserver_encryption_config_controller_automatic_reload_last_timestamp_seconds{apiserver_id_hash="sha256:3c607df3b2bf22c9d9f01d5314b4bbf411c48ef43ff44ff29b1d55b41367c795",status="success"} FP`, `apiserver_encryption_config_controller_automatic_reload_success_total{apiserver_id_hash="sha256:3c607df3b2bf22c9d9f01d5314b4bbf411c48ef43ff44ff29b1d55b41367c795"} 2`, `apiserver_encryption_config_controller_automatic_reloads_total{apiserver_id_hash="sha256:3c607df3b2bf22c9d9f01d5314b4bbf411c48ef43ff44ff29b1d55b41367c795",status="success"} 2`, } test.secret, err = test.createSecret(testSecret, testNamespace) if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } // create a new secret in default namespace. This is to assert cluster wide read works after hot reload. _, err = test.createSecret(fmt.Sprintf("%s-%s", testSecret, "1"), "default") if err != nil { t.Fatalf("Failed to create test secret in default namespace, error: %v", err) } _, err = test.createConfigMap(testConfigmap, testNamespace) if err != nil { t.Fatalf("Failed to create test configmap, error: %v", err) } // test if hot reload controller is healthy mustBeHealthy(t, "/poststarthook/start-encryption-provider-config-automatic-reload", "ok", test.kubeAPIServer.ClientConfig) encryptionConfigWithNewProvider := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: new-kms-provider-for-secrets cachesize: 1000 endpoint: unix:///@new-kms-provider.sock - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock - resources: - configmaps providers: - kms: name: new-kms-provider-for-configmaps cachesize: 1000 endpoint: unix:///@new-kms-provider.sock - identity: {} ` // start new KMS Plugin _ = mock.NewBase64Plugin(t, "@new-kms-provider.sock") // update encryption config updateFile(t, test.configDir, encryptionConfigFileName, []byte(encryptionConfigWithNewProvider)) wantPrefixForSecrets := "k8s:enc:kms:v1:new-kms-provider-for-secrets:" // implementing this brute force approach instead of fancy channel notification to avoid test specific code in prod. // wait for config to be observed verifyIfKMSTransformersSwapped(t, wantPrefixForSecrets, "", test) // run storage migration // get secrets secretsList, err := test.restClient.CoreV1().Secrets("").List( ctx, metav1.ListOptions{}, ) if err != nil { t.Fatalf("failed to list secrets, err: %v", err) } for _, secret := range secretsList.Items { // update secret _, err = test.restClient.CoreV1().Secrets(secret.Namespace).Update( ctx, &secret, metav1.UpdateOptions{}, ) if err != nil { t.Fatalf("failed to update secret, err: %v", err) } } // get configmaps configmapsList, err := test.restClient.CoreV1().ConfigMaps("").List( ctx, metav1.ListOptions{}, ) if err != nil { t.Fatalf("failed to list configmaps, err: %v", err) } for _, configmap := range configmapsList.Items { // update configmap _, err = test.restClient.CoreV1().ConfigMaps(configmap.Namespace).Update( ctx, &configmap, metav1.UpdateOptions{}, ) if err != nil { t.Fatalf("failed to update configmap, err: %v", err) } } // assert that resources has new prefix secretETCDPath := test.getETCDPathForResource(test.storageConfig.Prefix, "", "secrets", test.secret.Name, test.secret.Namespace) rawEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read %s from etcd: %v", secretETCDPath, err) } // assert secret if !bytes.HasPrefix(rawEnvelope, []byte(wantPrefixForSecrets)) { t.Fatalf("expected secret to be prefixed with %s, but got %s", wantPrefixForSecrets, rawEnvelope) } rawConfigmapEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "configmaps", testConfigmap, testNamespace)) if err != nil { t.Fatalf("failed to read %s from etcd: %v", test.getETCDPathForResource(test.storageConfig.Prefix, "", "configmaps", testConfigmap, testNamespace), err) } // assert prefix for configmap wantPrefixForConfigmaps := "k8s:enc:kms:v1:new-kms-provider-for-configmaps:" if !bytes.HasPrefix(rawConfigmapEnvelope.Kvs[0].Value, []byte(wantPrefixForConfigmaps)) { t.Fatalf("expected configmap to be prefixed with %s, but got %s", wantPrefixForConfigmaps, rawConfigmapEnvelope.Kvs[0].Value) } // remove old KMS provider // verifyIfKMSTransformersSwapped sometimes passes even before the changes in the encryption config file are observed. // this causes the metrics tests to fail, which validate two config changes. // this may happen when an existing KMS provider is already running (e.g., new-kms-provider-for-secrets in this case). // to ensure that the changes are observed, we added one more provider (kms-provider-to-encrypt-all) and are validating it in verifyIfKMSTransformersSwapped. encryptionConfigWithoutOldProvider := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: new-kms-provider-for-secrets cachesize: 1000 endpoint: unix:///@new-kms-provider.sock - resources: - configmaps providers: - kms: name: new-kms-provider-for-configmaps cachesize: 1000 endpoint: unix:///@new-kms-provider.sock - resources: - '*.*' providers: - kms: name: kms-provider-to-encrypt-all cachesize: 1000 endpoint: unix:///@new-encrypt-all-kms-provider.sock - identity: {} ` // start new KMS Plugin _ = mock.NewBase64Plugin(t, "@new-encrypt-all-kms-provider.sock") // update encryption config and wait for hot reload updateFile(t, test.configDir, encryptionConfigFileName, []byte(encryptionConfigWithoutOldProvider)) wantPrefixForEncryptAll := "k8s:enc:kms:v1:kms-provider-to-encrypt-all:" // wait for config to be observed verifyIfKMSTransformersSwapped(t, wantPrefixForSecrets, wantPrefixForEncryptAll, test) // confirm that reading secrets still works _, err = test.restClient.CoreV1().Secrets(testNamespace).Get( ctx, testSecret, metav1.GetOptions{}, ) if err != nil { t.Fatalf("failed to read secret, err: %v", err) } // make sure cluster wide secrets read still works _, err = test.restClient.CoreV1().Secrets("").List(ctx, metav1.ListOptions{}) if err != nil { t.Fatalf("failed to list secrets, err: %v", err) } // make sure cluster wide configmaps read still works _, err = test.restClient.CoreV1().ConfigMaps("").List(ctx, metav1.ListOptions{}) if err != nil { t.Fatalf("failed to list configmaps, err: %v", err) } // restart kube-apiserver with last applied encryption config and assert that server can start previousConfigDir := test.configDir test.shutdownAPIServer() restarted = true test, err = newTransformTest(t, test.transformerConfig, true, previousConfigDir, storageConfig) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig\n %s, error: %v", encryptionConfig, err) } defer test.cleanUp() _, err = test.restClient.CoreV1().Secrets(testNamespace).Get( ctx, testSecret, metav1.GetOptions{}, ) if err != nil { t.Fatalf("failed to read secret, err: %v", err) } // confirm that reading cluster wide secrets still works after restart if _, err = test.restClient.CoreV1().Secrets("").List(ctx, metav1.ListOptions{}); err != nil { t.Fatalf("failed to list secrets, err: %v", err) } // make sure cluster wide configmaps read still works if _, err = test.restClient.CoreV1().ConfigMaps("").List(ctx, metav1.ListOptions{}); err != nil { t.Fatalf("failed to list configmaps, err: %v", err) } // recreate rest client with the new transformTest copyConfig = rest.CopyConfig(test.kubeAPIServer.ClientConfig) copyConfig.GroupVersion = &schema.GroupVersion{} copyConfig.NegotiatedSerializer = unstructuredscheme.NewUnstructuredNegotiatedSerializer() rc, err = rest.RESTClientFor(copyConfig) if err != nil { t.Fatal(err) } defer func() { body, err := rc.Get().AbsPath("/metrics").DoRaw(ctx) if err != nil { t.Fatal(err) } var gotMetricStrings []string trimFP := regexp.MustCompile(`(.*)(} \d+\.\d+.*)`) for _, line := range strings.Split(string(body), "\n") { if strings.HasPrefix(line, "apiserver_encryption_config_controller_") { if strings.Contains(line, "_seconds") { line = trimFP.ReplaceAllString(line, `$1`) + "} FP" // ignore floating point metric values } gotMetricStrings = append(gotMetricStrings, line) } } if diff := cmp.Diff(wantMetricStrings, gotMetricStrings); diff != "" { t.Errorf("unexpected metrics diff (-want +got): %s", diff) } }() } func TestEncryptAll(t *testing.T) { encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - '*.*' providers: - kms: name: encrypt-all-kms-provider cachesize: 1000 endpoint: unix:///@encrypt-all-kms-provider.sock ` t.Run("encrypt all resources", func(t *testing.T) { _ = mock.NewBase64Plugin(t, "@encrypt-all-kms-provider.sock") // To ensure we are checking all REST resources defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, "AllAlpha", true)() defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, "AllBeta", true)() // Need to enable this explicitly as the feature is deprecated defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() test, err := newTransformTest(t, encryptionConfig, false, "", nil) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig") } defer test.cleanUp() etcd.CreateTestCRDs(t, apiextensionsclientset.NewForConfigOrDie(test.kubeAPIServer.ClientConfig), false, etcd.GetCustomResourceDefinitionData()...) _, serverResources, err := test.restClient.Discovery().ServerGroupsAndResources() if err != nil { t.Fatal(err) } resources := etcd.GetResources(t, serverResources) client := dynamic.NewForConfigOrDie(test.kubeAPIServer.ClientConfig) etcdStorageData := etcd.GetEtcdStorageDataForNamespace(testNamespace) restResourceSet := sets.New[schema.GroupVersionResource]() stubResourceSet := sets.New[schema.GroupVersionResource]() for _, resource := range resources { gvr := resource.Mapping.Resource stub := etcdStorageData[gvr].Stub // continue if stub is empty if stub == "" { t.Errorf("skipping resource %s because stub is empty", gvr) continue } restResourceSet.Insert(gvr) dynamicClient, obj, err := etcd.JSONToUnstructured(stub, testNamespace, &meta.RESTMapping{ Resource: gvr, GroupVersionKind: gvr.GroupVersion().WithKind(resource.Mapping.GroupVersionKind.Kind), Scope: resource.Mapping.Scope, }, client) if err != nil { t.Fatal(err) } _, err = dynamicClient.Create(context.TODO(), obj, metav1.CreateOptions{}) if err != nil { t.Fatal(err) } } for gvr, data := range etcdStorageData { if data.Stub == "" { continue } stubResourceSet.Insert(gvr) } if !restResourceSet.Equal(stubResourceSet) { t.Errorf("failed to check all REST resources: %q", restResourceSet.SymmetricDifference(stubResourceSet).UnsortedList()) } rawClient, etcdClient, err := integration.GetEtcdClients(test.kubeAPIServer.ServerOpts.Etcd.StorageConfig.Transport) if err != nil { t.Fatalf("failed to create etcd client: %v", err) } // kvClient is a wrapper around rawClient and to avoid leaking goroutines we need to // close the client (which we can do by closing rawClient). defer rawClient.Close() response, err := etcdClient.Get(context.TODO(), "/"+test.kubeAPIServer.ServerOpts.Etcd.StorageConfig.Prefix, clientv3.WithPrefix()) if err != nil { t.Fatalf("failed to retrieve secret from etcd %v", err) } // assert that total key values in response in greater than 0 if len(response.Kvs) == 0 { t.Fatalf("expected total number of keys to be greater than 0, but got %d", len(response.Kvs)) } // assert that total response keys are greater or equal to total resources if len(response.Kvs) < len(resources) { t.Fatalf("expected total number of keys to be greater or equal to total resources, but got %d", len(response.Kvs)) } wantPrefix := "k8s:enc:kms:v1:encrypt-all-kms-provider:" for _, kv := range response.Kvs { // the following resources are not encrypted as they are not REST APIs and hence are not expected // to be encrypted because it would be impossible to perform a storage migration on them if strings.Contains(kv.String(), "masterleases") || strings.Contains(kv.String(), "peerserverleases") || strings.Contains(kv.String(), "serviceips") || strings.Contains(kv.String(), "servicenodeports") { // assert that these resources are not encrypted with any provider if bytes.HasPrefix(kv.Value, []byte("k8s:enc:")) { t.Errorf("expected resource %s to not be prefixed with %s, but got %s", kv.Key, "k8s:enc:", kv.Value) } continue } // assert that all other resources are encrypted if !bytes.HasPrefix(kv.Value, []byte(wantPrefix)) { t.Errorf("expected resource %s to be prefixed with %s, but got %s", kv.Key, wantPrefix, kv.Value) } } }) } func TestEncryptAllWithWildcard(t *testing.T) { encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - configmaps providers: - identity: {} - resources: - '*.batch' providers: - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock - resources: - '*.*' providers: - kms: name: encrypt-all-kms-provider cachesize: 1000 endpoint: unix:///@encrypt-all-kms-provider.sock ` _ = mock.NewBase64Plugin(t, "@kms-provider.sock") _ = mock.NewBase64Plugin(t, "@encrypt-all-kms-provider.sock") defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() test, err := newTransformTest(t, encryptionConfig, false, "", nil) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig\n %s, error: %v", encryptionConfig, err) } defer test.cleanUp() wantPrefix := "k8s:enc:kms:v1:kms-provider:" wantPrefixForEncryptAll := "k8s:enc:kms:v1:encrypt-all-kms-provider:" _, err = test.createJob("test-job", "default") if err != nil { t.Fatalf("failed to create job: %v", err) } rawJobsEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "jobs", "test-job", "default")) if err != nil { t.Fatalf("failed to read %s from etcd: %v", test.getETCDPathForResource(test.storageConfig.Prefix, "", "jobs", "test-job", "default"), err) } // assert prefix for jobs if !bytes.HasPrefix(rawJobsEnvelope.Kvs[0].Value, []byte(wantPrefix)) { t.Fatalf("expected jobs to be prefixed with %s, but got %s", wantPrefix, rawJobsEnvelope.Kvs[0].Value) } _, err = test.createDeployment("test-deployment", "default") if err != nil { t.Fatalf("failed to create deployment: %v", err) } rawDeploymentsEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "deployments", "test-deployment", "default")) if err != nil { t.Fatalf("failed to read %s from etcd: %v", test.getETCDPathForResource(test.storageConfig.Prefix, "", "deployments", "test-deployment", "default"), err) } // assert prefix for deployments if !bytes.HasPrefix(rawDeploymentsEnvelope.Kvs[0].Value, []byte(wantPrefixForEncryptAll)) { t.Fatalf("expected deployments to be prefixed with %s, but got %s", wantPrefixForEncryptAll, rawDeploymentsEnvelope.Kvs[0].Value) } test.secret, err = test.createSecret(testSecret, testNamespace) if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } rawSecretEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read secrets from etcd: %v", err) } // assert prefix for secrets if !bytes.HasPrefix(rawSecretEnvelope, []byte(wantPrefixForEncryptAll)) { t.Fatalf("expected secrets to be prefixed with %s, but got %s", wantPrefixForEncryptAll, rawSecretEnvelope) } _, err = test.createConfigMap(testConfigmap, testNamespace) if err != nil { t.Fatalf("Failed to create test configmap, error: %v", err) } rawConfigMapEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "configmaps", testConfigmap, testNamespace)) if err != nil { t.Fatalf("failed to read configmaps from etcd: %v", err) } // assert configmaps do not have the encrypted data prefix if bytes.HasPrefix(rawConfigMapEnvelope.Kvs[0].Value, []byte("k8s:enc:")) { t.Fatalf("expected configmaps to be not encrypted, got %s", rawConfigMapEnvelope.Kvs[0].Value) } } func TestEncryptionConfigHotReloadFilePolling(t *testing.T) { defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() // this makes the test super responsive. It's set to a default of 1 minute. encryptionconfigcontroller.EncryptionConfigFileChangePollDuration = time.Second testCases := []struct { sleep time.Duration name string updateFile func(filePath, fileContent string) error }{ { name: "truncate file", updateFile: func(filePath string, fileContent string) error { // os.WriteFile truncates the file before writing return os.WriteFile(filePath, []byte(fileContent), 0644) }, // significantly longer than KMSCloseGracePeriod sleep: 20 * time.Second, }, { name: "delete and create file", updateFile: func(filePath, fileContent string) error { // os.Remove deletes the file before creating a new one if err := os.Remove(filePath); err != nil { return fmt.Errorf("failed to remove encryption config, err: %w", err) } file, err := os.Create(filePath) if err != nil { return fmt.Errorf("failed to create encryption config, err: %w", err) } defer file.Close() if _, err := file.Write([]byte(fileContent)); err != nil { return fmt.Errorf("failed to write encryption config, err: %w", err) } return nil }, }, { name: "move file", updateFile: func(filePath, fileContent string) error { // write new config to a temp file tmpFilePath := filePath + ".tmp" if err := os.WriteFile(tmpFilePath, []byte(fileContent), 0644); err != nil { return fmt.Errorf("failed to write config to tmp file, err: %w", err) } // move the temp file to the original file if err := os.Rename(tmpFilePath, filePath); err != nil { return fmt.Errorf("failed to move encryption config, err: %w", err) } return nil }, }, } for _, tc := range testCases { t.Run(tc.name, func(t *testing.T) { encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock timeout: 1s ` _ = mock.NewBase64Plugin(t, "@kms-provider.sock") test, err := newTransformTest(t, encryptionConfig, true, "", nil) if err != nil { t.Fatalf("failed to start KUBE API Server with encryptionConfig\n %s, error: %v", encryptionConfig, err) } defer test.cleanUp() test.secret, err = test.createSecret(testSecret, testNamespace) if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } // test if hot reload controller is healthy mustBeHealthy(t, "/poststarthook/start-encryption-provider-config-automatic-reload", "ok", test.kubeAPIServer.ClientConfig) encryptionConfigWithNewProvider := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: new-kms-provider-for-secrets cachesize: 1000 endpoint: unix:///@new-kms-provider.sock timeout: 1s - kms: name: kms-provider cachesize: 1000 endpoint: unix:///@kms-provider.sock timeout: 1s - resources: - configmaps providers: - kms: name: new-kms-provider-for-configmaps cachesize: 1000 endpoint: unix:///@new-kms-provider.sock timeout: 1s - identity: {} ` // start new KMS Plugin _ = mock.NewBase64Plugin(t, "@new-kms-provider.sock") // update encryption config if err := tc.updateFile(filepath.Join(test.configDir, encryptionConfigFileName), encryptionConfigWithNewProvider); err != nil { t.Fatalf("failed to update encryption config, err: %v", err) } wantPrefix := "k8s:enc:kms:v1:new-kms-provider-for-secrets:" verifyPrefixOfSecretResource(t, wantPrefix, test) // make sure things still work at a "later" time if tc.sleep != 0 { time.Sleep(tc.sleep) } _, err = test.createSecret(fmt.Sprintf("secret-%d", rand.Intn(100000)), "default") if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } _, err = test.restClient.CoreV1().Secrets("").List( context.TODO(), metav1.ListOptions{}, ) if err != nil { t.Fatalf("failed to re-list secrets, err: %v", err) } }) } } func verifyPrefixOfSecretResource(t *testing.T, wantPrefix string, test *transformTest) { // implementing this brute force approach instead of fancy channel notification to avoid test specific code in prod. // wait for config to be observed verifyIfKMSTransformersSwapped(t, wantPrefix, "", test) // run storage migration secretsList, err := test.restClient.CoreV1().Secrets("").List( context.TODO(), metav1.ListOptions{}, ) if err != nil { t.Fatalf("failed to list secrets, err: %v", err) } for _, secret := range secretsList.Items { _, err = test.restClient.CoreV1().Secrets(secret.Namespace).Update( context.TODO(), &secret, metav1.UpdateOptions{}, ) if err != nil { t.Fatalf("failed to update secret, err: %v", err) } } secretETCDPath := test.getETCDPathForResource(test.storageConfig.Prefix, "", "secrets", test.secret.Name, test.secret.Namespace) rawEnvelope, err := test.getRawSecretFromETCD() if err != nil { t.Fatalf("failed to read %s from etcd: %v", secretETCDPath, err) } // assert that resources has new prefix if !bytes.HasPrefix(rawEnvelope, []byte(wantPrefix)) { t.Fatalf("expected secret to be prefixed with %s, but got %s", wantPrefix, rawEnvelope) } } func verifyIfKMSTransformersSwapped(t *testing.T, wantPrefix, wantPrefixForEncryptAll string, test *transformTest) { t.Helper() var swapErr error // delete and recreate same secret flakes, so create a new secret with a different index until new prefix is observed // generate a random int to be used in secret name idx := rand.Intn(100000) pollErr := wait.PollImmediate(time.Second, wait.ForeverTestTimeout, func() (bool, error) { // create secret secretName := fmt.Sprintf("secret-%d", idx) _, err := test.createSecret(secretName, "default") if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } rawEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "secrets", secretName, "default")) if err != nil { t.Fatalf("failed to read %s from etcd: %v", test.getETCDPathForResource(test.storageConfig.Prefix, "", "secrets", secretName, "default"), err) } // check prefix if !bytes.HasPrefix(rawEnvelope.Kvs[0].Value, []byte(wantPrefix)) { idx++ swapErr = fmt.Errorf("expected secret to be prefixed with %s, but got %s", wantPrefix, rawEnvelope.Kvs[0].Value) // return nil error to continue polling till timeout return false, nil } if wantPrefixForEncryptAll != "" { deploymentName := fmt.Sprintf("deployment-%d", idx) _, err := test.createDeployment(deploymentName, "default") if err != nil { t.Fatalf("Failed to create test secret, error: %v", err) } rawEnvelope, err := test.readRawRecordFromETCD(test.getETCDPathForResource(test.storageConfig.Prefix, "", "deployments", deploymentName, "default")) if err != nil { t.Fatalf("failed to read %s from etcd: %v", test.getETCDPathForResource(test.storageConfig.Prefix, "", "deployments", deploymentName, "default"), err) } // check prefix if !bytes.HasPrefix(rawEnvelope.Kvs[0].Value, []byte(wantPrefixForEncryptAll)) { idx++ swapErr = fmt.Errorf("expected deployment to be prefixed with %s, but got %s", wantPrefixForEncryptAll, rawEnvelope.Kvs[0].Value) // return nil error to continue polling till timeout return false, nil } } return true, nil }) if pollErr == wait.ErrWaitTimeout { t.Fatalf("failed to verify if kms transformers swapped, err: %v", swapErr) } } func updateFile(t *testing.T, configDir, filename string, newContent []byte) { t.Helper() // Create a temporary file tempFile, err := os.CreateTemp(configDir, "tempfile") if err != nil { t.Fatal(err) } defer tempFile.Close() // Write the new content to the temporary file _, err = tempFile.Write(newContent) if err != nil { t.Fatal(err) } // Atomically replace the original file with the temporary file err = os.Rename(tempFile.Name(), filepath.Join(configDir, filename)) if err != nil { t.Fatal(err) } } func TestKMSHealthz(t *testing.T) { defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: provider-1 endpoint: unix:///@kms-provider-1.sock - kms: name: provider-2 endpoint: unix:///@kms-provider-2.sock ` pluginMock1 := mock.NewBase64Plugin(t, "@kms-provider-1.sock") pluginMock2 := mock.NewBase64Plugin(t, "@kms-provider-2.sock") test, err := newTransformTest(t, encryptionConfig, false, "", nil) if err != nil { t.Fatalf("failed to start kube-apiserver, error: %v", err) } defer test.cleanUp() // Name of the healthz check is always "kms-provider-0" and it covers all kms plugins. // Stage 1 - Since all kms-plugins are guaranteed to be up, healthz checks for: // healthz/kms-provider-0 and /healthz/kms-provider-1 should be OK. mustBeHealthy(t, "/kms-provider-0", "ok", test.kubeAPIServer.ClientConfig) mustBeHealthy(t, "/kms-provider-1", "ok", test.kubeAPIServer.ClientConfig) mustNotHaveLivez(t, "/kms-provider-0", "404 page not found", test.kubeAPIServer.ClientConfig) mustNotHaveLivez(t, "/kms-provider-1", "404 page not found", test.kubeAPIServer.ClientConfig) // Stage 2 - kms-plugin for provider-1 is down. Therefore, expect the healthz check // to fail and report that provider-1 is down pluginMock1.EnterFailedState() mustBeUnHealthy(t, "/kms-provider-0", "internal server error: rpc error: code = FailedPrecondition desc = failed precondition - key disabled", test.kubeAPIServer.ClientConfig) mustNotHaveLivez(t, "/kms-provider-0", "404 page not found", test.kubeAPIServer.ClientConfig) mustBeHealthy(t, "/kms-provider-1", "ok", test.kubeAPIServer.ClientConfig) mustNotHaveLivez(t, "/kms-provider-1", "404 page not found", test.kubeAPIServer.ClientConfig) pluginMock1.ExitFailedState() // Stage 3 - kms-plugin for provider-1 is now up. Therefore, expect the health check for provider-1 // to succeed now, but provider-2 is now down. pluginMock2.EnterFailedState() mustBeHealthy(t, "/kms-provider-0", "ok", test.kubeAPIServer.ClientConfig) mustBeUnHealthy(t, "/kms-provider-1", "internal server error: rpc error: code = FailedPrecondition desc = failed precondition - key disabled", test.kubeAPIServer.ClientConfig) pluginMock2.ExitFailedState() // Stage 4 - All kms-plugins are once again up, // the healthz check should be OK. mustBeHealthy(t, "/kms-provider-0", "ok", test.kubeAPIServer.ClientConfig) mustBeHealthy(t, "/kms-provider-1", "ok", test.kubeAPIServer.ClientConfig) } func TestKMSHealthzWithReload(t *testing.T) { defer featuregatetesting.SetFeatureGateDuringTest(t, utilfeature.DefaultFeatureGate, features.KMSv1, true)() encryptionConfig := ` kind: EncryptionConfiguration apiVersion: apiserver.config.k8s.io/v1 resources: - resources: - secrets providers: - kms: name: provider-1 endpoint: unix:///@kms-provider-1.sock - kms: name: provider-2 endpoint: unix:///@kms-provider-2.sock ` pluginMock1 := mock.NewBase64Plugin(t, "@kms-provider-1.sock") pluginMock2 := mock.NewBase64Plugin(t, "@kms-provider-2.sock") test, err := newTransformTest(t, encryptionConfig, true, "", nil) if err != nil { t.Fatalf("Failed to start kube-apiserver, error: %v", err) } defer test.cleanUp() // Name of the healthz check is always "kms-provider-0" and it covers all kms plugins. // Stage 1 - Since all kms-plugins are guaranteed to be up, // the healthz check should be OK. mustBeHealthy(t, "/kms-providers", "ok", test.kubeAPIServer.ClientConfig) // Stage 2 - kms-plugin for provider-1 is down. Therefore, expect the healthz check // to fail and report that provider-1 is down pluginMock1.EnterFailedState() mustBeUnHealthy(t, "/kms-providers", "internal server error: kms-provider-0: failed to perform encrypt section of the healthz check for KMS Provider provider-1, error: rpc error: code = FailedPrecondition desc = failed precondition - key disabled", test.kubeAPIServer.ClientConfig) pluginMock1.ExitFailedState() // Stage 3 - kms-plugin for provider-1 is now up. Therefore, expect the health check for provider-1 // to succeed now, but provider-2 is now down. pluginMock2.EnterFailedState() mustBeUnHealthy(t, "/kms-providers", "internal server error: kms-provider-1: failed to perform encrypt section of the healthz check for KMS Provider provider-2, error: rpc error: code = FailedPrecondition desc = failed precondition - key disabled", test.kubeAPIServer.ClientConfig) pluginMock2.ExitFailedState() // Stage 4 - All kms-plugins are once again up, // the healthz check should be OK. mustBeHealthy(t, "/kms-providers", "ok", test.kubeAPIServer.ClientConfig) }