注意事項

• 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產品訪問OSS，請使用內網Endpoint。關于OSS支持的Region與Endpoint的對應關系，請參見訪問域名和數據中心。

• 本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請參見初始化。

使用STS臨時授權

OSS可以通過阿里云STS（Security Token Service）進行臨時授權訪問。阿里云STS是為云計算用戶提供臨時訪問令牌的Web服務。通過STS，您可以為第三方應用或子用戶（即用戶身份由您自己管理的用戶）頒發一個自定義時效和權限的訪問憑證。關于STS的更多信息，請參見STS介紹。

STS的優勢如下：

• 您無需透露您的長期密鑰（AccessKey）給第三方應用，只需生成一個訪問令牌并將令牌交給第三方應用。您可以自定義這個令牌的訪問權限及有效期限。

• 您無需關心權限撤銷問題，訪問令牌過期后自動失效。

通過STS臨時授權訪問OSS的步驟如下：

1. 獲取臨時訪問憑證

   臨時訪問憑證包括臨時訪問密鑰（AccessKey ID和AccessKey Secret）和安全令牌（SecurityToken）。臨時訪問憑證有效時間單位為秒，最小值為900，最大值以當前角色設定的最大會話時間為準。更多信息，請參見設置RAM角色最大會話時間。

   您可以通過以下兩種方式獲取臨時訪問憑證。

   • 方式一

     通過調用STS服務的AssumeRole接口獲取臨時訪問憑證。

   • 方式二

     通過各語言STS SDK獲取臨時訪問憑證。

2. 使用STS憑證構造簽名請求。

   • 上傳文件

     #include "oss_api.h"
     #include "aos_http_io.h"
     /* yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
     const char *endpoint = "yourEndpoint";
     /* 運行本代碼示例之前，請確保已使用STS服務獲取的臨時訪問密鑰設置環境變量YOUR_ACCESS_KEY_ID和YOUR_ACCESS_KEY_SECRET。*/  
     const char *access_key_id = getenv("OSS_ACCESS_KEY_ID");
     const char *access_key_secret = getenv("OSS_ACCESS_KEY_SECRET");
     /* 從STS服務獲取的安全令牌（SecurityToken）。*/
     const char *sts_token = "yourStsToken";
     /* 填寫Bucket名稱，例如examplebucket。*/
     const char *bucket_name = "examplebucket";
     /* 填寫Object完整路徑，完整路徑中不能包含Bucket名稱，例如exampledir/exampleobject.txt。*/
     const char *object_name = "exampledir/exampleobject.txt";
     const char *object_content = "More than just cloud.";
     
     void init_options(oss_request_options_t *options)
     {
         options->config = oss_config_create(options->pool);
         /* 用char*類型的字符串初始化aos_string_t類型。*/
         aos_str_set(&options->config->endpoint, endpoint);
         aos_str_set(&options->config->access_key_id, access_key_id);
         aos_str_set(&options->config->access_key_secret, access_key_secret);
         aos_str_set(&options->config->sts_token, sts_token);
         /* 是否使用CNAME訪問OSS服務。0表示不使用。*/
         options->config->is_cname = 0;
         /* 設置網絡相關參數，例如超時時間等。*/
         options->ctl = aos_http_controller_create(options->pool, 0);
     }
     
     int main(int argc, char *argv[])
     {
         /* 在程序入口調用aos_http_io_initialize方法來初始化網絡、內存等全局資源。*/
         if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
             exit(1);
         }
     
         /* 用于內存管理的內存池（pool），等價于apr_pool_t。其實現代碼在apr庫中。*/
         aos_pool_t *pool;
         /* 重新創建一個內存池，第二個參數是NULL，表示沒有繼承其他內存池。*/
         aos_pool_create(&pool, NULL);
         /* 創建并初始化options，該參數包括endpoint、access_key_id、acces_key_secret、is_cname、curl等全局配置信息。*/
         oss_request_options_t *oss_client_options;
         /* 在內存池中分配內存給options。*/
         oss_client_options = oss_request_options_create(pool);
         /* 初始化Client的選項oss_client_options。*/
         init_options(oss_client_options);
     
         /* 初始化參數。*/
         aos_string_t bucket;
         aos_string_t object;
         aos_list_t buffer;
         aos_buf_t *content = NULL;
         aos_table_t *headers = NULL;
         aos_table_t *resp_headers = NULL; 
         aos_status_t *resp_status = NULL; 
         /* 將類型為char*的數據賦值給bucket。*/
         aos_str_set(&bucket, bucket_name);
         aos_str_set(&object, object_name);
     
         aos_list_init(&buffer);
         content = aos_buf_pack(oss_client_options->pool, object_content, strlen(object_content));
         aos_list_add_tail(&content->node, &buffer);
     
         /* 上傳文件。*/
         resp_status = oss_put_object_from_buffer(oss_client_options, &bucket, &object, &buffer, headers, &resp_headers);
         /* 判斷文件是否上傳成功。*/
         if (aos_status_is_ok(resp_status)) {
             printf("put object from buffer succeeded\n");
         } else {
             printf("put object from buffer failed\n");      
         }    
     
         /* 釋放內存池，相當于釋放了請求過程中各資源分配的內存。*/
         aos_pool_destroy(pool);
     
         /* 釋放之前分配的全局資源。*/
         aos_http_io_deinitialize();
     
         return 0;
     }            

   • 下載文件

     #include "oss_api.h"
     #include "aos_http_io.h"
     /* yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
     const char *endpoint = "yourEndpoint";
     /* 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/  
     const char *access_key_id = getenv("OSS_ACCESS_KEY_ID");
     const char *access_key_secret = getenv("OSS_ACCESS_KEY_SECRET");
     /* 從STS服務獲取的安全令牌（SecurityToken）。*/
     const char *sts_token = "yourStsToken";
     /* 填寫Bucket名稱，例如examplebucket。*/
     const char *bucket_name = "examplebucket";
     /* 填寫Object完整路徑，完整路徑中不能包含Bucket名稱，例如exampledir/exampleobject.txt。*/
     const char *object_name = "exampledir/exampleobject.txt";
     void init_options(oss_request_options_t *options)
     {
         options->config = oss_config_create(options->pool);
         /* 用char*類型的字符串初始化aos_string_t類型。*/
         aos_str_set(&options->config->endpoint, endpoint);
         aos_str_set(&options->config->access_key_id, access_key_id);
         aos_str_set(&options->config->access_key_secret, access_key_secret);
         aos_str_set(&options->config->sts_token, sts_token);
         /* 是否使用了CNAME。0表示不使用。*/
         options->config->is_cname = 0;
         /* 用于設置網絡相關參數，比如超時時間等。*/
         options->ctl = aos_http_controller_create(options->pool, 0);
     }
     int main(int argc, char *argv[])
     {
         /* 在程序入口調用aos_http_io_initialize方法來初始化網絡、內存等全局資源。*/
         if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
             exit(1);
         }
         /* 用于內存管理的內存池（pool），等價于apr_pool_t。其實現代碼在apr庫中。*/
         aos_pool_t *pool;
         /* 重新創建一個內存池，第二個參數是NULL，表示沒有繼承其它內存池。*/
         aos_pool_create(&pool, NULL);
         /* 創建并初始化options，該參數包括endpoint、access_key_id、acces_key_secret、is_cname、curl等全局配置信息。*/
         oss_request_options_t *oss_client_options;
         /* 在內存池中分配內存給options。*/
         oss_client_options = oss_request_options_create(pool);
         /* 初始化Client的選項oss_client_options。*/
         init_options(oss_client_options);
         /* 初始化參數。*/
         aos_string_t bucket;
         aos_string_t object;
         aos_list_t buffer;
         aos_buf_t *content = NULL;
         aos_table_t *params = NULL;
         aos_table_t *headers = NULL;
         aos_table_t *resp_headers = NULL; 
         aos_status_t *resp_status = NULL; 
         char *buf = NULL;
         int64_t len = 0;
         int64_t size = 0;
         int64_t pos = 0;
         aos_str_set(&bucket, bucket_name);
         aos_str_set(&object, object_name);
         aos_list_init(&buffer);
         /* 下載文件到本地內存。*/
         resp_status = oss_get_object_to_buffer(oss_client_options, &bucket, &object, 
                                      headers, params, &buffer, &resp_headers);
         if (aos_status_is_ok(resp_status)) {
             printf("get object to buffer succeeded\n");
             /* 將下載內容拷貝到buffer中。*/
             len = aos_buf_list_len(&buffer);
             buf = aos_pcalloc(pool, len + 1);
             buf[len] = '\0';
             aos_list_for_each_entry(aos_buf_t, content, &buffer, node) {
             size = aos_buf_size(content);
                 memcpy(buf + pos, content->pos, size);
                 pos += size;
             }
         }
         else {
             printf("get object to buffer failed\n");  
         }
         /* 釋放內存池，相當于釋放了請求過程中各資源分配的內存。*/
         aos_pool_destroy(pool);
         /* 釋放之前分配的全局資源。*/
         aos_http_io_deinitialize();
         return 0;
     }

使用簽名URL臨時授權