Function Compute:Bir HTTP tetikleyicisi için JWT kimlik doğrulamasını yapılandırın

Arka plan bilgileri

Önkoşullar

Bir işlev ve bir HTTP tetikleyicisi oluşturun. Daha fazla bilgi için bkz. İşlev oluşturma ve Tetikleyici oluşturma.

Sınırlamalar

• JWT'leri oluşturmak ve dağıtmak için herhangi bir yöntemi kullanabilirsiniz. Function Compute, tetikleyici için yapılandırılan genel JWKS kullanarak JWT'leri kimlik doğrular.

• Function Compute, kid (anahtar kimliği) içermeyen bir JSON Web Key (JWK) destekler.

• Tetikleyici, bir belirteci istek header alanından, bir Query parametresinden (GET istekleri için), bir form parametresinden (POST istekleri için) veya bir cookie değerinden okuyabilir.

• claims değerlerini işleve bir header alanı, bir form parametresi (POST istekleri için) veya bir cookie değeri olarak iletebilirsiniz.

• Function Compute, bir HTTP tetikleyicisi için bir JWKS yapılandırmanıza olanak tanır. Sistem, JWKS içinde token içindeki kid değeriyle eşleşen bir genel JWK arar. Ardından bu genel anahtarı kullanarak token imzasını doğrular. Bir tetikleyici için kullanılan JWKS'te, kid değeri eksik olan veya boş dize olan en fazla bir JWK bulunabilir.

  Function Compute JWT aşağıdaki algoritmaları destekler.

  İmza algoritması	Alg değeri
  RSASSA-PKCS1-V1_5	RS256, RS384, RS512
  RSASSA-PSS	PS256, PS384, PS512
  Eliptik Eğri (ECDSA)	ES256, ES384, ES512
  HMAC	HS256, HS384, HS512
  EdDSA	EdDSA

  Önemli

  • HMAC imza algoritması simetrik şifreleme kullanır ve daha az güvenlidir. Daha güvenli bir asimetrik şifreleme algoritması kullanmanızı öneririz.

  • Asimetrik şifreleme algoritması kullanırken, güvenlik amacıyla JWT'niz yalnızca genel anahtar bilgilerini içermelidir. Özel anahtar bilgilerini dahil etmemenizi öneririz.

  • Belirteç sızıntısını önlemek için isteklerdeki token gibi hassas bilgileri korumak üzere HTTPS kullanmanızı öneririz.

Yordam

1. Adım: JWT kimlik doğrulamasını yapılandırın

2. Adım: Yapılandırmayı doğrulayın

Postman gibi bir test aracı kullanarak bir uç nokta, belirteç ve diğer bilgileri sağlayarak HTTP tetikleyicisinin JWT yapılandırmasına göre HTTP hizmetine beklenen şekilde erişebildiğinizi doğrulayın.

1. Adımda oluşturduğunuz X.509 PEM formatındaki özel anahtarı kullanarak bir JWT belirteci verin. Aşağıdaki adımlar, yerel bir Python betiği kullanarak nasıl belirteç oluşturulacağını göstermektedir.

   1. PyJWT modülünü yükleyin.

      pip install 'PyJWT>=2.0'

   2. Bir JWT belirteci oluşturmak için aşağıdaki örnek Python betiğini yerel olarak çalıştırın.

      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()),   # The time when the token was issued.
          "exp": int(time.time()) + 60 * 60,   # Set the token to be valid for 1 hour.
      }
      
      encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
      print("Generated token: %s" % encoded)
      

2. HTTP hizmetine erişilebildiğini doğrulamak için Postman'i kullanın.

   1. İşlev ayrıntıları sayfasının Trigger sekmesinde HTTP tetikleyicisinin genel uç noktasını alın ve Postman'deki URL alanına girin.

   2. Postman'de başlıklardaki belirteç parametresini yapılandırın ve Send öğesini tıklayın. Aşağıdaki tabloda belirteç yapılandırmasına ilişkin bir örnek verilmiştir.

      Parametre	Değer	Açıklama
      Anahtar	Authentication	JWT Token Configuration bölümünde belirttiğiniz parametre adı.
      Değer	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLg	JWT Token Configuration bölümünde belirttiğiniz Remove Prefix parametresinin değeri ile JWT belirtecinin birleştirilmiş hali. Örnek değer, Remove Prefix değerinin Bearer olarak ayarlandığını varsayar.

      Önemli

      İstek başlığında bulunan JWT parametresinin ön eki ve boşluğu, JWT Token Configuration bölümünde belirttiğiniz Remove Prefix değeriyle tam olarak eşleşmelidir. Aksi takdirde tetikleyici belirteci ayrıştıramaz ve invalid or expired jwt hatası döndürür.

SSS