微信公衆平臺開發者中心安全模式消息體加解密實現

時間 2019-11-18

標籤微信公衆平臺開發者中心安全模式消息解密實現欄目職業生涯简体版

原文原文鏈接

1、消息體加解密php

微信公衆平臺在配置服務器時，提供了3種加解密的模式供開發者選擇，即明文模式、兼容模式、安全模式,選擇兼容模式和安全模式前，需在開發者中心填寫消息加解密密鑰EncodingAESKey。html

由浙江百牛信息技術bainiu.ltd整理髮佈於博客園算法

明文模式：維持現有模式，沒有適配加解密新特性，消息體明文收發，默認設置爲明文模式
兼容模式：公衆平臺發送消息內容將同時包括明文和密文，消息包長度增長到原來的3倍左右；公衆號回覆明文或密文都可，不影響現有消息收發；開發者可在此模式下進行調試
安全模式（推薦）：公衆平臺發送消息體的內容只含有密文，公衆帳號回覆的消息體也爲密文，建議開發者在調試成功後使用此模式收發消息

什麼是EncodingAESKey？api

微信公衆平臺採用AES對稱加密算法對推送給公衆賬號的消息體對行加密，EncodingAESKey則是加密所用的祕鑰。公衆賬號用此祕鑰對收到的密文消息體進行解密，回覆消息體也用此祕鑰加密。AES對稱加密算法的原理能夠參考 http://www.cnblogs.com/txw1958/p/aes.html

　　加解密的詳細技術方案能夠參考官方文檔 http://mp.weixin.qq.com/wiki/index.php?title=%E6%8A%80%E6%9C%AF%E6%96%B9%E6%A1%88安全

2、開發實現及數據分析

1. 配置

假設本次的開發配置中URL爲服務器

http://www.fangbei.org/index.php

接口程序中須要配置如下三項參數微信

/*
    方倍工做室 http://www.cnblogs.com/txw1958/
    CopyRight 2014 All Rights Reserved
*/
define("TOKEN", "weixin");
define("AppID", "wxbad0b45542aa0b5e");
define("EncodingAESKey", "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG");
require_once('wxBizMsgCrypt.php');

2. 加解密實現

當用戶向公衆帳號發送消息時，微信公衆帳號將會在URL中帶上signature、timestamp、nonce、encrypt_type、msg_signature等參數，以下所示微信公衆平臺

http://www.fangbei.org/index.php?signature=35703636de2f9df2a77a662b68e521ce17c34db4&timestamp=1414243737&nonce=1792106704&encrypt_type=aes&msg_signature=6147984331daf7a1a9eed6e0ec3ba69055256154

同時向該接口推送以下XML消息，即一個已加密的消息post

<xml>
    <ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
    <Encrypt><![CDATA[MNn4+jJ/VsFh2gUyKAaOJArwEVYCvVmyN0iXzNarP3O6vXzK62ft1/KG2/XPZ4y5bPWU/jfIfQxODRQ7sLkUsrDRqsWimuhIT8Eq+w4E/28m+XDAQKEOjWTQIOp1p6kNsIV1DdC3B+AtcKcKSNAeJDr7x7GHLx5DZYK09qQsYDOjP6R5NqebFjKt/NpEl/GU3gWFwG8LCtRNuIYdK5axbFSfmXbh5CZ6Bk5wSwj5fu5aS90cMAgUhGsxrxZTY562QR6c+3ydXxb+GHI5w+qA+eqJjrQqR7u5hS+1x5sEsA7vS+bZ5LYAR3+PZ243avQkGllQ+rg7a6TeSGDxxhvLw+mxxinyk88BNHkJnyK//hM1k9PuvuLAASdaud4vzRQlAmnYOslZl8CN7gjCjV41skUTZv3wwGPxvEqtm/nf5fQ=]]></Encrypt>
</xml>

這時，程序須要從url中得到如下參數ui

$timestamp  = $_GET['timestamp'];
$nonce = $_GET["nonce"];
$msg_signature  = $_GET['msg_signature'];
$encrypt_type = $_GET['encrypt_type'];

這些參數將用於加解密過程

收到消息後，先進行解密，解密部分代碼以下

$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
if ($encrypt_type == 'aes'){
    $pc = new WXBizMsgCrypt(TOKEN, EncodingAESKey, AppID);                
    $this->logger(" D \r\n".$postStr);
    $decryptMsg = "";  //解密後的明文
    $errCode = $pc->DecryptMsg($msg_signature, $timestamp, $nonce, $postStr, $decryptMsg);
    $postStr = $decryptMsg;
}

解密完成後，把解密內容又返回給$postStr，這是爲了保證將消息中解密後的內容和明文模式時的消息統一，方便後續處理，解密後的XML以下

<xml>
    <ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
    <FromUserName><![CDATA[oIDrpjpQ8j8mBuQ8nM26HWzNEZgg]]></FromUserName>
    <CreateTime>1414243737</CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[?]]></Content>
    <MsgId>6074130599188426998</MsgId>
</xml>

對消息在本身的原來代碼中處理，完成以後，要回復的消息以下

<xml>
    <ToUserName><![CDATA[oIDrpjpQ8j8mBuQ8nM26HWzNEZgg]]></ToUserName>
    <FromUserName><![CDATA[gh_680bdefc8c5d]]></FromUserName>
    <CreateTime>1414243733</CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[2014-10-25 21:28:53
技術支持 方倍工做室
http://www.fangbei.org/]]></Content>
</xml>

把上述消息進行加密，返回給微信公衆帳號

//加密
if ($encrypt_type == 'aes'){
    $encryptMsg = ''; //加密後的密文
    $errCode = $pc->encryptMsg($result, $timeStamp, $nonce, $encryptMsg);
    $result = $encryptMsg;
    $this->logger(" E \r\n".$result);
}

加密後的內容以下

<xml>
    <Encrypt><![CDATA[pE6gp6qvVBMHwCXwnM7illFBrh9LmvlKFlPUDuyQo9EKNunqbUFMd2KjiYoz+3K1B+93JbMWHt+19TI8awdRdyopRS4oUNg5M2jwpwXTmc6TtafkKNjvqlvPXIWmutw0tuMXke1hDgsqz0SC8h/QjNLxECuwnczrfCMJlt+APHnX2yMMaq/aYUNcndOH387loQvl2suCGucXpglnbxf7frTCz9NQVgKiYrvKOhk6KFiVMnzuxy6WWmoe3GBiUCPTtYf5b1CxzN2IHViEBm28ilV9wWdNOM9TPG7BSSAcpgY4pcwdIG5+4KhgYmnVU3bc/ZJkk42TIdidigOfFpJwET4UWVrLB/ldUud4aPexp3aPCR3Fe53S2HHcl3tTxh4iRvDftUKP3svYPctt1MlYuYv/BZ4JyzUQV03H+0XrVyDY2tyVjimgCrA2c1mZMgHttOHTQ6VTnxrMq0GWlRlH0KPQKqtjUpNQzuOH4upQ8boPsEtuY3wDA2RaXQPJrXon]]></Encrypt>
    <MsgSignature><![CDATA[6c46904dc1f58b2ddf2dd0399f1c6cf41f33ecb9]]></MsgSignature>
    <TimeStamp>1414243733</TimeStamp>
    <Nonce><![CDATA[1792106704]]></Nonce>
</xml>

這樣，一個安全模式下的加解密消息就完成了。

3、完整代碼

  1 <?php
  2 /*
  3     方倍工做室 http://www.cnblogs.com/txw1958/
  4     CopyRight 2014 All Rights Reserved
  5 */
  6 define("TOKEN", "weixin");
  7 define("AppID", "wxbad0b45542aa0b5e");
  8 define("EncodingAESKey", "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG");
  9 require_once('wxBizMsgCrypt.php');
 10 
 11 $wechatObj = new wechatCallbackapiTest();
 12 if (!isset($_GET['echostr'])) {
 13     $wechatObj->responseMsg();
 14 }else{
 15     $wechatObj->valid();
 16 }
 17 
 18 class wechatCallbackapiTest
 19 {
 20     //驗證簽名
 21     public function valid()
 22     {
 23         $echoStr = $_GET["echostr"];
 24         $signature = $_GET["signature"];
 25         $timestamp = $_GET["timestamp"];
 26         $nonce = $_GET["nonce"];
 27         $tmpArr = array(TOKEN, $timestamp, $nonce);
 28         sort($tmpArr);
 29         $tmpStr = implode($tmpArr);
 30         $tmpStr = sha1($tmpStr);
 31         if($tmpStr == $signature){
 32             echo $echoStr;
 33             exit;
 34         }
 35     }
 36 
 37     //響應消息
 38     public function responseMsg()
 39     {
 40         $timestamp  = $_GET['timestamp'];
 41         $nonce = $_GET["nonce"];
 42         $msg_signature  = $_GET['msg_signature'];
 43         $encrypt_type = (isset($_GET['encrypt_type']) && ($_GET['encrypt_type'] == 'aes')) ? "aes" : "raw";
 44         
 45         $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
 46         if (!empty($postStr)){
 47             //解密
 48             if ($encrypt_type == 'aes'){
 49                 $pc = new WXBizMsgCrypt(TOKEN, EncodingAESKey, AppID);                
 50                 $this->logger(" D \r\n".$postStr);
 51                 $decryptMsg = "";  //解密後的明文
 52                 $errCode = $pc->DecryptMsg($msg_signature, $timestamp, $nonce, $postStr, $decryptMsg);
 53                 $postStr = $decryptMsg;
 54             }
 55             $this->logger(" R \r\n".$postStr);
 56             $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
 57             $RX_TYPE = trim($postObj->MsgType);
 58 
 59             //消息類型分離
 60             switch ($RX_TYPE)
 61             {
 62                 case "event":
 63                     $result = $this->receiveEvent($postObj);
 64                     break;
 65                 case "text":
 66                     $result = $this->receiveText($postObj);
 67                     break;
 68             }
 69             $this->logger(" R \r\n".$result);
 70             //加密
 71             if ($encrypt_type == 'aes'){
 72                 $encryptMsg = ''; //加密後的密文
 73                 $errCode = $pc->encryptMsg($result, $timeStamp, $nonce, $encryptMsg);
 74                 $result = $encryptMsg;
 75                 $this->logger(" E \r\n".$result);
 76             }
 77             echo $result;
 78         }else {
 79             echo "";
 80             exit;
 81         }
 82     }
 83 
 84     //接收事件消息
 85     private function receiveEvent($object)
 86     {
 87         $content = "";
 88         switch ($object->Event)
 89         {
 90             case "subscribe":
 91                 $content = "歡迎關注方倍工做室 ";
 92                 break;
 93         }
 94 
 95         $result = $this->transmitText($object, $content);
 96         return $result;
 97     }
 98 
 99     //接收文本消息
100     private function receiveText($object)
101     {
102         $keyword = trim($object->Content);
103         if (strstr($keyword, "文本")){
104             $content = "這是個文本消息";
105         }else if (strstr($keyword, "單圖文")){
106             $content = array();
107             $content[] = array("Title"=>"單圖文標題",  "Description"=>"單圖文內容", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
108         }else if (strstr($keyword, "圖文") || strstr($keyword, "多圖文")){
109             $content = array();
110             $content[] = array("Title"=>"多圖文1標題", "Description"=>"", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
111             $content[] = array("Title"=>"多圖文2標題", "Description"=>"", "PicUrl"=>"http://d.hiphotos.bdimg.com/wisegame/pic/item/f3529822720e0cf3ac9f1ada0846f21fbe09aaa3.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
112             $content[] = array("Title"=>"多圖文3標題", "Description"=>"", "PicUrl"=>"http://g.hiphotos.bdimg.com/wisegame/pic/item/18cb0a46f21fbe090d338acc6a600c338644adfd.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
113         }else if (strstr($keyword, "音樂")){
114             $content = array();
115             $content = array("Title"=>"最炫民族風", "Description"=>"歌手：鳳凰傳奇", "MusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3", "HQMusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3");
116         }else{
117             $content = date("Y-m-d H:i:s",time())."\n".$object->FromUserName."\n技術支持 方倍工做室";
118         }
119 
120         if(is_array($content)){
121             if (isset($content[0])){
122                 $result = $this->transmitNews($object, $content);
123             }else if (isset($content['MusicUrl'])){
124                 $result = $this->transmitMusic($object, $content);
125             }
126         }else{
127             $result = $this->transmitText($object, $content);
128         }
129         return $result;
130     }
131 
132     //回覆文本消息
133     private function transmitText($object, $content)
134     {
135         $xmlTpl = "<xml>
136     <ToUserName><![CDATA[%s]]></ToUserName>
137     <FromUserName><![CDATA[%s]]></FromUserName>
138     <CreateTime>%s</CreateTime>
139     <MsgType><![CDATA[text]]></MsgType>
140     <Content><![CDATA[%s]]></Content>
141 </xml>";
142         $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), $content);
143         return $result;
144     }
145 
146     //回覆圖文消息
147     private function transmitNews($object, $newsArray)
148     {
149         if(!is_array($newsArray)){
150             return;
151         }
152         $itemTpl = "        <item>
153             <Title><![CDATA[%s]]></Title>
154             <Description><![CDATA[%s]]></Description>
155             <PicUrl><![CDATA[%s]]></PicUrl>
156             <Url><![CDATA[%s]]></Url>
157         </item>
158 ";
159         $item_str = "";
160         foreach ($newsArray as $item){
161             $item_str .= sprintf($itemTpl, $item['Title'], $item['Description'], $item['PicUrl'], $item['Url']);
162         }
163         $xmlTpl = "<xml>
164     <ToUserName><![CDATA[%s]]></ToUserName>
165     <FromUserName><![CDATA[%s]]></FromUserName>
166     <CreateTime>%s</CreateTime>
167     <MsgType><![CDATA[news]]></MsgType>
168     <ArticleCount>%s</ArticleCount>
169     <Articles>
170 $item_str    </Articles>
171 </xml>";
172 
173         $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), count($newsArray));
174         return $result;
175     }
176 
177     //回覆音樂消息
178     private function transmitMusic($object, $musicArray)
179     {
180         $itemTpl = "<Music>
181         <Title><![CDATA[%s]]></Title>
182         <Description><![CDATA[%s]]></Description>
183         <MusicUrl><![CDATA[%s]]></MusicUrl>
184         <HQMusicUrl><![CDATA[%s]]></HQMusicUrl>
185     </Music>";
186 
187         $item_str = sprintf($itemTpl, $musicArray['Title'], $musicArray['Description'], $musicArray['MusicUrl'], $musicArray['HQMusicUrl']);
188 
189         $xmlTpl = "<xml>
190     <ToUserName><![CDATA[%s]]></ToUserName>
191     <FromUserName><![CDATA[%s]]></FromUserName>
192     <CreateTime>%s</CreateTime>
193     <MsgType><![CDATA[music]]></MsgType>
194     $item_str
195 </xml>";
196 
197         $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time());
198         return $result;
199     }
200 
201     //日誌記錄
202     public function logger($log_content)
203     {
204         if(isset($_SERVER['HTTP_APPNAME'])){   //SAE
205             sae_set_display_errors(false);
206             sae_debug($log_content);
207             sae_set_display_errors(true);
208         }else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ //LOCAL
209             $max_size = 500000;
210             $log_filename = "log.xml";
211             if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);}
212             file_put_contents($log_filename, date('Y-m-d H:i:s').$log_content."\r\n", FILE_APPEND);
213         }
214     }
215 }
216 ?>

原文 http://www.cnblogs.com/txw1958/p/weixin-aes-encrypt-decrypt.html