Campos de encabezado de la solicitud demasiado grandes - TooBigHeaders

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X. Información

Síntoma

La aplicación cliente obtiene un código de estado HTTP de 431 Request Header Fields Too Large con el código de error protocol.http.TooBigHeaders como respuesta a las llamadas a la API.

Mensaje de error

La aplicación cliente obtiene el siguiente código de respuesta:

HTTP/1.1 431 Request Header Fields Too Large

Además, es posible que veas el siguiente mensaje de error:

{
   "fault":{
      "faultstring":"request headers size exceeding 25,600",
      "detail":{
         "errorcode":"protocol.http.TooBigHeaders"
      }
   }
}

Causas posibles

Este error ocurre si el tamaño total de todos los encabezados de solicitud que envía la aplicación cliente a Apigee Edge como parte de la solicitud HTTP es mayor que el límite permitido en Apigee Edge según RFC 6585, sección 5: 431 Campos de encabezado de solicitud demasiado grandes.

A continuación, se muestran las posibles causas de este error:

Causa	Descripción	Instrucciones de solución de problemas aplicables para
El tamaño de los encabezados de solicitud es mayor que el límite permitido	El tamaño total de todos los encabezados que envía la aplicación cliente como parte de la solicitud HTTP a Apigee Edge es mayor que el límite permitido en Apigee Edge.	Usuarios de la nube pública y privada de Edge

Pasos comunes de diagnóstico

Usa una de las siguientes herramientas o técnicas para diagnosticar este error:

Causa: El tamaño de los encabezados de solicitud es mayor que el límite permitido

Diagnóstico

1. Determina el código con errores, la fuente de errores y el tamaño de la longitud de la solicitud correspondiente al error observado con la supervisión de la API o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico.
2. Si la fuente de errores tiene el valor apigee o MP, el código de falla tiene el valor protocol.http.TooBigHeaders y la longitud de la solicitud es superior a 25 KB, esto indica que el tamaño de la solicitud que envió la aplicación cliente a Apigee es mayor que el límite permitido en Apigee Edge.
3. Puedes validar que el tamaño de los encabezados de solicitud superó el límite permitido de 25 KB mediante uno de los siguientes métodos:

   Mensaje de error

   Para validar mediante el mensaje de error, haz lo siguiente:

   Si tienes acceso al mensaje de error completo que recibiste de Apigee Edge, consulta la faultstring. El faultstring indica que el tamaño total de los encabezados de solicitud superó el límite permitido de 25 KB.

   Ejemplo de mensaje de error:

   "faultstring":"request headers size exceeding 25,600"
   

   Solicitud real

   Para validar el uso de la solicitud real, sigue estos pasos:

   Si tienes acceso a la solicitud real que realizó la aplicación cliente, sigue estos pasos:

   1. Verifica el tamaño de los encabezados que se pasaron en la solicitud.

   2. Si descubres que el tamaño total de los encabezados supera el límite permitido en Apigee Edge, esa es la causa del problema.

      Ejemplo de solicitud:

      curl -v https://HOSTALIAS/test -H "header0: 000000000000000000……..000000<trimmed>" -H "header1: 111111111111111111……..111111<trimmed>" -H "header2: 222222222222222222……..222222<trimmed>"-H "header3: 333333333333333333……..333333<trimmed>"
      

      En el caso anterior, el tamaño total de los encabezados header0, header1, header2 y header3 es superior a 25 KB, es decir, contiene más de 25, 000 caracteres ASCII (bytes).

      Si usas algún otro cliente, puedes revisar los registros del cliente y tratar de averiguar el tamaño de la línea de solicitud que se envía a Apigee Edge.

   Registros de Message Processor

   Para validar el uso de los registros de Message Processor, haz lo siguiente:

   Si eres usuario de la nube privada, puedes usar los registros de Message Processor para validar si el tamaño de los encabezados de solicitud superó el límite permitido en Apigee Edge.

   1. Verifica los registros de Message Processor:

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

   2. Realiza una búsqueda para ver si hay errores 431 durante un período específico (si el problema ocurrió en el pasado) o si hay solicitudes que aún fallan con 431. Puedes usar las siguientes strings de búsqueda.

      grep -ri "exceeding"
      

      grep -ri "RequestHeadersTooLarge"
      

   3. Encontrarás líneas de system.log similares a estas:

      2021-07-27 08:30:28,419  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() :
      Request:GET, uri:/test/, message Id:null,
      exception:com.apigee.errors.http.user.RequestHeadersTooLarge{
      code = protocol.http.TooBigHeaders, message = request headers size
      exceeding 25,600, associated contexts = []}, context:Context@9c5903
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.205.251:8443 Local:192.168.67.23:22188]@25130
      useCount=1 bytesRead=0 bytesWritten=15367 age=667062ms  lastIO=0ms
      isOpen=true)
      

      El texto message = request headers size exceeding 25,600 en el mensaje de error anterior indica que el tamaño total de los encabezados de solicitud es de más de 25 KB. Por lo tanto, Apigee Edge genera la excepción com.apigee.errors.http.user.RequestHeadersTooLarge y muestra el código de estado 431 con el código de falla protocol.http.TooBigHeaders a las aplicaciones cliente.

Resolución

Límites

Apigee espera que la aplicación cliente y el servidor de backend no envíen encabezados de solicitud o respuesta cuyos tamaños sean mayores que el límite permitido, como se documenta para el límite de tamaño de los encabezados de solicitud/respuesta en Límites de Apigee Edge.

1. Si eres un usuario de la nube pública, el límite máximo de tamaño de los encabezados de solicitud y respuesta es el que se documenta para Tamaño del encabezado de solicitud/respuesta en Límites de Apigee Edge.
2. Si eres un usuario de nube privada, es posible que hayas modificado el límite máximo predeterminado del tamaño de los encabezados de solicitud y respuesta (aunque no sea una práctica recomendada). Para determinar el límite de tamaño máximo del encabezado de solicitud, sigue las instrucciones que se indican en Cómo verificar el límite actual.

¿Cómo puedo verificar el límite actual?

En esta sección, se explica cómo verificar que la propiedad HTTPRequest.headers.limit se haya actualizado con un valor nuevo en Message Processor.

1. En la máquina del procesador de mensajes, busca la propiedad HTTPRequest.headers.limit en el directorio /opt/apigee/edge-message-processor/conf y verifica qué valor se configuró como se muestra a continuación:

   grep -ri "HTTPRequest.headers.limit" /opt/apigee/edge-message-processor/conf
   

2. El resultado de muestra del comando anterior es el siguiente:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.headers.limit=25k
   

3. En el resultado de ejemplo anterior, ten en cuenta que la propiedad HTTPRequest.headers.limit se configuró con el valor 25k en http.properties.

   Esto indica que el límite del tamaño del encabezado de solicitud configurado en Apigee para la nube privada es de 25 KB.

Especificación

Apigee Edge espera que la aplicación cliente no envíe encabezados de gran tamaño como parte de la solicitud. En caso de que la solicitud contenga encabezados con un tamaño total superior al límite especificado, Apigee arroja 431 Request Header Fields Too Large de acuerdo con las siguientes especificaciones de RFC:

Especificación
RFC 6585, sección 5: Campos de encabezado de solicitud demasiado grandes

Si aún necesitas asistencia de la asistencia de Apigee, consulta Debes recopilar información de diagnóstico.

Se debe recopilar información de diagnóstico

Recopila la siguiente información de diagnóstico y, luego, comunícate con el equipo de asistencia de Apigee Edge:

Si eres un usuario de la nube pública, proporciona la siguiente información:

• Nombre de la organización
• Nombre del entorno
• Nombre del proxy de API
• Completa el comando curl que se usa para reproducir el error 431.
• Archivo de seguimiento para las solicitudes a la API

Si eres un usuario de la nube privada, proporciona la siguiente información:

• Mensaje de error completo observado para las solicitudes con errores
• Nombre de la organización
• Nombre del entorno
• Paquete de proxy de API
• Archivo de seguimiento de las solicitudes a la API fallidas
• Completa el comando curl que se usa para reproducir el error 431.

• Registros de acceso de NGINX/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Dónde: Se reemplazan ORG, ENV y PORT# por valores reales.

• Registros del sistema del procesador de mensajes /opt/apigee/var/log/edge-message-processor/logs/system.log