插件開(kāi)發(fā)經(jīng)驗(yàn)之安全風(fēng)險(xiǎn).避免審核駁回

我是小站長(zhǎng)

交流探討應(yīng)是好事，但有些重復(fù)問(wèn)題老是不斷的問(wèn)，弄的我都煩了。為此，整理一些開(kāi)發(fā)者Q友常見(jiàn)的問(wèn)題，在此一并回答如下：
常有開(kāi)發(fā)者的作品因數(shù)據(jù)庫(kù)SUID(SELECT、UPDATE、INSERT、DELETE)的操作涉及安全風(fēng)險(xiǎn)而無(wú)法審核通過(guò)，可又一時(shí)搞不清所說(shuō)的“安全風(fēng)險(xiǎn)”到底是哪些代碼，不知所措。我來(lái)講解一下，希望能有所幫助(當(dāng)初我也經(jīng)常遇到這類(lèi)問(wèn)題，隨著經(jīng)驗(yàn)積累，慢慢有所悟了)。

此類(lèi)“安全風(fēng)險(xiǎn)”，一般是指對(duì)$_GET和$_POST有沒(méi)有進(jìn)行安全過(guò)濾處理(addslashes)。
搞清這個(gè)概念，問(wèn)題就好解決了。舉個(gè)自定義C::t方法的例子

$name  = $_GET['name'];//從地址欄或表單獲取
$query = C::t('#mp#common_member')->fetch_by_username($name);
這里用了$_GET，由于該值將用于數(shù)據(jù)庫(kù)操作，那么該值是否安全呢？
我們來(lái)看DZ的技術(shù)文庫(kù)是怎么說(shuō)的，經(jīng)查"Discuz! X2.5新版架構(gòu)優(yōu)化說(shuō)明"—>"程序底層架構(gòu)"—>"function_core.php 減肥之術(shù)"—>"用戶(hù)輸入數(shù)據(jù)的處理"中，有兩句話是這樣說(shuō)的：
$_GET和$_POST的值默認(rèn)不做addslashes處理；
$_GET為$_GET和$_POST數(shù)組的合并，代碼中統(tǒng)一使用$_GET取值;
顯然，上面參與數(shù)據(jù)庫(kù)操作的$name變量是不安全的。但事實(shí)真這樣嗎？
下面看看與之相關(guān)自定義的C::T方法是怎么寫(xiě)的吧。
------------------------
……
public fetch_by_username($name){
　　return DB::result_first('select * from %t where username=%s',array($this->_table,$name));
}
……
通過(guò)上面的代碼，需要明白兩件事：
①該方法調(diào)用了DB層封裝的函數(shù)result_first；
②使用了%s對(duì)數(shù)組第二參數(shù)$name進(jìn)行格式化處理；
對(duì)于①，我們?cè)倏碊Z的技術(shù)文庫(kù)，經(jīng)查"Discuz! X2.5新版架構(gòu)優(yōu)化說(shuō)明"—>"數(shù)據(jù)庫(kù)DB層"—>"新增數(shù)據(jù)層：數(shù)據(jù)層的規(guī)范和約定"中，有句話是這樣說(shuō)的：
"DB層封裝的函數(shù)實(shí)現(xiàn)了addslashes，個(gè)別直接寫(xiě)sql語(yǔ)句的需主意addslashes；"
通過(guò)查看source/discuz/discuz_database.php，我們可以找到該類(lèi)定義的result_first方法，說(shuō)明該方法是被封裝在DB里的，所以基本確定$name是安全的。
至于為啥要查看discuz_database.php，而不是discuz_table.php，自己慢慢上下求索吧。
對(duì)于②，我們?cè)倏碊Z的技術(shù)文庫(kù)，經(jīng)查"Discuz! X2.5新版架構(gòu)優(yōu)化說(shuō)明"—>"數(shù)據(jù)庫(kù)DB層"—>"原DB類(lèi)的改進(jìn)"—>"3、SQL語(yǔ)句format的支持"中，可以看到支持的格式化表，其中%s表示進(jìn)行addslashes安全過(guò)濾處理。至此，我們可以完全確定上面的代碼是安全可靠的了。
但是如果我將自定義函數(shù)修改如下：
……
public fetch_by_username($name){
　　return DB::result_first('select * from %t where username=%i',array($this->_table,$name));
}
……
public fetch_by_username($name){
　　return DB::query('select * from '.DB::table('xxx').' where username='.$name);
}
……
會(huì)怎樣呢？留給大家思考。
------------------------

再看一個(gè)例子：
$query = DB::query('select * from '.DB::table('xxx').' where username='.$_GET['name']);
雖然DB封裝了query函數(shù)，但該函數(shù)并未進(jìn)行addslashes處理，而只是檢驗(yàn)SQL語(yǔ)句里的每一個(gè)字符，嚴(yán)格的講是不安全的。
另外，DZ的技術(shù)文庫(kù)—>"Discuz! X2.5新版架構(gòu)優(yōu)化說(shuō)明"—>"數(shù)據(jù)庫(kù)DB層"—>"新增數(shù)據(jù)層：數(shù)據(jù)層的規(guī)范和約定"中規(guī)定："不能使用$_G、$POST、$GET等全局變量；"
其實(shí)，除了不能使用規(guī)定的三個(gè)全局變量外，$_REQUEST變量也不應(yīng)該在SQL中使用！

那么，凡是$_GET都要進(jìn)行add...處理嗎？不一定，要看用在什么地方，一般來(lái)講，參與數(shù)據(jù)庫(kù)SUID操作的DB::query中都要進(jìn)行處理。例如：
$name  = addslashes($_GET['name']);
$query = DB::query('select * from '.DB::table('xxx').' where username='.$name);
但要注意避免重復(fù)過(guò)濾，如
$name  = addslashes($_GET['name']);
$query = DB::query('select * from '.DB::table('xxx').' where username='.addslashes($name));

綜上：
1、使用C::t方法的，要注意相關(guān)參數(shù)是否用%s進(jìn)行了格式化
2、無(wú)論是否C::t方法，使用DB::query(...)的,必須進(jìn)行add...處理
3、避免重復(fù)過(guò)濾
4、盡量避免在SQL中使用禁用的全局變量，因?yàn)橛袝r(shí)獲取的變量值有違初衷，不是想要的結(jié)果
5、建議使用C::t方法
6、盡量了解、熟知、掌握DZ技術(shù)文庫(kù)
7、盡量了解、熟知、掌握discuz_database.php、discuz_table.php等文件內(nèi)容

有同行曾問(wèn)我，為啥X2.5以后不再支持$_G['gp_xx']，我也不知道，這個(gè)要問(wèn)官方。但既然不支持，最好就不要用，否則你還得寫(xiě)個(gè)說(shuō)明，告知用戶(hù)開(kāi)啟兼容的方法，這不是給自己找麻煩嘛。

還有同行問(wèn)我，C::t方法有啥好處？我認(rèn)為好處就是對(duì)象清楚、對(duì)SQL進(jìn)行了格式化處理、降低了安全風(fēng)險(xiǎn)，并且有利于維護(hù)。

也有一些用戶(hù)問(wèn)我為啥不再開(kāi)發(fā)X2的插件了，這個(gè)很簡(jiǎn)單，DZ的技術(shù)文庫(kù)—>"Discuz! X2.5新版架構(gòu)優(yōu)化說(shuō)明"—>"程序底層架構(gòu)"—>"function_core.php 減肥之術(shù)"—>"用戶(hù)輸入數(shù)據(jù)的處理"中，第一句話是這樣說(shuō)的："Discus! X2.5之前版本對(duì)$_GET和$_POST的值默認(rèn)是進(jìn)行addslashes處理，函數(shù)在使用此值時(shí)信任外部數(shù)據(jù)的安全性，但這樣處理的弊端是容易生產(chǎn)二次注射的漏洞，為了防止此類(lèi)漏洞的產(chǎn)生，函數(shù)必須不信任任何數(shù)據(jù)外部數(shù)據(jù)的安全性"。因此，我對(duì)X2及以前的版本安全性是不信任的，出于對(duì)用戶(hù)負(fù)責(zé)，所以不再開(kāi)發(fā)X2的插件了。

另外，忠告開(kāi)發(fā)者，尤其是新手，要想提高插件審核通過(guò)率，應(yīng)做到以下幾點(diǎn)：
①養(yǎng)成良好規(guī)范的代碼書(shū)寫(xiě)習(xí)慣，可讀性強(qiáng)。那種一大堆亂碼似的代碼，人見(jiàn)人煩
②從審核者的角度著想，該注釋的地方加注釋?zhuān)阌趯徍苏呃斫獯颂幱靡?，避免引起誤解而被踢回。與人方便與己方便
③清理垃圾文件和代碼，讓審核者省時(shí)省力，提高審核進(jìn)度。只有好處沒(méi)有壞處
④沒(méi)事就多看看“開(kāi)發(fā)文檔”，尤其是“Discuz! 應(yīng)用中心應(yīng)用審核規(guī)范”，避免違規(guī)。否則，遭罪的是自己
以上是個(gè)人經(jīng)歷及經(jīng)驗(yàn)之談，有不當(dāng)之處請(qǐng)指正。

本篇屬教程類(lèi)，希望版主能移動(dòng)到“插件教程”子版塊中。