Package io.helidon.security.provider.httpsign

Class OutboundTargetDefinition.Builder

java.lang.Object

io.helidon.security.provider.httpsign.OutboundTargetDefinition.Builder

All Implemented Interfaces:

Builder<OutboundTargetDefinition>, java.util.function.Supplier<OutboundTargetDefinition>

Enclosing class:

OutboundTargetDefinition

public static class OutboundTargetDefinition.Builder
extends java.lang.Object
implements Builder<OutboundTargetDefinition>

Fluent API builder to build OutboundTargetDefinition instances. Call build() to create a new instance.

Method Summary

Modifier and Type	Method and Description
OutboundTargetDefinition.Builder	algorithm(java.lang.String algorithm) Algorithm used by this signature.
OutboundTargetDefinition	build() Build the instance from this builder.
OutboundTargetDefinition.Builder	fromConfig(Config config) Update this builder instance from configuration.
OutboundTargetDefinition.Builder	header(HttpSignHeader header) Header to store signature in.
OutboundTargetDefinition.Builder	hmacSecret(byte[] secret) Shared secret for HMAC based algorithms.
OutboundTargetDefinition.Builder	hmacSecret(java.lang.String secret) Shared secret for HMAC based algorithms.
OutboundTargetDefinition.Builder	keyId(java.lang.String keyId) Key id of this service (will be mapped by target service to validate signature).
OutboundTargetDefinition.Builder	privateKeyConfig(KeyConfig keyConfig) Private key configuration for RSA based algorithms.
OutboundTargetDefinition.Builder	signedHeaders(SignedHeadersConfig config) Configuration of required and "if-present" headers to be signed for this target.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.helidon.common.Builder

get

Method Detail

keyId

public OutboundTargetDefinition.Builder keyId(java.lang.String keyId)

Key id of this service (will be mapped by target service to validate signature).

Parameters:

keyId - key id mapped by target service

Returns:

updated builder instance

header

public OutboundTargetDefinition.Builder header(HttpSignHeader header)

Header to store signature in.

Parameters:

header - header type

Returns:

updated builder instance

algorithm

public OutboundTargetDefinition.Builder algorithm(java.lang.String algorithm)

Algorithm used by this signature. Set automatically on call to methods privateKeyConfig(KeyConfig) and hmacSecret(byte[]).

Parameters:

algorithm - algorithm to use for outbound signatures

Returns:

updated builder instance

privateKeyConfig

public OutboundTargetDefinition.Builder privateKeyConfig(KeyConfig keyConfig)

Private key configuration for RSA based algorithms. If called sets the algorithm to "rsa-sha256". Expects either explicit private key, or keystore and private key alias.

Parameters:

keyConfig - private key configuration for outbound signatures

Returns:

updated builder instance

signedHeaders

public OutboundTargetDefinition.Builder signedHeaders(SignedHeadersConfig config)

Configuration of required and "if-present" headers to be signed for this target. Defaults to the same as HttpSignProvider.Builder.inboundRequiredHeaders(SignedHeadersConfig).

Parameters:

config - configuration of outbound headers to be signed for each method.

Returns:

updated builder instance

hmacSecret

public OutboundTargetDefinition.Builder hmacSecret(byte[] secret)

Shared secret for HMAC based algorithms. Also sets the algorithm to "hmac-sha256"

Parameters:

secret - secret to sign outgoing requests (symmetric)

Returns:

updated builder instance

hmacSecret

public OutboundTargetDefinition.Builder hmacSecret(java.lang.String secret)

Shared secret for HMAC based algorithms. Calls hmacSecret(byte[]) getting bytes of the secret string with UTF-8.

Parameters:

secret - shared secret to sign outgoing requests

Returns:

updated builder instance

build

public OutboundTargetDefinition build()

Description copied from interface: Builder

Build the instance from this builder.

Specified by:

build in interface Builder<OutboundTargetDefinition>

Returns:

instance of the built type

fromConfig

public OutboundTargetDefinition.Builder fromConfig(Config config)

Update this builder instance from configuration.

Parameters:

config - config instance

Returns:

updated builder instance