Buat AWS API permintaan yang ditandatangani

• HTTPMethod — HTTP Metode, sepertiGET,, PUTHEAD, danDELETE.

• CanonicalUri — Versi URI -encoded dari komponen jalur absolutURI, dimulai dengan / yang mengikuti nama domain dan hingga akhir string atau ke karakter tanda tanya (?) jika Anda memiliki parameter string kueri. Jika jalur absolut kosong, gunakan karakter garis miring maju (/). URIDalam contoh berikut,/amzn-s3-demo-bucket/myphoto.jpg, adalah jalur absolut dan Anda tidak menyandikan / di jalur absolut:

  http://s3.amazonaws.com/amzn-s3-demo-bucket/myphoto.jpg

• CanonicalQueryString — Parameter string URI kueri yang dikodekan. Anda URI -encode setiap nama dan nilai satu per satu. Anda juga harus mengurutkan parameter dalam string kueri kanonik menurut abjad dengan nama kunci. Penyortiran terjadi setelah pengkodean. String query dalam URI contoh berikut adalah:

  http://s3.amazonaws.com/amzn-s3-demo-bucket?prefix=somePrefix&marker=someMarker&max-keys=2

  String kueri kanonik adalah sebagai berikut (jeda baris ditambahkan ke contoh ini untuk keterbacaan):

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

  Ketika permintaan menargetkan subresource, nilai parameter query yang sesuai akan menjadi string kosong (""). Misalnya, berikut ini URI mengidentifikasi ACL subresource pada bucket: amzn-s3-demo-bucket

  http://s3.amazonaws.com/amzn-s3-demo-bucket?acl

  Dalam hal ini, CanonicalQueryString akan menjadi:

  UriEncode("acl") + "=" + ""

  Jika URI tidak menyertakan a?, tidak ada string kueri dalam permintaan, dan Anda mengatur string kueri kanonik ke string kosong ()"". Anda masih perlu menyertakan karakter baris baru ("\n").

• CanonicalHeaders — Daftar header permintaan dengan nilainya. Nama header individu dan pasangan nilai dipisahkan oleh karakter baris baru ("\n"). Berikut ini adalah contoh dari CanonicalHeader:

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

  CanonicalHeaders daftar harus mencakup yang berikut:

  • HTTPhostsundulan.

  • Jika Content-Type header ada dalam permintaan, Anda harus menambahkannya ke CanonicalHeaders daftar.

  • Setiap x-amz-* header yang Anda rencanakan untuk disertakan dalam permintaan Anda juga harus ditambahkan. Misalnya, jika Anda menggunakan kredensyal keamanan sementara, Anda harus memasukkan x-amz-security-token dalam permintaan Anda. Anda harus menambahkan header ini dalam daftar CanonicalHeaders.

  catatan

  x-amz-content-sha256Header diperlukan untuk permintaan Amazon S3 AWS . Ini menyediakan hash dari payload permintaan. Jika tidak ada payload, Anda harus memberikan hash dari string kosong.

  Setiap nama header harus:

  • gunakan karakter huruf kecil.

  • muncul dalam urutan abjad.

  • diikuti oleh titik dua (:).

  Untuk nilai, Anda harus:

  • potong ruang depan atau belakang.

  • mengubah ruang berurutan menjadi satu ruang.

  • pisahkan nilai untuk header multi-nilai menggunakan koma.

  • Anda harus menyertakan header host (HTTP/1.1) atau:authority header (HTTP/2), dan x-amz-* header apa pun dalam tanda tangan. Anda dapat secara opsional menyertakan header standar lainnya dalam tanda tangan, seperti tipe konten.

  Trim()Fungsi Lowercase() dan yang digunakan dalam contoh ini dijelaskan di bagian sebelumnya.

  Berikut ini adalah contoh CanonicalHeaders string. Nama header dalam huruf kecil dan diurutkan.

  host:s3.amazonaws.com
  x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  x-amz-date:20130708T220855Z

  catatan

  Untuk tujuan menghitung tanda tangan otorisasi, hanya host dan x-amz-* header apa pun yang diperlukan; Namun, untuk mencegah gangguan data, Anda harus mempertimbangkan untuk memasukkan semua header dalam perhitungan tanda tangan.

• SignedHeaders — Daftar nama header permintaan huruf kecil yang diurutkan berdasarkan abjad dan dipisahkan titik koma. Header permintaan dalam daftar adalah header yang sama yang Anda sertakan dalam string. CanonicalHeaders Untuk contoh sebelumnya, nilai SignedHeaders akan menjadi sebagai berikut:

  host;x-amz-content-sha256;x-amz-date

• HashedPayload — String yang dibuat menggunakan payload di badan HTTP permintaan sebagai input ke fungsi hash. String ini menggunakan karakter heksadesimal huruf kecil.

  Hex(SHA256Hash(<payload>>))

  Jika tidak ada payload dalam permintaan, Anda menghitung hash dari string kosong, seperti ketika Anda mengambil objek dengan menggunakan GET permintaan, tidak ada apa-apa dalam payload.

  Hex(SHA256Hash(""))

  catatan

  Untuk Amazon S3, sertakan string literal UNSIGNED-PAYLOAD saat membuat permintaan kanonik, dan tetapkan nilai yang sama dengan nilai x-amz-content-sha256 header saat mengirim permintaan.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm — Algoritma yang digunakan untuk membuat hash dari permintaan kanonik. Untuk SHA -256, algoritmanya adalahAWS4-HMAC-SHA256.

• RequestDateTime — Tanggal dan waktu yang digunakan dalam lingkup kredensi. Nilai ini adalah UTC waktu saat ini dalam format ISO 8601 (misalnya,20130524T000000Z).

• CredentialScope — Cakupan kredensi, yang membatasi tanda tangan yang dihasilkan ke Wilayah dan layanan yang ditentukan. String memiliki format berikut: YYYYMMDD/region/service/aws4_permintaan.

• HashedCanonicalRequest — Hash dari permintaan kanonik, dihitung pada langkah sebelumnya.

Input yang dibutuhkan

• Key, string yang berisi kunci akses rahasia Anda.

• Date, string yang berisi tanggal yang digunakan dalam lingkup kredensi, dalam format YYYYMMDD.

• Region, string yang berisi kode Wilayah (misalnya,us-east-1).

  Untuk daftar string Region, lihat Titik Akhir Regional di. Referensi Umum AWS

• Service, string yang berisi kode layanan (misalnya,ec2).

• String untuk menandatangani bahwa Anda membuat pada langkah sebelumnya.