org.kitteh.irc.client.library.feature.sts

Interface StsStorageManager

All Known Implementing Classes:

StsPropertiesStorageManager

public interface StsStorageManager

Represents a manager that can persist STS policies in some form.

Method Summary

Modifier and Type	Method and Description
void	addEntry(String hostname, long duration, StsPolicy policy) Adds an STS policy to the store.
Optional<StsPolicy>	getEntry(String hostname) Gets an STS policy from the store, looking it up via hostname.
boolean	hasEntry(String hostname) Checks if a policy has been stored for the hostname.
void	removeEntry(String hostname) Deletes an entry from the store (used for 0 duration policies).

Method Detail

addEntry

void addEntry(@Nonnull
              String hostname,
              long duration,
              @Nonnull
              StsPolicy policy)

Adds an STS policy to the store.

Implementers MUST accept requests to add entries that already exist and overwrite the old entry.

Parameters:

hostname - the hostname (as sent in the SNI by the client)

duration - the length (in seconds) until the expiry of this stored policy

policy - the STS policy instance, including all data sent from the server

getEntry

@Nonnull
Optional<StsPolicy> getEntry(@Nonnull
                                       String hostname)

Gets an STS policy from the store, looking it up via hostname.

Parameters:

hostname - the hostname (as sent in the SNI by the client)

Returns:

all data sent by the server in the CAP LS "sts" value when we connected securely

hasEntry

boolean hasEntry(@Nonnull
                 String hostname)

Checks if a policy has been stored for the hostname.

Parameters:

hostname - the hostname to check

Returns:

whether the entry exists in the store

removeEntry

void removeEntry(@Nonnull
                 String hostname)

Deletes an entry from the store (used for 0 duration policies).

Implementers MUST ignore requests to remove entries that do not exist.

Parameters:

hostname - the hostname to remove the policy for