org.jivesoftware.smackx.omemo.signal

Class SignalOmemoSession

java.lang.Object

org.jivesoftware.smackx.omemo.internal.OmemoSession<org.whispersystems.libsignal.IdentityKeyPair,org.whispersystems.libsignal.IdentityKey,org.whispersystems.libsignal.state.PreKeyRecord,org.whispersystems.libsignal.state.SignedPreKeyRecord,org.whispersystems.libsignal.state.SessionRecord,org.whispersystems.libsignal.SignalProtocolAddress,org.whispersystems.libsignal.ecc.ECPublicKey,org.whispersystems.libsignal.state.PreKeyBundle,org.whispersystems.libsignal.SessionCipher>

org.jivesoftware.smackx.omemo.signal.SignalOmemoSession

public class SignalOmemoSession
extends OmemoSession<org.whispersystems.libsignal.IdentityKeyPair,org.whispersystems.libsignal.IdentityKey,org.whispersystems.libsignal.state.PreKeyRecord,org.whispersystems.libsignal.state.SignedPreKeyRecord,org.whispersystems.libsignal.state.SessionRecord,org.whispersystems.libsignal.SignalProtocolAddress,org.whispersystems.libsignal.ecc.ECPublicKey,org.whispersystems.libsignal.state.PreKeyBundle,org.whispersystems.libsignal.SessionCipher>

Concrete implementation of the OmemoSession using the Signal library.

Field Summary

Fields inherited from class org.jivesoftware.smackx.omemo.internal.OmemoSession

cipher, identityKey, omemoManager, omemoStore, preKeyId, remoteDevice

Method Summary

Modifier and Type	Method and Description
org.whispersystems.libsignal.SessionCipher	createCipher(OmemoDevice contact) Create a new SessionCipher used to encrypt/decrypt keys.
byte[]	decryptMessageKey(byte[] encryptedKey) Decrypt a messageKey using our sessionCipher.
CiphertextTuple	encryptMessageKey(byte[] messageKey) Encrypt a message key for the recipient.

Methods inherited from class org.jivesoftware.smackx.omemo.internal.OmemoSession

decryptMessageElement, decryptMessageElement, decryptTransportedKey, getFingerprint, getIdentityKey, getPreKeyId, setIdentityKey

Methods inherited from class java.lang.Object

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

Method Detail

createCipher

public org.whispersystems.libsignal.SessionCipher createCipher(OmemoDevice contact)

Description copied from class: OmemoSession

Create a new SessionCipher used to encrypt/decrypt keys. The cipher typically implements the ratchet and KDF-chains.

Specified by:

createCipher in class OmemoSession<org.whispersystems.libsignal.IdentityKeyPair,org.whispersystems.libsignal.IdentityKey,org.whispersystems.libsignal.state.PreKeyRecord,org.whispersystems.libsignal.state.SignedPreKeyRecord,org.whispersystems.libsignal.state.SessionRecord,org.whispersystems.libsignal.SignalProtocolAddress,org.whispersystems.libsignal.ecc.ECPublicKey,org.whispersystems.libsignal.state.PreKeyBundle,org.whispersystems.libsignal.SessionCipher>

Parameters:

contact - OmemoDevice

Returns:

SessionCipher

encryptMessageKey

public CiphertextTuple encryptMessageKey(byte[] messageKey)

Description copied from class: OmemoSession

Encrypt a message key for the recipient. This key can be deciphered by the recipient with its corresponding session cipher. The key is then used to decipher the message.

Specified by:

encryptMessageKey in class OmemoSession<org.whispersystems.libsignal.IdentityKeyPair,org.whispersystems.libsignal.IdentityKey,org.whispersystems.libsignal.state.PreKeyRecord,org.whispersystems.libsignal.state.SignedPreKeyRecord,org.whispersystems.libsignal.state.SessionRecord,org.whispersystems.libsignal.SignalProtocolAddress,org.whispersystems.libsignal.ecc.ECPublicKey,org.whispersystems.libsignal.state.PreKeyBundle,org.whispersystems.libsignal.SessionCipher>

Parameters:

messageKey - serialized key to encrypt

Returns:

A CiphertextTuple containing the ciphertext and the messageType

decryptMessageKey

public byte[] decryptMessageKey(byte[] encryptedKey)
                         throws NoRawSessionException

Description copied from class: OmemoSession

Decrypt a messageKey using our sessionCipher. We can use that key to decipher the actual message. Same as encryptMessageKey, just the other way round.

Specified by:

decryptMessageKey in class OmemoSession<org.whispersystems.libsignal.IdentityKeyPair,org.whispersystems.libsignal.IdentityKey,org.whispersystems.libsignal.state.PreKeyRecord,org.whispersystems.libsignal.state.SignedPreKeyRecord,org.whispersystems.libsignal.state.SessionRecord,org.whispersystems.libsignal.SignalProtocolAddress,org.whispersystems.libsignal.ecc.ECPublicKey,org.whispersystems.libsignal.state.PreKeyBundle,org.whispersystems.libsignal.SessionCipher>

Parameters:

encryptedKey - encrypted key

Returns:

serialized decrypted key or null

Throws:

NoRawSessionException - when no session was found in the double ratchet library