de.stklcode.jvault.connector.factory

Class HTTPVaultConnectorFactory

java.lang.Object

de.stklcode.jvault.connector.factory.VaultConnectorFactory

de.stklcode.jvault.connector.factory.HTTPVaultConnectorFactory

All Implemented Interfaces:

VaultConnectorBuilder

Deprecated.

As of 0.8.0 please refer to HTTPVaultConnectorBuilder with identical API.

@Deprecated
public final class HTTPVaultConnectorFactory
extends VaultConnectorFactory

Vault Connector Factory implementation for HTTP Vault connectors.

Since:

0.1

Author:

Stefan Kalscheuer

Constructor Summary

Constructors

Constructor and Description
HTTPVaultConnectorFactory() Deprecated. Default empty constructor.

Method Summary

Modifier and Type	Method and Description
HTTPVaultConnector	build() Deprecated. Build command, produces connector after initialization.
HTTPVaultConnector	buildAndAuth() Deprecated. Build connector and authenticate with token set in factory or from environment.
HTTPVaultConnectorFactory	fromEnv() Deprecated. Build connector based on the VAULT_ADDR} and VAULT_CACERT (optional) environment variables.
HTTPVaultConnectorFactory	withHost(String host) Deprecated. Set hostname (default: 127.0.0.1).
HTTPVaultConnectorFactory	withNumberOfRetries(int numberOfRetries) Deprecated. Define the number of retries to attempt on 5xx errors.
HTTPVaultConnectorFactory	withoutTLS() Deprecated. Convenience Method for NOT using TLS.
HTTPVaultConnectorFactory	withPort(Integer port) Deprecated. Set port (default: 8200).
HTTPVaultConnectorFactory	withPrefix(String prefix) Deprecated. Set API prefix.
HTTPVaultConnectorFactory	withSslContext(SSLContext sslContext) Deprecated. As of 0.8.0 this is no longer supported, please use withTrustedCA(Path) or withTrustedCA(X509Certificate).
HTTPVaultConnectorFactory	withTimeout(int milliseconds) Deprecated. Define a custom timeout for the HTTP connection.
HTTPVaultConnectorFactory	withTLS() Deprecated. Convenience Method for TLS usage (enabled by default).
HTTPVaultConnectorFactory	withTLS(boolean useTLS) Deprecated. Set TLS usage (default: TRUE).
HTTPVaultConnectorFactory	withToken(String token) Deprecated. Set token for automatic authentication, using buildAndAuth().
HTTPVaultConnectorFactory	withTrustedCA(Path cert) Deprecated. Add a trusted CA certifiate for HTTPS connections.
HTTPVaultConnectorFactory	withTrustedCA(X509Certificate cert) Deprecated. Add a trusted CA certifiate for HTTPS connections.

Methods inherited from class de.stklcode.jvault.connector.factory.VaultConnectorFactory

httpFactory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.stklcode.jvault.connector.builder.VaultConnectorBuilder

http

Constructor Detail

HTTPVaultConnectorFactory

public HTTPVaultConnectorFactory()

Deprecated.

Default empty constructor. Initializes factory with default values.

Method Detail

withHost

public HTTPVaultConnectorFactory withHost(String host)

Deprecated.

Set hostname (default: 127.0.0.1).

Parameters:

host - Hostname or IP address

Returns:

self

withPort

public HTTPVaultConnectorFactory withPort(Integer port)

Deprecated.

Set port (default: 8200).

Parameters:

port - Vault TCP port

Returns:

self

withTLS

public HTTPVaultConnectorFactory withTLS(boolean useTLS)

Deprecated.

Set TLS usage (default: TRUE).

Parameters:

useTLS - use TLS or not

Returns:

self

withTLS

public HTTPVaultConnectorFactory withTLS()

Deprecated.

Convenience Method for TLS usage (enabled by default).

Returns:

self

withoutTLS

public HTTPVaultConnectorFactory withoutTLS()

Deprecated.

Convenience Method for NOT using TLS.

Returns:

self

withPrefix

public HTTPVaultConnectorFactory withPrefix(String prefix)

Deprecated.

Set API prefix. Default is "/v1/" and changes should not be necessary for current state of development.

Parameters:

prefix - Vault API prefix (default: "/v1/"

Returns:

self

withTrustedCA

public HTTPVaultConnectorFactory withTrustedCA(Path cert)
                                        throws VaultConnectorException

Deprecated.

Add a trusted CA certifiate for HTTPS connections.

Parameters:

cert - path to certificate file

Returns:

self

Throws:

VaultConnectorException - on error

Since:

0.4.0

withTrustedCA

public HTTPVaultConnectorFactory withTrustedCA(X509Certificate cert)

Deprecated.

Add a trusted CA certifiate for HTTPS connections.

Parameters:

cert - path to certificate file

Returns:

self

Since:

0.8.0

withSslContext

public HTTPVaultConnectorFactory withSslContext(SSLContext sslContext)

Deprecated. As of 0.8.0 this is no longer supported, please use withTrustedCA(Path) or withTrustedCA(X509Certificate).

Add a custom SSL context. Overwrites certificates set by withTrustedCA(java.nio.file.Path).

Parameters:

sslContext - the SSL context

Returns:

self

Since:

0.4.0

withToken

public HTTPVaultConnectorFactory withToken(String token)

Deprecated.

Set token for automatic authentication, using buildAndAuth().

Parameters:

token - Vault token

Returns:

self

Since:

0.6.0

fromEnv

public HTTPVaultConnectorFactory fromEnv()
                                  throws VaultConnectorException

Deprecated.

Build connector based on the VAULT_ADDR} and VAULT_CACERT (optional) environment variables.

Returns:

self

Throws:

VaultConnectorException - if Vault address from environment variables is malformed

Since:

0.6.0

withNumberOfRetries

public HTTPVaultConnectorFactory withNumberOfRetries(int numberOfRetries)

Deprecated.

Define the number of retries to attempt on 5xx errors.

Parameters:

numberOfRetries - The number of retries to attempt on 5xx errors (default: 0)

Returns:

self

Since:

0.6.0

withTimeout

public HTTPVaultConnectorFactory withTimeout(int milliseconds)

Deprecated.

Define a custom timeout for the HTTP connection.

Parameters:

milliseconds - Timeout value in milliseconds.

Returns:

self

Since:

0.6.0

build

public HTTPVaultConnector build()

Deprecated.

Description copied from interface: VaultConnectorBuilder

Build command, produces connector after initialization.

Returns:

Vault Connector instance.

buildAndAuth

public HTTPVaultConnector buildAndAuth()
                                throws VaultConnectorException

Deprecated.

Description copied from interface: VaultConnectorBuilder

Build connector and authenticate with token set in factory or from environment.

Returns:

Authenticated Vault connector instance.

Throws:

VaultConnectorException - if authentication failed