Puerta de enlace incorrecta 502: Respuesta 405 sin encabezado de permiso

Supervisión de API

Para diagnosticar el error con la Supervisión de API, haz lo siguiente:

1. Accede a la IU de Edge como un usuario con una función adecuada.

2. Cambia a la organización en la que deseas investigar el problema.

   
3. Navega a la página Analizar > Supervisión de API > Investigar.
4. Selecciona el período específico en el que observaste los errores.

5. Traza el Código de falla en función del Tiempo.

6. Selecciona una celda que tenga el código de falla protocol.http.Response405WithoutAllowHeader como se muestra a continuación:

   

7. La información sobre el código de falla protocol.http.Response405WithoutAllowHeader se muestra como se indica a continuación:

   

8. Haz clic en Ver registros y expande una de las solicitudes con errores para ver más información.

   
9. En la ventana Registros, toma nota de los siguientes detalles:
   • Código de estado: 502
   • Fuente de falla: target
   • Código de falla: protocol.http.Response405WithoutAllowHeader.
10. Si la Fuente de falla es target y el Código de falla es protocol.http.Response405WithoutAllowHeader, eso indica que el servidor de backend respondió con el código de estado 405 Method Not Allowed sin el encabezado Allow.

Herramienta de Trace

Para diagnosticar el error con la herramienta de Trace, haz lo siguiente:

1. Habilita la sesión de seguimiento y haz lo siguiente:
   • Espera a que se produzca el error 502 Bad Gateway.
   • Si puedes reproducir el problema, realiza la llamada a la API para reproducir el problema - 502 Bad Gateway error

2. Asegúrate de que Mostrar todos los FlowInfos esté habilitado:

   
3. Selecciona una de las solicitudes con errores y examina el seguimiento.
4. Navega por las diferentes fases del seguimiento y ubica dónde se produjo la falla.

5. Por lo general, encontrarás el error en un flujo después de la fase Solicitud enviada al servidor de destino , como se muestra a continuación:

   

6. Toma nota del valor del error del seguimiento.

   El seguimiento de muestra anterior muestra el error como Received 405 Response without Allow Header. Dado que Apigee genera el error después de que se envía la solicitud al servidor de backend, indica que el servidor de backend envió el código de estado de respuesta 405 sin el encabezado Allow.

7. Navega a la fase AX (datos de Analytics registrados) en el seguimiento y haz clic en ella.

8. Desplázate hacia abajo hasta la sección Encabezados de error o respuesta en el panel Detalles de la fase y determina los valores de X-Apigee-fault-code y X-Apigee-fault-source como se muestra a continuación:

   
9. Verás los valores de X-Apigee-fault-code y X-Apigee-fault-source como protocol.http.Response405WithoutAllowHeader y target, respectivamente, lo que indica que este error se produce porque el backend envió el código de estado de respuesta 405 sin el encabezado Allow.

   Encabezados de respuesta	Valor
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

Para diagnosticar el error con los registros de acceso de NGINX, haz lo siguiente:

1. Si eres un usuario de la nube privada, puedes usar los registros de acceso de NGINX para determinar la información clave sobre los errores HTTP 502.

2. Consulta los registros de acceso de NGINX:

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

   Donde: ORG, ORG y PORT# se reemplazan por valores reales.

3. Busca para ver si hay errores 502 con el código de error protocol.http.Response405WithoutAllowHeader durante un período específico (si el problema ocurrió en el pasado) o si aún hay solicitudes que fallan con 502.

4. Si encuentras errores 502 con el X-Apigee-fault-code que coincida con el valor de protocol.http.Response405WithoutAllowHeader, determina el valor de X-Apigee-fault-source.

   Ejemplo de error 502 del registro de acceso de NGINX:

   

   La entrada de muestra anterior del registro de acceso de NGINX tiene los siguientes valores para X-Apigee- fault-code y X-Apigee-fault-source:

   Encabezados de respuesta	Valor
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

Servidor backend

Opción 1: Corrige el servidor de backend para enviar el código de estado 405 con el encabezado Allow:

1. Asegúrate de que el servidor de backend siempre cumpla con la especificación RFC 7231, sección 6.5.5: 405 Método no permitido y envíe con el código de estado 405 incluyendo la lista de métodos permitidos como parte de un encabezado Allow, como se muestra a continuación:

   Allow: HTTP_METHODS

2. Por ejemplo, si tu servidor de backend permite los métodos GET, POST y HEAD, debes asegurarte de que el encabezado Allow los contenga de la siguiente manera:

   Allow: GET, POST, HEAD

Manejo de fallas

Opción 2: Usa la solución de errores para enviar el código de estado 405 con el encabezado Allow desde tu proxy de API:

Si el servidor de backend muestra el código de estado 405 sin el encabezado Allow, puedes usar el manejo de fallas para responder con el código de estado 405 y el encabezado Allow desde tu proxy de API de la siguiente manera:

1. Crea una política, como la política AssignMessage o RaiseFault y establece el código de estado en 405 con el encabezado Allow y un mensaje personalizado.

   Ejemplo de política de AssignMessage para enviar 405 con encabezado Allow:

   <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. Crea un FaultRule en el TargetEndpoint que invoque la política cuando obtenga el error 502 con el código de error protocol.http.Response405WithoutAllowHeader.

   Ejemplo de configuración de TargetEndpoint que muestra FaultRule:

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

3. Guarda estos cambios en una revisión nueva de tu proxy de API y, luego, implementa la revisión.
4. Realiza las llamadas a la API y verifica que obtengas el código de estado 405 con el Allow encabezado.

Configura la propiedad

Opción 3: Configura la propiedad en el Message Processor para evitar que Apigee Edge muestre el error 502

1. Si eres un usuario de la nube privada, puedes actualizar la propiedad HTTP.ignore.allow_header.for.405 a true para evitar que Apigee Edge genere un error 502, incluso si el servidor de backend responde con el código de estado 405 sin el encabezado Allow con la guía práctica: Configura el encabezado Allow de omisión para la propiedad 405 en Message Processors.
2. Si eres un usuario de la nube pública, comunícate con el equipo de asistencia de Apigee Edge.