在此页

• 特性
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

AesCtrParams dictionary of the Web 加密 API represents the object that should be passed as the algorithm parameter into SubtleCrypto.encrypt() , SubtleCrypto.decrypt() , SubtleCrypto.wrapKey() ，或 SubtleCrypto.unwrapKey() , when using the AES-CTR 算法。

AES is a block cipher, meaning that it splits the message into blocks and encrypts it a block at a time. In CTR mode, every time a block of the message is encrypted, an extra block of data is mixed in. This extra block is called the "counter block".

A given counter block value must never be used more than once with the same key:

• Given a message n blocks long, a different counter block must be used for every block.
• If the same key is used to encrypt more than one message, a different counter block must be used for all blocks across all messages.

Typically this is achieved by splitting the initial counter block value into two concatenated parts:

• A nonce (that is, a number that may only be used once). The nonce part of the block stays the same for every block in the message. Each time a new message is to be encrypted, a new nonce is chosen. Nonces don't have to be secret, but they must not be reused with the same key.
• A counter. This part of the block gets incremented each time a block is encrypted.

Essentially: the nonce should ensure that counter blocks are not reused from one message to the next, while the counter should ensure that counter blocks are not reused within a single message.

注意 : See Appendix B of the NIST SP800-38A standard 了解更多信息。

特性

名称

A DOMString . This should be set to AES-CTR .

counter

A BufferSource — the initial value of the counter block. This must be 16 bytes long (the AES block size). The rightmost length bits of this block are used for the counter, and the rest is used for the nonce. For example, if length is set to 64, then the first half of counter is the nonce and the second half is used for the counter.

length

A Number — the number of bits in the counter block that are used for the actual counter. The counter must be big enough that it doesn't wrap: if the message is n blocks and the counter is m bits long, then the following must be true: n <= 2 m 。 NIST SP800-38A standard, which defines CTR, suggests that the counter should occupy half of the counter block (see Appendix B.2 ), so for AES it would be 64.

范例

See the examples for SubtleCrypto.encrypt() and SubtleCrypto.decrypt() .

规范

规范	状态	注释
Web Cryptography API The definition of 'SubtleCrypto.AesCtrParams' in that specification.	推荐

浏览器兼容性

Browsers that support the "AES-CTR" algorithm for the SubtleCrypto.encrypt() , SubtleCrypto.decrypt() , SubtleCrypto.wrapKey() ，或 SubtleCrypto.unwrapKey() methods will support this type.

另请参阅

• CTR mode is defined in section 6.5 of the NIST SP800-38A standard .
• SubtleCrypto.encrypt() .
• SubtleCrypto.decrypt() .
• SubtleCrypto.wrapKey() .
• SubtleCrypto.unwrapKey() .

元数据

• 最后修改： Mar 18, 2019

相关话题

1. Web 加密 API
2. AesCtrParams
3. Related pages for Web Crypto API

   1. Crypto
   2. CryptoKey
   3. RandomSource
   4. SubtleCrypto