Package net.i2p.router.crypto.ratchet

Class MuxedPQSKM

java.lang.Object

net.i2p.crypto.SessionKeyManager

net.i2p.router.crypto.ratchet.MuxedPQSKM

public class MuxedPQSKM
extends SessionKeyManager

Both EC and PQ

Since:

0.9.67

Constructor Summary

Constructors

Constructor	Description
MuxedPQSKM(RatchetSKM ec, RatchetSKM pq)

Method Summary

Modifier and Type	Method	Description
RatchetEntry	consumeNextAvailableTag(PublicKey target)	EC/PQ
SessionTag	consumeNextAvailableTag(PublicKey target, SessionKey key)	ElG only
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(...)).
SessionKey	createSession(PublicKey target)	ElG only
void	createSession(PublicKey target, SessionKey key)	ElG only
void	failTags(PublicKey target, SessionKey key, TagSetHandle ts)	ElG only
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)	ElG only
SessionKey	getCurrentOrNewKey(PublicKey target)	ElG only
RatchetSKM	getECSKM()
int	getLowThreshold()
RatchetSKM	getPQSKM()
int	getTagsToSend()	How many to send, IF we need to.
(package private) boolean	preferRatchet()	Should we try the Ratchet slow decrypt before PQ slow decrypt? Adaptive test based on previous mix of traffic for this SKM, as reported by reportDecryptResult().
void	renderStatusHTML(Writer out)
(package private) void	reportDecryptResult(boolean isRatchet, boolean success)	Report the result of a slow decrypt attempt.
boolean	shouldSendTags(PublicKey target, SessionKey key)	ElG only
boolean	shouldSendTags(PublicKey target, SessionKey key, int lowThreshold)	ElG only
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)	ElG only
TagSetHandle	tagsDelivered(PublicKey target, SessionKey key, Set<SessionTag> sessionTags)	ElG only
void	tagsReceived(SessionKey key, Set<SessionTag> sessionTags)	ElG only
void	tagsReceived(SessionKey key, Set<SessionTag> sessionTags, long expire)	ElG only
void	tagsReceived(SessionKey key, RatchetSessionTag tag, long expire)	EC only.

Methods inherited from class net.i2p.crypto.SessionKeyManager

failTags

Methods inherited from class java.lang.Object

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

Constructor Details

MuxedPQSKM

public MuxedPQSKM(RatchetSKM ec,
 RatchetSKM pq)

Method Details

getECSKM

public RatchetSKM getECSKM()

getPQSKM

public RatchetSKM getPQSKM()

preferRatchet

boolean preferRatchet()

Should we try the Ratchet slow decrypt before PQ slow decrypt? Adaptive test based on previous mix of traffic for this SKM, as reported by reportDecryptResult().

reportDecryptResult

void reportDecryptResult(boolean isRatchet,
 boolean success)

Report the result of a slow decrypt attempt.

Parameters:

isRatchet - true for EC, false for PQ

success - true for successful decrypt

getCurrentKey

public SessionKey getCurrentKey(PublicKey target)

ElG only

Overrides:

getCurrentKey in class SessionKeyManager

getCurrentOrNewKey

public SessionKey getCurrentOrNewKey(PublicKey target)

ElG only

Overrides:

getCurrentOrNewKey in class SessionKeyManager

Returns:

non-null

createSession

public void createSession(PublicKey target,
 SessionKey key)

ElG only

Overrides:

createSession in class SessionKeyManager

createSession

public SessionKey createSession(PublicKey target)

ElG only

Overrides:

createSession in class SessionKeyManager

consumeNextAvailableTag

public SessionTag consumeNextAvailableTag(PublicKey target,
 SessionKey key)

ElG only

Overrides:

consumeNextAvailableTag in class SessionKeyManager

consumeNextAvailableTag

public RatchetEntry consumeNextAvailableTag(PublicKey target)

EC/PQ

getTagsToSend

public int getTagsToSend()

Description copied from class: SessionKeyManager

How many to send, IF we need to.

Overrides:

getTagsToSend in class SessionKeyManager

getLowThreshold

public int getLowThreshold()

Overrides:

getLowThreshold in class SessionKeyManager

shouldSendTags

public boolean shouldSendTags(PublicKey target,
 SessionKey key)

ElG only

Overrides:

shouldSendTags in class SessionKeyManager

Returns:

true if we have less than the threshold or what we have is about to expire

shouldSendTags

public boolean shouldSendTags(PublicKey target,
 SessionKey key,
 int lowThreshold)

ElG only

Overrides:

shouldSendTags in class SessionKeyManager

Returns:

true if we have less than the threshold or what we have is about to expire

getAvailableTags

public int getAvailableTags(PublicKey target,
 SessionKey key)

Description copied from class: SessionKeyManager

Determine (approximately) how many available session tags for the current target have been confirmed and are available

Overrides:

getAvailableTags in class SessionKeyManager

getAvailableTimeLeft

public long getAvailableTimeLeft(PublicKey target,
 SessionKey key)

Description copied from class: SessionKeyManager

Determine how long the available tags will be available for before expiring, in milliseconds

Overrides:

getAvailableTimeLeft in class SessionKeyManager

tagsDelivered

public TagSetHandle tagsDelivered(PublicKey target,
 SessionKey key,
 Set<SessionTag> sessionTags)

ElG only

Overrides:

tagsDelivered in class SessionKeyManager

tagsReceived

public void tagsReceived(SessionKey key,
 Set<SessionTag> sessionTags)

ElG only

Overrides:

tagsReceived in class SessionKeyManager

tagsReceived

public void tagsReceived(SessionKey key,
 Set<SessionTag> sessionTags,
 long expire)

ElG only

Overrides:

tagsReceived in class SessionKeyManager

Parameters:

sessionTags - modifiable; NOT copied

expire - time from now

tagsReceived

public void tagsReceived(SessionKey key,
 RatchetSessionTag tag,
 long expire)

EC only. One time session We do not support PQ one-time sessions on MuxedPQSKM.

Parameters:

expire - time from now

consumeTag

public SessionKey consumeTag(SessionTag tag)

Description copied from class: SessionKeyManager

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(...)). returns null if no session key matches

Overrides:

consumeTag in class SessionKeyManager

shutdown

public void shutdown()

Description copied from class: SessionKeyManager

Called when the system is closing down, instructing the session key manager to take whatever precautions are necessary (saving state, etc)

Overrides:

shutdown in class SessionKeyManager

renderStatusHTML

public void renderStatusHTML(Writer out)
                      throws IOException

Overrides:

renderStatusHTML in class SessionKeyManager

Throws:

IOException

failTags

public void failTags(PublicKey target,
 SessionKey key,
 TagSetHandle ts)

ElG only

Overrides:

failTags in class SessionKeyManager

tagsAcked

public void tagsAcked(PublicKey target,
 SessionKey key,
 TagSetHandle ts)

ElG only

Overrides:

tagsAcked in class SessionKeyManager