History

Richard van der Hoff 8e554ab5ef Avoid buffer overrun on encryption Make sure we null-terminate encrypted strings before passing them to UTF8ToString. This used to work when we allocated the buffer on the stack, because it turns out that allocate() zeroinits the returned memory. malloc(), of course, does not.		2016-12-16 14:42:41 +00:00
..
demo	Return the message index when decrypting group messages.	2016-10-20 09:58:55 +01:00
.gitignore	Make 'npm build' build the js lib	2016-04-26 12:12:08 +01:00
olm_inbound_group_session.js	zero out plaintext buffers	2016-12-15 13:37:34 +00:00
olm_outbound_group_session.js	Avoid buffer overrun on encryption	2016-12-16 14:42:41 +00:00
olm_post.js	Avoid buffer overrun on encryption	2016-12-16 14:42:41 +00:00
olm_pre.js	Let apps override emscripten settings	2016-12-14 11:46:12 +00:00
package.json	Version bump for 2.0.0	2016-10-25 11:35:20 +01:00
README.md	Javascript bindings for group sessions	2016-05-25 17:48:01 +01:00

README.md

Olm

Example:

var alice = new Olm.Account();
var bob = new Olm.Account();
alice.create();
bob.create();
bob.generate_one_time_keys(1);

var bobs_id_keys = JSON.parse(bob.identity_keys());
var bobs_id_key = bobs_id_keys.curve25519;
var bobs_ot_keys = JSON.parse(bob.one_time_keys());
for (key in bobs_ot_keys.curve25519) {
    var bobs_ot_key = bobs_ot_keys.curve25519[key];
}

alice_session = new Olm.Session();
alice_session.create_outbound(alice, bobs_id_key, bobs_ot_key);
alice_message = a_session.encrypt("Hello");

bob_session.create_inbound(bob, bob_message);
var plaintext = bob_session.decrypt(message_1.type, bob_message);
bob.remove_one_time_keys(bob_session);

Group chat:

var outbound_session = new Olm.OutboundGroupSession();
outbound_session.create();

// exchange these over a secure channel
var session_id = group_session.session_id();
var session_key = group_session.session_key();
var message_index = group_session.message_index();

var inbound_session = new Olm.InboundGroupSession();
inbound_session.create(message_index, session_key);

var ciphertext = outbound_session.encrypt("Hello");
var plaintext = inbound_session.decrypt(ciphertext);