Web Crypto API

Secure contextAvailable in workers

The Web Crypto API is an interface allowing a script to use cryptographic primitives in order to build systems using cryptography.

Some browsers implemented an interface called Crypto without having it well defined or being cryptographically sound. In order to avoid confusion, methods and properties of this interface have been removed from browsers implementing the Web Crypto API, and all Web Crypto API methods are available on a new interface: SubtleCrypto. The subtle property gives access to an object implementing it.

[!WARNING] The Web Crypto API provides a number of low-level cryptographic primitives. It’s very easy to misuse them, and the pitfalls involved can be very subtle.

Even assuming you use the basic cryptographic functions correctly, secure key management and overall security system design are extremely hard to get right, and are generally the domain of specialist security experts.

Errors in security system design and implementation can make the security of the system completely ineffective.

Please learn and experiment, but don’t guarantee or imply the security of your work before an individual knowledgeable in this subject matter thoroughly reviews it. The Crypto 101 Course can be a great place to start learning about the design and implementation of secure systems.

Interfaces

• Crypto
  • : Provides basic cryptography features, such as a cryptographically strong random number generator, and access to cryptographic primitives via a SubtleCrypto object. An object of this type can be accessed in the global scope using crypto or crypto.
• SubtleCrypto
  • : Represents an object that provides low-level cryptographic functions for key generation, encryption, decryption, key wrapping and unwrapping, and so on.
• CryptoKey
  • : Represents a cryptographic key obtained from one of the SubtleCrypto methods generateKey(), deriveKey(), importKey(), or unwrapKey().

Dictionaries

• AesCbcParams
  • : Represents the object that should be passed as the algorithm parameter into encrypt(), decrypt(), wrapKey(), or unwrapKey(), when using the AES-CBC algorithm.
• AesCtrParams
  • : Represents the object that should be passed as the algorithm parameter into encrypt(), decrypt(), wrapKey(), or unwrapKey(), when using the AES-CTR algorithm.
• AesGcmParams
  • : Represents the object that should be passed as the algorithm parameter into encrypt(), decrypt(), wrapKey(), or unwrapKey(), when using the AES-GCM algorithm.
• AesKeyGenParams
  • : Represents the object that should be passed as the algorithm parameter into generateKey(), when generating an AES key: that is, when the algorithm is identified as any of AES-CBC, AES-CTR, AES-GCM, or AES-KW.
• CryptoKeyPair
  • : Represents a public and private key pair used for an asymmetric cryptography algorithm.
• EcKeyGenParams
  • : Represents the object that should be passed as the algorithm parameter into generateKey(), when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of ECDSA or ECDH.
• EcKeyImportParams
  • : Represents the object that should be passed as the algorithm parameter into importKey() or unwrapKey(), when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of ECDSA or ECDH.
• EcdhKeyDeriveParams
  • : Represents the object that should be passed as the algorithm parameter into deriveKey(), when using the ECDH algorithm.
• EcdsaParams
  • : Represents the object that should be passed as the algorithm parameter into sign() or verify() when using the ECDSA algorithm.
• HkdfParams
  • : Represents the object that should be passed as the algorithm parameter into deriveKey(), when using the HKDF algorithm.
• HmacImportParams
  • : Represents the object that should be passed as the algorithm parameter into importKey() or unwrapKey(), when generating a key for the HMAC algorithm.
• HmacKeyGenParams
  • : Represents the object that should be passed as the algorithm parameter into generateKey(), when generating a key for the HMAC algorithm.
• Pbkdf2Params
  • : Represents the object that should be passed as the algorithm parameter into deriveKey(), when using the PBKDF2 algorithm.
• RsaHashedImportParams
  • : Represents the object that should be passed as the algorithm parameter into importKey() or unwrapKey(), when importing any RSA-based key pair: that is, when the algorithm is identified as any of RSASSA-PKCS1-v1_5, RSA-PSS, or RSA-OAEP.
• RsaHashedKeyGenParams
  • : Represents the object that should be passed as the algorithm parameter into generateKey(), when generating any RSA-based key pair: that is, when the algorithm is identified as any of RSASSA-PKCS1-v1_5, RSA-PSS, or RSA-OAEP.
• RsaOaepParams
  • : Represents the object that should be passed as the algorithm parameter into encrypt(), decrypt(), wrapKey(), or unwrapKey(), when using the RSA_OAEP algorithm.
• RsaPssParams
  • : Represents the object that should be passed as the algorithm parameter into sign() or verify(), when using the RSA-PSS algorithm.

Extensions to other interfaces

• crypto
  • : Represents the Crypto object associated with the global object in the main thread scope.
• crypto
  • : Represents Crypto object associated with the global object in worker scope.

Specifications

Browser compatibility