深入研究 sqlite3 (v3.6.12)加密.总结

SQLITE3 加密总结 (sqlite 3.6.12 版本)

董淳光 42530 (老工号)

dcg1981@163.com

2009 年 4 月 9 日星期四

I. 序.....................................................................................................................................................1

II. 问题初分析...................................................................................................................................2

III. 研究结果......................................................................................................................................3

IV. 可靠性........................................................................................................................................17

忘记。

我写本文章时，sqlite3 最新版本是 3.6.12 。我就以这个版本的源代码为例

进行分析。并且，我喜欢它那整合代码，整合成一个 .c 和一个 .h 文件。虽然在

vc2003 里编辑慢如蜗牛，但是一旦编辑好，以后使用起来不至于每个工程都拖

上一堆文件。工程简洁方便。所以下面的叙述全部都是以 sqlite3 v3.6.12 整合的

源代码为基础展开。

我认为未来 sqlite3 v3.XX 的整合版本大体上都可以用下面介绍的代码进

行加解密。Sqlite3 在版本变化中，有一些宏、函数被改名，读者很容易查出来

并自己修正。也有一些函数会被丢弃。读者应该也可以自行分析出来。我下面

的代码尽可能保持与 sqlite 版本的兼容性。不使用那些容易被丢弃的结构或函

面的叙述并没有使用过多的 vc2003 编译技巧，对应到 vc2005、2008，甚至

unix 下的 cc 等等都是通用的）。首先在工程属性里的“C/C++”选项里找到“命令

行”，如图：

自己手工敲上“/D "SQLITE_HAS_CODEC"”。 这个意思是在整个工程里预

先 define “SQLITE_HAS_CODEC”这个宏。

这个宏是 sqlite3 作者留下的加密接口。缺省没有这个宏， sqlite3 就是不

加密的标准版。定义有这个宏，那么就是要开启加密功能。

设定好宏后，开始编译。

结果，问题现象就出现了：

testSqliteEnc error LNK2019: 无法解析的外部符号 _sqlite3_activate_see ，该符号在函数 _sqlite3Pragma 中被

testSqliteEnc error LNK2019: 无法解析的外部符号 _sqlite3_key ，该符号在函数 _sqlite3Pragma 中被引用

testSqliteEnc error LNK2019: 无法解析的外部符号 _sqlite3CodecAttach ，该符号在函数 _attachFunc 中被引

己实现。反之，大概实现了这些函数后就能进行加密了。

III. 研究结果

参阅了网上某文章，照着他的做法的确可以做出加密效果。在这里十分感

谢那文章的作者。

但我并不满足于此。我无法确认人家的代码有没有问题。而且看过他代码，

觉得封装程度也并不好。

于是希望通过一些研究判断人家代码可靠性。同时更进一步进行封装。

研究过程不再赘述，无非就是简单编写先前编译缺少的那些函数体，再对

照网上代码编写那些函数内容，然后反复参考、单步调试 sqlite3 源代码。

这里直接给出最终结果。下面章节再简述关键点。

修改地方总共加有 3 处，这 3 处都是添加代码，不需要修改，也没有删除。

需要添加的代码下面全部都有。Sqlite3.c 里需要添加代码的位置大概如下

图所示：

下面列出源码。

打开 sqlite3.c 文件。在最顶端添加:

#ifdef SQLITE_HAS_CODEC

void DestroyKeyInBtree(void * lpTree );

#de$ne MY_DESTROY_KEY(BTREE) DestroyKeyInBtree (BTREE)

#else

#de$ne MY_DESTROY_KEY(BTREE)

通过分析代码，不难找到 sqlite3_close 会调用下面这个函数

SQLITE_PRIVATE int sqlite3BtreeClose(Btree *p)

这是 sqlite3 的函数。我确认销毁密钥块的时机就是在这个函数里。

搜索到这代码：

sqlite3BtreeRollback(p);

sqlite3BtreeLeave(p);

就在 Leave 后面添加我们销毁功能，如下：

/* Rollback any active transaction and free the handle structure.

The call to sqlite3BtreeRollback() drops any table-locks held by

this handle.

up the shared-btree.

*/

assert(p->wantToLock==0 && p->locked==0 );

这个销毁时机不能再往后放了，再往后 BTree 相关结构体都已被销毁，我

们再从它里面获取我们密钥块指针就会崩溃。因此在我上面代码那里销毁时机

刚好。

接下来修改就简单了。

直接拖到最末尾，3.6.12 版本的最后两行有效代码应该是：

#endif /* de$ned(SQLITE_ENABLE_ICU) */

#endif /* !de$ned(SQLITE_CORE) || de$ned(SQLITE_ENABLE_FTS3) */

//////////////////////////////////////////////////////////////////////////

#ifndef SQLITE_HAS_CODEC

#ifdef WIN32

#pragma message("We do not use encryption")

#endif

#else