Function Compute:Konfigurasikan autentikasi JWT untuk pemicu HTTP

Prasyarat

Buat fungsi dan pemicu HTTP. Untuk informasi selengkapnya, lihat Buat fungsi dan Buat pemicu.

Batasan

• Anda dapat menggunakan metode apa pun untuk menghasilkan dan mendistribusikan JWT. Function Compute mengotentikasi JWT menggunakan JWKS publik yang dikonfigurasi untuk pemicu.

• Function Compute mendukung Kunci Web JSON (JWK) tanpa kid (key ID).

• Pemicu dapat membaca token dari header permintaan, parameter Query (untuk permintaan GET), parameter form (untuk permintaan POST), atau cookie.

• Anda dapat meneruskan claims ke fungsi sebagai header, parameter form (untuk permintaan POST), atau cookie.

• Function Compute memungkinkan Anda mengonfigurasi JWKS untuk pemicu HTTP. Sistem mencari JWKS untuk menemukan JWK publik dengan kid yang sesuai dengan yang ada di token. Sistem kemudian menggunakan kunci publik ini untuk memverifikasi signature token. JWKS untuk pemicu dapat memiliki paling banyak satu JWK di mana kid tidak ada atau berupa string kosong.

  Function Compute JWT mendukung algoritma berikut.

  Algoritma Tanda Tangan	Nilai Alg
  RSASSA-PKCS1-V1_5	RS256, RS384, RS512
  RSASSA-PSS	PS256, PS384, PS512
  Elliptic Curve (ECDSA)	ES256, ES384, ES512
  HMAC	HS256, HS384, HS512
  EdDSA	EdDSA

  Penting

  • Algoritma signature HMAC menggunakan enkripsi simetris dan kurang aman. Kami menyarankan Anda menggunakan algoritma enkripsi asimetris yang lebih aman.

  • Saat menggunakan algoritma enkripsi asimetris, demi keamanan, JWT Anda sebaiknya hanya berisi informasi kunci publik. Kami menyarankan agar Anda tidak menyertakan informasi kunci privat.

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

Prosedur

Langkah 1: Konfigurasikan autentikasi JWT

Langkah 2: Verifikasi konfigurasi

Gunakan alat pengujian, seperti Postman, untuk memverifikasi bahwa Anda dapat mengakses layanan HTTP sesuai harapan berdasarkan konfigurasi JWT pemicu HTTP dengan menyediakan titik akhir, token, dan informasi lainnya.

1. Gunakan kunci privat dalam format X.509 PEM yang Anda hasilkan di Langkah 1 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 Python contoh berikut secara lokal untuk menghasilkan token JWT.

      import jwt
      import time
      
      private_key = """
      -----BEGIN PRIVATE KEY-----
      <The X.509 PEM-format 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 selama 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. Di tab Trigger pada halaman detail fungsi, peroleh titik akhir publik pemicu HTTP dan masukkan ke dalam bidang URL di Postman.

   2. Di Postman, konfigurasikan parameter token di header lalu klik Send. Tabel berikut memberikan contoh konfigurasi token.

      Parameter	Nilai	Deskripsi
      Key	Authentication	Nama parameter yang Anda tentukan di bagian JWT Token Configuration.
      Value	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLg	Nilai parameter Remove Prefix yang Anda tentukan di bagian JWT Token Configuration, digabungkan dengan token JWT. Nilai contoh mengasumsikan bahwa Remove Prefix diatur ke Bearer .

      Penting

      Awalan dan spasi untuk parameter JWT di header permintaan harus persis sama dengan nilai Remove Prefix yang Anda tentukan di bagian JWT Token Configuration. Jika tidak, Pemicu akan gagal mengurai token dan mengembalikan galat invalid or expired jwt.

FAQ