Function Compute：Konfigurasikan otentikasi JWT untuk pemicu HTTP

1. Masuk ke Konsol Function Compute. Di bilah navigasi sisi kiri, klik Services & Functions.

2. Di bilah navigasi atas, pilih wilayah. Pada halaman Services, klik layanan yang diinginkan.

3. Pada halaman Functions, klik nama fungsi yang diinginkan. Pada halaman Detail Fungsi yang muncul, klik tab Trigger Management (URL).

4. Pada tab Trigger Management (URL), klik Modify di kolom Actions pemicu HTTP.

5. Di panel Ubah Pemicu, konfigurasikan parameter berikut dan klik OK.

   1. Atur Authentication Method ke JWT Authentication.

      

   2. Konfigurasikan JWKS.

      Untuk mengonfigurasi otentikasi JWT untuk pemicu HTTP, Anda harus menyediakan JWKS yang valid. Anda dapat secara manual menghasilkan JWKS, atau cari dengan JSON Web Key generator di browser web untuk menggunakan generator online, seperti mkjwk.org. Jika Anda memiliki kunci dalam format Privacy Enhanced Mail (PEM), Anda dapat menggunakan alat seperti jwx untuk mengonversi kunci ke format JWKS.

      Dalam contoh ini, mkjwk.org digunakan untuk menghasilkan JWKS. Pada halaman untuk menghasilkan JWKS, atur Show X.509 ke Yes untuk melihat kunci privat. Anda perlu menggunakan kunci privat untuk menerbitkan JWT. Simpan kunci privat dengan aman. Anda dapat menyalin konten kunci publik ke array keys JWKS di Konsol Function Compute. Gambar berikut menunjukkan detailnya.

      

      Kode contoh:

      {
          "keys": [
              {
                  "alg": "RS256",
                  "e": "AQAB",
                  "kty": "RSA",
                  "n": "u1LWgoomekdOMfB1lEe96OHehd4XRNCbZRm96RqwOYTTc28Sc_U5wKV2umDzolfoI682ct2BNnRRahYgZPhbOCzHYM6i8sRXjz9Ghx3QHw9zrYACtArwQxrTFiejbfzDPGdPrMQg7T8wjtLtkSyDmCzeXpbIdwmxuLyt_ahLfHelr94kEksMDa42V4Fi5bMW4cCLjlEKzBEHGmFdT8UbLPCvpgsM84JK63e5ifdeI9NdadbC8ZMiR--dFCujT7AgRRyMzxgdn2l-nZJ2ZaYzbLUtAW5_U2kfRVkDNa8d1g__2V5zjU6nfLJ1S2MoXMgRgDPeHpEehZVu2kNaSFvDUQ",
                  "use": "sig"
              }
          ]
      }

   3. Di bagian JWT Token Configuration, pilih posisi dan nama token.

      Anda dapat mengatur parameter Posisi Baca token ke Header, Cookie, Parameter Query, atau Parameter Formulir. Jika Anda mengatur parameter Posisi Baca token ke Header, Anda harus menentukan parameter Parameter Name dan Remove Prefix. Saat Function Compute mendapatkan token, awalan yang ditentukan oleh parameter Remove Prefix dihapus.

      Penting

      Saat Anda mengonfigurasi parameter Remove Prefix, periksa apakah ada spasi setelah awalan. Kami merekomendasikan Anda menambahkan spasi setelah awalan yang ditentukan, misalnya, Bearer .

   4. Di bagian JWT Claim Conversion, pilih posisi untuk meneruskan parameter ke fungsi, nama asli parameter, dan nama baru parameter setelah parameter diteruskan ke fungsi.

      Anda dapat mengatur parameter Posisi Parameter Pemetaan ke Header, Cookie, Parameter Query, atau Parameter Formulir.

   5. Tentukan mode pencocokan permintaan.

      • Match All: Semua permintaan HTTP harus diverifikasi menggunakan JWT.

      • Whitelist Mode: Permintaan HTTP yang dikirim dari jalur yang ditentukan dalam Whitelist of Request Paths tidak diautentikasi menggunakan JWT. Permintaan lain diautentikasi menggunakan JWT.

      • Blacklist Mode: Permintaan HTTP yang dikirim dari jalur yang ditentukan dalam Blacklist of Request Paths diautentikasi menggunakan JWT. Permintaan lain tidak diautentikasi menggunakan JWT.

      Whitelist Mode dan Blacklist Mode mendukung mode pencocokan berikut:

      • Pencocokan tepat

        Jalur hanya cocok jika persis sama dengan jalur yang ditentukan. Misalnya, jika Anda mengatur Blacklist of Request Paths ke /a, otentikasi JWT diperlukan untuk permintaan yang dikirim dari /a. Otentikasi JWT tidak diperlukan untuk permintaan yang dikirim dari /a/.

      • Pencocokan kabur

        Anda dapat mengatur nilainya ke jalur yang diakhiri dengan asterisk (*) sebagai wildcard. Misalnya, jika Anda mengatur parameter Blacklist of Request Paths ke /login/*, otentikasi JWT diperlukan untuk permintaan yang dikirim dari jalur dengan awalan /login/, seperti /login/a dan /login/b/c/d.

Bagian ini menjelaskan cara memverifikasi apakah layanan HTTP dapat diakses sesuai harapan dengan menggunakan alat berdasarkan konfigurasi JWT pemicu HTTP Anda. Dalam bagian ini, Postman digunakan.

1. Gunakan kunci privat dalam format X.509 PEM yang dihasilkan di Langkah 1 sebagai kunci privat untuk menerbitkan JWT. Langkah-langkah berikut menggunakan Python sebagai contoh untuk menunjukkan proses menghasilkan token menggunakan skrip lokal.

   1. Instal modul PyJWT.

      pip install PyJWT

   2. Jalankan skrip Python berikut di mesin lokal Anda untuk menghasilkan JWT:

      import jwt
      import time
      
      private_key = """
      -----BEGIN PRIVATE KEY-----
      <Gunakan kunci privat dalam format X.509 PEM yang dihasilkan di Langkah 1>
      -----END PRIVATE KEY-----
      """
      
      headers = {
          "alg": "RS256",
          "typ": "JWT"
      }
      
      payload = {
          "sub": "1234567890",
          "name": "John Snow",
          "iat": int(time.time()),   # Waktu ketika token diterbitkan.
          "exp": int(time.time()) + 60 * 60,   # Atur periode validitas token menjadi 1 jam.
      }
      
      
      encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
      print("Token yang dihasilkan: %s" % encoded)
      

2. Gunakan Postman untuk memeriksa apakah layanan HTTP dapat diakses.

   1. Pada tab Trigger Management (URL) fungsi yang ingin Anda kelola, dapatkan titik akhir Internet pemicu HTTP. Lalu, masukkan titik akhir di bilah alamat Postman.

   2. Konfigurasikan parameter token di tab Headers di Postman dan klik Send untuk mengirim permintaan. Tabel berikut menjelaskan konfigurasi token.

      Nama	Contoh	Deskripsi
      Kunci	Authentication	Nama token yang Anda tentukan di bagian JWT Token Configuration.
      Nilai	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLg	Nilai JWT, yang berisi nilai parameter Hapus Awalan di JWT Token Configuration. Dalam contoh ini, parameter Hapus Awalan diatur ke Bearer .

      Penting

      Awalan dan spasi parameter JWT di header permintaan harus sama dengan parameter Remove Prefix di bagian JWT Token Configuration. Jika tidak, kesalahan terjadi saat pemicu mengurai token dan melaporkan kesalahan "jwt tidak valid atau kedaluwarsa".