Package io.helidon.security.provider.httpsign

Class OutboundTargetDefinition

java.lang.Object

io.helidon.security.provider.httpsign.OutboundTargetDefinition

public class OutboundTargetDefinition
extends java.lang.Object

Configuration of outbound target to sign outgoing requests.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OutboundTargetDefinition.Builder	Fluent API builder to build OutboundTargetDefinition instances.

Method Summary

Modifier and Type	Method	Description
static OutboundTargetDefinition.Builder	builder(Config config)	Create a builder from configuration.
static OutboundTargetDefinition.Builder	builder(java.lang.String keyId)	Get a new builder .
static OutboundTargetDefinition	fromConfig(Config config)	Create an instance from configuration.
java.lang.String	getAlgorithm()	Algorithm used by this signature.
HttpSignHeader	getHeader()	Header to store signature in.
java.util.Optional<byte[]>	getHmacSharedSecret()	Shared secret for HMAC based algorithms.
java.util.Optional<KeyConfig>	getKeyConfig()	Private key configuration for RSA based algorithms.
java.lang.String	getKeyId()	Key id of this service (will be mapped by target service to validate signature).
SignedHeadersConfig	getSignedHeadersConfig()	Configuration of method to headers to define headers to be signed.

Methods inherited from class java.lang.Object

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

Method Detail

builder

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

Get a new builder .

Parameters:

keyId - keyId to send with signature

Returns:

builder instance

builder

public static OutboundTargetDefinition.Builder builder(Config config)

Create a builder from configuration.

Parameters:

config - configuration located at this target, expects "key-id" to be a child

Returns:

builder instance

fromConfig

public static OutboundTargetDefinition fromConfig(Config config)

Create an instance from configuration.

Parameters:

config - configuration located at this outbound key, expects "key-id" to be a child

Returns:

new instance configured from config

getKeyId

public java.lang.String getKeyId()

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

Returns:

key id string (may be an API key, key fingerprint, service name etc.)

getAlgorithm

public java.lang.String getAlgorithm()

Algorithm used by this signature.

Returns:

algorithm

getKeyConfig

public java.util.Optional<KeyConfig> getKeyConfig()

Private key configuration for RSA based algorithms.

Returns:

private key location and configuration or empty optional if not configured

getHmacSharedSecret

public java.util.Optional<byte[]> getHmacSharedSecret()

Shared secret for HMAC based algorithms.

Returns:

shared secret or empty optional if not configured

getHeader

public HttpSignHeader getHeader()

Header to store signature in.

Returns:

header type

getSignedHeadersConfig

public SignedHeadersConfig getSignedHeadersConfig()

Configuration of method to headers to define headers to be signed.

The following headers have special handling:

• date - if not present and required, will be added to request
• host - if not present and required, will be added to request from target URI
• (request-target) - as per spec, calculated from method and path
• authorization - if getHeader() returns HttpSignHeader.AUTHORIZATION it is ignored

Returns:

configuration of headers to be signed