OpenSSL AES-256-CBC 加解密
本工具 100% 在瀏覽器端運算,金鑰與資料不會離開你的裝置。即使如此,也請使用測試環境的金鑰,不要貼上正式環境的金鑰。
運作原理
金流串接等伺服器之間的 API,常用 PHP 的 openssl_encrypt() 交換加密資料。本工具支援下面這種常見寫法,串接時可以用來對照程式的輸出:
$iv = openssl_random_pseudo_bytes(16);
$encrypted = openssl_encrypt($payload, 'aes-256-cbc', $key, 0, $iv);
$result = base64_encode($encrypted . '::' . $iv);結果有好幾層。openssl_encrypt() 的 options 設為 0 時,回傳的是 Base64 密文;程式接著加上 :: 和 16 bytes 的原始 IV,再把整段做一次 Base64。解密時,工具會先解開外層 Base64,從第一個 :: 切開,後半段就是 IV。資料使用 PKCS#7 補位。
最需要注意的是金鑰。$key 是一般字串,會直接當成 AES 金鑰,不經過任何金鑰衍生。AES-256 需要剛好 32 bytes,所以不足時 OpenSSL 會補 \0,超過 32 bytes 的部分則會忽略。本工具的處理方式相同,金鑰欄位下方也會顯示目前的 bytes 數。金鑰是以 UTF-8 計算,一個中文字算 3 bytes。
每次加密都會產生新的隨機 IV,所以同一段文字加密兩次,結果不會相同,但都能正確解密。:: 這種排列方式只是程式寫法,不是標準規格,而 CBC 本身也無法偵測資料被竄改。各家服務的金鑰長度、IV 處理方式和編碼都可能不同,請一律先對照對方的技術文件。
結果
使用情境
- 測試金流串接:你的伺服器要和金流服務交換加密欄位,對方卻回報解不開。先用測試金鑰在這裡解密你的輸出,確認自己這邊正確,再和對方對 log。
- 找出解密失敗的原因:openssl_decrypt() 回傳 false,卻看不出原因。把同一份資料貼到這裡:顯示格式不符就檢查編碼和 :: 的排列,顯示解密失敗就檢查金鑰。
- 把格式移植到其他語言:要把這段 PHP 改寫成 Node.js 或 Python 時,需要測試資料。先在這裡加密一段文字,確認新程式解得開,再反過來測一次。
常見問題
Q: 金鑰和資料會上傳嗎?
A: 不會。加解密是透過瀏覽器的 Web Crypto API 完成,不會傳到伺服器。即使如此,這裡也請使用測試環境的金鑰,正式環境的金鑰不應該貼到任何網頁上。
Q: 這跟本站的 AES-256-CBC 工具有什麼不同?
A: 那支工具使用十六進位的原始金鑰和 IV,輸出十六進位密文。這支使用文字金鑰、自動產生 IV,並採用 PHP 的 base64 與 :: 格式。兩者的結果不能互通。
Q: 為什麼解不開金流服務商的資料?
A: 各家做法不同,可能使用固定 IV、十六進位金鑰、其他金鑰長度或編碼,也有些是用 AES-128。本工具只支援這個頁面說明的格式,請先對照服務商的技術文件。
Q: 可以和 openssl enc 指令互通嗎?
A: 不能直接互通。openssl enc 使用密碼時,會加 salt 衍生金鑰,並加上 Salted__ 標頭,是不同的格式。本工具對應的是上面這段 PHP openssl_encrypt() 程式。
Q: 為什麼每次輸出都不一樣?
A: 每次加密都用新的隨機 IV,而 IV 就存在結果裡。同一段文字得到不同結果是正常的,用同一把金鑰都能解開。