萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Discuz! authcode 加密解密函數深度解析與安全使用指南

函數簽名

function authcode(string $string, string $operation = 'DECODE', string $key = '', int $expiry = 0): string
參數說明
$string明文(加密時)或密文(解密時)
$operationENCODE 加密,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 替換)。
copyright © 萬盛學電腦網 all rights reserved