SubtleCrypto

Instanz-Eigenschaften

Diese Schnittstelle erbt keine Eigenschaften, da sie keine übergeordnete Schnittstelle hat.

Instanz-Methoden

Diese Schnittstelle erbt keine Methoden, da sie keine übergeordnete Schnittstelle hat.

SubtleCrypto.encrypt()

Gibt ein Promise zurück, das mit den verschlüsselten Daten erfüllt wird, die dem angegebenen Klartext, Algorithmus und Schlüssel entsprechen.

SubtleCrypto.decrypt()

Gibt ein Promise zurück, das mit den Klartextdaten erfüllt wird, die dem verschlüsselten Text, Algorithmus und Schlüssel entsprechen, die als Parameter angegeben sind.

SubtleCrypto.sign()

Gibt ein Promise zurück, das mit der Signatur erfüllt wird, die dem Text, Algorithmus und Schlüssel entspricht, die als Parameter angegeben sind.

SubtleCrypto.verify()

Gibt ein Promise zurück, das mit einem booleschen Wert erfüllt wird, der angibt, ob die als Parameter angegebene Signatur mit dem Text, Algorithmus und Schlüssel übereinstimmt, die ebenfalls als Parameter angegeben sind.

SubtleCrypto.digest()

Gibt ein Promise zurück, das mit einem Digest erfüllt wird, der aus dem angegebenen Algorithmus und Text generiert wurde.

SubtleCrypto.generateKey()

Gibt ein Promise zurück, das mit einem neu generierten CryptoKey für symmetrische Algorithmen oder einem CryptoKeyPair erfüllt wird, das zwei neu generierte Schlüssel für asymmetrische Algorithmen enthält, die dem Algorithmus, den Verwendungen und der Extraktionsfähigkeit entsprechen, die als Parameter angegeben wurden.

SubtleCrypto.deriveKey()

Gibt ein Promise zurück, das mit einem neu generierten CryptoKey erfüllt wird, der aus dem Master-Schlüssel und dem spezifischen Algorithmus abgeleitet wurde, die als Parameter angegeben sind.

SubtleCrypto.deriveBits()

Gibt ein Promise zurück, das mit einem neu generierten Puffer von pseudorandomisierten Bits erfüllt wird, die aus dem Master-Schlüssel und dem spezifischen Algorithmus abgeleitet wurden, die als Parameter angegeben sind.

SubtleCrypto.importKey()

Gibt ein Promise zurück, das mit einem CryptoKey erfüllt wird, der dem Format, dem Algorithmus, den rohen Schlüsseldaten, den Verwendungen und der Extraktionsfähigkeit entspricht, die als Parameter angegeben sind.

SubtleCrypto.exportKey()

Gibt ein Promise zurück, das mit den rohen Schlüsseldaten erfüllt wird, die den Schlüssel im angeforderten Format enthalten.

SubtleCrypto.wrapKey()

Gibt ein Promise zurück, das mit einem umschlossenen symmetrischen Schlüssel erfüllt wird, um ihn in unsicheren Umgebungen zu verwenden (Übertragung und Speicherung). Der umschlossene Schlüssel entspricht dem im gegebenen Parameter angegebenen Format, und das Umschließen wird durch den gegebenen Umschlüssel mit dem angegebenen Algorithmus durchgeführt.

SubtleCrypto.unwrapKey()

Gibt ein Promise zurück, das mit einem CryptoKey erfüllt wird, der dem im Parameter angegebenen umschlossenen Schlüssel entspricht.

Verwendung von SubtleCrypto

Wir können die von dieser API implementierten Funktionen in zwei Gruppen aufteilen: kryptografische Funktionen und Schlüsselmanagement-Funktionen.

Kryptografische Funktionen

Dies sind die Funktionen, die Sie verwenden können, um Sicherheitsmerkmale wie Vertraulichkeit und Authentifizierung in einem System zu implementieren. Die SubtleCrypto-API bietet die folgenden kryptografischen Funktionen:

• sign() und verify(): Erstellen und Überprüfen digitaler Signaturen.
• encrypt() und decrypt(): Verschlüsseln und Entschlüsseln von Daten.
• digest(): Erstellen eines festgelegten, kollisionsresistenten Digests von Daten.

Schlüsselmanagement-Funktionen

Mit Ausnahme von digest() verwenden alle kryptografischen Funktionen in der API kryptografische Schlüssel. In der SubtleCrypto-API wird ein kryptografischer Schlüssel durch ein CryptoKey-Objekt dargestellt. Um Operationen wie das Signieren und Verschlüsseln durchzuführen, übergeben Sie ein CryptoKey-Objekt an die sign() oder encrypt() Funktion.

Erzeugen und Ableiten von Schlüsseln

Die Funktionen generateKey() und deriveKey() erstellen beide ein neues CryptoKey-Objekt.

Der Unterschied ist, dass generateKey() bei jedem Aufruf einen neuen, unterschiedlichen Schlüsselwert generiert, während deriveKey() einen Schlüssel aus einem anfänglichen Schlüsselmaterial ableitet. Wenn Sie das gleiche Schlüsselmaterial zwei separaten Aufrufen von deriveKey() zur Verfügung stellen, erhalten Sie zwei CryptoKey-Objekte, die denselben zugrunde liegenden Wert haben. Dies ist nützlich, wenn Sie beispielsweise einen Verschlüsselungsschlüssel aus einem Passwort ableiten und später denselben Schlüssel aus demselben Passwort ableiten möchten, um die Daten zu entschlüsseln.

Importieren und Exportieren von Schlüsseln

Um Schlüssel außerhalb Ihrer App verfügbar zu machen, müssen Sie den Schlüssel exportieren, was die Funktion exportKey() tut. Sie können eines von mehreren Exportformaten wählen.

Das Gegenteil von exportKey() ist importKey(). Sie können Schlüssel aus anderen Systemen importieren, und die Unterstützung für Standardformate wie PKCS #8 und JSON Web Key hilft Ihnen dabei. Die Funktion exportKey() exportiert den Schlüssel in einem unverschlüsselten Format.

Wenn der Schlüssel sensitiv ist, sollten Sie wrapKey() verwenden, die den Schlüssel exportiert und ihn dann mit einem anderen Schlüssel verschlüsselt; die API nennt dies einen "Key-Wrapping-Schlüssel".

Das Gegenteil von wrapKey() ist unwrapKey(), das den Schlüssel entschlüsselt und dann importiert.

Speichern von Schlüsseln

CryptoKey ist ein serialisierbares Objekt, das es ermöglicht, Schlüssel mit den Standard-Web-Speicher-APIs zu speichern und abzurufen.

Die Spezifikation erwartet, dass die meisten Entwickler die IndexedDB API verwenden, um CryptoKey-Objekte gegen einen klassischen Schlüsselstring-Identifikator zu speichern, der für die Anwendung sinnvoll ist, sowie alle anderen Metadaten, die sie nützlich finden. Dies ermöglicht das Speichern und Abrufen des CryptoKey, ohne das zugrunde liegende Schlüsselmateriel der Anwendung oder der JavaScript-Umgebung auszusetzen.

Unterstützte Algorithmen

Die von der Web Crypto API bereitgestellten kryptografischen Funktionen können durch einen oder mehrere verschiedene kryptografische Algorithmen ausgeführt werden: das algorithm-Argument der Funktion gibt an, welcher Algorithmus verwendet werden soll. Einige Algorithmen benötigen zusätzliche Parameter: In diesen Fällen ist das algorithm-Argument ein Wörterbuchobjekt, das die zusätzlichen Parameter enthält.

Die folgende Tabelle fasst zusammen, welche Algorithmen für welche kryptografischen Operationen geeignet sind:

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Web Crypto API
• Nicht-kryptografische Verwendungen von SubtleCrypto
• Websicherheit
• Datenschutz, Berechtigungen und Informationssicherheit
• Crypto und Crypto.subtle.
• Crypto 101: ein Einführungskurs in die Kryptografie.