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 Juli 2015.
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 schreibgeschützte usages-Eigenschaft der CryptoKey-Schnittstelle gibt an, was mit dem Schlüssel gemacht werden kann.
Wert
Ein Array von Zeichenfolgen 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 zur Ableitung eines neuen Schlüssels verwendet werden."deriveBits": Der Schlüssel kann zur Ableitung von Bits verwendet werden."wrapKey": Der Schlüssel kann verwendet werden, um einen Schlüssel zu verpacken."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",
]);
}
importSecretKey(rawKey).then((key) =>
console.log(
`The following usages are reported for this key: ${key.usages.toString()}`,
),
);
Spezifikationen
| Specification |
|---|
| Web Cryptography Level 2 # dom-cryptokey-usages |
Browser-Kompatibilität
Loading…