CryptoKey: usages-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die schreibgeschützte usages
-Eigenschaft der CryptoKey
-Schnittstelle gibt an, was mit dem Schlüssel gemacht werden kann.
Wert
Ein Array
von Zeichenketten aus der folgenden Liste:
"encrypt"
: Der Schlüssel kann verwendet werden, um Nachrichten zu verschlüsseln."decrypt"
: Der Schlüssel kann verwendet werden, um Nachrichten zu entschlüsseln."sign"
: Der Schlüssel kann verwendet werden, um Nachrichten zu signieren."verify"
: Der Schlüssel kann verwendet werden, um Signaturen zu verifizieren."deriveKey"
: Der Schlüssel kann bei der Ableitung eines neuen Schlüssels verwendet werden."deriveBits"
: Der Schlüssel kann bei der Ableitung von Bits verwendet werden."wrapKey"
: Der Schlüssel kann verwendet werden, um einen Schlüssel zu umhüllen."unwrapKey"
: Der Schlüssel kann verwendet werden, um einen Schlüssel zu entpacken.
Beispiele
js
const rawKey = window.crypto.getRandomValues(new Uint8Array(16));
// Import an AES secret key from an ArrayBuffer containing the raw bytes.
// Takes an ArrayBuffer string containing the bytes, and returns a Promise
// that will resolve to a CryptoKey representing the secret key.
function importSecretKey(rawKey) {
return window.crypto.subtle.importKey("raw", rawKey, "AES-GCM", true, [
"encrypt",
"decrypt",
]);
}
const key = importSecretKey(rawKey);
console.log(
`The following usages are reported for this key: ${key.usages.toString()}`,
);
Spezifikationen
Specification |
---|
Web Cryptography API # dom-cryptokey-usages |
Browser-Kompatibilität
BCD tables only load in the browser