本文介紹如何在30分鐘內搭建一個基於OSS的行動裝置 App數據直傳服務。直傳指的是行動裝置 App數據的上傳和下載直接連接OSS,只有控制流程串連自己的伺服器。
背景
在移動互聯的時代,手機app上傳的數據越來越多。作為開發人員,您可以利用OSS處理各種資料存放區需求,從而更加專註於自己的應用邏輯。
基於OSS的行動裝置 App數據直傳服務具有以下優勢:
- 數據安全:使用靈活的授權和鑒權方式進行數據的上傳和下載,更加安全。
- 成本低廉:您不需要準備很多伺服器。行動裝置 App直接連接雲端儲存OSS,只有控制流程串連應用伺服器。
- 高並發:支援海量用戶並發訪問。
- 彈性擴容:無限擴容的儲存空間。
- 資料處理:和圖片處理以及音視頻轉碼搭配使用,方便靈活地進行資料處理。
下載並安裝行動裝置 App
您可以通過此行動裝置 App上傳圖片到OSS。上傳的方法支援普通上傳和斷點續傳上傳。在網路環境差的情況下,推薦使用斷點續傳上傳。您還可以利用圖片處理服務,對要上傳的圖片進行縮略和加浮水印處理。樣本應用的最終效果圖如下:
- 應用伺服器:該行動裝置 App對應的後台應用伺服器。請使用步驟2:下載應用伺服器程式碼範例中提供的應用伺服器程式碼範例,部署自己的應用伺服器。
- 上傳Bucket:該行動裝置 App要把數據上傳到哪個Bucket。
- 區域:上傳Bucket所在的地域。
原理介紹
行動裝置 App直傳服務的架構圖如下所示:

- Android/iOS 行動裝置 App:即終端使用者手機上的app。
- OSS:即阿里雲對象儲存,負責儲存app上傳的數據。
- RAM/STS:負責生成臨時上傳憑證,即Token。
- 應用伺服器:即提供該Android/iOS應用的開發人員開發的app後台服務,用於管理app上傳和下載的Token,以及用戶通過app上傳數據的元資訊。
實現步驟如下:
- 行動裝置 App嚮應用伺服器申請一個臨時上傳憑證。
说明 Android和iOS應用不能直接儲存AccessKey,這樣會存在數據泄露的風險。所以應用必須向用戶的應用伺服器申請一個Token。這個Token是有時效性的,如果Token的過期時間是30分鐘(由應用伺服器指定),那麼在這30分鐘裡,該Android/iOS應用可以使用此Token從OSS上傳和下載數據, 30分鐘後需要重新獲取Token。 - 應用伺服器檢測上述請求的合法性,然後返回Token給行動裝置 App。
- Android/iOS行動裝置 App使用此Token將數據上傳到OSS,或者從OSS下載數據。
以下介紹應用伺服器如何生成Token以及Android/iOS行動裝置 App如何獲取Token。
步驟1:建立Bucket並開通STS服務
- 開通OSS,並且建立Bucket。
- 開通STS服務。
- 登入OSS管理主控台。
- 在OSS概覽頁中找到基礎配置區域,單擊安全性權杖。
- 進入到安全性權杖快捷配置頁面,單擊開始授權。
说明 如果沒有開通RAM,會彈出開通的對話方塊。單擊開通。開通完成後單擊開始授權。 - 系統進行自動授權。請保存AccessKeyID、AccessKeySecret和RoleArn三個參數。
- 如果您未建立過AccessKey,系統自動建立AccessKey。請保存AccessKeyId、AccessKeySecret和RoleArn,如下圖所示。
- 如果您之前已經建立過AccessKey,也可以單擊如下圖所示的查看建立新的AccessKey。
- 如果您未建立過AccessKey,系統自動建立AccessKey。請保存AccessKeyId、AccessKeySecret和RoleArn,如下圖所示。
步驟2:下載應用伺服器程式碼範例
步驟3:修改設定檔
以下例子採用PHP編寫。每個語言的範例程式碼下載後,都會有一個設定檔config.json,如下所示:
{
"AccessKeyID" : "",
"AccessKeySecret" : "",
"RoleArn" : "",
"TokenExpireTime" : "900",
"PolicyFile": "policy/all_policy.txt"
}
相關參數說明如下:
- AccessKeyID:填寫之前記錄的AccessKeyID。
- AccessKeySecret:填寫之前記錄的AccessKeySecret。
- RoleArn:填寫之前記錄的RoleArn。
- TokenExpireTime:指Android/iOS應用獲取到的Token的失效時間,最小值和預設值均為900s。
- PolicyFile:該Token所擁有的許可權列表的檔案,可使用預設值。
说明 程式碼範例中提供了三種最常用的Token許可權檔案,位於policy目錄下面。分別是:
- all_policy.txt:指定該Token擁有該帳號下的所有許可權,包括:
- 建立Bucket
- 刪除Bucket
- 上傳檔案
- 下載檔案
- 刪除檔案
- bucket_read_policy.txt:指定該Token擁有該帳號下指定Bucket的讀許可權。
- bucket_read_write_policy.txt:指定了該Token擁有該帳號下指定Bucket的讀寫權限。
- all_policy.txt:指定該Token擁有該帳號下的所有許可權,包括:
步驟4:運行範例程式碼
程式碼範例的運行方法如下:
- 對於PHP版本,將包下載解壓後,修改config.json檔案,直接運行php sts.php即能生成Token,將程式部署到指定的應用伺服器位址。
- 對於Java版本(依賴於java 1.7),將包下載解壓後,修改config.json檔案,運行java -jar oss-token-server.jar (port)。如果不指定port(通信埠),直接運行java –jar oss-token-server.jar,程式會監聽7080通信埠。
返回的資料格式解析如下:
//正確返回
{
"StatusCode":200,
"AccessKeyId":"STS.3p***dgagdasdg",
"AccessKeySecret":"rpnwO9***tGdrddgsR2YrTtI",
"SecurityToken":"CAES+wMIARKAAZhjH0EUOIhJMQBMjRywXq7MQ/cjLYg80Aho1ek0Jm63XMhr9Oc5s˙∂˙∂3qaPer8p1YaX1NTDiCFZWFkvlHf1pQhuxfKBc+mRR9KAbHUefqH+rdjZqjTF7p2m1wJXP8S6k+G2MpHrUe6TYBkJ43GhhTVFMuM3BZajY3VjZWOXBIODRIR1FKZjIiEjMzMzE0MjY0NzM5MTE4NjkxMSoLY2xpZGSSDgSDGAGESGTETqOio6c2RrLWRlbW8vKgoUYWNzOm9zczoqOio6c2RrLWRlbW9KEDExNDg5MzAxMDcyNDY4MThSBTI2ODQyWg9Bc3N1bWVkUm9sZVVzZXJgAGoSMzMzMTQyNjQ3MzkxMTg2OTExcglzZGstZGVtbzI=",
"Expiration":"2017-12-12T07:49:09Z",
}
//錯誤返回
{
"StatusCode":500,
"ErrorCode":"InvalidAccessKeyId.NotFound",
"ErrorMessage":"Specified access key is not found."
}
正確返回的五個變數構成一個Token:
- StatusCode:獲取Token的狀態,獲取成功時,傳回值是200。
- AccessKeyId:Android/iOS行動裝置 App初始化OSSClient獲取的 AccessKeyId。
- AccessKeySecret:Android/iOS行動裝置 App初始化OSSClient獲取AccessKeySecret。
- SecurityToken:Android/iOS行動裝置 App初始化的Token。
- Expiration:該Token失效的時間。Android SDK會自動判斷Token是否失效,如果失效,則自動獲取Token。
錯誤返回說明如下:
- StatusCode:表示獲取Token的狀態,獲取失敗時,傳回值是500。
- ErrorCode:表示錯誤原因。
- ErrorMessage:表示錯誤的具體資訊描述。
步驟5:體驗行動裝置 App直傳服務
- 部署程式後,記下應用伺服器位址如
http://abc.com:8080
,將樣本程式裡面的應用伺服器修改成上述地址。 - 選擇數據要上傳到哪個Bcuket及地域,修改樣本程式裡相應的上傳Bucket及區域。
- 單擊設定,載入配置。
- 選擇圖片,設定上傳OSS檔案名,上傳圖片。
- 上傳成功後,通過控制台查看上傳結果。
核心代碼解析
OSS初始化的代碼解析如下:
- Android版本
// 推薦使用OSSAuthCredentialsProvider,token過期後會自動刷新。 String stsServer = "應用伺服器位址,例如http://abc.com:8080" OSSCredentialProvider credentialProvider = new OSSAuthCredentialsProvider(stsServer); //config ClientConfiguration conf = new ClientConfiguration(); conf.setConnectionTimeout(15 * 1000); // 連接逾時時間,預設15秒 conf.setSocketTimeout(15 * 1000); // Socket逾時時間,預設15秒 conf.setMaxConcurrentRequest(5); // 最大並發請求數,預設5個 conf.setMaxErrorRetry(2); // 失敗後最大重試次數,預設2次 OSS oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider, conf);
- iOS版本
OSSClient * client; ... // 推薦使用OSSAuthCredentialProvider,token過期後會自動刷新。 id<OSSCredentialProvider> credential = [[OSSAuthCredentialProvider alloc] initWithAuthServerUrl:@"應用伺服器位址,例如http://abc.com:8080"]; client = [[OSSClient alloc] initWithEndpoint:endPoint credentialProvider:credential];