502 Bozuk Ağ Geçidi - İzin Verme Başlığı 405

API Monitoring

API İzleme'yi kullanarak hatayı teşhis etmek için:

1. Edge kullanıcı arayüzüne uygun bir role sahip kullanıcı olarak giriş yapın.

2. Sorunu incelemek istediğiniz kuruluşa geçin.

   
3. Analyze > API Monitoring > Investigate (Analiz > API İzleme > İnceleme) sayfasına gidin.
4. Hataları gözlemlediğiniz belirli zaman aralığını seçin.

5. Hata Kodunu Zaman ile karşılaştırın.

6. Aşağıda gösterildiği gibi, hata kodunu içeren bir hücre seçin: protocol.http.Response405WithoutAllowHeader

   

7. protocol.http.Response405WithoutAllowHeader hata koduyla ilgili bilgiler aşağıda gösterildiği gibi görüntülenir:

   

8. Daha fazla bilgi görüntülemek için Günlükleri görüntüle 'yi tıklayın ve başarısız olan isteklerden birini genişletin.

   
9. Günlükler penceresinde aşağıdaki ayrıntıları not edin:
   • Durum Kodu: 502
   • Hata Kaynağı: target
   • Hata Kodu: protocol.http.Response405WithoutAllowHeader.
10. Hata Kaynağı target ve Hata Kodu protocol.http.Response405WithoutAllowHeader ise bu, arka uç sunucusunun Allow başlığı olmadan 405 Method Not Allowed durum koduyla yanıt verdiği anlamına gelir.

İzleme aracı

İzleme aracını kullanarak hatayı teşhis etmek için:

1. İzleme oturumunu ve aşağıdakilerden birini etkinleştirin:
   • 502 Bad Gateway hatasının oluşmasını bekleyin veya
   • Sorunu yeniden oluşturabiliyorsanız sorunu yeniden oluşturmak için API çağrısı yapın - 502 Bad Gateway hatası

2. Tüm FlowInfo'ları göster'in etkinleştirildiğinden emin olun:

   
3. Başarısız olan isteklerden birini seçip izlemeyi inceleyin.
4. İzlemenin farklı aşamalarında gezinin ve hatanın nerede oluştuğunu bulun.

5. Hatayı genellikle aşağıdaki örnekte gösterildiği gibi Request sent to target server (İstek hedef sunucuya gönderildi) aşamasından sonraki bir akışta bulabilirsiniz:

   

6. İzden hatanın değerini not edin.

   Yukarıdaki örnek izlemede hata Received 405 Response without Allow Header olarak gösterilmektedir. Hata, istek arka uç sunucusuna gönderildikten sonra Apigee tarafından oluşturulduğundan arka uç sunucusunun Allow başlığı olmadan 405 yanıt durum kodunu gönderdiği anlaşılır.

7. İzleme işleminde AX (Analytics Verileri Kaydedildi) aşamasına gidin ve bu aşamayı tıklayın.

8. Aşama Ayrıntıları panelinde Hata / Yanıt Başlıkları bölümüne gidin ve aşağıdaki örnekte gösterildiği gibi X-Apigee-fault-code ve X-Apigee-fault-source değerlerini belirleyin:

   
9. X-Apigee-fault-code ve X-Apigee-fault-source değerlerini sırasıyla protocol.http.Response405WithoutAllowHeader ve target olarak görürsünüz. Bu, hatanın arka uç 405 yanıt durum kodunu Allow üstbilgisi olmadan gönderdiği için oluştuğunu gösterir.

   Yanıt Başlıkları	Değer
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

NGINX erişim günlüklerini kullanarak hatayı teşhis etmek için:

1. Özel bulut kullanıcısıysanız HTTP 502 hatalarıyla ilgili temel bilgileri belirlemek için NGINX erişim günlüklerini kullanabilirsiniz.

2. NGINX erişim günlüklerini kontrol edin:

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

   Nerede: ORG, ORG ve PORT# gerçek değerlerle değiştirilir.

3. protocol.http.Response405WithoutAllowHeaderBelirli bir süre boyunca (sorun geçmişte yaşandıysa) 502 hata koduyla hata olup olmadığını veya 502 ile başarısız olan isteklerin olup olmadığını arayın.

4. 502 hataları bulursanız ve X-Apigee-fault-code değeri protocol.http.Response405WithoutAllowHeader ile eşleşiyorsa X-Apigee-fault-source değerini belirleyin.

   NGINX erişim günlüğünden örnek 502 hatası:

   

   NGINX erişim günlüğündeki yukarıdaki örnek girişte, X-Apigee- fault-code ve X-Apigee-fault-source: için aşağıdaki değerler yer almaktadır:

   Yanıt Başlıkları	Değer
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

Arka uç sunucusu

1. seçenek: İzin verme başlığıyla 405 durum kodu göndermek için arka uç sunucusunu düzeltin:

1. Arka uç sunucusunun her zaman RFC 7231, bölüm 6.5.5: 405 Method Not Allowed spesifikasyonuna uyduğundan emin olun ve aşağıdaki örnekte gösterildiği gibi, izin verilen yöntemlerin listesini Allow başlığına ekleyerek 405 durum koduyla gönderin:

   Allow: HTTP_METHODS

2. Örneğin, arka uç sunucunuz GET, POST ve HEAD yöntemlerine izin veriyorsa Allow üst bilgisinin bunları aşağıdaki gibi içerdiğinden emin olmanız gerekir:

   Allow: GET, POST, HEAD

Hata işleme

2. seçenek: API proxy'nizden Allow üstbilgisiyle 405 durum kodu göndermek için Hata İşleme'yi kullanın:

Arka uç sunucusu, Allow başlığı olmadan 405 durum kodunu döndürürse API proxy'nizden 405 durum kodu ve Allow başlığıyla yanıt vermek için hata yönetimi özelliğini aşağıdaki gibi kullanabilirsiniz:

1. Aşağıdakiler gibi bir politika oluşturun: AssignMessage politikası veya RaiseFault politikası ve durum kodunu 405 olarak ayarlayın. Allow üstbilgisi ve özel bir mesaj ekleyin.

   İzin ver başlığıyla 405 göndermek için örnek AssignMessage politikası:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
       <DisplayName>AM-405WithAllowHeader</DisplayName>
       <Set>
           <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
           <StatusCode>405</StatusCode>
           <ReasonPhrase>Method Not Allowed</ReasonPhrase>
       </Set>
       <Add>
           <Headers>
               <Header name="Allow">GET, POST, HEAD</Header>
           </Headers>
       </Add>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

2. TargetEndpoint içinde, 502 hatası protocol.http.Response405WithoutAllowHeader hata koduyla alındığında politikayı çağıran bir FaultRule oluşturun.

   FaultRule'u gösteren örnek TargetEndpoint yapılandırması:

   <TargetEndpoint name="default">
   ...
       <FaultRules>
          <FaultRule name="405WithoutAllowHeader">
               <Step>
                   <Name>AM-405WithAllowHeader</Name>
               </Step>
               <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
           </FaultRule>
       </FaultRules>

3. Bu değişiklikleri API proxy'nizin yeni bir düzeltmesinde kaydedin ve düzeltmeyi dağıtın.
4. API çağrılarını yapın ve 405 durum kodunu Allow üstbilgisiyle aldığınızı doğrulayın.

Mülkü yapılandırma

3. seçenek: Apigee Edge'in 502 hatası döndürmesini önlemek için mülkü Mesaj İşleyici'de yapılandırın

1. Özel bulut kullanıcısıysanız arka uç sunucusu Allow üstbilgisi olmadan 405 durum koduyla yanıt verse bile Apigee Edge'in 502 hatası vermesini önlemek için HTTP.ignore.allow_header.for.405 özelliğini true olarak güncelleyebilirsiniz. Bunun için şu Nasıl Yapılır kılavuzunu kullanın: İleti İşleyicilerde 405 özelliği için izin verilen üstbilgiyi yoksayma özelliğini yapılandırma.
2. Public Cloud kullanıcısıysanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.