sm-crypto.js

sm-crypto.js是一个基于国密算法的JavaScript密码学库。国密算法是指中国新一代密码算法，由中国密码学家自主研发，被广泛应用于各种信息安全领域。

sm-crypto.js提供了一系列国密算法的实现，包括SM2、SM3和SM4。其中，SM2是一种椭圆曲线公钥密码算法，用于实现数字签名和密钥协商等功能；SM3是一种密码杂凑算法，用于计算消息的摘要值；SM4是一种分组密码算法，用于加密和解密数据。

使用sm-crypto.js可以在前端环境中进行国密算法的加密和解密操作，而无需依赖后端服务。这在一些场景下非常有用，比如在浏览器中进行数据加密传输或实现安全的本地存储等。

sm-crypto.js具有易用性和高性能的特点。它提供了简洁友好的接口，使得开发者能够便捷地使用国密算法进行加密和解密操作。同时，它还针对性能进行了优化，使得它在处理大量数据时能够获得较高的效率。

sm-crypto.js也兼容主流的浏览器环境，可以在各种现代浏览器中使用。同时，它还提供了Node.js环境下的支持，可以在服务端环境中使用。这使得开发者可以在不同的环境中无缝切换，实现灵活的应用场景。

总之，sm-crypto.js是一个功能强大的JavaScript密码学库，提供了国密算法的实现，能够方便地进行加密和解密操作，是保障信息安全的重要工具之一。

相关问题

sm-crypto sm4

### 关于 sm-crypto 中 SM4 加密算法的信息

#### 文档说明

`sm-crypto` 是一个用于实现国密标准 (GM/T) 的 JavaScript 库，支持多种加密算法，其中包括 SM4 对称加密算法。SM4 属于分组密码体制，其分组长度和密钥长度均为 128 比特。

为了初始化 SM4 密码实例并设置操作模式以及填充方式：

import { Sm4 } from 'sm-crypto';

// 创建一个新的 SM4 实例，默认采用 ECB 模式 PKCS7 填充
let sm4 = new Sm4();

对于更安全的应用场景推荐使用 CBC 模式的例子如下所示[^1]：

import { Sm4, util } from 'sm-crypto';
const algorithm = 'cbc'; // 设置为 cbc 模式
const password = 'Password used to generate key'; 

// 使用 scrypt 函数派生出合适的密钥材料
const key = await util.scryptPromise(password, 'salt', 16);

// 初始化向量 IV 需要与解密端保持一致
const iv = util.hexToBytes('00000000000000000000000000000000');

// 构建 SM4 实例对象
let sm4Cbc = new Sm4({ mode: algorithm, padding: 'pkcs7', iv });

上述代码展示了如何利用 `scrypt` 方法来生成适合 SM4 算法使用的密钥，并指定了 CBC 工作模式下的初始化向量（IV）。需要注意的是，在实际应用环境中应当随机生成盐值(salt)，并且每次加密时都应重新创建不同的 IV 来增强安全性。

#### 使用案例

下面给出一段完整的加解密过程示例代码：

import { Sm4, util } from 'sm-crypto';

async function encryptAndDecrypt() {
    try {
        const plaintext = "This is a secret message.";
        
        // 将明文转换成字节数组形式
        let bytesPlaintext = util.stringToUtf8ByteArray(plaintext);
    
        // 获取密钥
        const password = 'Password used to generate key';
        const salt = 'unique_salt_for_this_encryption_session';
        const derivedKey = await util.scryptPromise(password, salt, 16);
    
        // 定义工作参数
        const ivHexStr = 'f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff';
        const iv = util.hexToBytes(ivHexStr);
        const options = {mode:'cbc',padding:'pkcs7',iv};
    
        // 执行加密操作
        let cipherTextBytes;
        using(sm4Instance=new Sm4(options)){
            cipherTextBytes=sm4Instance.encrypt(bytesPlaintext,derivedKey);
        }
        console.log(`Cipher Text Bytes:${util.bytesToHexString(cipherTextBytes)}`);
    
        // 解密恢复原始数据
        let decryptedBytes;
        using(decryptorSm4Instance=new Sm4(options)){
            decryptedBytes=decryptorSm4Instance.decrypt(cipherTextBytes,derivedKey);
        }
        console.log(`Decrypted Message:${util.utf8ByteArrayToString(decryptedBytes)}`);
    } catch(error){
        console.error("Encryption/decryption failed:",error.message);
    }
}
encryptAndDecrypt();

这段脚本实现了基于给定口令推导出的密钥对消息进行加密后再成功还原的过程。其中包含了必要的错误处理逻辑以确保程序健壮性。

前端sm-crypto

前端sm-crypto是一个用于在前端环境中进行SM2、SM3、SM4等国密算法操作的JavaScript库。它提供了一系列的函数和方法，可以用于生成SM2密钥对、进行密钥交换、加解密、签名验证等操作。通过使用前端sm-crypto，开发人员可以在浏览器端直接进行国密算法的相关操作，而无需依赖后端服务器。这样可以更好地保护用户的数据安全性。