java.lang.Object

net.i2p.router.crypto.ratchet.MuxedSKM

public class MuxedSKM
extends SessionKeyManager

Both.

Since:: 0.9.44

Constructor Summary

Constructors

Constructor Description

MuxedSKM(TransientSessionKeyManager elg, RatchetSKM ec)

Method Summary

Modifier and Type	Method	Description
`RatchetEntry`	`consumeNextAvailableTag(PublicKey target)`	EC only
`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()`
`TransientSessionKeyManager`	`getElgSKM()`
`int`	`getLowThreshold()`
`int`	`getTagsToSend()`	How many to send, IF we need to.
`(package private) boolean`	`preferRatchet()`	Should we try the Ratchet slow decrypt before ElG 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

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
- MuxedSKM
  
  public MuxedSKM(TransientSessionKeyManager elg, RatchetSKM ec)
Method Details
- getElgSKM
  
  public TransientSessionKeyManager getElgSKM()
- getECSKM
  
  public RatchetSKM getECSKM()
- preferRatchet
  
  boolean preferRatchet()
  
  Should we try the Ratchet slow decrypt before ElG slow decrypt? Adaptive test based on previous mix of traffic for this SKM, as reported by reportDecryptResult().
  
  Since:
  
  0.9.46
- reportDecryptResult
  
  void reportDecryptResult(boolean isRatchet, boolean success)
  
  Report the result of a slow decrypt attempt.
  
  Parameters:
  
  isRatchet - true for EC, false for ElG
  
  success - true for successful decrypt
  
  Since:
  
  0.9.46
- 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 only
- 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
  
  sessionTags - modifiable; NOT copied
  
  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

Class MuxedSKM

Constructor Summary

Method Summary

Methods inherited from class net.i2p.crypto.SessionKeyManager

Methods inherited from class java.lang.Object

Constructor Details

Method Details