net.i2p.crypto
public class TransientSessionKeyManager extends SessionKeyManager
Modifier and Type | Field and Description |
---|---|
protected I2PAppContext |
_context |
static int |
MAX_INBOUND_SESSION_TAGS
a few MB? how about 16MB!
This is the max size of _inboundTagSets.
|
static long |
SESSION_LIFETIME_MAX_MS
Keep unused inbound session tags around for up to 12 minutes (2 minutes longer than
session tags are used on the outbound side so that no reasonable network lag
can cause failed decrypts)
|
static long |
SESSION_TAG_DURATION_MS
Let session tags sit around for 10 minutes before expiring them.
|
Constructor and Description |
---|
TransientSessionKeyManager(I2PAppContext context)
The session key manager should only be constructed and accessed through the
application context.
|
Modifier and Type | Method and Description |
---|---|
SessionTag |
consumeNextAvailableTag(PublicKey target,
SessionKey key)
Retrieve the next available session tag for identifying the use of the given
key when communicating with the target.
|
SessionKey |
consumeTag(SessionTag tag)
Determine if we have received a session key associated with the given session tag,
and if so, discard it (but keep track for frequent dups) and return the decryption
key it was received with (via tagsReceived(...)).
|
void |
createSession(PublicKey target,
SessionKey key)
Associate a new session key with the specified target.
|
void |
failTags(PublicKey target)
Deprecated.
unused and rather drastic
|
void |
failTags(PublicKey target,
SessionKey key,
TagSetHandle ts)
Mark these tags as invalid, since the peer
has failed to ack them in time.
|
int |
getAvailableTags(PublicKey target,
SessionKey key)
Determine (approximately) how many available session tags for the current target
have been confirmed and are available
|
long |
getAvailableTimeLeft(PublicKey target,
SessionKey key)
Determine how long the available tags will be available for before expiring, in
milliseconds
|
SessionKey |
getCurrentKey(PublicKey target)
Retrieve the session key currently associated with encryption to the target,
or null if a new session key should be generated.
|
void |
renderStatusHTML(Writer out) |
void |
shutdown()
Called when the system is closing down, instructing the session key manager to take
whatever precautions are necessary (saving state, etc)
|
void |
tagsAcked(PublicKey target,
SessionKey key,
TagSetHandle ts)
Mark these tags as acked, start to use them (if we haven't already)
|
TagSetHandle |
tagsDelivered(PublicKey target,
SessionKey key,
Set<SessionTag> sessionTags)
Take note of the fact that the given sessionTags associated with the key for
encryption to the target have been sent.
|
void |
tagsReceived(SessionKey key,
Set<SessionTag> sessionTags)
Accept the given tags and associate them with the given key for decryption
|
createSession
protected I2PAppContext _context
public static final long SESSION_TAG_DURATION_MS
public static final long SESSION_LIFETIME_MAX_MS
public static final int MAX_INBOUND_SESSION_TAGS
public TransientSessionKeyManager(I2PAppContext context)
public void shutdown()
SessionKeyManager
shutdown
in class SessionKeyManager
public SessionKey getCurrentKey(PublicKey target)
getCurrentKey
in class SessionKeyManager
public void createSession(PublicKey target, SessionKey key)
createSession
in class SessionKeyManager
public SessionTag consumeNextAvailableTag(PublicKey target, SessionKey key)
consumeNextAvailableTag
in class SessionKeyManager
public int getAvailableTags(PublicKey target, SessionKey key)
getAvailableTags
in class SessionKeyManager
public long getAvailableTimeLeft(PublicKey target, SessionKey key)
getAvailableTimeLeft
in class SessionKeyManager
public TagSetHandle tagsDelivered(PublicKey target, SessionKey key, Set<SessionTag> sessionTags)
tagsDelivered
in class SessionKeyManager
public void failTags(PublicKey target)
failTags
in class SessionKeyManager
public void failTags(PublicKey target, SessionKey key, TagSetHandle ts)
failTags
in class SessionKeyManager
public void tagsAcked(PublicKey target, SessionKey key, TagSetHandle ts)
tagsAcked
in class SessionKeyManager
public void tagsReceived(SessionKey key, Set<SessionTag> sessionTags)
tagsReceived
in class SessionKeyManager
public SessionKey consumeTag(SessionTag tag)
consumeTag
in class SessionKeyManager
public void renderStatusHTML(Writer out) throws IOException
renderStatusHTML
in class SessionKeyManager
IOException