PHP中SSG-WSG API的AES加密与初始化向量的正确使用

string openssl_encrypt ( string $data , string $cipher_algo , string $passphrase [, int $options = 0 [, string $iv = "" ]] )

<?php

/**
 * 针对SSG-WSG API的AES-256-CBC加密函数
 *
 * @param string $payload 待加密的原始数据
 * @param string $encryptionKey SSG-WSG提供的加密密钥
 * @param string $initializationVector SSG-WSG提供的固定初始化向量
 * @return string Base64编码的加密数据
 * @throws Exception 如果加密失败
 */
function encryptForSsgWsgApi(string $payload, string $encryptionKey, string $initializationVector): string
{
    // 定义加密算法
    $cipher = "aes-256-cbc";

    // 检查加密密钥和IV长度是否符合算法要求
    // AES-256-CBC需要32字节（256位）密钥和16字节（128位）IV
    if (mb_strlen($encryptionKey, '8bit') !== 32) {
        throw new Exception("加密密钥长度必须为32字节 (256位)。");
    }
    if (mb_strlen($initializationVector, '8bit') !== openssl_cipher_iv_length($cipher)) {
        throw new Exception("初始化向量长度必须为 " . openssl_cipher_iv_length($cipher) . " 字节。");
    }

    // 执行加密操作
    // 注意：这里的$options参数通常设置为0，表示不进行额外的填充或处理
    $encrypted_data = openssl_encrypt(
        $payload,
        $cipher,
        $encryptionKey,
        0, // 通常为0，表示默认模式
        $initializationVector // 使用SSG-WSG提供的固定IV
    );

    // 检查加密是否成功
    if ($encrypted_data === false) {
        throw new Exception("AES加密失败，请检查密钥、IV或数据。");
    }

    // 对加密后的数据进行Base64编码，以便于传输
    return base64_encode($encrypted_data);
}

// --- 示例用法 ---
try {
    // 假设SSG-WSG API提供的密钥和初始化向量
    $ssg_encryption_key = "your_32_byte_encryption_key_here"; // 替换为SSG提供的256位（32字节）密钥
    $ssg_api_init_vector = "your_16_byte_iv_here";             // 替换为SSG提供的128位（16字节）IV

    // 待加密的JSON payload
    $data_payload = json_encode([
        "transactionId" => "TXN12345",
        "amount" => 100.50,
        "currency" => "USD",
        "items" => [
            ["id" => "item001", "qty" => 1],
            ["id" => "item002", "qty" => 2]
        ]
    ]);

    // 调用加密函数
    $encrypted_payload = encryptForSsgWsgApi(
        $data_payload,
        $ssg_encryption_key,
        $ssg_api_init_vector
    );

    echo "原始数据: " . $data_payload . "\n";
    echo "加密后的Base64数据: " . $encrypted_payload . "\n";

    // 通常会将此$encrypted_payload发送到SSG-WSG API
    // 例如：
    // $ch = curl_init("https://your.ssg-wsg.api/endpoint");
    // curl_setopt($ch, CURLOPT_POSTFIELDS, $encrypted_payload);
    // curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); // 或其他适当的Content-Type
    // ...
    // curl_exec($ch);

} catch (Exception $e) {
    echo "错误: " . $e->getMessage() . "\n";
}

?>