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