Object Storage Service:C SDK を使用したアクセス権限の付与

注意事項

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

• このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する場合は、「初期化 (C SDK)」をご参照ください。

STS を使用した一時的なアクセス権限の付与

OSS は、Alibaba Cloud Security Token Service (STS) による一時的なアクセス権限の付与をサポートしています。STS は、クラウドコンピューティングユーザーに一時的なアクセストークンを提供する Web サービスです。STS を使用すると、カスタムの有効期間と権限を持つアクセス認証情報をサードパーティのアプリケーションまたはサブユーザー (ID を管理するユーザー) に発行できます。STS の詳細については、「STS とは」をご参照ください。

STS には次の利点があります。

• 長期的な AccessKey ペアをサードパーティのアプリケーションに公開する必要はありません。代わりとして、アクセストークンを生成してアプリケーションに提供できます。このトークンのアクセス権限と有効期間はカスタマイズできます。

• 権限の失効を管理する必要はありません。アクセストークンは有効期限が切れると自動的に無効になります。

STS からの一時的なアクセス認証情報を使用して OSS にアクセスするには、次の手順を実行します。

1. 一時的なアクセス認証情報の取得

   一時的なアクセス認証情報には、一時的な AccessKey ペア (AccessKey ID と AccessKey Secret) とセキュリティトークン (SecurityToken) が含まれます。一時的なアクセス認証情報の有効期間は秒単位で指定します。最小値は 900 です。最大値は、現在の RAM ロールに指定された最大セッション期間です。詳細については、「RAM ロールの最大セッション期間の設定」をご参照ください。

   一時的なアクセス認証情報は、次のいずれかの方法で取得できます。

   • 方法 1

     AssumeRole 操作を呼び出して、一時的なアクセス認証情報を取得します。

   • 方法 2

     STS SDK を使用して一時的なアクセス認証情報を取得します。詳細については、「STS SDK」をご参照ください。

2. STS 認証情報を使用した署名付きリクエストの作成

   • ファイルのアップロード

     #include "oss_api.h"
     #include "aos_http_io.h"
     /* yourEndpoint を、バケットが配置されているリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。*/
     const char *endpoint = "yourEndpoint";
     /* このサンプルコードを実行する前に、STS から取得した一時的な AccessKey ペアに基づいて、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";
     /* バケット名を指定します。例：examplebucket */
     const char *bucket_name = "examplebucket";
     /* オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。例：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);
         /* aos_string_t 型を char* 文字列で初期化します。*/
         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 は、CNAME ドメイン名が使用されないことを示します。*/
         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;
         /* 新しいメモリプールを作成します。2 番目のパラメーターは NULL で、プールが他のメモリプールから継承しないことを示します。*/
         aos_pool_create(&pool, NULL);
         /* オプションを作成して初期化します。このパラメーターには、endpoint、access_key_id、access_key_secret、is_cname、curl などのグローバル構成情報が含まれます。*/
         oss_request_options_t *oss_client_options;
         /* メモリプール内のオプションにメモリを割り当てます。*/
         oss_client_options = oss_request_options_create(pool);
         /* クライアントオプション 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* 型のデータをバケットに割り当てます。*/
         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 を、バケットが配置されているリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを 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";
     /* バケット名を指定します。例：examplebucket */
     const char *bucket_name = "examplebucket";
     /* オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。例：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);
         /* aos_string_t 型を char* 文字列で初期化します。*/
         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 は、CNAME ドメイン名が使用されないことを示します。*/
         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;
         /* 新しいメモリプールを作成します。2 番目のパラメーターは NULL で、プールが他のメモリプールから継承しないことを示します。*/
         aos_pool_create(&pool, NULL);
         /* オプションを作成して初期化します。このパラメーターには、endpoint、access_key_id、access_key_secret、is_cname、curl などのグローバル構成情報が含まれます。*/
         oss_request_options_t *oss_client_options;
         /* メモリプール内のオプションにメモリを割り当てます。*/
         oss_client_options = oss_request_options_create(pool);
         /* クライアントオプション 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");
             /* ダウンロードしたコンテンツをバッファーにコピーします。*/
             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 を使用した一時的なアクセス権限の付与