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(@NonNull String hostname, long duration, @NonNull StsPolicy policy) Adds an STS policy to the store.
@NonNull Optional<StsPolicy>	getEntry(@NonNull String hostname) Gets an STS policy from the store, looking it up via hostname.
boolean	hasEntry(@NonNull String hostname) Checks if a policy has been stored for the hostname.
void	removeEntry(@NonNull 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