Otentikasi Permintaan: Menggunakan Parameter Kueri (AWS Versi Tanda Tangan 4)

Seperti dijelaskan dalam ikhtisar otentikasi (lihatMetode Autentikasi), Anda dapat memberikan informasi otentikasi menggunakan parameter string kueri. Menggunakan parameter kueri untuk mengotentikasi permintaan berguna ketika Anda ingin mengungkapkan permintaan sepenuhnya dalam URL. Metode ini juga disebut sebagai penandatanganan URL.

Skenario kasus penggunaan untuk URL yang ditandatangani sebelumnya adalah Anda dapat memberikan akses sementara ke sumber daya Amazon S3 Anda. Misalnya, Anda dapat menyematkan URL yang telah ditandatangani sebelumnya di situs web Anda atau menggunakannya di klien baris perintah (seperti Curl) untuk mengunduh objek.

Berikut ini adalah contoh URL yang ditandatangani sebelumnya.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<your-access-key-id>/20130721/us-east-1/s3/aws4_request
&X-Amz-Date=20130721T201207Z
&X-Amz-Expires=86400
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>  

Dalam contoh URL, perhatikan hal berikut:

Tabel berikut menjelaskan parameter kueri di URL yang menyediakan informasi otentikasi.

<your-access-key-id>/<date>/<Wilayah AWS>/<AWS-service>/aws4_request

AKIAIOSFODNN7EXAMPLE/20130721/us-east-1/s3/aws4_request

Menghitung Tanda Tangan

Diagram berikut menggambarkan proses perhitungan tanda tangan.

Tabel berikut menjelaskan fungsi yang ditunjukkan dalam diagram. Anda perlu menerapkan kode untuk fungsi-fungsi ini.

public static String UriEncode(CharSequence input, boolean encodeSlash) {
          StringBuilder result = new StringBuilder();
          for (int i = 0; i < input.length(); i++) {
              char ch = input.charAt(i);
              if ((ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z') || (ch >= '0' && ch <= '9') || ch == '_' || ch == '-' || ch == '~' || ch == '.') {
                  result.append(ch);
              } else if (ch == '/') {
                  result.append(encodeSlash ? "%2F" : ch);
              } else {
                  result.append(toHexUTF8(ch));
              }
          }
          return result.toString();
      }

Untuk informasi selengkapnya tentang proses penandatanganan (detail pembuatan permintaan kanonik, string untuk ditandatangani, dan perhitungan tanda tangan), lihatPerhitungan Tanda Tangan untuk Header Otorisasi: Mentransfer Payload dalam Satu Potongan (AWS Versi Tanda Tangan 4). Prosesnya umumnya sama kecuali bahwa pembuatan CanonicalRequest dalam URL yang telah ditandatangani berbeda sebagai berikut:

Sebuah contoh

Misalkan Anda memiliki objek test.txt di examplebucket ember Anda. Anda ingin berbagi objek ini dengan orang lain untuk jangka waktu 24 jam (86400 detik) dengan membuat URL yang telah ditandatangani sebelumnya.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20130524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>

Langkah-langkah berikut menggambarkan terlebih dahulu perhitungan tanda tangan dan kemudian konstruksi URL yang telah ditandatangani sebelumnya. Contoh membuat asumsi tambahan berikut:

Anda dapat menggunakan contoh ini sebagai kasus uji untuk memverifikasi tanda tangan yang dihitung kode Anda; namun, Anda harus menggunakan nama bucket yang sama, kunci objek, stempel waktu, dan kredenSIAL contoh berikut:

Contoh 2

Berikut ini adalah contoh (tidak terkait dengan contoh sebelumnya) yang menunjukkan URL yang ditandatangani sebelumnya dengan X-Amz-Security-Token parameter.

https://examplebucket.s3.us-east-1.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20200524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEMv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCIBSUbVdj9YGs2g0HkHsOHFdkwOozjARSKHL987NhhOC8AiBPepRU1obMvIbGU0T%2BWphFPgK%2Fqpxaf5Snvm5M57XFkCqlAgjz%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDQ3MjM4NTU0NDY2MCIM83pULBe5%2F%2BNm1GZBKvkBVslSaJVgwSef7SsoZCJlfJ56weYl3QCwEGr2F4BmCZZyFpmWEYzWnhNK1AnHMj5nkfKlKBx30XAT5PZGVrmq4Vkn9ewlXQy1Iu3QJRi9Tdod8Ef9%2FyajTaUGh76%2BF5u5a4O115jwultOQiKomVwO318CO4l8lv%2F3HhMOkpdanMXn%2B4PY8lvM8RgnzSu90jOUpGXEOAo%2F6G8OqlMim3%2BZmaQmasn4VYRvESEd7O72QGZ3%2BvDnDVnss0lSYjlv8PP7IujnvhZRnj0WoeOyMe1lL0wTG%2Fa9usH5hE52w%2FYUJccOn0OaZuyROuVsRV4Q70sbWQhUvYUt%2B0tUMKzm8vsFOp4BaNZFqobbjtb36Y92v%2Bx5kY6i0s8QE886jJtUWMP5ldMziClGx3p0mN5dzsYlM3GyiJ%2FO1mWkPQDwg3mtSpOA9oeeuAMPTA7qMqy9RNuTKBDSx9EW27wvPzBum3SJhEfxv48euadKgrIX3Z79ruQFSQOc9LUrDjR%2B4SoWAJqK%2BGX8Q3vPSjsLxhqhEMWd6U4TXcM7ku3gxMbzqfT8NDg%3D
&X-Amz-Signature=<signature-value>