Object Storage Service：Sertakan tanda tangan V4 di header Authorization (disarankan)

Parameter

Deskripsi

HTTP Verb

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

Canonical URI

Path sumber daya yang di-enkode URI. Path sumber daya tidak termasuk string query, dan encoding untuk garis miring (/) tidak diperlukan.

• Jika target permintaan adalah OSS, path sumber daya adalah /, dan path sumber daya yang di-enkode URI adalah UriEncode("/").

• Jika target permintaan adalah bucket, path sumber daya adalah /examplebucket/, dan path sumber daya yang di-enkode URI adalah UriEncode("/examplebucket/").

• Jika target permintaan adalah objek dalam bucket, path sumber daya adalah /examplebucket/exampleobject, dan path sumber daya yang di-enkode URI adalah UriEncode("/examplebucket/exampleobject").

Canonical Query String

Parameter query yang di-URI-encode diurutkan secara leksikografis.

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

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

  • Parameter query kanonisasi:

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

• Jika parameter query hanya mencakup nama parameter, lakukan enkode URI pada nama parameter.

  • Parameter query: ?acl

  • Parameter query kanonisasi: UriEncode("acl")

• Jika tidak ada parameter query, yaitu URI permintaan tidak mengandung ?, string query kanonisasi diatur ke string kosong ("").

Canonical Headers

Daftar header permintaan.

Header permintaan dibagi menjadi tiga kategori:

• Header yang harus ada dalam permintaan dan termasuk dalam perhitungan tanda tangan:

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

• Header yang harus termasuk dalam perhitungan tanda tangan jika ada dalam permintaan:

  • Content-Type

  • Content-MD5

  • x-oss-*: Header permintaan lainnya yang dimulai dengan x-oss-. Misalnya, saat mengakses melalui STS AK, SecurityToken dijelaskan melalui x-oss-security-token:security-token. Misalnya, waktu permintaan dijelaskan melalui x-oss-date, dan sintaksisnya harus dalam format waktu ISO8601 standar, seperti 20231203T121212Z.

• Header permintaan opsional yang ditentukan dalam AdditionalHeaders.

Sintaksisnya adalah sebagai berikut:

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

Contoh kode sampel berikut memberikan 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 yang termasuk dalam perhitungan tanda tangan (Anda tidak perlu menentukan header yang wajib termasuk dalam perhitungan tanda tangan). Bidang ini hanya berisi nama header huruf kecil, diurutkan secara leksikografis dan dipisahkan dengan titik koma (;), konsisten dengan AdditionalHeaders.

Tentukan header opsional yang termasuk dalam perhitungan tanda tangan (tidak termasuk header wajib), hanya nama header huruf kecil yang disertakan dan diurutkan secara leksikografis. Mereka dipisahkan oleh titik koma (;) dan konsisten dengan AdditionalHeaders.

Contoh kode sampel berikut memberikan contoh:

content-disposition;content-length

Hashed PayLoad

Representasi heksadesimal dari nilai hash SHA256 payload permintaan. Hanya nilai UNSIGNED-PAYLOAD yang didukung.

Parameter

Deskripsi

OSS4-HMAC-SHA256

Algoritma hash dari tanda tangan, nilainya harus OSS4-HMAC-SHA256.

TimeStamp

Waktu UTC saat ini, sintaksisnya harus dalam format ISO8601, seperti 20250320T083322Z.

Scope

Set parameter untuk mendapatkan/mengambil kunci turunan. Set parameter ini menentukan tanggal, wilayah, dan layanan. Oleh karena itu, tanda tangan yang dihitung menggunakan kunci turunan hanya valid untuk tanggal, wilayah, dan layanan yang ditentukan.

Sintaksisnya adalah sebagai berikut:

<SignDate>/<SignRegion>/oss/aliyun_v4_request

Penjelasannya adalah sebagai berikut:

• SignDate: Tanggal dalam format YYYYMMDD yang termasuk dalam tanda tangan.

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

• oss: Nama layanan yang termasuk dalam tanda tangan, tetap sebagai oss.

• aliyun_v4_request: Versi yang termasuk dalam tanda tangan, tetap sebagai aliyun_v4_request.

CanonicalRequest

Permintaan kanonisasi yang telah dibuat.

Parameter

Nilai

AccessKeyId

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

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

cn-hangzhou