Object Storage Service:バケットのデフォルトドメイン名にカスタムドメイン名をマップする

ステップ 1: カスタムドメイン名をマップする

カスタムドメイン名をバケットにマップするプロセスは、ドメインレジストラと所有アカウントによって異なります。Alibaba Cloud WHOIS ページでドメインレジストラを照会し、Alibaba Cloud DNS コンソールで関連付けられている所有アカウントを確認できます。

ステップ 2: カスタムドメイン名を確認する

カスタムドメイン名をバケットにマップした後、カスタムドメイン名を使用して行われたリクエストはすべて、DNS を介してバケットのデフォルトドメイン名に解決されます。 カスタムドメイン名の DNS レコードを確認するには、nslookup コマンドまたは dig コマンドを実行できます。

nslookup -type=CNAME static.example.com

dig CNAME static.example.com

ステップ 3: カスタムドメイン名を使用する

カスタムドメイン名の DNS レコードが有効になった後、HTTP プロトコルとカスタムドメイン名を使用して URL を構築できます。これには、署名と有効期間が含まれます。 URL の形式は http://YourDomain/ObjectName?SignatureInformation です。その後、この URL を使用して OSS バケット内のオブジェクトにアクセスできます。

1. 署名付き URL を取得します。

   OSS コンソールを使用する

   1. OSS コンソール にログインします。

   2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケット] ページで、バケットの名前をクリックします。

   3. 左側のナビゲーションツリーで、オブジェクト管理 > オブジェクト を選択します。

   4. [オブジェクト] ページで、オブジェクトの名前をクリックします。

   5. [詳細の表示] パネルで、[カスタムドメイン名] フィールドのバケットにマッピングされているカスタムドメイン名を選択し、他のパラメーターのデフォルト設定を保持して、[オブジェクト URL のコピー] をクリックします。

      

   ossbrowser を使用する

   ossbrowser を使用して、OSS コンソールで実行できるのと同じオブジェクトレベルの操作を実行できます。 ossbrowser の画面上の指示に従って、署名付き URL を取得できます。 ossbrowser のダウンロード方法については、「ossbrowser 1.0」をご参照ください。

   1. カスタムドメイン名を使用して ossbrowser にログインします。

   1. オブジェクトの URL を取得します。

   OSS SDK を使用する

   カスタムドメイン名を使用して、OssClient インスタンスを作成し、署名付き URL を生成できます。

   Java

   import com.aliyun.oss.*;
   import com.aliyun.oss.common.auth.*;
   import com.aliyun.oss.common.comm.SignVersion;
   import com.aliyun.oss.model.GeneratePresignedUrlRequest;
   
   import java.net.URL;
   import java.util.Date;
   
   public class Demo {
       public static void main(String[] args) throws Throwable {
           // カスタムドメイン名を指定します。例: https://static.example.com。
           String endpoint = "yourCustomEndpoint";
           // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
           String region = "cn-hangzhou";
           // バケットの名前を指定します。例: examplebucket。
           String bucketName = "examplebucket";
           // オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: exampledir/exampleobject.txt。
           String objectName = "exampleobject.txt";
   
           // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、環境変数を構成する必要があります。
           EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
   
           // OSSClient インスタンスを作成します。
           // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
           ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
           // CNAME を有効にするには、このパラメーターを true に設定します。
           clientBuilderConfiguration.setSupportCname(true);
           // V4 署名アルゴリズムの使用を明示的に宣言します。
           clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
           OSS ossClient = OSSClientBuilder.create()
                   .endpoint(endpoint)
                   .credentialsProvider(credentialsProvider)
                   .clientConfiguration(clientBuilderConfiguration)
                   .region(region)
                   .build();
   
           try {
               // 署名付き URL の有効期間を指定します。単位: ミリ秒。この例では、有効期間は 1 時間に設定されています。
               Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
   
               // 署名付き URL を生成します。
               GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
   
               // URL の有効期間を設定します。
               request.setExpiration(expiration);
   
               // HTTP GET リクエストを許可する署名付き URL を生成します。
               URL signedUrl = ossClient.generatePresignedUrl(request);
               // 署名付き URL を表示します。
               System.out.println("signed url for getObject: " + signedUrl);
           } catch (OSSException oe) {
               System.out.println("Caught an OSSException, which means your request made it to OSS, "
                       + "but was rejected with an error response for some reason.");
               System.out.println("Error Message:" + oe.getErrorMessage());
               System.out.println("Error Code:" + oe.getErrorCode());
               System.out.println("Request ID:" + oe.getRequestId());
               System.out.println("Host ID:" + oe.getHostId());
           } catch (ClientException ce) {
               System.out.println("Caught an ClientException, which means the client encountered "
                       + "a serious internal problem while trying to communicate with OSS, "
                       + "such as not being able to access the network.");
               System.out.println("Error Message:" + ce.getMessage());
           } finally {
               if (ossClient != null) {
                   ossClient.shutdown();
               }
           }
       }
   }

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   
   # 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
   auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
   
   # エンドポイントにマッピングされるリージョンの ID を指定します。例: cn-hangzhou。署名アルゴリズム V4 を使用する場合は、このパラメーターが必要です。
   region = "cn-hangzhou"
   
   # カスタムドメイン名を指定します。例: static.example.com。
   endpoint = 'http://static.example.com'
   
   # バケットの名前を指定します。
   bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region, is_cname=True)
   
   
   # オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: exampledir/exampleobject.txt。
   object_name = 'exampledir/exampleobject.txt'
   
   # オブジェクトのダウンロードに使用される署名付き URL を生成します。この例では、URL の有効期間は 600 秒です。
   # デフォルトでは、OSS は署名プロセスでオブジェクトの完全なパスにあるスラッシュ (/) をエスケープ文字として識別します。したがって、署名付き URL は直接使用できません。
   # slash_safe パラメーターを True に設定します。このようにして、OSS はオブジェクトの完全なパスにあるスラッシュ (/) をエスケープ文字として識別せず、署名付き URL を直接使用できます。
   url = bucket.sign_url('GET', object_name, 600, slash_safe=True, params=params)
   print('Presigned URL:', url)

   Node.js

   const OSS = require("ali-oss");
   
   // 署名付き URL を生成するために使用される関数を指定します。
   async function generateSignatureUrl(fileName) {
     // 署名付き URL を取得します。
     const client = await new OSS({
         // バケットにマッピングするカスタムドメイン名を指定します。
         endpoint: 'http://static.example.com', 
         // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
         accessKeyId: process.env.OSS_ACCESS_KEY_ID,
         accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
         bucket: 'examplebucket',
         // バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
         region: 'oss-cn-hangzhou',
         authorizationV4: true,
         cname: true
     });
   
     return await client.signatureUrlV4('GET', 3600, {
         headers: {} // 実際のリクエストヘッダーに基づいてリクエストヘッダーを指定します。
     }, fileName);
   }
   // 関数を呼び出し、オブジェクトの名前を渡します。
   generateSignatureUrl('yourFileName').then(url => {
     console.log('Generated Signature URL:', url);
   }).catch(err => {
     console.error('Error generating signature URL:', err);
   });

   PHP

   <?php
   if (is_file(__DIR__ . '/../autoload.php')) {
       require_once __DIR__ . '/../autoload.php';
   }
   if (is_file(__DIR__ . '/../vendor/autoload.php')) {
       require_once __DIR__ . '/../vendor/autoload.php';
   }
   
   use OSS\OssClient;
   use OSS\Core\OssException;
   use OSS\Http\RequestCore;
   use OSS\Http\ResponseCore;
   use OSS\Credentials\EnvironmentVariableCredentialsProvider;
   
   // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
   $provider = new EnvironmentVariableCredentialsProvider();
   // yourEndpoint を、バケットが配置されているリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを http://static.example.com に設定します。
   $endpoint = "http://static.example.com";
   // バケット名を指定します。
   $bucket= "examplebucket";
   // バケット名を除くオブジェクトの完全なパスを指定します。
   $object = "exampleobject.txt";
   // 署名付き URL の有効期間を 600 秒 (最大 32400 秒) に設定します。
   $timeout = 600;
   try {
       $config = array(  
           "provider" => $provider,
           "endpoint" => $endpoint,
           'signatureVersion'=>OssClient::OSS_SIGNATURE_VERSION_V4,
           "cname"	=> true,
           "region"=> "cn-hangzhou"
       );
       $ossClient = new OssClient($config);
       // 署名付き URL を生成します。
       $signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET");
       print_r($signedUrl);
   } catch (OssException $e) {
       printf(__FUNCTION__ . ": FAILED\n");
       printf($e->getMessage() . "\n");
       return;
   }

   Go

   package main
   
   import (
   	"context"
   	"flag"
   	"log"
   	"time"
   
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
   )
   
   // グローバル変数を指定します。
   var (
   	region     string // バケットが配置されているリージョン。
   	bucketName string // バケットの名前。
   	objectName string // オブジェクトの名前。
   )
   
   // コマンドラインパラメーターを初期化するために使用される init 関数を指定します。
   func init() {
   	flag.StringVar(&region, "region", "", "バケットが配置されているリージョン。")
   	flag.StringVar(&bucketName, "bucket", "", "バケットの名前。")
   	flag.StringVar(&objectName, "object", "", "オブジェクトの名前。")
   }
   
   func main() {
   	// コマンドラインパラメーターを解析します。
   	flag.Parse()
   
   	// バケットの名前が指定されているかどうかを確認します。
   	if len(bucketName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメーター、バケット名が必要です")
   	}
   
   	// リージョンが指定されているかどうかを確認します。
   	if len(region) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメーター、リージョンが必要です")
   	}
   
   	// オブジェクトが指定されているかどうかを確認します。
   	if len(objectName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメーター、オブジェクト名が必要です")
   	}
   
   	// デフォルトの構成を読み込み、認証情報プロバイダーとリージョンを指定します。
   	cfg := oss.LoadDefaultConfig().
   		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
   		WithRegion(region).
   		WithEndpoint("http://static.example.com").
   		WithUseCName(true)
   
   	// OSS クライアントを作成します。
   	client := oss.NewClient(cfg)
   
   	// GetObject リクエストの署名付き URL を生成します。
   	result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
   		Bucket: oss.Ptr(bucketName),
   		Key:    oss.Ptr(objectName),
   		//RequestPayer: oss.Ptr("requester"), // リクエスターの ID を指定します。
   	},
   		oss.PresignExpires(10*time.Minute),
   	)
   	if err != nil {
   		log.Fatalf("オブジェクトの署名付き URL の取得に失敗しました %v", err)
   	}
   
   	log.Printf("リクエストメソッド:%v\n", result.Method)
   	log.Printf("リクエストの有効期限:%v\n", result.Expiration)
   	log.Printf("リクエスト URL:%v\n", result.URL)
   	if len(result.SignedHeaders) > 0 {
   		// HTTP GET リクエストを許可する署名付き URL を生成するときにリクエストヘッダーを指定する場合は、署名付き URL を使用して開始された GET リクエストにリクエストヘッダーが含まれていることを確認してください。これにより、リクエストの失敗と署名エラーを防ぎます。
   		log.Printf("署名付きヘッダー:\n")
   		for k, v := range result.SignedHeaders {
   			log.Printf("%v: %v\n", k, v)
   		}
   	}
   }

   ossutil を使用する

   presign (署名付き URL を生成する) コマンドを実行して、カスタムドメイン名を使用してオブジェクトの署名付き URL を生成します。

   ossutil presign oss://examplebucket/exampleobject.txt --endpoint "http://static.example.com” --addressing-style "cname"

   ossutil コマンドがカスタムドメイン名を毎回手動で指定する代わりに自動的に使用できるようにするには、構成ファイル にカスタムドメイン名を追加します。

2. ブラウザで署名付き URL にアクセスします。