用密碼 secret 保護的 BIFF5 活頁簿,可以帶著一個完全對得上的密碼驗證值,卻照樣讓 Excel 16 回答密碼不正確。只有當 FILEPASS 金鑰等於 CreateXorKey_Method1(password)、16 位元組 XOR 陣列用 XorRor 建出、且每個位元組都用 XorArrayIndex = (串流位移 + 記錄長度) mod 16 時,Excel 才收下這個檔案
Excel 16 拒收這種檔案有兩種截然不同的方式,正好對應 [MS-OFFCRYPTO] §2.3.7 的各層。密碼提示一直拒絕正確的密碼,指向 FILEPASS 裡的金鑰字組;密碼被接受之後才冒出的「檔案有問題、無法開啟」報告,指向 XOR 陣列,或指向挑選陣列位元組的索引。下面的章節就按這個順序,一路追到位元組
FILEPASS 記錄在 BIFF5 檔案裡存了什麼
BIFF XOR 混淆只儲存兩個 16 位元字組,其餘一切都從密碼重算。FILEPASS 記錄($002F)緊跟在活頁簿 globals 的 BOF 之後,在 BIFF5 檔案裡它的主體長 4 位元組:XOR 金鑰,然後是密碼驗證值。沒有 salt,也沒有演算法識別碼,更沒有 RC4 與 AES 方案帶的那種加密驗證值區塊
讀取器從這兩個字組重建三個值:
- 驗證值:密碼位元組的 16 位元雜湊,與密碼長度及
$CE4B做 XOR。與儲存字組比對,就是文件記載的密碼檢查 - XOR 金鑰:由 [MS-OFFCRYPTO] §2.3.7.2 的
CreateXorKey_Method1從兩張常數表——InitialCode(15 個字組)與XorMatrix(105 個字組)——算出的 16 位元值 - XOR 陣列:16 個位元組,由密碼位元組補上固定的 16 位元組 pad 組成,偶數位置與低位金鑰位元組、奇數位置與高位金鑰位元組各做一次 XOR,再整體右旋一個位元
記錄標頭保持明文。少數整條豁免的記錄也是——BOF、FILEPASS、USREXCL、FILELOCK、INTERFACEHDR、RRDHEAD 與 RRDINFO——外加每條 BOUNDSHEET 的前 4 位元組。其餘每條記錄主體逐位元組轉換:先左旋 5 個位元,再與 16 位元組陣列的某個項目做 XOR。解密(§2.3.7.3 寫成 DecryptData_Method1)跑的是鏡像:先 XOR,再右旋 5
HotXLS 把這一切藏在兩個活頁簿屬性後面。TXLSWorkbook.EncryptionPassword 放密碼,EncryptionType 選方案,用 xlExcel5 呼叫 SaveAs 就會在 BOF 之後立即寫出 FILEPASS,並轉換串流的其餘部分:
uses
SysUtils, lxHandle;
procedure SaveLegacyProtectedBook(const FileName: string);
var
Wb: IXLSWorkbook;
begin
Wb := TXLSWorkbook.Create;
Wb.Sheets.Add.Name := 'Ledger';
Wb.Sheets[1].Range['A1', 'A1'].Value := 'Account';
Wb.Sheets[1].Range['B1', 'B1'].Value := 1250.75;
// BIFF5 只有 XOR 混淆;對 xlExcel5 來說 xletAuto 選的
// 是同一個方案,明寫出來只是把意圖記錄在程式碼裡
Wb.EncryptionType := xletXor;
// ASCII,至多 15 個字元(見下方密碼注意事項)
Wb.EncryptionPassword := 'secret';
if Wb.SaveAs(FileName, xlExcel5) <> 1 then
raise Exception.Create('BIFF5 save failed');
end;
驗證值對得上,Excel 為什麼還說密碼錯?
Excel 用 CreateXorKey_Method1 從輸入的密碼推導金鑰,再與 FILEPASS 裡的金鑰字組比對,所以金鑰是任何其他值的檔案,即使驗證值正確也過不了密碼檢查。規格把金鑰視為密碼的函數,Excel 16 嚴格執行這個解讀
誘人的捷徑是拿兩個隨機位元組填進金鑰字組。紙面上看起來無害:驗證值才是文件記載的密碼檢查,而陣列是按檔案聲明的金鑰建的。把 FILEPASS 金鑰照單全收的讀取器會毫無怨言地打開這種檔案,這就是為什麼只在「自己測自己」的程式碼裡這條捷徑能一直活著。同一個檔案加上正確密碼交給 Excel 16,它在提示框就把人擋下。HotXLS 每次存檔都重新推導金鑰,所以密碼 secret 的 FILEPASS 永遠是金鑰 $014D、驗證值 $DAA7
兩張表到位之後,推導本身很短。從密碼最後一個位元組倒著走,每個位元組左移的同時測試 bit 6 七次,位元為 1 就 XOR 一個 XorMatrix 項目;表索引從最後一項 $68 起算,不論位元是否為 1,每個位元遞減一次。下面的示意碼逐步重現規格演算法,結果與函式庫一致。它只是給你自己讀取器的示意圖,這些常式沒有一個是 HotXLS API 的一部分:
// [MS-OFFCRYPTO] 2.3.7.2 CreateXorKey_Method1 與
// CreateXorArray_Method1 的示意(僅供說明,不是 HotXLS API)
type
TXorArray = array [0..15] of Byte;
function DemoCreateXorKey(const Password: AnsiString): Word;
const
InitialCode: array [0..14] of Word = ($E1F0, $1D0F, $CC9C, $84C0, $110C,
$0E10, $F1CE, $313E, $1872, $E139, $D40F, $84F9, $280C, $A96A, $4EC3);
XorMatrix: array [0..104] of Word = (
$AEFC, $4DD9, $9BB2, $2745, $4E8A, $9D14, $2A09,
$7B61, $F6C2, $FDA5, $EB6B, $C6F7, $9DCF, $2BBF,
$4563, $8AC6, $05AD, $0B5A, $16B4, $2D68, $5AD0,
$0375, $06EA, $0DD4, $1BA8, $3750, $6EA0, $DD40,
$D849, $A0B3, $5147, $A28E, $553D, $AA7A, $44D5,
$6F45, $DE8A, $AD35, $4A4B, $9496, $390D, $721A,
$EB23, $C667, $9CEF, $29FF, $53FE, $A7FC, $5FD9,
$47D3, $8FA6, $0F6D, $1EDA, $3DB4, $7B68, $F6D0,
$B861, $60E3, $C1C6, $93AD, $377B, $6EF6, $DDEC,
$45A0, $8B40, $06A1, $0D42, $1A84, $3508, $6A10,
$AA51, $4483, $8906, $022D, $045A, $08B4, $1168,
$76B4, $ED68, $CAF1, $85C3, $1BA7, $374E, $6E9C,
$3730, $6E60, $DCC0, $A9A1, $4363, $86C6, $1DAD,
$3331, $6662, $CCC4, $89A9, $0373, $06E6, $0DCC,
$1021, $2042, $4084, $8108, $1231, $2462, $48C4);
var
Len, I, Bit, Element: Integer;
Ch: Byte;
begin
Result := 0;
Len := Length(Password);
if Len > 15 then
Len := 15; // 金鑰只吃到 15 個位元組
if Len = 0 then
Exit;
Result := InitialCode[Len - 1];
Element := $68; // XorMatrix 最後一項
for I := Len downto 1 do
begin
Ch := Ord(Password[I]);
for Bit := 1 to 7 do
begin
if (Ch and $40) <> 0 then
Result := Result xor XorMatrix[Element];
Ch := Byte(Ch shl 1);
Dec(Element);
end;
end;
end;
function XorRor(B, KeyByte: Byte): Byte;
begin
B := B xor KeyByte;
Result := Byte((B shr 1) or (B shl 7)); // 右旋一個位元
end;
procedure DemoCreateXorArray(const Password: AnsiString; out Arr: TXorArray);
const
PadArray: TXorArray = ($BB, $FF, $FF, $BA, $FF, $FF, $B9, $80,
$00, $BE, $0F, $00, $BF, $0F, $00, $00);
var
Key: Word;
Len, I: Integer;
begin
Key := DemoCreateXorKey(Password);
Len := Length(Password);
if Len > 16 then
Len := 16;
for I := 0 to Len - 1 do
Arr[I] := Ord(Password[I + 1]);
for I := Len to 15 do
Arr[I] := PadArray[I - Len];
for I := 0 to 15 do
if Odd(I) then
Arr[I] := XorRor(Arr[I], Byte(Key shr 8))
else
Arr[I] := XorRor(Arr[I], Byte(Key and $FF));
end;
對 secret 而言,這會算出陣列 1F 32 17 B9 14 BA 7B 7F 59 DD 59 7F 7A C0 A6 DF。加上金鑰 $014D 與驗證值 $DAA7,你就有三個已知正確的值,在碰 Excel 之前可以先拿來斷言
右旋一位,以及為什麼左旋兩位看起來像那麼回事
金鑰對了之後,Excel 16 會越過密碼提示,直接撞上第二個錯誤:檔案有問題的報告。常見原因是 XOR 陣列旋錯了方向。§2.3.7.2 把陣列步驟定義為 XorRor——右旋一個位元——但「每個陣列位元組左旋 2 位元」的變體在好幾個 BIFF 實作裡流傳,建立在同一變體上的讀取器永遠察覺不了異常
Excel 16 不存 Excel 5.0/95 檔,存 BIFF8 也不提供 XOR,所以沒有原生樣本可以拿來比對。要確定自己的程式碼實作了哪個組合,可靠的辦法反著走:先寫出一條純明文的 BIFF5 串流,在三個獨立選擇的每種組合下重新編碼,然後讓 Excel 16 逐一打開:
| 選擇 | 選項 A | 選項 B |
|---|---|---|
| 陣列旋轉 | XorRor(右旋 1) | 左旋 2 |
| 陣列索引 | (偏移 + 記錄長度) mod 16 | 偏移 mod 16 |
| 位元組轉換順序 | 左旋 5 再 XOR | 先 XOR 再左旋 5 |
八個檔案裡,Excel 16 收下規格組合——XorRor、先旋後 XOR、含記錄長度的索引——外加唯一一個只是看起來不同的。左旋 2 配上先 XOR 後旋、同樣的索引,其實是同一個函數的偽裝。旋轉對 XOR 可分配,所以 rol5(p xor rol2(b)) 等於 rol5(p) xor rol7(b),而在 8 位元值上左旋 7 就是右旋 1。壓縮成一句:rol5 ∘ rol2 = ror1
這條恆等式解釋了為什麼左旋 2 陣列在孤立測試裡看起來是對的。它只有在配上相反的轉換順序時才正確;配上規格順序,它會毀掉每個被轉換的位元組。凡把記錄長度從索引裡拿掉的變體也全數失敗,不管用哪種旋轉。寫規格組合,其他都別寫。代數雙胞胎能開檔,但它留給下一個維護者兩個要逆推的偏離,而規格文字一個都不留
每個位元組的 XorArrayIndex 怎麼算?
一個位元組的 XorArrayIndex 是它在活頁簿串流中的位移,加上所屬整條記錄資料的長度,再 mod 16。所以每條記錄的索引都從一個隨記錄而異的值重新起算,並在記錄內每個位元組遞增一次。規格偽碼把輸入命名為 FileOffset 與 Data.Length,第一個很容易被誤讀成只算記錄起始位移
三個細節決定您的索引能不能跟 Excel 對齊:
- 4 位元組的記錄標頭永遠不做轉換,但它照樣佔用串流位置,所以記錄的第一個主體位元組位於標頭位移 + 4
- 長度項是整條記錄資料的長度,包括轉換會跳過的任何明文前綴
- BOUNDSHEET 部分明文:前 4 位元組
lbPlyPos(工作表 BOF 的串流位移)保持可讀,讓剖析器不用密碼就能定位工作表。這 4 位元組被轉換跳過,卻照樣計入位移與記錄長度
合起來,逐記錄的轉換就幾行。跟前面一樣,這是給你自己程式碼的規則示意;HotXLS 在 SaveAs 內部套用它:
function Rol8(B: Byte; N: Integer): Byte;
begin
Result := Byte((B shl N) or (B shr (8 - N)));
end;
// 就地混淆一條記錄主體。BodyPos 是 Body[0] 的串流偏移,
// 亦即記錄標頭偏移 + 4。PlainPrefix 對 BOUNDSHEET 是 4、
// 對 BOF / FILEPASS 是全長,多數記錄為 0
procedure DemoObfuscateRecord(var Body: array of Byte; RecordLength: Word;
PlainPrefix: Integer; BodyPos: LongWord; const Arr: TXorArray);
var
I: Integer;
begin
for I := PlainPrefix to RecordLength - 1 do
Body[I] := Rol8(Body[I], 5) xor
Arr[(BodyPos + LongWord(I) + RecordLength) mod 16];
end;
// 讀取是鏡像操作:B := Body[I] xor Arr[...];
// 然後右旋 5,即 Rol8(B, 3)
讀取端與寫入端如果都只按串流位置索引,等於兩邊都把記錄長度丟了,於是它們彼此一致、卻跟誰都不一致。讀取端上,HotXLS 用目前串流位置加明文前綴長度加已轉換位元組數計算索引——正是寫入端用的那個記錄長度
讀取使用左旋 2 陣列的檔案
HotXLS 也能打開用左旋 2 陣列與隨機金鑰建的 XOR 檔案,並靠 FILEPASS 金鑰分辨它們。儲存的金鑰等於從密碼推導的金鑰時,讀取器建規格的 XorRor 陣列;不同時,讀取器切到左旋 2 陣列。Excel 寫出的檔案永遠帶推導金鑰,所以永遠走規格路徑
這個判別是有精確失敗率的啟發法。對金鑰被隨機填入的檔案,它恰好等於推導金鑰——因而被用錯的陣列讀取——的機率是 65,536 分之 1。這個切換只涵蓋陣列旋轉;索引規則不動,所以它只適用於已經使用記錄長度索引的檔案。用 HotXLS 打開這種檔案再存一次,得到的檔案 Excel 就收了,因為寫入端永遠用推導金鑰與 XorRor
還有兩個密碼細節,不論檔案用哪種陣列都適用:
- 長度。
CreateXorKey_Method1只讀密碼的前 15 個位元組,這是規格上限。HotXLS 把這個上限套在金鑰上,驗證值照用完整密碼、陣列照用它的 16 位元組規則,讀取與寫入兩端一致。因為金鑰永遠只看到 15 個位元組,15 個字元是實際上限 - 字元集。HotXLS 把密碼經由系統 ANSI 字碼頁轉成位元組,金鑰、驗證值與陣列一視同仁。規格描述的是取每個 UTF-16 字元的低位元組,兩者對 ASCII 一致。沒有受非 ASCII 密碼保護的 Excel 樣本,其他情況就沒有基準真相,所以 XOR 密碼請保持純 ASCII
當 Open 遇到 FILEPASS 記錄而密碼缺失或錯誤時,TXLSWorkbook.OnPassword 觸發。處理器是 TXLSPasswordEvent,帶 var PassWord: WideString 與 var Retry: Boolean;指派新密碼並把 Retry 設為 True 就再試一次,最多重試三次。Retry 留在 False 會讓 Open 回傳密碼錯誤碼:
procedure TImportForm.WorkbookPassword(Sender: TObject;
var PassWord: WideString; var Retry: Boolean);
var
S: string;
begin
S := '';
Retry := InputQuery('Protected workbook', 'Password:', S);
PassWord := S;
end;
procedure TImportForm.ImportLegacyFile(const FileName: string);
var
Wb: IXLSWorkbook;
Rc: Integer;
begin
Wb := TXLSWorkbook.Create;
Wb.OnPassword := WorkbookPassword;
Rc := Wb.Open(FileName);
// -1003:需要密碼但未提供;-1005:密碼錯誤
if Rc <> 1 then
raise Exception.CreateFmt('Cannot open %s (code %d)', [FileName, Rc]);
ShowMessage(VarToStr(Wb.Sheets[1].Range['A1', 'A1'].Value));
end;
密碼已知的話,重載 Open(FileName, APassWord) 會預先傳入,事件只在該密碼失敗時才觸發
XOR 混淆到底還值不值得寫?
BIFF XOR 混淆擋得住隨手亂翻的人,擋不住有備而來的。密碼檢查是 16 位元驗證值,金鑰 16 位元,16 位元組陣列在整條串流上反覆使用,所以 BIFF 記錄內容的可預測性會在完全沒有密碼的情況下暴露陣列位元組。今天還寫它的唯一理由,是某個只讀 Excel 5.0/95 檔、再新格式都不認的既有消費端,因為 BIFF5 沒有別的方案
傳統引擎用 TXLSWorkbook.EncryptionType 選方案,並與存檔格式嚴格核對組合:
xletAuto(預設)對xlExcel97寫 RC4 CryptoAPI、對xlExcel5寫 XOR,與 Excel 自己對各格式寫的一致xletXor只對 BIFF5 有效;配上xlExcel97,存檔直接丟出例外,不會退回別的方案xletRC4與xletRC4CryptoAPI只對 BIFF8 有效,在 BIFF5 存檔時要求也會丟例外
可能存兩種格式的程式碼,讓 EncryptionType 留在 xletAuto。它永遠落在目標格式支援的最強方案,也不會在某天有人把存檔切到 xlExcel97 時,丟出明寫 xletXor 才會有的組不合例外
RC4 也老了,要讓它互通有自己的坑,在 Excel 為什麼拒絕密碼正確的加密活頁簿一文有講。如果收件端讀得了 XLSX,跳過傳統格式、用 XLSX 引擎:TXLSXWorkbook.SaveAsEncryptedAgile 寫 Agile Encryption(SHA-512 密碼雜湊、100,000 次迭代 spin count、AES-256-CBC),正是 Excel 2010 起的預設容器;SaveAsEncrypted 則寫較舊的 AES-128 Standard Encryption。兩者的取捨見 在 Delphi 中用 AES 加密 XLSX 檔案,讀取端見 用 HotXLS 讀取 Agile 加密的 Excel 檔案
在 Excel 16 看到之前先檢查 BIFF5 XOR 輸出
- 用同一個密碼把同一本活頁簿存兩次,在十六進位傾印裡比對 FILEPASS 主體。兩份拷貝應該有相同的字組;兩次存檔之間金鑰會變,代表它是隨機填的,Excel 16 會拒收密碼
- 密碼
secret的 4 位元組 FILEPASS 主體在磁碟上應讀作4D 01 A7 DA,金鑰在前,兩個字組都是 little-endian - 每條 BOUNDSHEET 的前 4 位元組應讀作一個落在工作表 BOF 上的明文串流位移;如果指向空處,代表轉換碰了前綴,任何剖析器都無法在沒有密碼時定位工作表
- 測試密碼保持純 ASCII、15 個字元以內,讓金鑰、驗證值與陣列在每台機器上看到相同的位元組
同一套 Delphi 與 C++Builder 函式庫涵蓋 BIFF5 XOR、BIFF8 RC4 與 RC4 CryptoAPI、XLSX Standard 與 Agile Encryption,以及讀取端的密碼回呼,上述每條位元組層級規則都在存檔時套用。版本、支援平台與試用下載,見 HotXLS Delphi spreadsheet component 頁面