A tool/lib to encrypt/decrypt Microsoft Office Document
Environment
- 64-bit Windows Visual Studio 2012 or later
- gcc 4.6, clang 3.0 or later
- libssl
sudo apt install libssl-dev
bin/msoffice-crypt.exe
How to make Linux
mkdir work
git clone https://github.com/herumi/cybozulib
git clone https://github.com/herumi/msoffice
cd msoffice
make -j RELEASE=1
Windows
mkdir work
git clone https://github.com/herumi/cybozulib
git clone https://github.com/herumi/msoffice
git clone https://github.com/herumi/cybozulib_ext # for openssl
cd msoffice
mk.bat ; or open msoffice12.sln and build
How to use
- Encrypt test.xlsx with a password
test
.
bin/msoffice-crypt.exe -e -p test test.xlsx enc.xlsx
- Decrypt enc.xlsx with a password
test
.
bin/msoffice-crypt.exe -d -p test enc.xlsx dec.xlsx
- Other options
usage:msoffice-crypt.exe [opt] input output
-h : show this message
-p password in only ascii
-encMode 0:use AES128(default), 1: use AES256 for encoding
-ph8 password in utf8 hex. ex. 68656C6C6F for 'hello'
-ph16 password in utf16 hex. ex. u3042u3044u3046 for 'aiu' in hiragana
-k (experimental) secret key in hex. ex. 0123456789ABCDEF0123456789ABCDEF
-by (experimental) extract secret key from this file
-e encode
-d decode
-c spin count
-psk print secret key
-v print debug info
-vv print debug info and save binary data
Return code
- 0 success
- 1 not support formart
- 2 already encrypted with -e or decrypted with -d
- 3 bad password with -d
Support format
Office 2010 or later Office Document format which suffix is pptx, docx, xlsx.
DLL for Windows
MSOC_encrypt(outFile, inFile, pass, NULL);
- Decrypt
inFile
withpass
and makeoutFile
.
MSOC_decrypt(outFile, inFile, pass, NULL);
Remark
The type of inFile
, outFile
and pass
are const wchar_t*
(UTF-16 string).
See Csample code
and Python sample code.
lib for Linux
-
libmsoc.lib
-
Encrypt
inFile
withpass
and makeoutFile
.
MSOC_encryptA(outFile, inFile, pass, NULL);
- Decrypt
inFile
withpass
and makeoutFile
.
MSOC_decryptA(outFile, inFile, pass, NULL);
Remark
The type of inFile
, outFile
and pass
are const char*
(ascii string).
See mini C sample code.
License
BSD 3-Clause License
Copyright (c) 2015 Cybozu Labs, Inc. All rights reserved.
References
- Compound File Binary File Format(v20120328) [MS-CFB]
- Office Document Cryptography Structure Specification(v20120412) [MS-OFFCRYPTO]
- CODE BLUE 2015 [Backdoors with the MS Office file encryption master key and a proposal for a reliable file format]