/* Copyright © 2025 ESO Maintainer Team 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 https://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 webhook import ( "context" "encoding/json" "errors" "fmt" "net/http" "strconv" "time" "github.com/PaesslerAG/jsonpath" corev1 "k8s.io/api/core/v1" "sigs.k8s.io/controller-runtime/pkg/client" "sigs.k8s.io/controller-runtime/pkg/webhook/admission" esv1 "github.com/external-secrets/external-secrets/apis/externalsecrets/v1" "github.com/external-secrets/external-secrets/providers/v1/webhook/pkg/webhook" "github.com/external-secrets/external-secrets/runtime/esutils" ) const ( errNotImplemented = "not implemented" errFailedToGetStore = "failed to get store: %w" ) // https://github.com/external-secrets/external-secrets/issues/644 var _ esv1.SecretsClient = &WebHook{} var _ esv1.Provider = &Provider{} // Provider satisfies the provider interface. type Provider struct{} // WebHook implements the External Secrets webhook provider. type WebHook struct { wh webhook.Webhook store esv1.GenericStore storeKind string url string } // Capabilities return the provider-supported capabilities (ReadOnly, WriteOnly, ReadWrite). func (p *Provider) Capabilities() esv1.SecretStoreCapabilities { return esv1.SecretStoreReadWrite } // NewClient creates a new WebHook client for accessing secrets. func (p *Provider) NewClient(ctx context.Context, store esv1.GenericStore, kube client.Client, namespace string) (esv1.SecretsClient, error) { wh := webhook.Webhook{ Kube: kube, Namespace: namespace, StoreKind: store.GetObjectKind().GroupVersionKind().Kind, } whClient := &WebHook{ store: store, wh: wh, storeKind: store.GetObjectKind().GroupVersionKind().Kind, } whClient.wh.EnforceLabels = true if whClient.storeKind == esv1.ClusterSecretStoreKind { whClient.wh.ClusterScoped = true } provider, err := getProvider(store) if err != nil { return nil, err } whClient.url = provider.URL whClient.wh.HTTP, err = whClient.wh.GetHTTPClient(ctx, provider) if err != nil { return nil, err } return whClient, nil } // ValidateStore validates the provider-specific store configuration. func (p *Provider) ValidateStore(_ esv1.GenericStore) (admission.Warnings, error) { return nil, nil } func getProvider(store esv1.GenericStore) (*webhook.Spec, error) { spc := store.GetSpec() if spc == nil || spc.Provider == nil || spc.Provider.Webhook == nil { return nil, errors.New("missing store provider webhook") } out := webhook.Spec{} d, err := json.Marshal(spc.Provider.Webhook) if err != nil { return nil, err } err = json.Unmarshal(d, &out) return &out, err } // DeleteSecret deletes a secret from a remote store. func (w *WebHook) DeleteSecret(ctx context.Context, remoteRef esv1.PushSecretRemoteRef) error { provider, err := getProvider(w.store) if err != nil { return fmt.Errorf(errFailedToGetStore, err) } escapedData := map[string]map[string]string{ "remoteRef": { "remoteKey": remoteRef.GetRemoteKey(), }, } url, err := webhook.ExecuteTemplateString(provider.URL, escapedData) if err != nil { return fmt.Errorf("failed to parse url: %w", err) } method := http.MethodDelete req, err := http.NewRequestWithContext(ctx, method, url, http.NoBody) if err != nil { return fmt.Errorf("failed to create delete request: %w", err) } rawData := map[string]map[string]string{ "remoteRef": { "remoteKey": remoteRef.GetRemoteKey(), }, } if provider.Headers != nil { req, err = w.wh.ReqAddHeaders(req, provider, rawData) if err != nil { return err } } if provider.Auth != nil { req, err = w.wh.ReqAddAuth(ctx, req, provider) if err != nil { return err } } resp, err := w.wh.HTTP.Do(req) if err != nil { return fmt.Errorf("failed to delete secret: %w", err) } defer func() { _ = resp.Body.Close() }() if resp.StatusCode == 404 { // Secret doesn't exist, that's OK for delete return nil } if resp.StatusCode < 200 || resp.StatusCode >= 300 { return fmt.Errorf("delete endpoint gave error %s", resp.Status) } return nil } // SecretExists checks if a secret exists in the remote store. func (w *WebHook) SecretExists(ctx context.Context, remoteRef esv1.PushSecretRemoteRef) (bool, error) { provider, err := getProvider(w.store) if err != nil { return false, fmt.Errorf(errFailedToGetStore, err) } _, err = w.wh.GetWebhookData(ctx, provider, &esv1.ExternalSecretDataRemoteRef{ Key: remoteRef.GetRemoteKey(), }) if err != nil { var noSecretErr esv1.NoSecretError if errors.As(err, &noSecretErr) { return false, nil } return false, err } return true, nil } // PushSecret pushes a secret to a remote store. func (w *WebHook) PushSecret(ctx context.Context, secret *corev1.Secret, data esv1.PushSecretData) error { if data.GetRemoteKey() == "" { return errors.New("remote key must be defined") } provider, err := getProvider(w.store) if err != nil { return fmt.Errorf(errFailedToGetStore, err) } value, err := esutils.ExtractSecretData(data, secret) if err != nil { return err } if err := w.wh.PushWebhookData(ctx, provider, value, data); err != nil { return fmt.Errorf("failed to push webhook data: %w", err) } return nil } // GetAllSecrets Empty . func (w *WebHook) GetAllSecrets(_ context.Context, _ esv1.ExternalSecretFind) (map[string][]byte, error) { // TO be implemented return nil, errors.New(errNotImplemented) } // GetSecret gets a secret from the remote store. func (w *WebHook) GetSecret(ctx context.Context, ref esv1.ExternalSecretDataRemoteRef) ([]byte, error) { provider, err := getProvider(w.store) if err != nil { return nil, fmt.Errorf(errFailedToGetStore, err) } result, err := w.wh.GetWebhookData(ctx, provider, &ref) if err != nil { return nil, err } // Only parse as json if we have a jsonpath set data, err := w.wh.GetTemplateData(ctx, &ref, provider.Secrets, false) if err != nil { return nil, err } resultJSONPath, err := webhook.ExecuteTemplateString(provider.Result.JSONPath, data) if err != nil { return nil, err } if resultJSONPath != "" { jsondata := any(nil) if err := json.Unmarshal(result, &jsondata); err != nil { return nil, fmt.Errorf("failed to parse response json: %w", err) } jsondata, err = jsonpath.Get(resultJSONPath, jsondata) if err != nil { return nil, fmt.Errorf("failed to get response path %s: %w", resultJSONPath, err) } return extractSecretData(jsondata) } return result, nil } // tries to extract data from an any // it is supposed to return a single value. func extractSecretData(jsondata any) ([]byte, error) { switch val := jsondata.(type) { case bool: return []byte(strconv.FormatBool(val)), nil case nil: return []byte{}, nil case int: return []byte(strconv.Itoa(val)), nil case float64: return []byte(strconv.FormatFloat(val, 'f', 0, 64)), nil case []byte: return val, nil case string: return []byte(val), nil // due to backwards compatibility we must keep this! // in case we see a []something we pick the first element and return it case []any: if len(val) == 0 { return nil, errors.New("filter worked but didn't get any result") } return extractSecretData(val[0]) // in case we encounter a map we serialize it instead of erroring out // The user should use that data from within a template and figure // out how to deal with it. case map[string]any: return json.Marshal(val) default: return nil, fmt.Errorf("failed to get response (wrong type: %T)", jsondata) } } // GetSecretMap gets a map of secrets from the remote store. func (w *WebHook) GetSecretMap(ctx context.Context, ref esv1.ExternalSecretDataRemoteRef) (map[string][]byte, error) { provider, err := getProvider(w.store) if err != nil { return nil, fmt.Errorf(errFailedToGetStore, err) } data, err := w.wh.GetTemplateData(ctx, &ref, provider.Secrets, false) if err != nil { return nil, fmt.Errorf("cannot get template data: %w", err) } resultJSONPath, err := webhook.ExecuteTemplateString(provider.Result.JSONPath, data) if err != nil { return nil, fmt.Errorf("cannot get templated json path: %w", err) } provider.Result.JSONPath = resultJSONPath return w.wh.GetSecretMap(ctx, provider, &ref) } // Close closes the connection to the webhook provider. func (w *WebHook) Close(_ context.Context) error { return nil } // Validate checks if the webhook provider is configured correctly. func (w *WebHook) Validate() (esv1.ValidationResult, error) { timeout := 15 * time.Second url := w.url if err := esutils.NetworkValidate(url, timeout); err != nil { return esv1.ValidationResultError, err } return esv1.ValidationResultReady, nil } // NewProvider creates a new Provider instance. func NewProvider() esv1.Provider { return &Provider{} } // ProviderSpec returns the provider specification for registration. func ProviderSpec() *esv1.SecretStoreProvider { return &esv1.SecretStoreProvider{ Webhook: &esv1.WebhookProvider{}, } } // MaintenanceStatus returns the maintenance status of the provider. func MaintenanceStatus() esv1.MaintenanceStatus { return esv1.MaintenanceStatusMaintained }