消息通知功能公測說明__操作指南_產品使用問題_媒體轉碼-阿裏雲

,,媒體轉碼通過 MNS實現轉碼作業及模版分析作業結束時的消息通知功能，因此激活此功能請先開通MNS服務。您可以訪問媒體轉碼,控製台 － ,雲資源授權管理 － MNS，按照向導開通MNS服務及完成相關授權。

,,2. 創建 MNS 通知主題

,,,請訪問 ,MNS,控製台（選擇與媒體轉碼服務同區域） －發布訂閱 － 創建主題 以創建消息主題；然後在主題的訂閱詳情中設定訂閱消息的HTTP地址；

,,,詳細指導見： 消息服務－控製台使用幫助－主題使用幫助

,訂閱消息的HTTP地址

,HTTP地址僅指定域名或IP地址（可設定自定義Web服務端口），實際消息推送至 Web服務的 ,/notifications 。

,取消,接收消息的HTTP地址強製為 “,Web服務的 ,/notifications路徑”的限製，,支持用戶自行設定接收消息的Web服務的路徑；

,,3. 在轉碼管道上綁定消息主題

,,請訪問媒體轉碼,控製台 － 資源,管理  － 管道 ，在管道上關聯消息通知主題。

, 

,,二、消息通知功能接收消息服務搭建

,,MNS通過發送POST請求將消息推送到指定接收消息的HTTP地址。

,,1. 消息推送請求格式

,,Request的構造主要由以下幾個部分組成：

,,· 請求行

,,POST /notifications HTTP/1.1

,,· URI參數

,,無

,,· Request Header

,,· Request Body

,,Request Body為XML格式，包括創建消息正文和屬性。

,,· Response

,,返回消息由返回狀態行，HTTP頭和消息體三部分組成

,,· HTTP Status Code

,,,HTTP/1.1 204 NoContent

,,若確認成功，返回204。

,,若請求簽名認證不過，返回403。

,,若任何其他錯誤，返回500。

,,· Response Header

,, 無

,,· Response Body

,, 無

,,· Special Error:

,,無

,,請求示例：

,,媒體轉碼消息通知消息體－Message 結構說明：

,,消息示例：

,,返回頭示例：

,,2. 接收消息服務端對消息推送請求的簽名認證

,H,,TTP,,的消息接收地址，用戶可以通過SigningCerURL獲取簽名證書（推送消息的請求中都會攜帶），並根據相應的方法來驗證該請求是否由MNS係統發出，防止惡意請求對用戶造成負麵影響。

,, SigningCerURL：描述了用戶提取驗證請求是否來自MNS的簽名證書的地址。

,,HTTP的消息接收地址對應的HTTP Server對請求的合法性進行驗證的方法如下：在請求的Header中，Authorization字段的值是MNS根據待簽名字符串，用SHA1-RSA簽名算法生成簽名。用戶可以使用公鑰對簽名進行驗證。具體的驗證方法為：

,,第一步：

,,· 獲取X509證書

,,在MNS發送給消息接收地址對應的HTTP Server的XML格式的Request Body中，SigningCertURL指定了簽名證書的地址。用戶需要獲取該簽名文件，從中提取出簽名的公鑰。

,,第二步：

,,· 計算待簽名字符串：

,· VERB,表示HTTP的Method

,· Content-Md5,表示請求內容數據的MD5值

,· CONTENT-TYPE,表示請求內容的類型

,· DATE,表示此次操作的時間，不能為空，目前隻支持GMT格式，如果請求時間和MNS服務器時間相差超過15分鍾，MNS會判定此請求不合法，返回400。

,· CanonicalizedMNSHeaders,表示 http中的x-mns-開始的字段組合

,· CanonicalizedResource,表示http請求的相對地址，不能為空

,· ,采用SHA1算法對待簽名字符串進行哈希。請按照RFC3447中的SHA1算法對待簽名字符串做哈希運算。

,第三步：

,· ,對Authorization簽名字段Base64解碼。Authorization簽名字段采用Base64編碼方式進行編碼，在對比簽名前，需要對其進行Base64解碼。

,· ,用公鑰對Authorization簽名進行解碼。Authorization簽名經過Base64 Decode後，再用從X509證書中提取的公鑰對其進行解密。

,第四步：

,· ,比較第二、三兩步的結果是否一致。如果一致，則表明請求來自  MNS，訪問合法。

,其他：

,1.      ,用來簽名的字符串為utf-8格式。

,2.      ,簽名的方法用 RFC 3447 中定義的 sha1WithRSAEncryption, 方法。

,3.      base64,是指使用base64算法轉碼文本。

附：

,HTTP,的消息接收服務 Java 實現示例