DasAesCtrParams-Wörterbuch derWeb Crypto API repräsentiert das Objekt, das alsalgorithm-Parameter inSubtleCrypto.encrypt(),SubtleCrypto.decrypt(),SubtleCrypto.wrapKey() oderSubtleCrypto.unwrapKey() übergeben werden sollte, wenn derAES-CTR-Algorithmus verwendet wird.

AES ist ein Blockchiffre, was bedeutet, dass es die Nachricht in Blöcke aufteilt und diese Block für Block verschlüsselt. Im CTR-Modus wird jedes Mal, wenn ein Block der Nachricht verschlüsselt wird, ein zusätzlicher Block von Daten eingemischt. Dieser zusätzliche Block wird "Counter-Block" genannt.

Ein gegebener Counter-Block-Wert darf nicht mehr als einmal mit demselben Schlüssel verwendet werden:

• Bei einer Nachricht, dien Blöcke lang ist, muss für jeden Block ein anderer Counter-Block verwendet werden.
• Wenn derselbe Schlüssel zum Verschlüsseln mehrerer Nachrichten verwendet wird, muss für alle Blöcke über alle Nachrichten hinweg ein unterschiedlicher Counter-Block verwendet werden.

Typischerweise wird dies erreicht, indem der anfängliche Counter-Block-Wert in zwei zusammengefügte Teile aufgeteilt wird:

• EineNonce (das heißt, eine Zahl, die nur einmal verwendet werden darf). Der Nonce-Teil des Blocks bleibt für jeden Block in der Nachricht gleich. Jedes Mal, wenn eine neue Nachricht verschlüsselt werden soll, wird eine neue Nonce gewählt. Nonces müssen nicht geheim sein, aber sie dürfen nicht mit demselben Schlüssel wiederverwendet werden.
• Ein Zähler. Dieser Teil des Blocks wird jedes Mal inkrementiert, wenn ein Block verschlüsselt wird.

Im Wesentlichen sollte die Nonce sicherstellen, dass Counter-Blöcke nicht von einer Nachricht zur nächsten wiederverwendet werden, während der Zähler sicherstellen sollte, dass Counter-Blöcke nicht innerhalb einer einzelnen Nachricht wiederverwendet werden.

Instanz-Eigenschaften

name

Ein String. Dieser sollte aufAES-CTR gesetzt werden.

counter

EinArrayBuffer, einTypedArray, oder eineDataView — Der Anfangswert des Counter-Blocks. Dieser muss 16 Bytes lang sein (die AES-Blockgröße). Die rechtsmostlength Bits dieses Blocks werden für den Zähler verwendet, und der Rest wird für die Nonce verwendet. Zum Beispiel, wennlength auf 64 gesetzt ist, dann ist die erste Hälfte voncounter die Nonce und die zweite Hälfte wird für den Zähler verwendet.

length

EineNumber — die Anzahl der Bits im Counter-Block, die für den tatsächlichen Zähler verwendet werden. Der Zähler muss groß genug sein, damit er nicht überläuft: Wenn die Nachrichtn Blöcke lang ist und der Zählerm Bits lang ist, muss folgendes gelten:n <= 2^m. DerNIST SP800-38A Standard, der CTR definiert, empfiehlt, dass der Zähler die Hälfte des Counter-Blocks einnehmen sollte (sieheAnhang B.2), so dass er für AES 64 wäre.

Beispiele

Siehe die Beispiele fürSubtleCrypto.encrypt() undSubtleCrypto.decrypt().

Spezifikationen

Browser-Kompatibilität

Browser, die den "AES-CTR"-Algorithmus für die MethodenSubtleCrypto.encrypt(),SubtleCrypto.decrypt(),SubtleCrypto.wrapKey(), oderSubtleCrypto.unwrapKey() unterstützen, werden diesen Typ unterstützen.

Siehe auch

• Der CTR-Modus ist in Abschnitt 6.5 desNIST SP800-38A-Standards definiert.
• SubtleCrypto.encrypt().
• SubtleCrypto.decrypt().
• SubtleCrypto.wrapKey().
• SubtleCrypto.unwrapKey().