Function Compute：Konfigurasikan otentikasi JWT untuk pemicu HTTP

Sebelum Anda mulai

Buat fungsi dan pemicu HTTP untuk fungsi tersebut. Untuk informasi lebih lanjut, lihat Buat Fungsi dan Langkah 1: Buat Pemicu.

Batasan

• Anda dapat menghasilkan dan mendistribusikan JWT sesuai kebutuhan bisnis Anda. Function Compute mengotentikasi JWT menggunakan JWKS publik yang dikonfigurasi untuk pemicu.

• JSON Web Key (JWK) yang tidak memiliki kid (ID kunci) didukung.

• Token dapat dibaca dari header, parameter query (metode GET), parameter formulir (metode POST), atau cookie.

• Anda dapat meneruskan klaim sebagai header, parameter query (metode GET), parameter formulir (metode POST), atau cookie ke fungsi.

• Anda dapat mengonfigurasi JWKS untuk pemicu HTTP. Setelah JWKS dikonfigurasi, sistem mencari JWKS untuk JWK publik yang memiliki kid yang sama dengan kid dalam token dan menggunakan JWK publik untuk memverifikasi tanda tangan token. JWKS pemicu diizinkan memiliki maksimal satu JWK yang kid-nya tidak ada atau diatur ke string kosong.

  Tabel berikut mencantumkan algoritma yang didukung oleh JWT Function Compute.

  Algoritma tanda tangan	Nilai alg
  RSASSA-PKCS1-V1_5	RS256, RS384, atau RS512
  RSASSA-PSS	PS256, PS384, atau PS512
  Kurva Eliptik (ECDSA)	ES256, ES384, atau ES512
  HMAC	HS256, HS384, atau HS512
  EdDSA	EdDSA

  Penting

  • Algoritma tanda tangan kode otentikasi pesan berbasis hash (HMAC) menggunakan enkripsi simetris, yang memberikan keamanan lemah. Kami merekomendasikan Anda menggunakan algoritma enkripsi asimetris untuk keamanan yang lebih baik.

  • Jika Anda menggunakan algoritma enkripsi asimetris, Anda perlu memasukkan informasi hanya tentang kunci publik, bukan kunci privat dalam JWT demi alasan keamanan.

  • Kami merekomendasikan Anda menggunakan HTTPS untuk melindungi informasi sensitif seperti token dalam permintaan guna mencegah kebocoran token.

Prosedur

Langkah 1: Konfigurasikan otentikasi JWT

Langkah 2: Verifikasi konfigurasi JWT

Bagian ini menjelaskan cara memverifikasi apakah layanan HTTP dapat diakses sesuai harapan 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 saat 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 memverifikasi apakah layanan HTTP dapat diakses sesuai harapan.

   1. Dapatkan URL Internet dari halaman Configurations > Triggers dan masukkan URL di Postman.

   2. Konfigurasikan parameter token di tab Headers di Postman. Lalu, klik Send. Tabel berikut menjelaskan konfigurasi token.

      Nama	Nilai	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".

FAQ