500 Dahili Sunucu Hatası - BadFormData

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Belirti

İstemci uygulaması 500 Internal Server Error HTTP durum kodunu alır ve API çağrılarına yanıt olarak protocol.http.BadFormData hata kodunu ekleyin.

Hata mesajı

İstemci uygulaması aşağıdaki yanıt kodunu alır:

HTTP/1.1 500 Internal Server Error

Ayrıca, aşağıdaki hata mesajını da görebilirsiniz:

{
   "fault":{
      "faultstring":"Bad Form Data",
      "detail":{
         "errorcode":"protocol.http.BadFormData"
      }
   }
}

Form verileri

Bu sorunu gidermenin ayrıntılarına geçmeden önce form verilerinin ne olduğunu görelim.

Form verileri, kullanıcı tarafından genellikle öğeler içeren bir HTML formu aracılığıyla sağlanan bilgilerdir bir metin giriş kutusu, düğme veya onay kutusu gibi. Form verileri genellikle bir dizi anahtar/değer çiftlerinin bir parçası olarak kullanabilirsiniz.

Form veri aktarımı

1. İçerik Türü: application/x-www-form-urlcoding
   • Form verilerinin boyutu küçükse veriler şunları içeren anahtar/değer çiftleri olarak gönderilir:
     • Her iki anahtardaki karakterler, Formlar - Bölüm 17.13.4.1
     • Content-Type: application/x-www-form-urlencoded başlığı

     Form verilerini içeren örnek istek:

     curl https://HOSTALIAS/somepath -H "Content-Type: application/x-www-form-urlencoded" -d "username=abc@google.com&pasword=secret123"
     

   • Anahtarlar ve değerlerdeki alfanümerik olmayan karakterler kodlanan yüzde, yani bir karakter üçlüceği olarak temsil edilir Yüzde işareti ve ardından iki on altılı basamaktan oluşan %HH belirli bir karakterin ASCII kodunu temsil eder.
   • Bu nedenle, form verilerinde yüzde işaretine (%) izin verilse de özel bir kaçış dizisinin başlangıcı olarak yorumlanır. Bu nedenle, form verilerinin anahtar veya değerde yüzde işaretini (%) içeriyorsa bu işaret iletilmelidir %25, , yüzde işareti için ASCII kodunu temsil eder (%) karakter.
2. İçerik Türü: çok parçalı/form-veriler

   Büyük miktarlarda ikili verileri veya ASCII olmayan içeren metinler iletmek istiyorsanız kullanıyorsanız verileri Content-Type: çok parçalı/form-veri: Formlar - Bölüm 17.13.4.2

Olası nedenler

Bu hata yalnızca aşağıdaki koşulların tamamı karşılandığında ortaya çıkar:

1. İstemci tarafından Apigee Edge'e gönderilen HTTP isteği şunları içerir:
   1. Content-Type: application/x-www-form-urlencoded ve
   2. Yüzde işareti (%) veya yüzde işareti olan form verileri (%) ve ardından şu nedenle izin verilmeyen geçersiz onaltılık karakterler gelir: Formlar - Bölüm 17.13.4.1.

2. Apigee Edge'deki API proxy'si, karakter içeren belirli form parametrelerini okur veya AttributionMessage politikası.

   Örneğin, form verileri yüzde işaretini (%) olduğu gibi ( kodlaması) veya yüzde işareti (%) ve ardından geçersiz onaltılık anahtar ve/veya değerde yer alıyorsa bu hatayı alırsınız.

   Bu hatanın olası nedenleri aşağıda açıklanmıştır:

   Neden	Açıklama	Şunun için geçerli sorun giderme talimatları:
   İstekteki form parametrelerinde izin verilmeyen karakterler var	İstemci tarafından HTTP isteğinin bir parçası olarak iletilen form parametreleri kullanılmasına izin verilmeyen karakterler bulunmalıdır.	Edge Herkese Açık ve Private Cloud kullanıcıları

Sık kullanılan teşhis adımları

Bu hatayı teşhis etmek için aşağıdaki araçlardan/tekniklerden birini kullanın:

Neden: İstekteki form parametrelerinde izin verilmeyen karakterler var

Teşhis

1. Açıklanan şekilde API İzleme, İzleme aracı veya NGINX erişim günlüklerini kullanarak 500 Internal Server Error için Hata Kodu, Hata Kaynağı ve Hata Politikası'nı belirleyin Genel teşhis adımları başlıklı makaleyi inceleyin.
2. Hata Kodu protocol.http.BadFormData ise Hata Kaynağı proxy veya policy değeri ve Hata Politikası şu değil: boşsa, bu değer,,'nda belirtilen politikanın (form parametreleri) kullanarak form verilerini okuma veya ayıklama.
3. Hata Politikası'nda belirtilen politikayı inceleyin ve aşağıdakileri belirleyin: bilgi:
   1. Kaynak: Politikanın yanıt verebilmeniz için kritik önem taşır.
   2. Form parametreleri: politikası.

      Örnek 1

      1. örnek: Form parametrelerini çıkaran ExtractVariables politikası:

            <ExtractVariables name="EV-ExtractFormParms">
               <DisplayName>EV-ExtractFormParams</DisplayName>
               <Source>request</Source>
               <FormParam name="username">
                  <Pattern ignoreCase="false">{username}</Pattern>
               </FormParam>
               <FormParam name="password">
                 <Pattern ignoreCase="false">{password}</Pattern>
               </FormParam>
               <VariablePrefix>forminfo</VariablePrefix>
             <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
            </ExtractVariables>
            

      Yukarıdaki ExtractVariables politikasında:

      • Kaynak: request

        Bu, <Source> öğesi ile gösterilir

      • Form parametreleri: username ve password

        Bu,<Pattern> <FormParam> öğe

      Bu, username ve/veya password, istemci tarafından HTTP isteğinin bir parçası olarak Apigee Edge, kullanılmasına izin verilmeyen karakterler içeriyor.

      Örnek 2

      2. örnek: Form parametrelerini kopyalayan atamayla ilgili politika:

            <AssignMessage continueOnError="false" enabled="true" name="AM-CopyFormParams">
              <Copy source="request">
                <FormParams>
                  <FormParam name="username"/>
                  <FormParam name="password"/>
                </FormParams>
              </Copy>
              <AssignTo createNew="true" transport="http" type="request"/>
            </AssignMessage>
            

      Yukarıdaki ExtractVariables politikasında:

      • Kaynak: request

        Bu,source <Copy> öğe

      • Form parametreleri: username ve password

        Bu,name <FormParam> öğe

      Bu, username veya password form parametrelerinin Her ikisi de istemci tarafından HTTP isteği olarak Apigee Edge'e iletilen herhangi bir izin verilmeyen karakterlerin kullanılmasına izin verilmez.

4. İzin verilmeyen karakter olup olmadığını kontrol edin 3. adımda tanımlanan form parametrelerindeki karakterler kullanıldı aşağıdaki yöntemlerden birini kullanın:

   İzleme aracı

   İzleme aracını kullanarak doğrulamak için:

   1. Başarısız olan isteğin izini aşağıdaki sayfada açıklandığı gibi yakaladıysanız: Yaygın teşhis adımları'nı tıklayın, ardından unutmayın.
   2. Form parametrelerinin herhangi bir karakter içeren kullanılmasına izin verilmeyen veriler, Yukarıdaki 3. adıma ve
      1. Müşteriden İstek Alındı aşamasına gidin.

      2. Aşama Ayrıntıları bölümüne gidin ve İçerik İsteyin.

         ( resmi büyüt)

         
      3. Yukarıdaki örnekte, password form parametresinin yüzde işaretini (%) içerir.
      4. Yüzde işareti (%) yüzde kodlaması özel karakterler içeriyorsa olduğu gibi kullanılamaz. olduğunu unutmayın.
      5. Bu nedenle Apigee Edge, Hata kodunu içeren 500 Internal Server Error protocol.http.BadFormData.

   Gerçek istek

   Gerçek isteği kullanarak doğrulamak için:

   1. Hedef sunucuya gönderilen gerçek isteğe erişiminiz yoksa ardından Çözünürlük'e gidin.
   2. Apigee Edge'e gönderilen isteğe erişiminiz varsa şu adımları uygulayın:
      1. Form verilerinin içeriğini inceleyin ve yüzde işareti (%) gibi kullanılmasına izin verilmez veya yüzde işareti (%) ve ardından geçersiz onaltılık karakterler yer alır.

         Örnek 1

         1. Örnek İstek: İstek kapsamında form verileri

         curl -X GET "https://HOSTALIAS/myproxy -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=123456abc123&client_secret=c23578%ZY"
         

         Bu örnekte, client_secret öğesinin yüzde işareti (%) ve ardından gelen geçersiz on altılı karakterler: ZY.

         Örnek 2

         2. Örnek İstek: Dosyada iletilen form verileri:

         curl -X GET "https://HOSTALIAS/myproxy -H "Content-Type: application/x-www-form-urlencoded" -d @form_data.xml
         

         form_data.xml dosyasının içeriği:

         xml=<user><username>abc1234@google.com</username><password>qwerty12345!@#$%</password></user>
         

         Bu örnekte, password öğesinin yüzde işaretini (%) içerdiğine ve olduğu gibi aktarılır.

   3. Yukarıdaki iki örnekte, HTTP isteğinin bir parçası olarak Apigee Edge, kullanılmasına izin verilmeyen karakterler içeriyor.
   4. Bu nedenle Apigee Edge 500 Internal Server Error ile yanıt veriyor protocol.http.BadFormData hata koduyla.

Çözünürlük

1. Form verilerinin veya parametrelerinin hem anahtarlarındaki hem de değerlerindeki özel karakterlerin bulunduğundan emin olun. HTTP isteğinin bir parçası olarak gönderilen iletiler her zaman bölümünde açıklandığı gibi kodlanır. Form Verileri: application/x-www-form-urlcoding.
2. Yukarıda açıklanan örnekler için sorunları aşağıdaki şekilde düzeltebilirsiniz:

   Örnek 1

   1. Örnek: İstek kapsamında iletilen form verileri:

   Geçerli kullanın Belirli bir karakterin ASCII koduyla eşleşen onaltılık karakterler. Örneğin, dolar işaretini ($) göndermek istiyorsanız %24 kullanın. aşağıdaki gibidir:

   curl -X GET "https://HOSTALIAS/myproxy -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=123456abc123&client_secret=c23578%24"
   

   Örnek 2

   2. Örnek İstek: Dosyada iletilen form verileri:

   curl -X GET "https://HOSTALIAS/myproxy -H "Content-Type: application/x-www-form-urlencoded" -d @form_data.xml
   

   form_data.xml dosyasının içeriği:

   Şunu kullanın: yüzde (%) işareti için yüzdelik kodlaması ise dosyayı %25 aşağıda gösterildiği gibidir:

   xml=<user><username>abc1234@google.com</username><password>qwerty12345!!@#$%25</password></user>
   

Spesifikasyon

Apigee Edge, form verilerinin aşağıdaki özelliklere göre gönderilmesini bekler:

Spesifikasyon
Form Verileri: application/x-www-form-urlcoding

Hâlâ Apigee Destek Ekibi'nden yardım almanız gerekiyorsa teşhis bilgileri bölümüne bakın.

Teşhis bilgileri toplanmalıdır

Yukarıdaki talimatları uygulamanıza rağmen sorun devam ederse aşağıdaki Apigee Edge Destek Ekibi ile iletişime geçin:

Herkese açık Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Kuruluş adı
• Ortam adı
• API proxy'si adı
• Yeniden oluşturmak için kullanılan curl komutunu tamamlayın Hata koduyla 500 Internal Server Error protocol.http.BadFormData
• API istekleri için izleme dosyası

Private Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Başarısız istekler için tam hata mesajı gözlemlendi
• Ortam adı
• API proxy paketi
• API istekleri için izleme dosyası

• NGINX erişim günlükleri

  /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Yer: ORG, ENV ve PORT# şununla değiştirilir: gerçek değerler.

• Mesaj İşleyici sistem günlükleri

  /opt/apigee/var/log/edge-message-processor/logs/system.log

Referanslar

• Form İçeriği türleri
• RFC3986, bölüm 2.1: Yüzde kodlaması
• Kodlama Yüzdesi
• Onaltılık karakterler