index.md

---

title: AesCbcParams
slug: Web/API/AesCbcParams
page-type: web-api-interface
spec-urls: https://w3c.github.io/webcrypto/#dfn-AesCbcParams

---

{{ APIRef("Web Crypto API") }}

The AesCbcParams dictionary of the Web Crypto API represents the object that should be passed as the algorithm parameter into {{domxref("SubtleCrypto.encrypt()")}}, {{domxref("SubtleCrypto.decrypt()")}}, {{domxref("SubtleCrypto.wrapKey()")}}, or {{domxref("SubtleCrypto.unwrapKey()")}}, when using the AES-CBC algorithm.

Instance properties

• name

  • : A string. This should be set to AES-CBC.

• iv

  • : An {{jsxref("ArrayBuffer")}}, a {{jsxref("TypedArray")}}, or a {{jsxref("DataView")}}. The initialization vector. Must be 16 bytes, unpredictable, and preferably cryptographically random. However, it need not be secret (for example, it may be transmitted unencrypted along with the ciphertext).

Examples

See the examples for {{domxref("SubtleCrypto.encrypt()")}} and {{domxref("SubtleCrypto.decrypt()")}}.

Specifications

{{Specifications}}

Browser compatibility

Browsers that support the "AES-CBC" algorithm for the {{domxref("SubtleCrypto.encrypt()")}}, {{domxref("SubtleCrypto.decrypt()")}}, {{domxref("SubtleCrypto.wrapKey()")}}, or {{domxref("SubtleCrypto.unwrapKey()")}} methods will support this type.

See also

• CBC mode is defined in section 6.2 of the NIST SP800-38A standard.

• {{domxref("SubtleCrypto.encrypt()")}}.

• {{domxref("SubtleCrypto.decrypt()")}}.

• {{domxref("SubtleCrypto.wrapKey()")}}.

• {{domxref("SubtleCrypto.unwrapKey()")}}.