SubtleCrypto

Propiedades de instancia

Esta interfaz no hereda ni implementa ninguna propiedad.

Métodos de instancia

Esta interfaz no hereda ningún método.

SubtleCrypto.encrypt()

Retorna un Promise que se completa con los datos codificados correspondientes al texto sin cifrar, el algoritmo y la clave dados como parámetros.

SubtleCrypto.decrypt()

Retorna un Promise que se completa con los datos claros correspondientes al texto encriptado, el algoritmo y la clave dados como parámetros.

SubtleCrypto.sign()

Retorna un Promise que se completa con la firma correspondiente al texto, algoritmo y clave dados como parámetros.

SubtleCrypto.verify()

Retorna un Promise que se completa con un valor Boolean indicando si la firma dada como parámetro coincide con el texto, el algoritmo y la clave que también se dan como parámetros.

SubtleCrypto.digest()

Retorna un Promise que se completa con el digest generado a partir del algoritmo y el texto dados como parámetros.

SubtleCrypto.generateKey()

Retorna un Promise que se completa con un recién generado CryptoKey, para algoritmos simétricos, o un CryptoKeyPair, que contiene dos claves recién generadas, para algoritmos asimétricos. Estas coincidirán con el algoritmo, usos y extraíbles dados como parámetros.

SubtleCrypto.deriveKey()

Retorna un Promise que se completa con un recién generado CryptoKey derivado de la clave maestra y el algoritmo específico dados como parámetros.

SubtleCrypto.deriveBits()

Retorna un Promise que se completa con un recién generado buffer de bits pseudo-aleatorios derivado de la clave maestra y el algoritmo específico dados como parámetros.

SubtleCrypto.importKey()

Retorna un Promise que se completa con un CryptoKey correspondiente al formato, el algoritmo, los datos clave en bruto, los usos y la extraíbilidad dados como parámetros.

SubtleCrypto.exportKey()

Retorna un Promise que se completa con un buffer que contiene la clave en el formato solicitado.

SubtleCrypto.wrapKey()

Retorna un Promise que se completa con una clave simétrica envuelta para su uso (transferencia y almacenamiento) en entornos inseguros. La clave envuelta coincide con el formato especificado en los parámetros dados, y la envoltura se hace con la clave envuelta dada, usando el algoritmo especificado.

SubtleCrypto.unwrapKey()

Retorna un Promise que se completa con un CryptoKey correspondiente a la clave envuelta dada en el parámetro.

Uso de SubtleCrypto

Podemos dividir las funciones implementadas por esta API en dos grupos: funciones criptográficas y funciones de administración de claves.

Funciones criptográficas

Estas son las funciones que puedes utilizar para implementar características de seguridad como la privacidad y la autenticación en un sistema. El API de SubtleCrypto proporciona las siguientes funciones criptográficas:

• sign() y verify(): crea y verifica las firmas digitales.
• encrypt() y decrypt(): encripta y desencripta datos.
• digest(): crea un digest de longitud fija y resistente a colisiones de algunos datos.

Funciones de gestión de claves

Excepto para digest(), todas las funciones de criptografía de la API utilizan claves criptográficas. En la API SubtleCrypto una clave criptográfica se representa usando un objeto CryptoKey. Para realizar operaciones como firmado y encriptación, provee un objeto CryptoKey a la función sign() o encrypt().

Generando y derivando claves

Las funciones generateKey() y deriveKey() ambas crean un nuevo objeto CryptoKey.

La diferencia es que generateKey() generará un nuevo valor clave distinto cada vez que lo llames, mientras que deriveKey() deriva una clave de algún material inicial de claves. Si proporcionas el mismo material de claves a dos llamadas separadas a deriveKey(), obtendrás dos objetos CryptoKey que tienen el mismo valor de base. Esto es útil si, por ejemplo, se quiere derivar una clave de cifrado de una contraseña y luego derivar la misma clave de la misma contraseña para descifrar los datos.

Importación y exportación de claves

Para hacer que las claves estén disponibles fuera de tu aplicación, necesitas exportar la clave, y para eso sirve exportKey(). Puedes elegir uno de varios formatos de exportación.

El inverso de exportKey() es importKey(). Puedes importar claves de otros sistemas, y la compatibilidad con formatos estándar como PKCS #8 y JSON Web Key te ayudan a hacer esto. La función exportKey() exporta la clave en un formato no codificado.

Si la clave es sensible, deberías usar wrapKey(), que exporta la clave y luego la encripta usando otra clave; la API la llama "clave de envoltura".

El inverso de wrapKey() es unwrapKey(), que descifra y luego importa la clave.

Almacenamiento de claves

CryptoKey es un objeto serializable, lo que permite que las claves se almacenen y recuperen utilizando las API de almacenamiento web estándar.

La especificación espera que la mayoría de los desarrolladores utilicen la API IndexedDB, almacenando los objetos CryptoKey asociados a algún identificador de cadena clave que sea significativo para la aplicación, junto con cualquier otro metadato que consideren útil. Esto permite el almacenamiento y la recuperación de la CryptoKey sin tener que exponer su material de clave subyacente a la aplicación o al entorno de JavaScript.

Algoritmos soportados

Las funciones criptográficas que proporciona la Web Crypto API pueden ser realizadas por uno o más algoritmos criptográficos diferentes: El argumento algorithm de la función indica el algoritmo a utilizar. Algunos algoritmos necesitan parámetros adicionales: en estos casos el argumento algorithm es un objeto de diccionario que incluye los parámetros adicionales.

En el cuadro que figura a continuación se resume qué algoritmos son adecuados para cada operación criptográfica:

Especificaciones

Compatibilidad con navegadores

Véase también

• Web Crypto API
• Usos no criptográficos de SubtleCrypto
• Seguridad web
• Privacidad, permisos y seguridad de la información
• Crypto y Crypto.subtle.
• Crypto 101: un curso de introducción a la criptografía (en inglés).