End to End Encryption

A cryptography module that provides RSA & AES encryption interfaces.
Currently supports RSA-OAEP (Asymmetrical) encryption and AES-GCM (Symmetrical) encryption.
This module is available on npm.

Feature highlights

• Easy interfaces to safely encrypt / decrypt.
• RSA & AES encryption algorithms.
• PEM format export.

Contents

• Why should I use this?
• Installation
• APIs
  • RSA-OAEP
    • init()
    • exportPublicKey()
    • importClientPublic()
    • encrypt()
    • decrypt()
    • spkiToPEM()
  • AES-GCM
    • init()
    • exportKey()
    • importBufferKey()
    • encrypt()
    • decrypt()
• Tests

Why should I use this?

This module abstracts the webcrypto APIs, and provides easier interfaces to interact with.

Installation

Yarn

yarn add e2ee-ts

npm

npm i e2ee-ts

RSA Client

init()

Creates a RSA key pair, note that the private key cannot be exported. This method must be called first before other methods can be called, otherwise, it will reject all the operations.

constclient=newRSAClient();awaitclient.init();

exportPublicKey()

Exports the public key as ArrayBuffer. Returns Promise<ArrayBuffer>.

constclient=newRSAClient();awaitclient.init();constexpotedKey=awaitclient.exportPublicKey();

importClientPublic(ArrayBuffer)

Imports a public key into the object, which will be used for encryption.

constclient=newRSAClient();awaitclient.init();constexpotedKey=awaitclient.exportPublicKey();constclient2=newRSAClient();awaitclient2.importClientPublic(expotedKey);

encrypt(BufferSource)

Encrypts BufferSource using the public key. Returns Promise<ArrayBuffer>.

awaitclient.encrypt(messageasArrayBuffer,);

decrypt(ArrayBuffer)

Decrypts ArrayBuffer using the private key. Returns Promise<ArrayBuffer>.

awaitclient.decrypt(encryptedMessageasArrayBuffer);

spkiToPEM(ArrayBuffer)

Converts spki into human readable PEM format.

constclient=newRSAClient();awaitclient.init();constexpotedKey=awaitclient.exportPublicKey();constpem=client.spkiToPEM(expotedKey)

AES Client

init()

Generates a AES key, note that the private key cannot be exported. This method must be called first before other methods can be called, otherwise, it will reject all the operations.

constclient=newAESClient();awaitclient.init();

exportKey()

Exports the key as ArrayBuffer. Returns Promise<ArrayBuffer>.

constclient=newAESClient();awaitclient.init();constexpotedKey=awaitclient.exportKey();

importBufferKey(ArrayBuffer)

Imports a key into the object, which will be used for encryption.

constclient=newAESClient();awaitclient.init();constexpotedKey=awaitclient.exportKey();constclient2=newAESClient();awaitclient2.importBufferKey(expotedKey);

encrypt(BufferSource)

Encrypts BufferSource using the public key. Returns Promise<ArrayBuffer>.

awaitclient.encrypt(messageasArrayBuffer,);

decrypt(ArrayBuffer)

Decrypts ArrayBuffer using the private key. Returns Promise<ArrayBuffer>.

awaitclient.decrypt(encryptedMessageasArrayBuffer);

Tests

All unit test cases are defined under __tests__ folder.
Run it with:

npm run test