Object Storage Service:Tanda tangan POST V1

Kapan tanda tangan POST V1 diperlukan

Permintaan HTTP POST ke OSS mendukung algoritma signature V1, yang dalam topik ini disebut sebagai penandatanganan POST V1. Sebelum menghitung tanda tangan POST V1, tinjau kondisi dan dependensi berikut:

• Bucket ACL — Permintaan PostObject harus menyertakan signature jika ACL bucket tujuan adalah public-read atau private.

• Field formulir — Sediakan field formulir OSSAccessKeyId, Signature, dan policy sebagai satu kelompok. Jika salah satu dari ketiga field tersebut ada dalam formulir, dua field lainnya juga wajib disertakan. Untuk deskripsi tiap field, lihat Form fields.

• Lokasi perhitungan signature — Server aplikasi menghitung signature dan mengirimkannya bersama kebijakan unggah ke klien. Klien menggunakan informasi ini untuk menyusun permintaan PostObject.

• Kredensial — Signature dihitung dari AccessKey secret. Field formulir OSSAccessKeyId membawa ID AccessKey dari Pasangan Kunci Akses yang sama.

Menghitung tanda tangan POST V1

Hitung tanda tangan POST V1 pada server aplikasi Anda dalam tiga langkah berikut:

1. Buat kebijakan (policy). Buat policy dengan encoding UTF-8. Untuk sintaksis policy dan kondisi yang dapat Anda deklarasikan, lihat Policy structure.

2. Buat string yang akan ditandatangani (StringToSign). Encode policy dalam Base64. String hasilnya merupakan string yang akan ditandatangani (StringToSign).

3. Hitung signature. Gunakan AccessKey secret untuk menandatangani string yang akan ditandatangani. Rumus penandatanganan adalah Signature = base64(hmac-sha1(AccessKeySecret,base64(policy))).

Gambar berikut menunjukkan proses perhitungan tanda tangan POST V1.

Contoh: menghitung tanda tangan POST V1 dalam Java

Contoh Java berikut menjalankan tiga langkah penandatanganan POST V1 terhadap contoh policy yang dijelaskan dalam Policy structure. Langkah 3 memanggil OSS Java SDK, yang menerapkan rumus base64(hmac-sha1(AccessKeySecret,base64(policy))) pada string yang akan ditandatangani.

import org.apache.commons.codec.binary.Base64;

public class Demo {
    public static void main(String[] args) {
        // Sebelum menjalankan contoh kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_SECRET telah disetel.
        String accessKeySecret =  System.getenv().get("OSS_ACCESS_KEY_SECRET");

        // Langkah 1: Buat policy.
        String policy = "{\n" +
                "  \"expiration\": \"2023-12-03T13:00:00.000Z\",\n" +
                "  \"conditions\": [\n" +
                "    {\"bucket\": \"examplebucket\"},\n" +
                "    [\"content-length-range\", 1, 10],\n" +
                "    [\"eq\", \"$success_action_status\", \"201\"],\n" +
                "    [\"starts-with\", \"$key\", \"user/eric/\"],\n" +
                "    [\"in\", \"$content-type\", [\"image/jpeg\", \"image/png\"]],\n" +
                "    [\"not-in\", \"$cache-control\", [\"no-cache\"]]\n" +
                "  ]\n" +
                "}";

        // Langkah 2: Buat string yang akan ditandatangani (StringToSign).
        String stringToSign = new String(Base64.encodeBase64(policy.getBytes()));

        // Langkah 3: Hitung signature.
        String signature = com.aliyun.oss.common.auth.ServiceSignature.create().computeSignature(accessKeySecret, stringToSign);
        System.out.println("signature:" + signature);
    }
}

Signature dicetak dalam format berikut. Nilai yang dicetak merupakan string yang diencode Base64, yang bergantung pada AccessKey secret Anda dan byte eksak dari policy Anda, sehingga output Anda akan berbeda dari contoh berikut.

signature:****

Kirimkan nilai yang dihitung dalam field formulir Signature pada permintaan PostObject, bersama dengan field formulir OSSAccessKeyId dan policy.

Field formulir

Elemen formulir berikut khusus untuk penandatanganan POST V1. Untuk elemen formulir umum lainnya, lihat PostObject form elements. Untuk kondisi yang mewajibkan penggunaan field ini, lihat Kapan tanda tangan POST V1 diperlukan.

Struktur policy

Field formulir policy adalah kebijakan keamanan yang mendefinisikan izin dan batasan untuk mengunggah objek ke OSS melalui formulir HTML. Policy didefinisikan dalam format JSON dan membatasi operasi unggah melalui beberapa parameter, seperti nama bucket yang diizinkan, awalan objek, waktu kedaluwarsa, metode HTTP yang diizinkan, batas ukuran konten, dan pembatasan tipe konten.

Policy harus mencakup field expiration dan conditions, seperti yang ditunjukkan pada contoh berikut.

{
  "expiration": "2023-12-03T13:00:00.000Z",
  "conditions": [
    {"bucket": "examplebucket"},
    ["content-length-range", 1, 10],
    ["eq", "$success_action_status", "201"],
    ["starts-with", "$key", "user/eric/"],
    ["in", "$content-type", ["image/jpeg", "image/png"]],
    ["not-in", "$cache-control", ["no-cache"]]
  ]
}

Policy berisi elemen-elemen berikut:

• expiration — Menentukan waktu kedaluwarsa policy dalam format ISO 8601 GMT. Misalnya, 2023-12-03T13:00:00.000Z berarti permintaan POST harus diajukan sebelum pukul 13.00 GMT pada 3 Desember 2023.

• conditions — Menentukan nilai yang valid untuk field formulir dalam permintaan POST.

Tabel berikut menjelaskan field yang dapat Anda deklarasikan dalam conditions.