SubtleCrypto: decrypt() Methode - Web-APIs | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

SubtleCrypto: decrypt() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die decrypt() Methode des SubtleCrypto Interfaces entschlüsselt einige verschlüsselte Daten. Sie nimmt als Argumente einen Schlüssel zum Entschlüsseln, einige optionale zusätzliche Parameter und die zu entschlüsselnden Daten (auch als "Chiffretext" bekannt). Sie gibt ein Promise zurück, das mit den entschlüsselten Daten (auch als "Klartext" bekannt) erfüllt wird.

In diesem Artikel

Syntax

decrypt(algorithm, key, data)

Parameter

algorithm

Ein Objekt, das den zu verwendenden Algorithmus und alle erforderlichen zusätzlichen Parameter angibt. Die angegebenen Werte für die zusätzlichen Parameter müssen mit denen übereinstimmen, die im entsprechenden encrypt() Aufruf übergeben wurden.

Um RSA-OAEP zu verwenden, geben Sie ein RsaOaepParams Objekt an.
Um AES-CTR zu verwenden, geben Sie ein AesCtrParams Objekt an.
Um AES-CBC zu verwenden, geben Sie ein AesCbcParams Objekt an.
Um AES-GCM zu verwenden, geben Sie ein AesGcmParams Objekt an.

key

Ein CryptoKey, der den Schlüssel für die Entschlüsselung enthält. Wenn RSA-OAEP verwendet wird, ist dies die privateKey Eigenschaft des CryptoKeyPair Objekts.

data

Ein ArrayBuffer, ein TypedArray, oder ein DataView, das die zu entschlüsselnden Daten enthält (auch als Chiffretext bekannt).

Rückgabewert

Ein Promise, das mit einem ArrayBuffer erfüllt wird, der den Klartext enthält.

Ausnahmen

Das Promise wird abgelehnt, wenn die folgenden Ausnahmen auftreten:

InvalidAccessError DOMException

Tritt auf, wenn die angeforderte Operation für den bereitgestellten Schlüssel nicht gültig ist (z.B. ungültiger Verschlüsselungsalgorithmus oder ungültiger Schlüssel für den angegebenen Verschlüsselungsalgorithmus).

OperationError DOMException

Tritt auf, wenn die Operation aus einem spezifischen Grund fehlschlägt (z.B. Algorithmusparameter ungültiger Größen oder es gab einen Fehler bei der Entschlüsselung des Chiffretexts).

js
function decryptMessage(privateKey, ciphertext) {
  return window.crypto.subtle.decrypt(
    { name: "RSA-OAEP" },
    privateKey,
    ciphertext,
  );
}

AES-CTR

Dieser Code entschlüsselt ciphertext mit AES im CTR-Modus. Beachten Sie, dass counter mit dem Wert übereinstimmen muss, der für die Verschlüsselung verwendet wurde. Sehen Sie den vollständigen Code auf GitHub.

js
function decryptMessage(key, ciphertext) {
  return window.crypto.subtle.decrypt(
    { name: "AES-CTR", counter, length: 64 },
    key,
    ciphertext,
  );
}

AES-CBC

Dieser Code entschlüsselt ciphertext mit AES im CBC-Modus. Beachten Sie, dass iv mit dem Wert übereinstimmen muss, der für die Verschlüsselung verwendet wurde. Sehen Sie den vollständigen Code auf GitHub.

js
function decryptMessage(key, ciphertext) {
  // The iv value is the same as that used for encryption
  return window.crypto.subtle.decrypt({ name: "AES-CBC", iv }, key, ciphertext);
}

AES-GCM

Dieser Code entschlüsselt ciphertext mit AES im GCM-Modus. Beachten Sie, dass iv mit dem Wert übereinstimmen muss, der für die Verschlüsselung verwendet wurde. Sehen Sie den vollständigen Code auf GitHub.

js
function decryptMessage(key, ciphertext) {
  // The iv value is the same as that used for encryption
  return window.crypto.subtle.decrypt({ name: "AES-GCM", iv }, key, ciphertext);
}

SubtleCrypto.encrypt().
RFC 3447 spezifiziert RSAOAEP.
NIST SP800-38A spezifiziert CTR-Modus.
NIST SP800-38A spezifiziert CBC-Modus.
NIST SP800-38D spezifiziert GCM-Modus.
FIPS 198-1 spezifiziert HMAC.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Web Crypto API
SubtleCrypto
Instanzmethoden
Verwandte Seiten für Web Crypto API
Anleitungen
1. Nicht-kryptografische Anwendungen von SubtleCrypto

SubtleCrypto: decrypt() Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Ausnahmen

Unterstützte Algorithmen

Beispiele

RSA-OAEP

AES-CTR

AES-CBC

AES-GCM

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN