函數簽名
function authcode(string $string, string $operation = 'DECODE', string $key = '', int $expiry = 0): string
| 參數 | 說明 |
| $string | 明文(加密時)或密文(解密時) |
| $operation | ENCODE 加密,DECODE 解密 |
| $key | 自定義密鑰,為空則用全局 $GLOBALS['discuz_auth_key'] |
| $expiry | 有效期(秒),0=永久。加密時寫入明文頭部,解密時驗證 |
核心機制詳解
1. 動態密鑰($keyc)
- 加密時:取
md5(microtime()) 末 4 字符(默認 $ckey_length=4)。
- 解密時:從密文前 4 字符提取。
- 作用:相同明文+密鑰,每次加密結果不同,防彩虹表、已知明文攻擊。
2. 三層密鑰派生
$key = md5($key ?: $GLOBALS['discuz_auth_key']); // 32 字符
$keya = md5(substr($key, 0, 16)); // 參與加解密運算
$keyb = md5(substr($key, 16, 16)); // 完整性驗證
$keyc = ...; // 動態密鑰
$cryptkey = $keya . md5($keya . $keyc); // 最終加密密鑰流
3. RC4 改進流加密
- 構建 256 字節 S 盒(
$box),基於 $cryptkey 打亂。
- 輸出流與明文/密文逐字節異或(XOR)。
- 雙重打亂增加隨機性,但本質仍屬流密碼,**不適用於高機密數據**。
4. 明文結構(加密前)
[10位時間戳過期時間][16位完整性校驗碼][原始明文]
// 時間戳:sprintf('%010d', $expiry ? $expiry + time() : 0)
// 校驗碼:substr(md5($string . $keyb), 0, 16)
5. 密文輸出
$keyc . base64_encode($ciphertext) // 去除填充 '='
使用示例
<?php
// 配置全局密鑰(生產環境請用強隨機 32+ 字符,存儲於環境變量)
$GLOBALS['discuz_auth_key'] = 'YourSuperSecretKeyHere123456';
// 加密
$token = authcode('user_id=1001&action=reset_pwd', 'ENCODE', '', 3600); // 1小時有效
echo "Token: $token\n";
// 解密
$plain = authcode($token, 'DECODE');
if ($plain === '') {
die('Token 無效或已過期');
}
parse_str($plain, $params);
echo "User ID: {$params['user_id']}\n";
安全評估與建議
- 優點:自帶過期驗證、完整性校驗、動態鹽值,比單純 Base64/RC4 強。
- 缺點:
- RC4 存在已知偏差,理論上可被區分攻擊(需海量密文)。
- 無認證加密(AEAD),若密鑰洩露可偽造任意 Token。
- 4 字節動態密鑰空間僅 16^4=65536,高併發下極小概率碰撞。
- 現代替代方案:
openssl_encrypt($data, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag) —— 標準 AEAD,硬體加速,推薦。
sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() —— 最新標準,抗旁路攻擊。
- JWT(RS256/ES256)用於無狀態 Token,含簽名驗證。
- 遷移策略:新功能用 OpenSSL/Sodium,舊
authcode Token 設置較短過期時間自然過渡。
常見問題 FAQ
- 解密返回空字符串?
- 1. 密鑰不一致 2. Token 已過期 3. 密文被截斷/更改 4. PHP 版本差異導致
md5/chr 行為不同(極罕見)。
- 能否用於密碼存儲?
- 絕不可**!**密碼必須用
password_hash() (bcrypt/argon2) 單向哈希,而非可逆加密。
- URL 傳輸需注意?
- Base64 含
+ / =,需 urlencode() 或替換為 URL-safe Base64(strtr 替換)。