Function Compute:Konfigurasikan autentikasi JWT untuk pemicu HTTP

Prasyarat

Fungsi dan pemicu HTTP telah dibuat. Untuk informasi selengkapnya, lihat Buat fungsi dan Buat pemicu.

Batasan

• Anda dapat menghasilkan dan mendistribusikan JWT dengan cara apa pun. Function Compute mengautentikasi JWT menggunakan JWKS publik yang dikonfigurasi untuk pemicu.

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

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

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

• Function Compute memungkinkan Anda mengonfigurasi JWKS untuk pemicu HTTP. Sistem mencari JWKS untuk menemukan JWK publik dengan key ID (kid) yang sesuai dengan kid dalam token. Pemicu kemudian menggunakan kunci ini untuk memverifikasi signature token tersebut. JWKS pemicu dapat berisi paling banyak satu JWK yang tidak memiliki kid atau memiliki string kosong sebagai kid.

  Function Compute JWT mendukung algoritma berikut.

  Algoritma signature	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 menggunakan algoritma enkripsi asimetris yang lebih aman.

  • Saat menggunakan algoritma enkripsi asimetris, pastikan JWKS Anda hanya berisi informasi kunci publik demi keamanan. Jangan sertakan detail kunci privat.

  • Kami menyarankan menggunakan HTTPS untuk melindungi informasi sensitif dalam permintaan, seperti token.

Prosedur

Langkah 1: Konfigurasikan autentikasi JWT

Langkah 2: Verifikasi konfigurasi

Gunakan tool pengujian, seperti Postman, untuk memverifikasi bahwa Anda dapat mengakses layanan HTTP. Konfigurasikan alamat akses, token, dan informasi lainnya berdasarkan konfigurasi JWT pemicu HTTP.

1. Gunakan kunci privat dalam format X.509 PEM yang Anda hasilkan di Langkah 1: Konfigurasikan autentikasi JWT untuk menerbitkan token JWT. Langkah-langkah berikut menggunakan Python sebagai contoh untuk menunjukkan cara menghasilkan token dengan menggunakan skrip lokal.

   1. Instal modul PyJWT.

      pip install 'PyJWT>=2.0'

   2. Jalankan skrip Python berikut secara lokal untuk menghasilkan token JWT.

      import jwt
      import time
      
      private_key = """
      -----BEGIN PRIVATE KEY-----
      <The private key in X.509 PEM format that you generated in Step 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 masa berlaku token selama satu jam.
      }
      
      
      encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
      print("Generated token: %s" % encoded)
      

2. Gunakan Postman untuk memverifikasi akses ke layanan HTTP.

   1. Di tab Trigger pada halaman detail fungsi, dapatkan alamat akses publik pemicu HTTP dan tempelkan ke field URL di Postman.

   2. Di tab Headers di Postman, konfigurasikan parameter token lalu klik Send. Contoh berikut menunjukkan konfigurasi token.

      Parameter	Nilai	Deskripsi
      Key	Authentication	Nama parameter yang dikonfigurasi di JWT Token Configuration.
      Value	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLg	Awalan yang ditentukan di JWT Token Configuration, diikuti oleh token JWT. Nilai contoh mengasumsikan bahwa awalan diatur ke Bearer .

      Penting

      Nilai token dalam header permintaan harus diawali dengan awalan dan spasi persis seperti yang Anda konfigurasi untuk Remove Prefix di bagian JWT Token Configuration. Jika tidak, pemicu gagal mengurai token dan mengembalikan error invalid or expired jwt.

FAQ