SubtleCrypto
============

Интерфейс **`SubtileCrypto`** представляет набор криптографических примитивов. Экземпляр **`SubtileCrypto`** доступен как `Crypto.subtle` (en-US), в контексте window (`Window.crypto`).

**Предупреждение:** Per the spec: "Developers making use of the SubtleCrypto interface are expected to be aware of the security concerns associated with both the design and implementation of the various algorithms provided. The raw algorithms are provided in order to allow developers maximum flexibility in implementing a variety of protocols and applications, each of which may represent the composition and security parameters in a unique manner that necessitate the use of the raw algorithms."

Свойства
--------

*Интерфейс не наследует и не определяет собственные свойства.*

Методы
------

`SubtleCrypto.encrypt()` (en-US)

Возвращает `Promise` с данными, зашифрованными на основании исходного текста, алгоритма шифрования и ключа, переданных в качества аргументов.

`SubtleCrypto.decrypt()` (en-US)

Возвращает `Promise` с исходным текстом. В качества аргументов принимает зашифрованную строку, алгоритм шифрования и ключ.

`SubtleCrypto.sign()` (en-US)

Возвращает `Promise` с сигнатурой, полученной на основании текста, алгоритма шифрования и ключа, переданных в качества аргументов.

`SubtleCrypto.verify()` (en-US)

Возвращает `Promise` с `Boolean` значением, определяющим соответствует ли переданная сигнатура тексу, алгоритму шифрования и ключу, также переданным в качества аргументов.

`SubtleCrypto.digest()` (en-US)

Возвращает `Promise` с хеш-суммой сгенерированной на основании алгоритма шифрования и исходного текста, переданных в качества аргументов

`SubtleCrypto.generateKey()` (en-US)

Возвращает `Promise` с сгенерированным `CryptoKey` (en-US) для симметричных алгоритмов, или `CryptoKeyPair` для асимметричных алгоритмов.

`SubtleCrypto.deriveKey()` (en-US)

Возвращает `Promise` с сгенерированным `CryptoKey` (en-US), на основе переданных в качестве аргументов мастер-ключа и алгоритма шифрования.

`SubtleCrypto.deriveBits()` (en-US)

Возвращает `Promise` с буфером псевдо-случайных бит, полученных на основании мастер-ключа и алгоритма шифрования, переданных в качества аргументов.

`SubtleCrypto.importKey()` (en-US)

Returns a `Promise` of a `CryptoKey` (en-US) corresponding to the format, the algorithm, the raw key data, the usages and the extractability given as parameters.

`SubtleCrypto.exportKey()` (en-US)

Returns a `Promise` of a buffer containing the key in the format requested.

`SubtleCrypto.wrapKey()` (en-US)

Returns a `Promise` of a wrapped symmetric key for usage (transfer, storage) in insecure environments. The wrapped buffer returned is in the format given in parameters, and contains the key wrapped by the given wrapping key with the given algorithm.

`SubtleCrypto.unwrapKey()` (en-US)

Returns a `Promise` of a `CryptoKey` (en-US) corresponding to the wrapped key given in parameter.

Specifications
--------------

| Specification |
| --- |
| Web Cryptography API # subtlecrypto-interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `Crypto` and `Crypto.subtle` (en-US).