Перейти до вмісту

Web Crypto API

Випадкові значення, UUID, ключі та криптографічні операції

На цій сторінці
Open in ChatGPTOpen in Claude

Глобальний об’єкт crypto надає getRandomValues(typedArray), randomUUID() і crypto.subtle — SubtleCrypto на основі тієї самої реалізації AWS-LC, що й node:crypto. Ключі — це об’єкти CryptoKey (глобальний клас); вони мають спільний ключовий матеріал із KeyObject, тож KeyObject.from(cryptoKey) і keyObject.toCryptoKey() перетворюють без копіювання. util.types.isCryptoKey() і util.types.isKeyObject() їх розпізнають.

ОпераціяАлгоритми
digestSHA-1, SHA-256, SHA-384, SHA-512, SHA3-256/384/512, cSHAKE128/256 (без імені функції чи кастомізації)
generateKey, importKey, exportKeyRSASSA-PKCS1-v1_5, RSA-PSS, RSA-OAEP, ECDSA, ECDH (P-256, P-384, P-521), Ed25519, X25519, HMAC, AES-CTR/CBC/GCM/KW, ChaCha20-Poly1305; HKDF і PBKDF2 — лише імпорт
sign, verifyRSASSA-PKCS1-v1_5, RSA-PSS, ECDSA, Ed25519, HMAC
encrypt, decryptRSA-OAEP, AES-CTR, AES-CBC, AES-GCM, ChaCha20-Poly1305
wrapKey, unwrapKeyAES-KW і кожен алгоритм encrypt/decrypt
deriveBits, deriveKeyECDH, X25519, HKDF, PBKDF2
getPublicKey, SubtleCrypto.supportsяк у Node (експериментально)

Формати ключів: raw (і псевдоніми raw-public/raw-secret), spki, pkcs8 і jwk.

const key = await crypto.subtle.generateKey(
  { name: "AES-GCM", length: 256 },
  true,
  ["encrypt", "decrypt"],
);
const iv = crypto.getRandomValues(new Uint8Array(12));
const sealed = await crypto.subtle.encrypt(
  { name: "AES-GCM", iv },
  key,
  new TextEncoder().encode("hello"),
);

Перевірка, імена помилок і повідомлення відповідають Node. Elide поводиться як збірка на основі BoringSSL, тож алгоритми, які Node пропонує лише з OpenSSL 3, недоступні: Ed448, X448, AES-OCB, KMAC, Argon2, ML-DSA, ML-KEM, TurboSHAKE і KangarooTwelve відхиляються з NotSupportedError.

Reference

Status: Full · Not measured · since 1.1.0

Exports

ExportKindStatusNotes
cryptoobjectFullrandomUUID(), getRandomValues(), subtle
SubtleCryptoclassFulldigest(), encrypt(), decrypt(), sign(), verify(), generateKey(), importKey(), exportKey(), deriveBits(), deriveKey(), wrapKey(), unwrapKey()

Чи була ця сторінка корисною?