Object Storage Service:V4 署名を Authorization ヘッダーに含める (推奨)

パラメーター

説明

HTTP Verb

HTTP リクエストメソッド。PUT、GET、POST、HEAD、DELETE、OPTIONS など。

Canonical URI

URI エンコードされたリソースパス。リソースパスにはクエリ文字列は含まれず、スラッシュ (/) のエンコードは不要です。

• リクエストターゲットが OSS の場合、リソースパスは / で、URI エンコードされたリソースパスは UriEncode("/") です。

• リクエストターゲットがバケットの場合、リソースパスは /examplebucket/ で、URI エンコードされたリソースパスは UriEncode("/examplebucket/") です。

• リクエストターゲットがバケット内のオブジェクトの場合、リソースパスは /examplebucket/exampleobject で、URI エンコードされたリソースパスは UriEncode("/examplebucket/exampleobject") です。

Canonical Query String

辞書式順序でソートされた、URI エンコードされたクエリパラメーター。

• クエリパラメーターにパラメーター名と値の両方が含まれている場合は、各パラメーターの名前と値を個別に URI エンコードし、エンコードされた名前基づいてパラメーターを辞書順にソートします。ソートはエンコード後に行われることに注意してください。エンコードされた名前と値を接続するには = を使用し、異なるパラメーターを連結するには & を使用します。

  • クエリパラメーター: prefix=somePrefix&marker=someMarker&max-keys=20

  • 正規化されたクエリパラメーター:

    UriEncode("marker")+"="+UriEncode("someMarker")+"&"+UriEncode("max-keys")+"="+UriEncode("20")+"&"+UriEncode("prefix")+"="+UriEncode("somePrefix")

• クエリパラメーターにパラメーター名のみが含まれている場合は、パラメーター名に対して URI エンコードを実行します。

  • クエリパラメーター: ?acl

  • 正規化されたクエリパラメーター: UriEncode("acl")

• クエリパラメーターがない場合、つまり、リクエスト URI に ? が含まれていない場合、正規化されたクエリ文字列は空の文字列 ("") に設定されます。

Canonical Headers

リクエストヘッダーのリスト。

リクエストヘッダーは、次の 3 つのカテゴリに分類されます。

• リクエストに存在し、署名計算に含まれる必要があるヘッダー:

  • x-oss-content-sha256: UNSIGNED-PAYLOAD のみがサポートされています。

• リクエストに存在する場合、署名計算に含める必要があるヘッダー:

  • Content-Type

  • Content-MD5

  • x-oss-*: x-oss- で始まるその他のリクエストヘッダー。たとえば、STS AK 経由でアクセスする場合、SecurityToken は x-oss-security-token:security-token を介して記述されます。たとえば、リクエスト時間は x-oss-date を介して記述され、構文は 20231203T121212Z などの ISO8601 標準時間形式である必要があります。

• AdditionalHeaders で指定されたオプションのリクエストヘッダー。

構文は次のとおりです。

Lowercase(<HeaderName1>) + ":" + Trim(<value>) + "\n"
Lowercase(<HeaderName2>) + ":" + Trim(<value>) + "\n"
...
Lowercase(<HeaderNameN>) + ":" + Trim(<value>) + "\n"

次のサンプル コードは例を示しています。

content-disposition:attachment
content-length:3
content-md5:ICy5YqxZB1uWSwcVLSNLcA==
content-type:text/plain
x-oss-content-sha256:UNSIGNED-PAYLOAD
x-oss-date:20250328T101048Z

Additional Headers

署名計算に含まれるオプションのリクエストヘッダーを指定します (署名計算に含める必要がある必須ヘッダーを指定する必要はありません)。このフィールドには、小文字のヘッダー名のみが含まれ、辞書順にソートされ、セミコロン (;) で区切られます。 AdditionalHeaders と一致します。

署名計算に含まれるオプションのヘッダー (必須ヘッダーを除く) を指定します。小文字のヘッダー名のみが含まれ、辞書順にソートされます。セミコロン (;) で区切られ、 AdditionalHeaders と一致します。

次のサンプル コードは例を示しています。

content-disposition;content-length

Hashed PayLoad

リクエストペイロードの SHA256 ハッシュ値の 16 進数表現。UNSIGNED-PAYLOAD の値のみがサポートされています。

パラメーター

説明

OSS4-HMAC-SHA256

署名のハッシュアルゴリズム。値は OSS4-HMAC-SHA256 である必要があります。

TimeStamp

現在の UTC 時刻。構文は 20250320T083322Z などの ISO8601 である必要があります。

Scope

派生キーを取得/検索するためのパラメーターセット。このパラメーターセットは、日付、リージョン、サービスを指定します。したがって、派生キーを使用して計算された署名は、指定された日付、リージョン、サービスに対してのみ有効です。

構文は次のとおりです。

<SignDate>/<SignRegion>/oss/aliyun_v4_request

各項目の説明は次のとおりです。

• SignDate: 署名に含まれる YYYYMMDD 形式の日付。

• SignRegion: 署名に使用される リージョン ID。 cn-hangzhou など。

• oss: 署名に含まれるサービス名。 oss として固定。

• aliyun_v4_request: 署名に含まれるバージョン。 aliyun_v4_request として固定。

CanonicalRequest

構築された正規化リクエスト。

パラメーター

値

AccessKeyId

LTAI****************

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

cn-hangzhou