Web Cryptography API shim for legacy browsers
npm install webcrypto-shimwebcrypto-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 - 10_, _iOS Safari 8 - 10_.
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+_.
* _Safari 11+_.
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 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
Sponsored by
------------
BrowserStack — automated & manual crossbrowser testing solution.