Saltar al contenido

API Web Crypto

Valores aleatorios, UUID, claves y operaciones criptográficas

En esta página
Open in ChatGPTOpen in Claude

El objeto global crypto proporciona getRandomValues(typedArray), randomUUID() y crypto.subtle, un SubtleCrypto respaldado por la misma implementación de AWS-LC que node:crypto. Las claves son objetos CryptoKey (una clase global); comparten el material de clave con KeyObject, de modo que KeyObject.from(cryptoKey) y keyObject.toCryptoKey() convierten sin copiar. util.types.isCryptoKey() y util.types.isKeyObject() los reconocen.

OperaciónAlgoritmos
digestSHA-1, SHA-256, SHA-384, SHA-512, SHA3-256/384/512, cSHAKE128/256 (sin nombre de función ni personalización)
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 y PBKDF2 solo importación
sign, verifyRSASSA-PKCS1-v1_5, RSA-PSS, ECDSA, Ed25519, HMAC
encrypt, decryptRSA-OAEP, AES-CTR, AES-CBC, AES-GCM, ChaCha20-Poly1305
wrapKey, unwrapKeyAES-KW y todos los algoritmos de encrypt/decrypt
deriveBits, deriveKeyECDH, X25519, HKDF, PBKDF2
getPublicKey, SubtleCrypto.supportscomo en Node (experimental)

Los formatos de clave son raw (y los alias raw-public/raw-secret), spki, pkcs8 y 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"),
);

La validación, los nombres de error y los mensajes siguen a Node. Elide se comporta como una compilación basada en BoringSSL, así que los algoritmos que Node solo ofrece con OpenSSL 3 no están disponibles: Ed448, X448, AES-OCB, KMAC, Argon2, ML-DSA, ML-KEM, TurboSHAKE y KangarooTwelve se rechazan con 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()

¿Te resultó útil esta página?