Package energy.trolie.client.spp

Class SppApiTokenHeaderProvider

java.lang.Object

energy.trolie.client.spp.SppApiTokenHeaderProvider

All Implemented Interfaces:

RequestHeaderProvider

public final class SppApiTokenHeaderProvider
extends Object
implements RequestHeaderProvider

A RequestHeaderProvider that implements the SPP Two-Factor Authentication (TFA) token generation as specified in the SPP TFA Technical Specifications v1.4.

For every outgoing request, this provider generates a fresh X-SPP-API-Token header containing:

• A UTC timestamp
• A unique nonce (UUID, max 128 characters)
• An HMAC-SHA512 signature over the request metadata

Constructor Summary

Constructors

Constructor	Description
SppApiTokenHeaderProvider(String screenName, String apiKey, Clock clock)	Creates an SppApiTokenHeaderProvider with the given credentials.

Method Summary

Modifier and Type	Method	Description
Map<String,String>	headersFor(TrolieRequestContext context)

Methods inherited from class java.lang.Object

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

Constructor Details

SppApiTokenHeaderProvider

public SppApiTokenHeaderProvider(String screenName,
 String apiKey,
 Clock clock)

Creates an SppApiTokenHeaderProvider with the given credentials.

Parameters:

screenName - the SPP-assigned screen name for this client

apiKey - the Base64-encoded API key assigned by SPP

clock - the clock to use for timestamp generation (use Clock.systemUTC() in production)

Method Details

headersFor

public Map<String,String> headersFor(TrolieRequestContext context)

Specified by:

headersFor in interface RequestHeaderProvider