500 Errore interno del server - BadFormData

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Sintomo

L'applicazione client riceve un codice di stato HTTP 500 Internal Server Error con il codice di errore protocol.http.BadFormData come risposta per le chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 500 Internal Server Error

Inoltre, potresti visualizzare il seguente messaggio di errore:

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

Dati modulo

Prima di entrare nei dettagli della risoluzione di questo problema, vediamo cosa sono i dati dei moduli.

I dati del modulo sono le informazioni fornite dall'utente in genere tramite un modulo HTML con elementi come una casella di immissione di testo, un pulsante o una casella di controllo. I dati del modulo vengono generalmente inviati come una serie di coppie chiave-valore all'interno di richieste o risposte HTTP.

Trasmissione dati modulo

1. Tipo di contenuti: application/x-www-form-urlcoded
   • Se le dimensioni dei dati del modulo sono ridotte, i dati vengono inviati come coppie chiave-valore con:
     • I caratteri in entrambe le chiavi sono codificati secondo le regole spiegate in Moduli - Sezione 17.13.4.1
     • L'intestazione Content-Type: application/x-www-form-urlencoded

     Esempio di richiesta con i dati del modulo:

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

   • Tutti i caratteri non alfanumerici in chiavi e valori sono con codifica in percentuale, ovvero sono rappresentati come terzine di caratteri %HH, composte da un segno percentuale seguito da due cifre esadecimali che rappresentano il codice ASCII del carattere specifico.
   • Di conseguenza, anche se il segno percentuale (%) è consentito nei dati del modulo, viene interpretato come l'inizio di una sequenza di escape speciale. Pertanto, se i dati del modulo devono contenere il segno percentuale (%) nella chiave o nel valore, devono essere trasmessi come %25, , che rappresenta il codice ASCII per il carattere del segno percentuale (%).
2. Tipo di contenuto: multipart/form-data

   Se vuoi trasmettere grandi quantità di dati binari o testo contenente caratteri non ASCII, puoi inviare i dati con Content-Type: multipart/form-data come spiegato in Moduli - Sezione 17.13.4.2

Possibili cause

Questo errore si verifica solo se vengono soddisfatte tutte le seguenti condizioni:

1. La richiesta HTTP inviata dal client ad Apigee Edge contiene:
   1. Content-Type: application/x-www-form-urlencoded e
   2. Dati del modulo con il segno percentuale (%) o il segno percentuale (%) seguito da caratteri esadecimali non validi non consentiti in base a Moduli - Sezione 17.13.4.1.

2. Il proxy API in Apigee Edge legge i parametri specifici del modulo contenenti caratteri che non possono essere utilizzati nel flusso di richiesta mediante il criterio ExtractVariables o MigrateMessage.

   Ad esempio, se i dati del modulo contengono il segno percentuale (%) così com'è (senza codifica) o il segno percentuale (%) seguito da caratteri esadecimali non validi nella chiave e/o nel valore, viene visualizzato questo errore.

   Di seguito sono riportate le possibili cause di questo errore:

   Causa	Descrizione	Istruzioni per la risoluzione dei problemi applicabili a
   I parametri modulo nella richiesta contengono caratteri non consentiti	I parametri del modulo passati come parte della richiesta HTTP dal client contengono tutti i caratteri che non è consentito utilizzare.	Utenti di cloud pubblico e privato perimetrale

Passaggi di diagnosi più comuni

Utilizza uno dei seguenti strumenti/tecniche per diagnosticare questo errore:

Causa: i parametri del modulo nella richiesta contengono caratteri non consentiti

Diagnostica

1. Determina il codice di errore, l'origine del errore e il criterio di errore per 500 Internal Server Error utilizzando il monitoraggio delle API, lo strumento Trace o i log degli accessi NGINX come spiegato nella sezione Passaggi comuni di diagnosi.
2. Se il Codice di errore è protocol.http.BadFormData, Origine errore ha il valore proxy o policy e il Criterio di errore non è vuoto, significa che il criterio specificato in Criterio di errore non è riuscito durante la lettura o l'estrazione dei dati del modulo (parametri del modulo).
3. Esamina le norme indicate nelle Norme relative ai guasti e determina le seguenti informazioni:
   1. Origine: determina se il criterio legge o estrae i dati dalla richiesta o dalla risposta.
   2. Parametri modulo: determinano i parametri specifici del modulo che vengono letti nel criterio.

      Esempio 1

      Esempio 1: criterio ExtractVariables che estrae i parametri modulo:

            <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>
            

      Nella norma ExtractVariables sopra riportata:

      • Fonte: request

        Questo è indicato dall'elemento <Source>

      • Parametri modulo: username e password

        Ciò è indicato dall'elemento <Pattern> all'interno dell'elemento <FormParam>

      Indica che i parametri del modulo username e/o password passati come parte della richiesta HTTP dal client ad Apigee Edge contengono caratteri che non è consentito utilizzare.

      Esempio 2

      Esempio 2: criterio di AssegnaMessage che copia i parametri del modulo:

            <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>
            

      Nella norma ExtractVariables sopra riportata:

      • Origine: request

        Ciò è indicato dall'attributo source nell'elemento <Copy>

      • Parametri modulo: username e password

        Ciò è indicato dall'attributo name nell'elemento <FormParam>

      Ciò indica che i parametri del modulo username o password o entrambi passati come parte della richiesta HTTP dal client ad Apigee Edge contengono caratteri che non possono essere utilizzati.

4. Verifica se sono presenti caratteri non consentiti da utilizzare nei parametri del modulo identificati nel passaggio 3 utilizzando uno dei seguenti metodi:

   Strumento Traccia

   Per eseguire la convalida utilizzando lo strumento Trace:

   1. Se hai acquisito la traccia per la richiesta non riuscita come spiegato nei passaggi di diagnostica comuni, seleziona una delle richieste con esito negativo.
   2. Se hai stabilito che i parametri del modulo contenenti caratteri che non possono essere utilizzati fanno parte della richiesta HTTP nel passaggio 3 riportato sopra, allora
      1. Vai alla fase Richiesta ricevuta dal client.

      2. Scorri verso il basso fino alla sezione Dettagli fase ed esamina la sezione Richiedi contenuti.

         ( visualizza immagine ingrandita)

         
      3. Nell'esempio riportato sopra, tieni presente che il parametro di modulo password contiene il segno di percentuale (%).
      4. Poiché il segno percentuale (%) viene utilizzato anche per la codifica percentuale dei caratteri speciali, non può essere utilizzato così come è nei dati del modulo.
      5. Di conseguenza, Apigee Edge risponde con 500 Internal Server Error con il codice di errore protocol.http.BadFormData.

   Richiesta effettiva

   Per eseguire la convalida utilizzando la richiesta effettiva:

   1. Se non hai accesso alla richiesta effettiva inviata al server di destinazione, vai a Risoluzione.
   2. Se hai accesso alla richiesta effettiva effettuata ad Apigee Edge, esegui questi passaggi:
      1. Esamina i contenuti dei dati del modulo e controlla se contengono caratteri che non è possibile utilizzare, ad esempio il segno percentuale (%) o il segno percentuale (%) seguito da caratteri esadecimali non validi.

         Esempio 1

         Richiesta di esempio n. 1: dati del modulo come parte della richiesta

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

         In questo esempio, tieni presente che l'elemento client_secret contiene il segno di percentuale (%) seguito da caratteri esadecimali non validi ZY.

         Esempio 2

         Richiesta di esempio n. 2: dati del modulo passati in un file:

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

         Contenuti di form_data.xml:

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

         In questo esempio, tieni presente che l'elemento password contiene il segno percentuale (%), che non deve essere passato così com'è nei dati del modulo.

   3. Nei due esempi precedenti, i dati del modulo inviati come parte della richiesta HTTP ad Apigee Edge contengono caratteri che non è consentito utilizzare.
   4. Di conseguenza, Apigee Edge risponde con 500 Internal Server Error con il codice di errore protocol.http.BadFormData.

Risoluzione

1. Assicurati che tutti i caratteri speciali nelle chiavi e nei valori dei dati del modulo o dei parametri inviati come parte della richiesta HTTP dal client siano sempre codificati come spiegato in Dati del modulo - application/x-www-form-urlcoded.
2. Per gli esempi illustrati sopra, puoi risolvere i problemi nel seguente modo:

   Esempio 1

   Esempio n. 1: dati del modulo trasmessi come parte della richiesta:

   Utilizza caratteri esadecimali validi corrispondenti al codice ASCII per un carattere specifico. Ad esempio, se vuoi inviare il simbolo del dollaro ($), usa %24 come mostrato di seguito:

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

   Esempio 2

   Richiesta di esempio n. 2: dati del modulo passati in un file:

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

   Contenuti di form_data.xml:

   Utilizza la codifica percentuale per il segno percentuale (%), ovvero modifica il file in modo che abbia %25 come mostrato di seguito:

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

Specifiche

Apigee Edge si aspetta che i dati del modulo vengano inviati in base alle seguenti specifiche:

Specifiche
Dati del modulo - application/x-www-form-urlcoded

Se hai ancora bisogno di aiuto dall'Assistenza Apigee, vai a Devi raccogliere informazioni diagnostiche.

Devi raccogliere dati diagnostici

Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, raccogli le seguenti informazioni diagnostiche e contatta l'assistenza Apigee Edge:

Se sei un utente del cloud pubblico, fornisci le seguenti informazioni:

• Nome dell'organizzazione.
• Nome ambiente
• Nome proxy API
• Comando curl completo utilizzato per riprodurre 500 Internal Server Error con il codice di errore protocol.http.BadFormData
• File di traccia per le richieste API

Se sei un utente Private Cloud, fornisci le seguenti informazioni:

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome ambiente
• Bundle di proxy API
• File di traccia per le richieste API

• Log degli accessi NGINX

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

  Dove: ORG, ENV e PORT# vengono sostituiti con i valori effettivi.

• Log di sistema del processore di messaggi

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

Riferimenti

• Tipi di contenuti del modulo
• RFC3986, sezione 2.1: codifica percentuale
• Codifica percentuale
• Caratteri esadecimali