webcrypto-shim-commonjs

webcrypto-shim.js
=================

Web Cryptography API shim for legacy browsers.

Quick start with _Bower_
------------------------

Install the package

``sh $ bower install webcrypto-shim`

and link scripts into your html code

`html`

Now you can use webcrypto api through the window.crypto and window.crypto.subtle objects.

Note that _IE11_ lacks support of Promise-s and requires _promiz.js_ to work properly. You can replace _promiz.js_ with any _Promise/A+_-compatible implementation.

Supported browsers ------------------

The library is targeted to fix these browsers having prefixed and buggy webcrypto api implementations: * _Internet Explorer 11_, _Mobile Internet Explorer 11_, * _Safari 8+_, _iOS Safari 8+_.

These browsers have unprefixed and conforming webcrypto api implementations, so no need in shim: * _Chrome 43+_, _Chrome for Android 44+_, * _Opera 24+_, * _Firefox 34+_, * _Edge 12+_.

Crossbrowser support of algorithms & operations -----------------------------------------------

* SHA-256, SHA-384: digest

* HMAC: sign, verify, generateKey, importKey, exportKey* with _hash_ SHA-1, SHA-256, SHA-384

* AES-CBC: encrypt, decrypt, generateKey, importKey, exportKey, wrapKey, unwrapKey* _TODO_ tests

* AES-KW: generateKey, importKey, exportKey, wrapKey, unwrapKey* _TODO_ tests

* RSASSA-PKCS1-v1\_5: sign, verify, generateKey, importKey, exportKey* with _hash_ SHA-256, SHA-384 * and _modulusLength_ at least 2048 bits

* RSA-OAEP: encrypt, decrypt, generateKey, importKey, exportKey, wrapKey, unwrapKey* with _hash_ SHA-1 * and _modulusLength_ at least 2048 bits * _FIXME_ only"jwk" format for wrapped/unwrapped keys

Known limitations -----------------

deriveKey, deriveBits are not supported under _IE11_ and _Safari_ since there is no implementation of any algorithm providing key derivation.

Under _IE11_ exception is thrown in case of empty input data since _IE11_ silently discards empty data and leaves returned Promise` object never resolved nor rejected.

Other browsers support
----------------------

See https://vibornoff.github.io/webcrypto-examples/index.html