io.helidon.integrations.vault.secrets.kv1.Kv1SecurityProvider Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of helidon-integrations-vault-secrets-kv1 Show documentation
Key/Value secrets engine version 1 support for Vault.
There is a newer version: 4.1.6
Show newest version
/*
 * Copyright (c) 2021, 2023 Oracle and/or its affiliates.
 *
 * 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 io.helidon.integrations.vault.secrets.kv1;

import java.util.Objects;
import java.util.Optional;
import java.util.function.Supplier;

import io.helidon.common.config.Config;
import io.helidon.integrations.vault.Vault;
import io.helidon.security.spi.ProviderConfig;
import io.helidon.security.spi.SecretsProvider;

/**
 * Integration with Helidon Security.
 */
public class Kv1SecurityProvider implements SecretsProvider {
    private final Kv1Secrets secrets;

    Kv1SecurityProvider(Vault vault) {
        this.secrets = vault.secrets(Kv1Secrets.ENGINE);
    }

    @Override
    public Supplier> secret(Config config) {
        return secret(Kv1SecretConfig.create(config));
    }

    @Override
    public Supplier> secret(Kv1SecretConfig providerConfig) {
        String key = providerConfig.key;

        return () -> secrets.get(providerConfig.request())
                .entity()
                .flatMap(response -> response.value(key));
    }

    /**
     * Configuration of a secret when using programmatic setup of security secrets.
     */
    public static class Kv1SecretConfig implements ProviderConfig {
        private final String path;
        private final String key;

        private Kv1SecretConfig(Builder builder) {
            this.path = builder.path;
            this.key = builder.key;
        }

        /**
         * A new builder for {@link io.helidon.integrations.vault.secrets.kv1.Kv1SecurityProvider.Kv1SecretConfig}.
         *
         * @return a new builder
         */
        public static Builder builder() {
            return new Builder();
        }

        /**
         * Create a new secrets configuration from config.
         *
         * @param config config to use
         * @return a new secret configuration
         */
        public static Kv1SecretConfig create(Config config) {
            return builder()
                    .config(config)
                    .build();
        }

        private GetKv1.Request request() {
            return GetKv1.Request.builder()
                    .path(this.path);
        }

        /**
         * Fluent API builder for {@link io.helidon.integrations.vault.secrets.kv1.Kv1SecurityProvider.Kv1SecretConfig}.
         */
        public static class Builder implements io.helidon.common.Builder {
            private String path;
            private String key;

            private Builder() {
            }

            @Override
            public Kv1SecretConfig build() {
                Objects.requireNonNull(path, "Secret path must be defined. Config property \"path\"");
                Objects.requireNonNull(key, "Secret value key must be defined. Config property \"key\"");

                return new Kv1SecretConfig(this);
            }

            /**
             * Update this builder from configuration.
             * Configuration options:
             * 
             * 
             * 
             *     
             *     
             *     
             * 
             * 
             *     
             *     
             *     
             * 
             * 
             *     
             *     
             *     
             * 
             * Secret configurationkey description builder method
path Path of the secret on Vault's KV2 secret provider {@link #path(String)}
key Key within the secret used to obtain the value {@link #key(String)}
             *
             * @param config config to use
             * @return updated builder
             */
            public Builder config(Config config) {
                config.get("path").asString().ifPresent(this::path);
                config.get("key").asString().ifPresent(this::key);
                return this;
            }

            /**
             * Path of the secret on Vault's KV1 secret provider.
             *
             * @param path secret path
             * @return updated builder
             */
            public Builder path(String path) {
                this.path = path;
                return this;
            }

            /**
             * Key within the secret used to obtain the value.
             *
             * @param key key to use
             * @return updated builder
             */
            public Builder key(String key) {
                this.key = key;
                return this;
            }
        }
    }
}
key	description	builder method
path	Path of the secret on Vault's KV2 secret provider	{@link #path(String)}
key	Key within the secret used to obtain the value	{@link #key(String)}