Function Compute:Konfigurasi Autentikasi JWT untuk Pemicu HTTP

1. Masuk ke Konsol Function Compute. Di panel navigasi sebelah 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 tombol Edit di kolom Actions untuk Pemicu HTTP.

5. Pada panel Edit Trigger, konfigurasikan item berikut, lalu klik OK.

   1. Atur Authentication Method menjadi JWT Authentication.

      

   2. Konfigurasi JWKS.

      Untuk mengonfigurasi autentikasi JWT pada Pemicu HTTP, Anda harus menyediakan JSON Web Key Set (JWKS) yang valid. Anda dapat membuat JWKS sendiri, atau mencari JSON Web Key Generator untuk menemukan tool online, seperti mkjwk.org. Jika Anda memiliki kunci dalam format PEM, gunakan tool seperti jwx untuk mengonversinya ke format JWKS.

      Dokumen ini menunjukkan contoh pembuatan JWKS menggunakan mkjwk.org. Seperti ditunjukkan pada gambar berikut, pada antarmuka pembuatan, atur Key Use menjadi Signature, Algorithm menjadi RS256, dan Show X.509 menjadi Yes. Lalu, klik Generate. Gunakan Private Key (① pada gambar) dalam kode Anda untuk menerbitkan Token JWT. Simpan dengan aman. Salin isi Public Key (② pada gambar) ke dalam array keys pada konfigurasi JWKS di konsol.

      

      

      Contoh berikut menunjukkan JWKS yang dikonfigurasi dalam dokumen ini.

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

   3. Pada JWT Token Configuration, pilih lokasi Token dan nama Token.

      Lokasi Token mendukung Header, Cookie, parameter Query (GET), dan parameter form (POST). Jika Anda memilih Header sebagai lokasi Token, tentukan Parameter Name dan Prefix to Remove. Function Compute akan menghapus konten awalan yang ditetapkan di Prefix to Remove saat mengambil Token.

      Penting

      Saat mengatur Prefix to Remove, periksa apakah terdapat spasi setelah awalan tersebut. Tambahkan spasi setelah bidang awalan, misalnya Bearer .

   4. Pada konfigurasi JWT Claim Transformation, pilih lokasi parameter, nama parameter asli, dan nama parameter setelah diteruskan ke fungsi.

      Lokasi parameter yang dipetakan mendukung Header, Cookie, dan parameter form (POST).

   5. Atur mode pencocokan permintaan.

      • Match All: Semua permintaan HTTP memerlukan validasi JWT.

      • Whitelist Mode: Permintaan HTTP dengan path yang ditetapkan dalam Request Path Whitelist tidak memerlukan validasi JWT. Permintaan lainnya memerlukan validasi JWT.

      • Blacklist Mode: Permintaan HTTP dengan path yang ditetapkan dalam Request Path Blacklist memerlukan validasi JWT. Permintaan lainnya tidak memerlukan validasi JWT.

      Whitelist Mode dan Blacklist Mode mendukung dua mode pencocokan berikut.

      • Pencocokan eksak

        Path permintaan harus persis sama dengan path yang dikonfigurasi. Misalnya, jika Anda menetapkan Request Path Blacklist ke /a, permintaan dari path /a memerlukan validasi JWT. Permintaan dari path /a/ tidak memerlukan validasi.

      • Pencocokan fuzzy

        Gunakan karakter wildcard (*) untuk menetapkan path. Karakter wildcard (*) hanya boleh muncul di akhir path. Misalnya, jika Anda menetapkan Request Path Blacklist ke /login/*, permintaan dengan awalan path /login/ (seperti /login/a atau /login/b/c/d) memerlukan validasi JWT.

Menggunakan tool debugging seperti Postman, masukkan endpoint akses dan Token sesuai konfigurasi JWT Pemicu HTTP. Verifikasi bahwa Anda dapat mengakses layanan HTTP tersebut.

1. Gunakan Private Key berformat X.509 PEM yang dihasilkan pada Langkah 1 sebagai kunci privat untuk menerbitkan Token JWT. Langkah-langkah berikut menunjukkan cara menghasilkan Token menggunakan skrip Python lokal.

   1. Instal modul PyJWT.

      pip install 'PyJWT>=2.0'

   2. Jalankan skrip contoh Python berikut secara lokal untuk menghasilkan Token JWT.

      import jwt
      import time
      
      private_key = """
      -----BEGIN PRIVATE KEY-----
      <Use the X.509 PEM-formatted private key generated in Step 1>
      -----END PRIVATE KEY-----
      """
      
      headers = {
          "alg": "RS256",
          "typ": "JWT"
      }
      
      payload = {
          "sub": "1234567890",
          "name": "John Snow",
          "iat": int(time.time()),   # Waktu penerbitan token
          "exp": int(time.time()) + 60 * 60,   # Atur masa berlaku token menjadi 1 jam
      }
      
      
      encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
      print("Generated token: %s" % encoded)
      

2. Gunakan Postman untuk memverifikasi bahwa layanan HTTP dapat diakses.

   1. Pada tab Trigger Management (URL) fungsi target, ambil endpoint akses jaringan publik Pemicu HTTP dan masukkan ke dalam bidang URL di Postman.

   2. Pada Headers Postman, konfigurasikan informasi parameter Token, lalu klik Send untuk mengirim permintaan. Contoh berikut menunjukkan Token yang diisi dalam dokumen ini.

      Name	Example Value	Description
      Key	Authentication	Nama parameter yang ditetapkan di JWT Token Configuration.
      Value	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLQ	Di JWT Token Configuration, Anda dapat mengonfigurasi sistem untuk menghapus awalan saat membangun token JWT. Misalnya, asumsikan awalan yang dihapus diatur ke Bearer .

      Penting

      Perhatikan bahwa awalan dan spasi parameter JWT dalam header permintaan harus sesuai dengan konten Prefix to Remove yang ditetapkan di JWT Token Configuration. Jika tidak, pemicu gagal mengurai Token dan mengembalikan error "invalid or expired jwt".