Object Storage Service：Sertakan signature V4 di header (direkomendasikan)

Parameter

Deskripsi

HTTP Verb

Metode permintaan HTTP, seperti PUT, GET, POST, HEAD, DELETE, dan OPTIONS.

Canonical URI

Jalur resource yang telah di-encode URI. Jalur resource tidak mencakup query string. Jangan encode garis miring maju (/).

• Jika target permintaan adalah layanan OSS, jalur resourcenya adalah /, dan jalur resource yang di-encode URI adalah UriEncode("/").

• Jika target permintaan adalah bucket, jalur resourcenya adalah /examplebucket/, dan jalur resource yang di-encode URI adalah UriEncode("/examplebucket/").

• Jika target permintaan adalah objek dalam bucket, jalur resourcenya adalah /examplebucket/exampleobject, dan jalur resource yang di-encode URI adalah UriEncode("/examplebucket/exampleobject")

Canonical Query String

Parameter kueri yang telah di-encode URI, diurutkan secara leksikografis.

• Jika parameter kueri mencakup nama dan nilai, encode URI setiap nama dan nilai parameter secara terpisah. Lalu, urutkan parameter secara leksikografis berdasarkan nama yang telah di-encode. Perhatikan bahwa pengurutan dilakukan setelah encoding. Gunakan = untuk menghubungkan nama dan nilai yang telah di-encode. Gunakan & untuk menggabungkan parameter yang berbeda.

  • Parameter kueri: prefix=somePrefix&marker=someMarker&max-keys=20

  • Parameter kueri canonical:

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

• Jika parameter kueri hanya berisi nama, encode URI nama parameter tersebut.

  • Parameter kueri: ?acl

  • Parameter kueri canonical: UriEncode("acl")

• Jika tidak ada parameter kueri (URI permintaan tidak mengandung ?), atur canonical query string menjadi string kosong ("").

Canonical Headers

Daftar header permintaan.

Header permintaan terbagi menjadi tiga kategori:

• Header yang harus ada dalam permintaan dan ikut dalam perhitungan signature:

  • x-oss-content-sha256: Saat ini hanya UNSIGNED-PAYLOAD yang didukung.

• Header yang ikut dalam perhitungan signature jika ada dalam permintaan:

  • Content-Type

  • Content-MD5

  • x-oss-*: Header permintaan lain yang diawali dengan x-oss-. Misalnya, saat mengakses melalui AccessKey STS, SecurityToken ditentukan menggunakan x-oss-security-token:security-token. Sebagai contoh lain, waktu permintaan ditentukan menggunakan x-oss-date, dan formatnya harus sesuai standar waktu ISO 8601, seperti 20231203T121212Z.

• Header permintaan opsional yang ditentukan dalam AdditionalHeaders.

Formatnya sebagai berikut:

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

Contoh:

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

Tentukan header permintaan opsional untuk perhitungan signature (jangan tentukan header wajib). Sertakan hanya nama header dalam huruf kecil, diurutkan secara leksikografis, dan dipisahkan dengan titik koma (;). Nilai ini harus konsisten dengan AdditionalHeaders.

Contoh:

content-disposition;content-length

Hashed PayLoad

Representasi heksadesimal dari nilai hash SHA256 muatan permintaan. Saat ini hanya UNSIGNED-PAYLOAD yang didukung.

Parameter

Deskripsi

OSS4-HMAC-SHA256

Algoritma hash signature. Nilainya harus OSS4-HMAC-SHA256.

TimeStamp

Waktu UTC saat ini. Formatnya harus ISO8601, seperti 20250320T083322Z.

Scope

Kumpulan parameter untuk menurunkan kunci. Kumpulan ini menentukan tanggal, wilayah, dan layanan. Oleh karena itu, signature yang dihitung dengan kunci turunan hanya berlaku untuk tanggal, wilayah, dan layanan yang ditentukan.

Formatnya sebagai berikut:

<SignDate>/<SignRegion>/oss/aliyun_v4_request

Penjelasan:

• SignDate: Tanggal yang digunakan dalam signature, dalam format YYYYMMDD.

• SignRegion: ID wilayah yang digunakan untuk signature, seperti cn-hangzhou.

• oss: Nama layanan yang digunakan dalam signature, tetap sebagai oss.

• aliyun_v4_request: Versi yang digunakan dalam signature, tetap sebagai aliyun_v4_request.

CanonicalRequest

Canonical request yang telah dibuat.

Parameter

Nilai

AccessKeyId

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

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

cn-hangzhou