Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Riferimento all'errore dei criteri

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Policy AccessControl

Questa sezione descrive i codici e i messaggi di errore restituiti, nonché le variabili di errore impostate da Edge quando questo criterio attiva un errore. È importante sapere se stai sviluppando regole di errore per per gestire gli errori. Per saperne di più, consulta Cosa devi sapere sugli errori relativi ai criteri e sulla gestione di errore.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`accesscontrol.IPDeniedAccess`	403	L'indirizzo IP del client o un indirizzo IP passato nella richiesta API, corrisponda a un indirizzo IP specificato nell'elemento `<SourceAddress>` in l'elemento `<MatchRule>` del criterio di controllo dell'accesso e l'attributo `action` del L'elemento `<MatchRule>` è impostato su `DENY`.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, consulta Variabili specifiche per gli errori dei criteri.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "IPDeniedAccess"`
`acl.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`acl.AC-AllowAccess.failed = true`

Esempio di risposta all'errore

Nota: per la gestione dei guasti, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring perché potrebbe cambiare.

{
   "fault":{
     "faultstring":"Access Denied for client ip : 52.211.243.3"
      "detail":{
         "errorcode":"accesscontrol.IPDeniedAccess"
      }
   }
}

Esempio di regola di errore

<FaultRule name="IPDeniedAccess">
    <Step>
        <Name>AM-IPDeniedAccess</Name>
        <Condition>(fault.name Matches "IPDeniedAccess") </Condition>
    </Step>
    <Condition>(acl.failed = true) </Condition>
</FaultRule>

Policy AccessEntity

Per informazioni correlate, consulta Informazioni importanti sugli errori delle norme e Gestire gli errori.

Errori di runtime

Nessuno.

Errori di deployment

Nome dell'errore	Stringa di errore	Stato HTTP	Si verifica quando
`InvalidEntityType`	`Invalid type [entity_type] in ACCESSENTITYStepDefinition [policy_name]`	N/D	Il tipo di entità utilizzato deve essere uno dei tipi supportati.

Policy AssignMessage

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore Stato HTTP Causa Correggi

steps.assignmessage.SetVariableFailed 500 Il criterio non è stato in grado di impostare una variabile. Controlla la stringa di errore per il nome del non risolta.

Codice di errore	Stato HTTP	Causa
`steps.assignmessage.SetVariableFailed`	500	Il criterio non è stato in grado di impostare una variabile. Controlla la stringa di errore per il nome del non risolta.
`steps.assignmessage.VariableOfNonMsgType`	500	Questo errore si verifica se l'attributo `source` nell'elemento `<Copy>` è impostato su una variabile che non è di tipo message. Le variabili del tipo di messaggio rappresentano intere richieste e risposte HTTP. Il dispositivo Edge integrato le variabili di flusso `request`, `response` e `message` sono di tipo message. Per scoprire di più sulle variabili dei messaggi, consulta Riferimento per le variabili.
`steps.assignmessage.UnresolvedVariable`	500	Questo errore si verifica se una variabile specificata nel criterio Assegna messaggio è: fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o non può essere risolto (non è definito)

steps.assignmessage.VariableOfNonMsgType

500

Questo errore si verifica se l'attributo source nell'elemento <Copy> è impostato su una variabile che non è di tipo message.

Le variabili del tipo di messaggio rappresentano intere richieste e risposte HTTP. Il dispositivo Edge integrato le variabili di flusso request, response e message sono di tipo message. Per scoprire di più sulle variabili dei messaggi, consulta Riferimento per le variabili.

steps.assignmessage.UnresolvedVariable

500

Questo errore si verifica se una variabile specificata nel criterio Assegna messaggio è:

fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio)
non può essere risolto (non è definito)

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidIndex`	Se l'indice specificato negli elementi `<Copy>` e/o `<Remove>` della sezione Assegna messaggio è 0 o un numero negativo, il deployment del proxy API non va a buon fine.
`InvalidVariableName`	Se l'elemento secondario `<Name>` è vuoto o non specificato nell'elemento `<AssignVariable>`, il deployment del proxy API non riesce perché non esiste un nome di variabile valido in a cui assegnare un valore. È richiesto un nome di variabile valido.
`InvalidPayload`	Un payload specificato nel criterio non è valido.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime. Per ulteriori informazioni, consulta Cosa che devi conoscere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "UnresolvedVariable"`
`assignmessage.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`assignmessage.AM-SetResponse.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.assignmessage.VariableOfNonMsgType"
      },
      "faultstring":"AssignMessage[AM-SetResponse]: value of variable is not of type Message"
   }
}

Esempio di regola di errore

    <FaultRule name="Assign Message Faults">    <Step>
        <Name>AM-CustomNonMessageTypeErrorResponse</Name>
        <Condition>(fault.name Matches "VariableOfNonMsgType") </Condition>
    </Step>
    <Step>
        <Name>AM-CustomSetVariableErrorResponse</Name>
        <Condition>(fault.name = "SetVariableFailed")</Condition>
    </Step>
    <Condition>(assignmessage.failed = true) </Condition>
</FaultRule>

Policy BasicAuthentication

Questa sezione descrive i codici e i messaggi di errore restituiti, nonché le variabili di errore impostate da Edge quando questo criterio attiva un errore. È importante sapere se stai sviluppando regole di errore per e gestire gli errori. Per saperne di più, consulta Cosa devi sapere sugli errori relativi ai criteri e sulla gestione di errore.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.basicauthentication.InvalidBasicAuthenticationSource`	500	Su una decodifica quando la stringa codificata Base64 in arrivo non contiene un valore valido o il formato dell'intestazione non è valido (ad es. non inizia con "Base").
`steps.basicauthentication.UnresolvedVariable`	500	Le variabili di origine richieste per la decodifica o l'encode non sono presenti. Questo errore può si verificano solo se `IgnoreUnresolvedVariables` è false.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Si verifica quando	Correggi
`UserNameRequired`	L'elemento `<User>` deve essere presente per l'operazione denominata.
`PasswordRequired`	L'elemento `<Password>` deve essere presente per l'operazione denominata.
`AssignToRequired`	L'elemento `<AssignTo>` deve essere presente per l'operazione denominata.
`SourceRequired`	L'elemento `<Source>` deve essere presente per l'operazione denominata.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "UnresolvedVariable"`
`BasicAuthentication.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`BasicAuthentication.BA-Authenticate.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.basicauthentication.UnresolvedVariable"
      },
      "faultstring":"Unresolved variable : request.queryparam.password"
   }
}

Esempio di regola di errore

<FaultRule name="Basic Authentication Faults">
    <Step>
        <Name>AM-UnresolvedVariable</Name>
        <Condition>(fault.name Matches "UnresolvedVariable") </Condition>
    </Step>
    <Step>
        <Name>AM-AuthFailedResponse</Name>
        <Condition>(fault.name = "InvalidBasicAuthenticationSource")</Condition>
    </Step>
    <Condition>(BasicAuthentication.BA-Authentication.failed = true) </Condition>
</FaultRule>

Policy ConcurrentRateLimit

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle errors. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code HTTP status Occurs when

Fault code	HTTP status	Occurs when
`policies.concurrentratelimit.ConcurrentRatelimtViolation`	503	ConcurrentRatelimit connection exceeded. Connection limit : {0} Note: The Fault code shown on the left is correct, although it contains a misspelling ("limt"). Be sure to use the code exactly as shown here when creating fault rules to trap this error.

policies.concurrentratelimit.ConcurrentRatelimtViolation

503

ConcurrentRatelimit connection exceeded. Connection limit : {0}

Note: The Fault code shown on the left is correct, although it contains a misspelling ("limt"). Be sure to use the code exactly as shown here when creating fault rules to trap this error.

Deployment errors

Error name	Occurs when
`InvalidCountValue`	ConcurrentRatelimit invalid count value specified.
`ConcurrentRatelimitStepAttachment\ NotAllowedAtProxyEndpoint`	Concurrent Ratelimit policy {0} attachment is not allowed at proxy request/response/fault paths. This policy must be placed on the Target Endpoint.
`ConcurrentRatelimitStepAttachment\ MissingAtTargetEndpoint`	Concurrent Ratelimit policy {0} attachment is missing at target request/response/fault paths. This policy must be placed in the Target Request Preflow, Target Response Postflow, and DefaultFaultRule.
`InvalidTTLForMessageTimeOut`	ConcurrentRatelimit invalid ttl value specified for message timeout. It must be a positive integer.

Fault variables

These variables are set when this policy triggers an error. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the Runtime errors table above. The fault name is the last part of the fault code.	`fault.name Matches "ConcurrentRatelimtViolation"` Note: The Error code shown in the example is correct, although it contains a misspelling ("limt"). Please be sure to use the code exactly as shown here when creating fault rules to trap this error.
`concurrentratelimit.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`concurrentratelimit.CRL-RateLimitPolicy.failed = true`

Example error response

If the rate limit is exceeded, the policy returns only an HTTP status 503 to the client.

Example fault rule

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "ConcurrentRatelimtViolation") </Condition>
        </Step>
        <Condition>concurrentratelimit.CRL-RateLimitPolicy.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy DecodeJWS

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Occurs when
`steps.jws.FailedToDecode`	401	The policy was unable to decode the JWS. The JWS is possibly corrupted.
`steps.jws.FailedToResolveVariable`	401	Occurs when the flow variable specified in the `<Source>` element of the policy does not exist.
`steps.jws.InvalidClaim`	401	For a missing claim or claim mismatch, or a missing header or header mismatch.
`steps.jws.InvalidJsonFormat`	401	Invalid JSON found in the JWS header.
`steps.jws.InvalidJws`	401	This error occurs when the JWS signature verification fails.
`steps.jws.InvalidPayload`	401	The JWS payload is invalid.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` is omitted and the JWS has a detached content payload.
`steps.jws.MissingPayload`	401	The JWS payload is missing.
`steps.jws.NoAlgorithmFoundInHeader`	401	Occurs when the JWS omits the algorithm header.
`steps.jws.UnknownException`	401	An unknown exception occurred.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name Occurs when

InvalidAlgorithm The only valid values are: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

Error name	Occurs when
`InvalidAlgorithm`	The only valid values are: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.
`EmptyElementForKeyConfiguration` `FailedToResolveVariable` `InvalidConfigurationForActionAndAlgorithmFamily` `InvalidConfigurationForVerify` `InvalidEmptyElement` `InvalidFamiliesForAlgorithm` `InvalidKeyConfiguration` `InvalidNameForAdditionalClaim` `InvalidNameForAdditionalHeader` `InvalidPublicKeyId` `InvalidPublicKeyValue` `InvalidSecretInConfig` `InvalidTypeForAdditionalClaim` `InvalidTypeForAdditionalHeader` `InvalidValueForElement` `InvalidValueOfArrayAttribute` `InvalidVariableNameForSecret` `MissingConfigurationElement` `MissingElementForKeyConfiguration` `MissingNameForAdditionalClaim` `MissingNameForAdditionalHeader`	Other possible deployment errors.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Other possible deployment errors.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, consulta Informazioni importanti sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come indicato nella tabella Errori di runtime sopra. Il nome dell'errore è l'ultima parte del codice dell'errore.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tutti i criteri JWS impostano la stessa variabile in caso di errore.	`jws.JWS-Policy.failed = true`

Esempio di risposta di errore

Per la gestione degli errori, la best practice è intercettare la parte errorcode della risposta all'errore. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy DecodeJWT

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause
`steps.jwt.FailedToDecode`	401	Occurs when the policy is unable to decode the JWT. The JWT may be malformed, invalid or otherwise not decodable.
`steps.jwt.FailedToResolveVariable`	401	Occurs when the flow variable specified in the `<Source>` element of the policy does not exist.
`steps.jwt.InvalidToken`	401	Occurs when the flow variable specified in the `<Source>` element of the policy is out of scope or can't be resolved.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidEmptyElement`	Occurs when the flow variable containing the JWT to be decoded is not specified in the `<Source>` element of the policy.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tutti i criteri JWT impostano la stessa variabile in caso di errore.	`JWT.failed = true`

Esempio di risposta di errore

Codici di errore dei criteri JWT

Per la gestione degli errori, la best practice è il trap della parte errorcode dell'errore la risposta corretta. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

Policy ExtractVariables

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.extractvariables.ExecutionFailed`	500	Questo errore si verifica quando: Il payload di input (JSON, XML) è vuoto. L'input (JSON, XML e così via) trasmesso al criterio non è valido o è in un formato non corretto.
`steps.extractvariables.ImmutableVariable`	500	Una variabile utilizzata nel criterio è immutabile. Il criterio non è stato in grado di impostare questa impostazione .
`steps.extractvariables.InvalidJSONPath`	500	Questo errore si verifica se viene utilizzato un percorso JSON non valido nell'elemento `JSONPath` della . Ad esempio, se un payload JSON non include l'oggetto `Name`, ma specifichi `Name` come percorso nel criterio, si verifica questo errore.
`steps.extractvariables.JsonPathParsingFailure`	500	Questo errore si verifica quando il criterio non è in grado di analizzare un percorso JSON e Estrai i dati dalla variabile di flusso specificata nell'elemento `Source`. In genere questo si verifica se la variabile di flusso specificata nell'elemento `Source` non esiste nell'elemento attuale flusso di lavoro.
`steps.extractvariables.SetVariableFailed`	500	Questo errore si verifica se il criterio non può impostare il valore su una variabile. In genere l'errore si verifica quando tenti di assegnare valori a più variabili i cui nomi iniziano con le stesse parole in un formato nidificato separato da punti.
`steps.extractvariables.SourceMessageNotAvailable`	500	Questo errore si verifica se il messaggio specificata nell'elemento `Source` del criterio è: Fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o Impossibile risolvere (non è definito)
`steps.extractvariables.UnableToCast`	500	Questo errore si verifica se il criterio non è riuscito a trasmettere i contenuti estratti a una variabile. In genere ciò si verifica se tenti di impostare il valore da un tipo di dati a una variabile di un altro tipo.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`NothingToExtract`	Se il criterio non include gli elementi `URIPath`, `QueryParam`, `Header`, `FormParam`, `XMLPayload` o `JSONPayload`, la distribuzione del proxy API ha esito negativo perché non c'è nulla da estrarre.
`NONEmptyPrefixMappedToEmptyURI`	Questo errore si verifica se il criterio ha un prefisso definito nel L'elemento `Namespace` sotto l'elemento `XMLPayload`, ma nessun URI è definito.
`DuplicatePrefix`	Questo errore si verifica se il criterio ha lo stesso prefisso definito più di una volta nell'elemento `Namespace` sotto l'elemento `XMLPayload`.
`NoXPathsToEvaluate`	Se il criterio non include l'elemento `XPath` all'interno della sezione `XMLPayload`, il deployment del proxy API non va a buon fine e restituisce questo errore. Se vuoi estrarre variabili da un payload XML, È necessario specificare `XPath` elemento secondario.
`EmptyXPathExpression`	Se il criterio ha un'espressione `XPath` vuota all'interno di `XMLPayload` , il deployment del proxy API non va a buon fine.
`NoJSONPathsToEvaluate`	Se il criterio non include l'elemento `JSONPath` all'interno della sezione `JSONPayload`, il deployment del proxy API non va a buon fine e restituisce questo errore.
`EmptyJSONPathExpression`	Se il criterio ha un'espressione `XPath` vuota all'interno della sezione `XMLPayload`, il deployment del proxy API non va a buon fine.
`MissingName`	Se il criterio non ha l'attributo `name` in nessuno dei criteri elementi come `QueryParam`, `Header`, `FormParam` o `Variable`, dove richiesto, il deployment del proxy API non va a buon fine.
`PatternWithoutVariable`	Se il criterio non ha una variabile specificata all'interno dell'elemento `Pattern`, il deployment del proxy API non va a buon fine. L'elemento `Pattern` richiede il nome di la variabile in cui verranno archiviati i dati estratti.
`CannotBeConvertedToNodeset`	Se il criterio ha un'espressione `XPath` in cui il tipo `Variable` è definito come nodeset, ma l'espressione non può essere convertita in set di nodi, il deployment del proxy API non va a buon fine.
`JSONPathCompilationFailed`	Il criterio non può compilare un percorso JSON specificato.
`InstantiationFailed`	Impossibile creare un'istanza del criterio.
`XPathCompilationFailed`	Se il prefisso o il valore utilizzato nell'elemento `XPath` non fa parte di nessuno degli gli spazi dei nomi dichiarati nel criterio, il deployment del proxy API non riesce.
`InvalidPattern`	Se la definizione dell'elemento `Pattern` non è valida in uno qualsiasi degli elementi come `URIPath`, `QueryParam`, `Header`, `FormParam` e `XMLPayload` o `JSONPayload` all'interno del criterio, il deployment Il proxy API non funziona. L'elemento `Pattern` non è considerato valido se non include una variabile. Per ulteriori informazioni sulla corrispondenza di pattern, consulta Informazioni sulla corrispondenza e sulla creazione di variabili.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime. Per ulteriori informazioni, consulta Cosa che devi conoscere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "SourceMessageNotAvailable"`
`extractvariables.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`extractvariables.EV-ParseJsonResponse.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
   "fault":{
      "detail":{
         "errorcode":"steps.extractvariables.SourceMessageNotAvailable"
      },
      "faultstring":"request message is not available for ExtractVariable: EV-ParseJsonResponse"
   }
}

Esempio di regola di errore

<FaultRule name="Extract Variable Faults">
    <Step>
        <Name>AM-CustomErrorMessage</Name>
        <Condition>(fault.name = "SourceMessageNotAvailable") </Condition>
    </Step>
    <Condition>(extractvariables.EM-ParseJsonResponse.failed = true) </Condition>
</FaultRule>

Policy GenerateJWS

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per la gestione degli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Si verifica quando
`steps.jws.GenerationFailed`	401	Il criterio non è stato in grado di generare il JWS.
`steps.jws.InsufficientKeyLength`	401	Per una chiave di dimensioni inferiori a 32 byte per l'algoritmo HS256
`steps.jws.InvalidClaim`	401	Per una rivendicazione mancante o mancata corrispondenza di una rivendicazione oppure una mancata corrispondenza di intestazione o intestazione.
`steps.jws.InvalidCurve`	401	La curva specificata dalla chiave non è valida per l'algoritmo Curva ellittica.
`steps.jws.InvalidJsonFormat`	401	JSON non valido trovato nell'intestazione JWS.
`steps.jws.InvalidPayload`	401	Il payload JWS non è valido.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` viene omesso e il JWS ha un payload di contenuti scollegato.
`steps.jws.KeyIdMissing`	401	Il criterio di verifica utilizza un JWKS come origine per le chiavi pubbliche, ma il JWS firmato non include una proprietà `kid` nell'intestazione.
`steps.jws.KeyParsingFailed`	401	Impossibile analizzare la chiave pubblica a partire dalle informazioni sulla chiave specificate.
`steps.jws.MissingPayload`	401	Payload JWS mancante.
`steps.jws.NoAlgorithmFoundInHeader`	401	Si verifica quando il JWS omette l'intestazione dell'algoritmo.
`steps.jws.SigningFailed`	401	In CreateJWS, per una chiave inferiore alla dimensione minima per gli algoritmi HS384 o HS512
`steps.jws.UnknownException`	401	Si è verificata un'eccezione sconosciuta.
`steps.jws.WrongKeyType`	401	Tipo di chiave specificato errato. Ad esempio, se specifichi una chiave RSA per un algoritmo Elliptic Curve o una chiave curva per un algoritmo RSA.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore Si verifica quando

InvalidAlgorithm Gli unici valori validi sono: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

Nome errore	Si verifica quando
`InvalidAlgorithm`	Gli unici valori validi sono: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.
`EmptyElementForKeyConfiguration` `FailedToResolveVariable` `InvalidConfigurationForActionAndAlgorithmFamily` `InvalidConfigurationForVerify` `InvalidEmptyElement` `InvalidFamiliesForAlgorithm` `InvalidKeyConfiguration` `InvalidNameForAdditionalClaim` `InvalidNameForAdditionalHeader` `InvalidPublicKeyId` `InvalidPublicKeyValue` `InvalidSecretInConfig` `InvalidTypeForAdditionalClaim` `InvalidTypeForAdditionalHeader` `InvalidValueForElement` `InvalidValueOfArrayAttribute` `InvalidVariableNameForSecret` `MissingConfigurationElement` `MissingElementForKeyConfiguration` `MissingNameForAdditionalClaim` `MissingNameForAdditionalHeader`	Altri possibili errori di deployment.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Altri possibili errori di deployment.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, consulta Informazioni importanti sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come indicato nella tabella Errori di runtime sopra. Il nome dell'errore è l'ultima parte del codice dell'errore.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tutti i criteri JWS impostano la stessa variabile in caso di errore.	`jws.JWS-Policy.failed = true`

Esempio di risposta di errore

Per la gestione degli errori, la best practice è intercettare la parte errorcode della risposta all'errore. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy GenerateJWT

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Occurs when
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	Occurs when the verification policy has multiple algorithms.
`steps.jwt.AlgorithmMismatch`	401	The algorithm specified in the Generate policy did not match the one expected in the Verify policy. The algorithms specified must match.
`steps.jwt.FailedToDecode`	401	The policy was unable to decode the JWT. The JWT is possibly corrupted.
`steps.jwt.GenerationFailed`	401	The policy was unable to generate the JWT.
`steps.jwt.InsufficientKeyLength`	401	For a key less than 32 bytes for the HS256 algorithm, less than 48 bytes for the HS386 algortithm, and less than 64 bytes for the HS512 algorithm.
`steps.jwt.InvalidClaim`	401	For a missing claim or claim mismatch, or a missing header or header mismatch.
`steps.jwt.InvalidCurve`	401	The curve specified by the key is not valid for the Elliptic Curve algorithm.
`steps.jwt.InvalidJsonFormat`	401	Invalid JSON found in the header or payload.
`steps.jwt.InvalidToken`	401	This error occurs when the JWT signature verification fails.
`steps.jwt.JwtAudienceMismatch`	401	The audience claim failed on token verification.
`steps.jwt.JwtIssuerMismatch`	401	The issuer claim failed on token verification.
`steps.jwt.JwtSubjectMismatch`	401	The subject claim failed on token verification.
`steps.jwt.KeyIdMissing`	401	The Verify policy uses a JWKS as a source for public keys, but the signed JWT does not include a `kid` property in the header.
`steps.jwt.KeyParsingFailed`	401	The public key could not be parsed from the given key information.
`steps.jwt.NoAlgorithmFoundInHeader`	401	Occurs when the JWT contains no algorithm header.
`steps.jwt.NoMatchingPublicKey`	401	The Verify policy uses a JWKS as a source for public keys, but the `kid` in the signed JWT is not listed in the JWKS.
`steps.jwt.SigningFailed`	401	In GenerateJWT, for a key less than the minimum size for the HS384 or HS512 algorithms
`steps.jwt.TokenExpired`	401	The policy attempts to verify an expired token.
`steps.jwt.TokenNotYetValid`	401	The token is not yet valid.
`steps.jwt.UnhandledCriticalHeader`	401	A header found by the Verify JWT policy in the `crit` header is not listed in `KnownHeaders`.
`steps.jwt.UnknownException`	401	An unknown exception occurred.
`steps.jwt.WrongKeyType`	401	Wrong type of key specified. For example, if you specify an RSA key for an Elliptic Curve algorithm, or a curve key for an RSA algorithm.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidNameForAdditionalClaim`	The deployment will fail if the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is one of the following registered names: `kid`, `iss`, `sub`, `aud`, `iat`, `exp`, `nbf`, or `jti`.
`InvalidTypeForAdditionalClaim`	If the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is not of type `string`, `number`, `boolean`, or `map`, the deployment will fail.
`MissingNameForAdditionalClaim`	If the name of the claim is not specified in the child element `<Claim>` of the `<AdditionalClaims>` element, the deployment will fail.
`InvalidNameForAdditionalHeader`	This error ccurs when the name of the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is either `alg` or `typ`.
`InvalidTypeForAdditionalHeader`	If the type of claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is not of type `string`, `number`, `boolean`, or `map`, the deployment will fail.
`InvalidValueOfArrayAttribute`	This error occurs when the value of the array attribute in the child element `<Claim>` of the `<AdditionalClaims>` element is not set to `true` or `false`.
`InvalidConfigurationForActionAndAlgorithm`	If the `<PrivateKey>` element is used with HS Family algorithms or the `<SecretKey>` element is used with RSA Family algorithms, the deployment will fail.
`InvalidValueForElement`	If the value specified in the `<Algorithm>` element is not a supported value, the deployment will fail.
`MissingConfigurationElement`	This error will occur if the `<PrivateKey>` element is not used with RSA family algorithms or the `<SecretKey>` element is not used with HS Family algorithms.
`InvalidKeyConfiguration`	If the child element `<Value>` is not defined in the `<PrivateKey>` or `<SecretKey>` elements, the deployment will fail.
`EmptyElementForKeyConfiguration`	If the ref attribute of the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements is empty or unspecified, the deployment will fail.
`InvalidVariableNameForSecret`	This error occurs if the flow variable name specified in the ref attribute of the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements does not contain the private prefix `(private.)`.
`InvalidSecretInConfig`	This error occurs if the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements does not contain the private prefix `(private.)`.
`InvalidTimeFormat`	If the value specified in the`<NotBefore>` element does not use a supported format, the deployment will fail.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tutti i criteri JWT impostano la stessa variabile in caso di errore.	`JWT.failed = true`

Esempio di risposta di errore

Codici di errore dei criteri JWT

Per la gestione degli errori, la best practice è il trap della parte errorcode dell'errore la risposta corretta. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

Policy JavaCallout

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.javacallout.ExecutionError`	500	Si verifica quando il codice Java genera un'eccezione o restituisce un valore nullo durante l'esecuzione di un criterio JavaCallout.

Errori di deployment

Questi errori possono verificarsi quando viene eseguito il deployment del proxy contenente il criterio.

Nome errore	Stringa errore	Stato HTTP	Si verifica quando
`ResourceDoesNotExist`	`Resource with name [name] and type [type] does not exist`	N/D	Il file specificato nell'elemento `<ResourceURL>` non esiste.
`JavaCalloutInstantiationFailed`	`Failed to instantiate the JavaCallout Class [classname]`	N/D	Il file della classe specificato nell'elemento `<ClassName>` non è in barattolo.
`IncompatibleJavaVersion`	`Failed to load java class [classname] definition due to - [reason]`	N/D	Vedi stringa errore. Vedi anche Contenuti supportati software e le versioni supportate.
`JavaClassNotFoundInJavaResource`	`Failed to find the ClassName in java resource [jar_name] - [class_name]`	N/D	Vedi stringa errore.
`JavaClassDefinitionNotFound`	`Failed to load java class [class_name] definition due to - [reason]`	N/D	Vedi stringa errore.
`NoAppropriateConstructor`	`No appropriate constructor found in JavaCallout class [class_name]`	N/D	Vedi stringa errore.
`NoResourceForURL`	`Could not locate a resource with URL [string]`	N/D	Vedi stringa errore.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "ExecutionError"`
`javacallout.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`javacallout.JC-GetUserData.failed = true`

Esempio di risposta di errore

{  
   "fault":{  
      "faultstring":"Failed to execute JavaCallout. [policy_name]",
      "detail":{  
         "errorcode":"javacallout.ExecutionError"
      }
   }
}

Esempio di regola di errore

<FaultRule name="JavaCalloutFailed">
    <Step>
        <Name>AM-JavaCalloutError</Name>
    </Step>
    <Condition>(fault.name Matches "ExecutionError") </Condition>
</FaultRule>

Policy JavaScript

Questa sezione descrive i codici e i messaggi di errore restituiti, nonché le variabili di errore. impostate da Edge quando questo criterio attiva un errore. È importante conoscere queste informazioni se stai sviluppando regole di errore per gestire gli errori. Per saperne di più, consulta Cosa devi sapere sugli errori relativi ai criteri e sulla gestione di errore.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.javascript.ScriptExecutionFailed`	500	Il criterio JavaScript può generare molti tipi diversi di errori ScriptExecutionFailed. Normalmente i tipi di errori riscontrati includono RangeError, ReferenceError, SyntaxError: TypeError e URIError.
`steps.javascript.ScriptExecutionFailedLineNumber`	500	Si è verificato un errore nel codice JavaScript. Consulta la stringa di errore per i dettagli.	N/D
`steps.javascript.ScriptSecurityError`	500	Si è verificato un errore di sicurezza durante l'esecuzione di JavaScript. Vedi la stringa di errore per i dettagli.	N/D

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidResourceUrlFormat`	Se il formato dell'URL della risorsa specificato nell'elemento `<ResourceURL>` o `<IncludeURL>` del criterio JavaScript non è valido, il deployment del proxy API non va a buon fine.
`InvalidResourceUrlReference`	Se gli elementi `<ResourceURL>` o `<IncludeURL>` fare riferimento a un file JavaScript che non esiste, il deployment del proxy API non va a buon fine. Il file di origine a cui viene fatto riferimento deve esistere a livello di organizzazione, proxy API o ambiente.
`WrongResourceType`	Questo errore si verifica durante il deployment se `<ResourceURL>` o `<IncludeURL>` del criterio JavaScript fanno riferimento a qualsiasi tipo di risorsa diverso da jsc (file JavaScript).
`NoResourceURLOrSource`	Il deployment del criterio JavaScript può non riuscire con questo errore se `<ResourceURL>` non viene dichiarato o l'URL della risorsa non è definito all'interno di questo elemento. L'elemento `<ResourceURL>` è obbligatorio. Oppure, l'elemento `<IncludeURL>` viene dichiarato ma l'URL della risorsa non è definito all'interno di questo elemento. L'elemento `<IncludeURL>` è facoltativo ma se dichiarato, l'URL della risorsa deve essere specificato all'interno dell'elemento `<IncludeURL>`.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime. Per ulteriori informazioni, consulta Cosa che devi conoscere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "ScriptExecutionFailed"`
`javascript.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`javascript.JavaScript-1.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "Execution of SetResponse failed with error: Javascript runtime error: "ReferenceError: "status" is not defined. (setresponse.js:6)\"",
    "detail": {
      "errorcode": "steps.javascript.ScriptExecutionFailed"
    }
  }
}

Esempio di regola di errore

<FaultRule name="JavaScript Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ScriptExecutionFailed") </Condition>
    </Step>
    <Condition>(javascript.JavaScript-1.failed = true) </Condition>
</FaultRule>

Policy JSONThreatProtection

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.jsonthreatprotection.ExecutionFailed`	500	Il criterio JSONThreatProtection può generare molti tipi diversi di errori ExecutionFailed. La maggior parte di questi errori si verifica quando viene superata una soglia specifica impostata nel criterio. Questi tipi di errori includono: lunghezza del nome dell'elemento, conteggio delle voci di oggetto, numero di elementi array, profondità del container, lunghezza valore stringa stringa. Questo errore si verifica anche quando il payload contiene un oggetto JSON non valido.
`steps.jsonthreatprotection.SourceUnavailable`	500	Questo errore si verifica se il messaggio specificata nell'elemento `<Source>` è: Fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) Non è uno dei valori validi `request`, `response`, o `message`
`steps.jsonthreatprotection.NonMessageVariable`	500	Questo errore si verifica se l'elemento `<Source>` è impostato su una variabile che non è di tipo messaggio.

Errori di deployment

Nessuno.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "SourceUnavailable"`
`jsonattack.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`jsonattack.JTP-SecureRequest.failed = true`

Esempio di risposta di errore

{
  "fault": {
    "faultstring": "JSONThreatProtection[JPT-SecureRequest]: Execution failed. reason: JSONThreatProtection[JTP-SecureRequest]: Exceeded object entry name length at line 2",
    "detail": {
      "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
    }
  }
}

Esempio di regola di errore

<FaultRule name="JSONThreatProtection Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ExecutionFailed") </Condition>
    </Step>
    <Condition>(jsonattack.JPT-SecureRequest.failed = true) </Condition>
</FaultRule>

I tipi di policy JSONThreatProtection definiscono i seguenti codici di errore:

Policy JSONtoXML

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.jsontoxml.ExecutionFailed`	500	Il payload di input (JSON) è vuoto oppure l'input (JSON) passato al criterio JSON-XML è non valido o in un formato non valido.
`steps.jsontoxml.InCompatibleTypes`	500	Questo errore si verifica se il tipo di variabile definita nell'elemento `<Source>` e L'elemento `<OutputVariable>` non sono uguali. È obbligatorio che il tipo variabili contenute negli elementi `<Source>` e `<OutputVariable>` corrispondenze. I tipi validi sono `message` e `string`.
`steps.jsontoxml.InvalidSourceType`	500	Questo errore si verifica se il tipo di variabile utilizzato per definire l'elemento `<Source>` non è valido. I tipi di variabili validi sono `message` e `string`.
`steps.jsontoxml.OutputVariableIsNotAvailable`	500	Questo errore si verifica se la variabile specificata nell'elemento `<Source>` del file JSON per Il criterio XML è di tipo stringa e l'elemento `<OutputVariable>` non è definito. L'elemento `<OutputVariable>` è obbligatorio quando la variabile definita in `<Source>` è obbligatorio è di tipo stringa.
`steps.jsontoxml.SourceUnavailable`	500	Questo errore si verifica se il messaggio specificata nell'elemento `<Source>` del criterio da JSON a XML è: fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o non può essere risolto (non è definito)

Errori di deployment

Nessuno.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "SourceUnavailable"`
`jsontoxml.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`jsontoxml.JSON-to-XML-1.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "JSONToXML[JSON-to-XML-1]: Source xyz is not available",
    "detail": {
      "errorcode": "steps.json2xml.SourceUnavailable"
    }
  }
}

Esempio di regola di errore

<FaultRule name="JSON To XML Faults">
    <Step>
        <Name>AM-SourceUnavailableMessage</Name>
        <Condition>(fault.name Matches "SourceUnavailable") </Condition>
    </Step>
    <Step>
        <Name>AM-BadJSON</Name>
        <Condition>(fault.name = "ExecutionFailed")</Condition>
    </Step>
    <Condition>(jsontoxml.JSON-to-XML-1.failed = true) </Condition>
</FaultRule>

Policy KeyValueMapOperations

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.keyvaluemapoperations.SetVariableFailed`	500	Questo errore si verifica se tenti di recuperare un valore da una mappa chiave-valore criptata e imposti il valore su una variabile il cui nome non ha il prefisso `private`. Il prefisso, necessario per motivi di sicurezza di base durante il debug, nasconde i valori criptati dalle sessioni di traccia e di debug del proxy API.
`steps.keyvaluemapoperations.UnsupportedOperationException`	500	Questo errore si verifica se l'attributo `mapIdentifier` è impostato sulla stringa vuota nel criterio Operazioni mappa chiave-valore.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidIndex`	Se l'attributo `index` specificato nell'elemento `<Get>` del criterio Operazioni mappa chiave-valore è zero o un numero negativo, il deployment del proxy API non va a buon fine. L'indice inizia da `1`, pertanto un indice pari a zero o un numero intero negativo viene considerato non valido.
`KeyIsMissing`	Questo errore si verifica se l'elemento `<Key>` è completamente mancante o se manca l'elemento `<Parameter>` all'interno dell'elemento `<Key>` sotto `<Entry>` dell'elemento `<InitialEntries>` del criterio Key Value Map Operations.
`ValueIsMissing`	Questo errore si verifica se l'elemento `<Value>` non è presente sotto l'elemento `<Entry>` dell'elemento `<InitialEntries>` del criterio Key Value Map Operations.

Policy LDAP

Questo criterio utilizza i seguenti codici di errore:

Codice di errore	Messaggio
`InvalidAttributeName`	`Invalid attribute name {0}.`
`InvalidSearchBase`	`Search base can not be empty.`
`InvalidValueForPassword`	`Invalid value for password field. It can not be empty.`
`InvalidSearchScope`	`Invalid scope {0}. Allowed scopes are {1}.`
`InvalidUserCredentials`	`Invalid user credentials.`
`InvalidExternalLdapReference`	`Invalid external ldap reference {0}.`
`LdapResourceNotFound`	`Ldap resource {0} not found.`
`BaseDNRequired`	`Base DN required.`
`OnlyReferenceOrValueIsAllowed`	`Only value or reference is allowed for {0}.`
`AttributesRequired`	`At least one attribute required for search action.`
`UserNameIsNull`	`User name is null.`
`SearchQueryAndUserNameCannotBePresent`	`Both search query and username can not be present in the authentication action. Please specify either one of them.`

Policy MessageLogging

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.messagelogging.StepDefinitionExecutionFailed`	500	Vedi stringa errore.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidProtocol`	Il deployment del criterio MessageLogging può non riuscire con questo errore se il protocollo specificato all'interno dell'elemento `<Protocol>` non è valido. I protocolli validi sono TCP e UDP. Per l'invio di messaggi syslog su TLS/SSL, è supportato solo TCP.
`InvalidPort`	Il deployment del criterio MessageLogging può non riuscire con questo errore se il numero di porta non è specificato nell'elemento `<Port>` o se non è valido. Il numero di porta deve essere un numero intero maggiore di zero.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "StepDefinitionExecutionFailed"`
`messagelogging.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`messagelogging.ML-LogMessages.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.messagelogging.StepDefinitionExecutionFailed"
      },
      "faultstring":"Execution failed"
   }
}

Esempio di regola di errore

<FaultRule name="MessageLogging">
    <Step>
        <Name>ML-LogMessages</Name>
        <Condition>(fault.name Matches "StepDefinitionExecutionFailed") </Condition>
    </Step>
    <Condition>(messagelogging.ML-LogMessages.failed = true) </Condition>
</FaultRule>

Policy OASValidation

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.oasvalidation.Failed`	500	Il corpo del messaggio della richiesta non può essere convalidato in base alla specifica OpenAPI fornita.
`steps.oasvalidation.SourceMessageNotAvailable`	500	La variabile specificata nell'elemento `<Source>` del criterio non rientra nell'ambito o non può essere risolta.
`steps.oasvalidation.NotMessageVariable`	500	L'elemento `<Source>` è impostato su una variabile non di tipo message.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa
`ResourceDoesNotExist`	La specifica OpenAPI a cui viene fatto riferimento nell'elemento `<OASResource>` non esiste.
`ResourceCompileFailed`	La specifica OpenAPI inclusa nel deployment contiene errori che ne impediscono la compilazione. In genere, ciò indica che la specifica non è una specifica OpenAPI 3.0 ben strutturata.
`BadResourceURL`	Impossibile elaborare la specifica OpenAPI a cui viene fatto riferimento nell'elemento `<OASResource>`. Questo può accadere se il file non è un file JSON o YAML oppure se l'URL del file non è specificato correttamente.

Variabili di errore

Queste variabili vengono impostate quando questo criterio attiva un errore in fase di runtime. Per maggiori informazioni, consulta la sezione Cosa devi sapere sugli errori dei criteri.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come indicato nella tabella Errori di runtime riportata sopra. Il nome del guasto è l'ultima parte del codice di errore.	`fault.name Matches "ResourceDoesNotExist"`
`oasvalidation.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oasvalidation.myoaspolicy.failed = true`

Policy PopulateCache

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Si verifica quando
`policies.populatecache.EntryCannotBeCached`	500	Una voce non può essere memorizzata nella cache. L'oggetto del messaggio che si sta memorizzando nella cache non è un'istanza di un Serializzabile.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidCacheResourceReference`	Questo errore si verifica se l'elemento `<CacheResource>` del criterio RulesCache è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.
`CacheNotFound`	La cache specificata nell'elemento `<CacheResource>` non esistono.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "EntryCannotBeCached"`
`populatecache.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`populatecache.POP-CACHE-1.failed = true`

Esempio di risposta di errore

{
  "fault": {
    "faultstring": "[entry] can not be cached. Only serializable entries are cached.",
    "detail": {
      "errorcode": "steps.populatecache.EntryCannotBeCached"
    }
  }
}

Esempio di regola di errore

<FaultRule name="Populate Cache Fault">
    <Step>
        <Name>AM-EntryCannotBeCached</Name>
        <Condition>(fault.name Matches "EntryCannotBeCached") </Condition>
    </Step>
    <Condition>(populatecache.POP-CACHE-1.failed = true) </Condition>
</FaultRule>

Policy LookupCache

Questa sezione descrive i messaggi di errore e le variabili di flusso che vengono impostati quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se stai sviluppando regole di errore per un proxy. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Prefisso codice di errore

N/A

Errori di runtime

Questo criterio non genera errori di runtime.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidCacheResourceReference`	Questo errore si verifica se l'elemento `<CacheResource>` è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.
`InvalidTimeout`	Se l'elemento `<CacheLookupTimeoutInSeconds>` è impostato su un numero negativo, il deployment del proxy API non va a buon fine.
`CacheNotFound`	Questo errore si verifica se la cache specifica menzionata nel messaggio di errore non è stata creata su un componente specifico dell'elaboratore di messaggi.

Variabili di errore

N/A

Esempio di risposta di errore

N/A

Policy InvalidateCache

Prefisso codice di errore

N/A

Errori di runtime

Questo criterio non genera errori di runtime.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidCacheResourceReference`	Questo errore si verifica se l'elemento `<CacheResource>` nel criterio InvalidateCache è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.
`CacheNotFound`	Questo errore si verifica se la cache specifica menzionata nel messaggio di errore non è stata creata su un componente specifico dell'elaboratore di messaggi.

Variabili di errore

N/A

Esempio di risposta di errore

N/A

Policy ResponseCache

Prefisso codice di errore

N/A

Errori di runtime

Questo criterio non genera errori di runtime.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidTimeout`	Se l'elemento `<CacheLookupTimeoutInSeconds>` del criterio ResponseCache viene impostato su un numero negativo, il deployment del proxy API non va a buon fine.
`InvalidCacheResourceReference`	Questo errore si verifica se l'elemento `<CacheResource>` in un criterio ResponseCache è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.
`ResponseCacheStepAttachmentNotAllowedReq`	Questo errore si verifica se lo stesso criterio ResponseCache è collegato a più percorsi di richiesta all'interno di qualsiasi flusso di un proxy API.
`ResponseCacheStepAttachmentNotAllowedResp`	Questo errore si verifica se lo stesso criterio ResponseCache è collegato a più percorsi di risposta all'interno di qualsiasi flusso di un proxy API.
`InvalidMessagePatternForErrorCode`	Questo errore si verifica se l'elemento `<SkipCacheLookup>` o `<SkipCachePopulation>` in un criterio ResponseCache contiene una condizione non valida.
`CacheNotFound`	Questo errore si verifica se la cache specifica menzionata nel messaggio di errore non è stata creata su un componente specifico dell'elaboratore di messaggi.

Variabili di errore

N/A

Esempio di risposta di errore

N/A

Policy OAuthV2

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause	Thrown by operations
`steps.oauth.v2.access_token_expired`	401	The access token is expired.	VerifyAccessToken InvalidateToken
`steps.oauth.v2.access_token_not_approved`	401	The access token was revoked.	VerifyAccessToken
`steps.oauth.v2.apiresource_doesnot_exist`	401	The requested resource does not exist any of the API products associated with the access token.	VerifyAccessToken
`steps.oauth.v2.FailedToResolveAccessToken`	500	The policy expected to find an access token in a variable specified in the `<AccessToken>` element, but the variable could not be resolved.	GenerateAccessToken
`steps.oauth.v2.FailedToResolveAuthorizationCode`	500	The policy expected to find an authorization code in a variable specified in the `<Code>` element, but the variable could not be resolved.	GenerateAuthorizationCode
`steps.oauth.v2.FailedToResolveClientId`	500	The policy expected to find the Client ID in a variable specified in the `<ClientId>` element, but the variable could not be resolved.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken
`steps.oauth.v2.FailedToResolveRefreshToken`	500	The policy expected to find a refresh token in a variable specified in the `<RefreshToken>` element, but the variable could not be resolved.	RefreshAccessToken
`steps.oauth.v2.FailedToResolveToken`	500	The policy expected to find a token in a variable specified in the `<Tokens>` element, but the variable could not be resolved.	ValidateToken InvalidateToken
`steps.oauth.v2.InsufficientScope`	403	The access token presented in the request has a scope that does not match the scope specified in the verify access token policy. To learn about scope, see Working with OAuth2 scopes.	VerifyAccessToken
`steps.oauth.v2.invalid_access_token`	401	The access token sent from the client is invalid.	VerifyAccessToken
`steps.oauth.v2.invalid_client`	401	This error name is returned when the `<GenerateResponse>` property of the policy is set to true and the client ID sent in the request is invalid. Check to be sure you are using the correct client key and secret values for the Developer App associated with your proxy. Typically, these values are sent as a Base64 encoded Basic Authorization header. Note: It is recommended that you change existing fault rule conditions to catch both the `invalid_client` and `InvalidClientIdentifier` names. See the 16.09.21 Release Notes for more information and an example.	GenerateAccessToken RefreshAccessToken
`steps.oauth.v2.InvalidRequest`	400	This error name is used for multiple different kinds of errors, typically for missing or incorrect parameters sent in the request. If `<GenerateResponse>` is set to `false`, use fault variables (described below) to retrieve details about the error, such as the fault name and cause.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken
`steps.oauth.v2.InvalidAccessToken`	401	The authorization header does not have the word "Bearer", which is required. For example: `Authorization: Bearer your_access_token`	VerifyAccessToken
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	The API proxy is not in the Product associated with the access token. Tips: Be sure that the product associated with the access token is configured correctly. For example, if you use wildcards in resource paths, be sure the wildcards are being used correctly. See Create API products for details. See also this Apigee Community post for more guidance on causes for this error.	VerifyAccessToken
`steps.oauth.v2.InvalidClientIdentifier`	500	This error name is returned when the `<GenerateResponse>` property of the policy is set to false and the client ID sent in the request is invalid. Check to be sure you are using the correct client key and secret values for the Developer App associated with your proxy. Typically, these values are sent as a Base64 encoded Basic Authorization header. Note: In this situation, this error used to be called `invalid_client`. It is recommended that you change existing fault rule conditions to catch both the `invalid_client` and `InvalidClientIdentifier` names. See the 16.09.21 Release Notes for more information and an example.	GenerateAccessToken RefreshAccessToken
`steps.oauth.v2.InvalidParameter`	500	The policy must specify either an access token or an authorization code, but not both.	GenerateAuthorizationCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.InvalidTokenType`	500	The `<Tokens>/<Token>` element requires you to specify the token type (for example, `refreshtoken`). If the client passes the wrong type, this error is thrown.	ValidateToken InvalidateToken
`steps.oauth.v2.MissingParameter`	500	The response type is `token`, but no grant types are specified.	GenerateAuthorizationCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.UnSupportedGrantType`	500	The client specified a grant type that is unsupported by the policy (not listed in the <SupportedGrantTypes> element). Note: There is currently a bug where unsupported grant type errors are not thrown correctly. If an unsupported grant type error occurs, the proxy does not enter the Error Flow, as expected.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause
`InvalidValueForExpiresIn`	For the `<ExpiresIn>` element, valid values are positive integers and `-1`.
`InvalidValueForRefreshTokenExpiresIn`	For the `<RefreshTokenExpiresIn>` element, valid values are positive integers and `-1`.
`InvalidGrantType`	An invalid grant type is specified in the `<SupportedGrantTypes>` element. See the policy reference for a list of valid types.
`ExpiresInNotApplicableForOperation`	Be sure that the operations specified in the <Operations> element support expiration. For example, the VerifyToken operation does not.
`RefreshTokenExpiresInNotApplicableForOperation`	Be sure that the operations specified in the <Operations> element support refresh token expiration. For example, the VerifyToken operation does not.
`GrantTypesNotApplicableForOperation`	Be sure that the grant types specified in <SupportedGrantTypes> are supported for the specified operation.
`OperationRequired`	You must specify an operation in this policy using the `<Operation>` element. Note: If the `<Operation>` element is missing, the UI throws a schema validation error.
`InvalidOperation`	You must specify a valid operation in this policy using the `<Operation>` element. Note: If the `<Operation>` element is invalid, the UI throws a schema validation error.
`TokenValueRequired`	You must specify a token `<Token>` value in the `<Tokens>` element.

Fault variables

These variables are set when this policy triggers an error at runtime.

Note: You an use these variables to create Fault Rule conditions. These variables are populated when an error occurs if <GenerateResponse> is set to false. If <GenerateResponse> is true, the policy returns a response to the client immediately if an error occurs -- the error flow is skipped and these variables are not populated. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the Runtime errors table above. The fault name is the last part of the fault code.	`fault.name = "InvalidRequest"`
`oauthV2.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`oauthV2.GenerateAccesstoken.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` is the user-specified name of the policy that threw the fault.	`oauthV2.GenerateAccesstoken.fault.name = InvalidRequest` Note: For the VerifyAccessToken operation, the fault name includes this suffix: `keymanagement.service` For example: `keymanagement.service.invalid_access_token`
`oauthV2.policy_name.fault.cause`	`policy_name` is the user-specified name of the policy that threw the fault.	`oauthV2.GenerateAccesstoken.cause = Required param : grant_type`

Example error response

These responses are sent back to the client if the <GenerateResponse> element is true.

Note: For error handling, the best practice is to trap the errorcode part of the error response. Do not rely on the text in the faultstring, because it could change.

If <GenerateResponse> is true, the policy returns errors in this format for operations that generate tokens and codes. For a complete list, see see OAuth HTTP error response reference.

{"ErrorCode" : "invalid_client", "Error" :"ClientId is Invalid"}

If <GenerateResponse> is true, the policy returns errors in this format for verify and validate operations. For a complete list, see see OAuth HTTP error response reference.

{  
   {  
      "fault":{  
         "faultstring":"Invalid Access Token",
         "detail":{  
            "errorcode":"keymanagement.service.invalid_access_token"
         }
      }
   }

Example fault rule

<FaultRule name=OAuthV2 Faults">
    <Step>
        <Name>AM-InvalidClientResponse</Name>
        <Condition>(fault.name = "invalid_client") OR (fault.name = "InvalidClientIdentifier")</Condition>
    </Step>
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
        <Condition>(fault.name = "invalid_access_token")</Condition>
    </Step>
    <Condition>(oauthV2.failed = true) </Condition>
</FaultRule>

Policy GetOAuthV2Info

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito. I nomi degli errori mostrati di seguito sono le stringhe assegnate alla variabile fault.name quando si verifica un errore. Vedi il problema di seguito per maggiori dettagli.

Codice di errore	Stato HTTP	Causa
`steps.oauth.v2.access_token_expired`	500	Il token di accesso inviato al criterio è scaduto.
`steps.oauth.v2.authorization_code_expired`	500	Il codice di autorizzazione inviato al criterio è scaduto.
`steps.oauth.v2.invalid_access_token`	500	Il token di accesso inviato al criterio non è valido.
`steps.oauth.v2.invalid_client-invalid_client_id`	500	L'ID client inviato al criterio non è valido.
`steps.oauth.v2.invalid_refresh_token`	500	Il token di aggiornamento inviato al criterio non è valido.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	500	Il codice di autorizzazione inviato al criterio non è valido.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Vedi questo post della community Apigee per informazioni su come risolvere questo errore.
`steps.oauth.v2.refresh_token_expired`	500	Il token di aggiornamento inviato al criterio è scaduto.

Errori di deployment

Per informazioni sugli errori di deployment, fai riferimento al messaggio riportato nell'interfaccia utente.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "IPDeniedAccess"`
`oauthV2.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.GetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.GetToKenInfo.fault.name = invalid_client-invalid_client_id`
`oauthV2.policy_name.fault.cause`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.GetTokenInfo.cause = ClientID is Invalid`

Esempio di risposta di errore

{  
   "fault":{  
      "faultstring":"ClientId is Invalid",
      "detail":{  
         "errorcode":"keymanagement.service.invalid_client-invalid_client_id"
      }
   }
}

Esempio di regola di errore

<FaultRule name="OAuthV2 Faults">
    <Step>
        <Name>AM-InvalidClientIdResponse</Name>
    </Step>
    <Condition>(fault.name = "invalid_client-invalid_client_id")</Condition>
</FaultRule>

Policy SetOAuthV2Info

Questa sezione descrive i codici di errore e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio genera un errore. Queste informazioni sono importanti se stai sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta Cosa devi sapere sugli errori relativi alle norme e Gestione dei guasti.

Errori di runtime

Questi errori possono verificarsi durante l'esecuzione del criterio.

Codice di errore	Stato HTTP	Causa
`steps.oauth.v2.access_token_expired`	500	Il token di accesso inviato al criterio è scaduto.
`steps.oauth.v2.invalid_access_token`	500	Il token di accesso inviato alla policy non è valido.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Per informazioni sulla risoluzione dei problemi relativi a questo errore, consulta questo post della community Apigee.

Errori di deployment

Per informazioni sugli errori di deployment, consulta il messaggio segnalato nell'interfaccia utente.

Variabili di errore

Queste variabili vengono impostate quando questo criterio genera un errore in fase di runtime.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella tabella Errori di runtime riportata sopra. Il nome del guasto è l'ultima parte del codice di errore.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.SetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.SetTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.SetTokenInfo.cause = Invalid Access Token`

Esempio di risposta di errore

{
  "fault": {
    "faultstring": "Invalid Access Token",
    "detail": {
      "errorcode": "keymanagement.service.invalid_access_token"
    }
  }
}

Regola di errore di esempio

<FaultRule name=SetOAuthV2Info Faults">
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
        <Condition>(fault.name = "invalid_access_token")</Condition>
    </Step>
    <Condition>(oauthV2.failed = true) </Condition>
</FaultRule>

Policy DeleteOAuthV2Info

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.oauth.v2.invalid_access_token`	401	Il token di accesso inviato al criterio non è valido.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	401	Il codice di autorizzazione inviato al criterio non è valido.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Vedi questo post della community Apigee per informazioni su come risolvere questo errore.

Errori di deployment

Per informazioni sugli errori di deployment, fai riferimento al messaggio riportato nell'interfaccia utente.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.DeleteTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.DeleteTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.DeleteTokenInfo.cause = Invalid Access Token`

Esempio di risposta di errore

{
  "fault": {
    "faultstring": "Invalid Access Token",
    "detail": {
      "errorcode": "keymanagement.service.invalid_access_token"
    }
  }
}

Esempio di regola di errore

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="DeleteOAuthV2Info_Faults">
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
    </Step>
    <Condition>(fault.name = "invalid_access_token")</Condition>
</FaultRule>

Policy OAuthv1.0a

Il tipo di criterio OAuthV1 definisce i seguenti codici di errore.

Per i codici di errore HTTP relativi ad OAuth, consulta il riferimento per la risposta all'errore HTTP OAuth.

Codice di errore	Messaggio

`AppKeyNotResolved`	`Could not resolve the app key with variable {0}`
`ConsumerKeyNotResolved`	`Could not resolve the consumer key with variable {0}`
`RequestTokenNotResolved`	`Could not resolve the request token with the variable {0}`
`AccessTokenNotResolved`	`Could not resolve the access token with the variable {0}`
`ResponseGenerationError`	`Error while generating response : {0}`
`UnableToDetermineOperation`	`Unable to determine an operation for stepDefinition {0}`
`UnableToResolveOAuthConfig`	`Unable to resolve the OAuth configuration for {0}`
`AtLeastOneParamRequired`	`At least one of AccessToken, RequestToken or ConsumerKey must be specified in stepDefinition {0}`
`SpecifyValueOrRefReqToken`	`Specify Request Token as value or ref in stepDefinition {0}`
`SpecifyValueOrRefAccToken`	`Specify Access Token as value or ref in stepDefinition {0}`
`SpecifyValueOrRefConKey`	`Specify Consumer Key as value or ref in stepDefinition {0}`
`SpecifyValueOrRefAppKey`	`Specify App Key as value or ref in stepDefinition {0}`
`ExpiresInNotApplicableForOperation`	`ExpiresIn element is not valid for operation {0}`
`InvalidValueForExpiresIn`	`Invalid value for ExpiresIn element for operation {0}`
`FailedToFetchApiProduct`	`Failed to fetch api product for key {0}`
`InvalidTokenType`	`Valid token types : {0}, Invalid toke type {1} in stepDefinition {2}`
`TokenValueRequired`	`Token value is required in stepDefinition {0}`
`FailedToResolveRealm`	`Failed to resolve realm {0}`

Policy GetOAuthV1Info

No error codes are specified for the Get OAuth v1.0a Info policy.

Policy DeleteOAuthV1Info

Se l'operazione riesce, il criterio restituisce lo stato 200.

In caso di errore, il criterio restituisce un errore 404 e un output simile al seguente (a seconda che stai eliminando un token di accesso, un token per la richiesta o uno strumento di verifica.):

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 144
Connection: keep-alive

{"fault":{"faultstring":"Invalid Access Token","detail":{"errorcode":"keymanagement.service.invalid_request-access_token_invalid"}}}

Policy PythonScript

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.script.ScriptEvaluationFailed`	500	Il criterio PythonScript può generare diversi tipi di errori ScriptExecutionFailed. Normalmente i tipi di errori riscontrati includono NameError e ZeroDivisionError.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidResourceUrlFormat`	Se il formato dell'URL della risorsa specificato all'interno di `<ResourceURL>` o l'elemento `<IncludeURL>` del criterio PythonScript non è valido, la distribuzione del proxy API non va a buon fine.
`InvalidResourceUrlReference`	Se gli elementi `<ResourceURL>` o `<IncludeURL>` fare riferimento a un file PythonScript che non esiste, il deployment del proxy API non va a buon fine. Il file di origine a cui viene fatto riferimento deve esistere a livello di organizzazione, di proxy API o di ambiente.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore in fase di runtime. Per ulteriori informazioni, consulta Cosa che devi conoscere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "ScriptExecutionFailed"`
`pythonscript.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`pythonscript.PythonScript-1.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "Execution of SetResponse failed with error: Pythonscript runtime error: "ReferenceError: "status" is not defined.\"",
    "detail": {
      "errorcode": "steps.script.ScriptExecutionFailed"
    }
  }
}

Esempio di regola di errore

<FaultRule name="PythonScript Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ScriptExecutionFailed") </Condition>
    </Step>
    <Condition>(pythonscript.PythonScript-1.failed = true) </Condition>
</FaultRule>

Policy Quota

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`policies.ratelimit.FailedToResolveQuotaIntervalReference`	500	Si verifica se l'elemento `<Interval>` non è definito nel criterio per le quote. Questo elemento è obbligatorio e viene utilizzato per specificare l'intervallo di tempo applicabile alla quota. L'intervallo di tempo può essere minuti, ore, giorni, settimane o mesi, come definito con l'elemento `<TimeUnit>`.
`policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference`	500	Si verifica se l'elemento `<TimeUnit>` non è definito nel criterio per le quote. Questo elemento è obbligatorio e viene utilizzato per specificare l'unità di tempo applicabile alla quota. L'intervallo di tempo può essere in minuti, ore, giorni, settimane o mesi.
`policies.ratelimit.InvalidMessageWeight`	500	Si verifica se il valore dell'elemento `<MessageWeight>` specificato tramite una variabile di flusso non è valido (valore non intero).
`policies.ratelimit.QuotaViolation`	500	Il limite di quota è stato superato.	N/D

Errori di deployment

Nome errore	Causa	Correggi
`InvalidQuotaInterval`	Se l'intervallo di quota specificato nell'elemento `<Interval>` non è un numero intero, il deployment del proxy API non va a buon fine. Ad esempio, se l'intervallo di quota specificato è 0,1 nell'elemento `<Interval>`, il deployment Il proxy API non funziona.
`InvalidQuotaTimeUnit`	Se l'unità di tempo specificata nell'elemento `<TimeUnit>` non è supportata, il deployment del proxy API non va a buon fine. Le unità di tempo supportate sono `minute`, `hour`, `day`, `week` e `month`.
`InvalidQuotaType`	Se il tipo di quota specificato dall'attributo `type` in `<Quota>` non è valido, il deployment del proxy API non va a buon fine. La i tipi di quota supportati sono `default`, `calendar`, `flexi` e `rollingwindow`.
`InvalidStartTime`	Se il formato dell'ora specificato nell'elemento `<StartTime>` è non valido, il deployment del proxy API non va a buon fine. Il formato valido è `yyyy-MM-dd HH:mm:ss`, che è il formato di data e ora in ISO 8601. Per Ad esempio, se l'ora specificata nell'elemento `<StartTime>` è `7-16-2017 12:00:00`, il deployment del proxy API non va a buon fine.
`StartTimeNotSupported`	Se viene specificato l'elemento `<StartTime>` il cui tipo di quota non è `calendar`, il deployment del proxy API non va a buon fine. L'elemento `<StartTime>` è supportato solo per il tipo di quota `calendar`. Ad esempio, se l'attributo `type` è impostato a `flexi` o `rolling window` nell'elemento `<Quota>`, quindi che il deployment del proxy API non va a buon fine.
`InvalidTimeUnitForDistributedQuota`	Se l'elemento `<Distributed>` è impostato su `true` e l'elemento `<TimeUnit>` è impostato su `second`, il deployment del proxy API non va a buon fine. L'unità di tempo `second` non è valida per una quota distribuita.
`InvalidSynchronizeIntervalForAsyncConfiguration`	Se il valore specificato per l'elemento `<SyncIntervalInSeconds>` all'interno dei campi L'elemento `<AsynchronousConfiguration>` in un criterio per le quote è minore di zero, allora che il deployment del proxy API non va a buon fine.
`InvalidAsynchronizeConfigurationForSynchronousQuota`	Se il valore dell'elemento `<AsynchronousConfiguration>` è impostato su `true` in un criterio per le quote, che abbia una configurazione asincrona definita utilizzando l'elemento `<AsynchronousConfiguration>`, quindi l'esecuzione del deployment del proxy API non va a buon fine.

Variabili di errore

Queste variabili vengono impostate quando il criterio attiva un errore. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "QuotaViolation"`
`ratelimit.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`ratelimit.QT-QuotaPolicy.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      },
      "faultstring":"Rate limit quota violation. Quota limit  exceeded. Identifier : _default"
   }
}

Esempio di regola di errore

<FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "QuotaViolation") </Condition>
        </Step>
        <Condition>ratelimit.Quota-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy ResetQuota

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause
`policies.resetquota.InvalidRLPolicy`	500	The Quota policy specified in the `<Quota>` element of the Reset Quota policy is not defined in the API proxy and thus is not available during the flow. The `<Quota>` element is mandatory and identifies the target Quota policy whose counter should be updated through the Reset Quota policy.
`policies.resetquota.FailedToResolveAllowCountRef`	N/A	The reference to the variable containing the allow count in the `<Allow>` element of the policy cannot be resolved to a value. This element is mandatory and specifies the amount to decrease the quota counter.
`policies.resetquota.FailedToResolveRLPolicy`	500	The variable referenced by the `ref` attribute in the `<Quota>` element cannot be resolved.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidCount`	If the count value specified in the `<Allow>` element of the Reset Quota Policy is not an integer, then the deployment of the API proxy fails.

Policy RaiseFault

Questa sezione descrive i codici e i messaggi di errore restituiti, nonché le variabili di errore. impostate da Edge quando questo criterio attiva un errore. È importante sapere se stai sviluppando regole di errore per per gestire gli errori. Per saperne di più, vedi Informazioni importanti sugli errori relativi alle norme Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.raisefault.RaiseFault`	500	Vedi stringa errore.

Errori di deployment

Nessuno.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato in Tabella Errori di runtime qui sopra. Il nome dell'errore è l'ultimo parte del codice di errore.	`fault.name = "RaiseFault"`
`raisefault.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha buttato via il fallo.	`raisefault.RF-ThrowError.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
   "fault":{
      "detail":{
         "errorcode":"steps.raisefault.RaiseFault"
      },
      "faultstring":"Raising fault. Fault name: [name]"
   }
}

Policy RegularExpressionProtection

Questa sezione descrive i codici e i messaggi restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per la gestione degli errori. Per acquisire un errore e generare un errore personalizzato, imposta l'attributo continueOnError="true" nell'elemento principale del criterio. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Gli errori restituiti dai criteri perimetrali seguono un formato coerente, come descritto in Riferimento ai codici di errore.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Messaggio

ExecutionFailed	Impossibile eseguire la StepDefinition di RegularExpressionProtection {0}. Motivo: {1}
InstantiationFailed	Impossibile creare un'istanza della StepDefinition RegularExpressionProtection {0}
NonMessageVariable	La variabile {0} non si risolve in un messaggio.
SourceMessageNotAvailable	{0} non è disponibile per RegularExpressionProtection StepDefinition {1}
ThreatDetected	Minaccia espressione regolare rilevata in {0}: regex: {1} input: {2}
VariableResolutionFailed	Impossibile risolvere la variabile {0}

Errori di deployment

Codice di errore	Messaggio	Correggi

CannotBeConvertedToNodeset	RegularExpressionProtection {0}: il risultato di xpath {1} non può essere convertito in un set di nodi. Contesto {2}
DuplicatePrefix	RegularExpressionProtection {0}: prefisso duplicato {1}
EmptyJSONPathExpression	RegularExpressionProtection {0}: espressione JSONPath vuota
EmptyXPathExpression	RegularExpressionProtection {0}: espressione XPath vuota
InvalidRegularExpression	RegularEspressioneProtection {0}: espressione regolare non valida {1}, contesto {2}
JSONPathCompilationFailed	RegularExpressionProtection {0}: impossibile compilare jsonpath {1}. Contesto {2}
NON vuotoPrefissoMappedToVuotoURI	RegularExpressionProtection {0}: il prefisso non vuoto {1} non può essere mappato a un URI vuoto
NoPatternsToEnforce	RegularExpressionProtection {0}: nessun pattern da applicare in {1}
NothingToEnforce	RegularExpressionProtection {0}: è obbligatorio almeno un valore URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload
XPathCompilationFailed	RegularExpressionProtection {0}: impossibile compilare xpath {1}. Contesto {2}

Variabili di errore

Queste variabili vengono impostate quando questo criterio attiva un errore. Per maggiori informazioni, consulta la sezione Cosa devi sapere sugli errori relativi ai criteri.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come indicato nella tabella precedente.	`fault.name Matches "ThreatDetected"`
`regularexpressionprotection.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`regularexpressionprotection.Regular-Expressions-Protection-1.failed = true`

Policy SOAPMessageValidation

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore Stato HTTP Causa Correggi

steps.messagevalidation.SourceMessageNotAvailable

500

Questo errore si verifica se una variabile specificata nell'elemento <Source> del criterio è:

fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio)
non può essere risolto (non è definito)

steps.messagevalidation.NonMessageVariable

500

Questo errore si verifica se l'elemento <Source> nel criterio SOAPMessageValidation è impostato su una variabile non di tipo messaggio.

Le variabili del tipo di messaggio rappresentano intere richieste e risposte HTTP. Le variabili di flusso Edge integrate request, response e message sono di tipo messaggio. Per scoprire di più sulle variabili messaggio, consulta la documentazione di riferimento sulle variabili.

steps.messagevalidation.Failed 500 Questo errore si verifica se il criterio SOAPMessageValidation non riesce a convalidare il payload dei messaggi di input in base allo schema XSD o alla definizione WSDL. Si verifica anche se il formato JSON o XML del messaggio del payload è in formato errato.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidResourceType`	L'elemento `<ResourceURL>` nel criterio SOAPMessageValidation è impostato su un tipo di risorsa non supportato dal criterio.
`ResourceCompileFailed`	Lo script della risorsa a cui viene fatto riferimento nell'elemento `<ResourceURL>` del criterio SOAPMessageValidation contiene un errore che ne impedisce la compilazione.
`RootElementNameUnspecified`	L'elemento `<Element>` nel criterio SOAPMessageValidation non contiene il nome dell'elemento principale.
`InvalidRootElementName`	L'elemento `<Element>` nel criterio SOAPMessageValidation contiene un nome dell'elemento principale che non ottempera alle regole XML per la denominazione di elementi validi.

Policy SAMLAssertion

Questa sezione descrive i codici e i messaggi di errore restituiti. e le variabili di errore impostate da Edge quando questo criterio attiva un errore. È importante sapere se stai sviluppando regole di errore per per gestire gli errori. Per saperne di più, consulta Cosa devi sapere sugli errori relativi ai criteri e sulla gestione di errore.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`SourceNotConfigured`	Uno o più dei seguenti elementi della colonna Convalida asserzione SAML criterio non definito o vuoto: `<Source>`, `<XPath>`, `<Namespaces>`, `<Namespace>`.
`TrustStoreNotConfigured`	Se l'elemento `<TrustStore>` è vuoto o non specificato nel Convalida il criterio SAMLAssertion, il deployment del proxy API non va a buon fine. È richiesto un archivio di attendibilità valido.
`NullKeyStoreAlias`	Se l'elemento secondario `<Alias>` è vuoto o non specificato nel campo `<Keystore>` del criterio Genera asserzione SAML, il deployment dell'API un errore del proxy. È richiesto un alias valido dell'archivio chiavi.
`NullKeyStore`	Se l'elemento secondario `<Name>` è vuoto o non specificato nel campo `<Keystore>` del criterio Genera SAMLAssertion, quindi il deployment dell'API un errore del proxy. È richiesto un nome dell'archivio chiavi valido.
`NullIssuer`	Se l'elemento `<Issuer>` è vuoto o non è specificato nel campo Genera SAML Criterio di asserzione, il deployment del proxy API non va a buon fine. R È necessario un valore `<Issuer>` valido.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "InvalidMediaTpe"`
`GenerateSAMLAssertion.failed`	Per una configurazione di convalida dei criteri di asserzione SAML, il prefisso di errore è `ValidateSAMLAssertion`.	`GenerateSAMLAssertion.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "GenerateSAMLAssertion[GenSAMLAssert]: Invalid media type",
    "detail": {
      "errorcode": "steps.saml.generate.InvalidMediaTpe"
    }
  }
}

Esempio di regola di errore

<FaultRules>
    <FaultRule name="invalid_saml_rule">
        <Step>
            <Name>invalid-saml</Name>
        </Step>
        <Condition>(GenerateSAMLAssertion.failed = "true")</Condition>
    </FaultRule>
</FaultRules>

Policy ServiceCallout

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore Stato HTTP Causa Correggi

steps.servicecallout.ExecutionFailed

500

Questo errore può verificarsi quando:

al criterio viene chiesto di gestire l'input non valido o altrimenti non valido.
il servizio di destinazione backend restituisce uno stato di errore (per impostazione predefinita, 4xx o 5xx).

steps.servicecallout.RequestVariableNotMessageType 500 La variabile di richiesta specificata nel criterio non è di tipo Messaggio. Ad esempio, se si tratta di una stringa o di un altro tipo non legato ai messaggi, viene visualizzato questo errore.

steps.servicecallout.RequestVariableNotRequestMessageType 500 La variabile di richiesta specificata nel criterio non è di tipo Messaggio di richiesta. Per Ad esempio, se si tratta di un tipo di risposta, visualizzerai questo errore.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`URLMissing`	L'elemento `<URL>` all'interno di `<HTTPTargetConnection>` mancante o vuoto.
`ConnectionInfoMissing`	Questo errore si verifica se il criterio non ha un `<HTTPTargetConnection>` o `<LocalTargetConnection>` .
`InvalidTimeoutValue`	Questo errore si verifica se il valore di `<Timeout>` è negativo o pari a zero.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "RequestVariableNotMessageType"`
`servicecallout.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`servicecallout.SC-GetUserData.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.servicecallout.RequestVariableNotMessageType"
      },
      "faultstring":"ServiceCallout[ServiceCalloutGetMockResponse]: 
            request variable data_str value is not of type Message"
   }
}

Esempio di regola di errore

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="RequestVariableNotMessageType">
    <Step>
        <Name>AM-RequestVariableNotMessageType</Name>
    </Step>
    <Condition>(fault.name = "RequestVariableNotMessageType")</Condition>
</FaultRule>

Policy SpikeArrest

Questa sezione descrive i codici e i messaggi di errore restituiti, nonché le variabili di errore. impostate da Edge quando questo criterio attiva un errore. È importante sapere se stai sviluppando regole di errore per per gestire gli errori. Per saperne di più, vedi Cosa devi sapere sugli errori relativi ai criteri e sulla gestione di errore.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`policies.ratelimit.FailedToResolveSpikeArrestRate`	`500`	Questo errore si verifica se il riferimento alla variabile contenente l'impostazione della tariffa all'interno dell'elemento `<Rate>` non può essere risolto in un valore all'interno della funzione Spike Arrest . Questo elemento è obbligatorio e viene utilizzato per specificare il tasso di arresto dei picchi in nel formato `intpm` o `intps`.
`policies.ratelimit.InvalidMessageWeight`	`500`	Questo errore si verifica se il valore specificato per l'elemento `<MessageWeight>` tramite una variabile di flusso non è valida (valore non intero).
`policies.ratelimit.SpikeArrestViolation`	`429`	Il limite di frequenza è stato superato. Nota: per il cloud privato, il codice di stato HTTP predefinito restituito è `500`. Per modificare il codice di stato restituito a `429`, imposta questa proprietà con l'API chiamata descritta in Esempio di regola di errore

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidAllowedRate`	Se il tasso di arresto dei picchi specificato nell'elemento `<Rate>` della funzione di arresto dei picchi Il criterio non è un numero intero o se la tariffa non ha `ps` o `pm` come suffisso, il deployment del proxy API non va a buon fine.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato in Tabella Errori di runtime qui sopra. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "SpikeArrestViolation"`
`ratelimit.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`ratelimit.SA-SpikeArrestPolicy.failed = true`

Esempio di risposta di errore

Di seguito è riportato un esempio di risposta di errore:

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.SpikeArrestViolation"
      },
      "faultstring":"Spike arrest violation. Allowed rate : 10ps"
   }
}

Esempio di regola di errore

Di seguito è riportato un esempio di regola di errore per gestire un errore SpikeArrestViolation:

<FaultRules>
    <FaultRule name="Spike Arrest Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "SpikeArrestViolation") </Condition>
        </Step>
        <Condition>ratelimit.Spike-Arrest-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy StatisticsCollector

Questa sezione descrive i messaggi di errore e le variabili di flusso impostate quando questo criterio attiva un errore. Queste informazioni sono importanti se stai sviluppando regole di errore per un proxy. Per scoprire di più, consulta Informazioni importanti sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Nessuno.

Errori di deployment

Nome dell'errore	Causa	Correggi
`UnsupportedDatatype`	Se il tipo di variabile specificato dall'attributo ref nell'elemento `<Statistic>` del criterio del Collector di statistiche non è supportato, il deployment del proxy API non va a buon fine. I tipi di dati supportati sono `string`, `integer`, `float`, `long`, `double` e `boolean`.
`InvalidName`	Se il nome utilizzato per fare riferimento ai dati raccolti per la variabile specificata definita all'interno dell'elemento `<Statistic>` del criterio del Collector di statistiche è in conflitto con una variabile definita dal sistema, il deployment del proxy API non va a buon fine. Alcune delle variabili predefinite dal sistema sono `organization` e `environment`.
`DatatypeMissing`	Se il tipo della variabile specificato dall'attributo `ref` nell'elemento `<Statistic>` del criterio del Collector di statistiche non è presente, il deployment del proxy API non va a buon fine.

Variabili di errore

Nessuno.

Policy VerifyAPIKey

Errori di runtime

Questi errori possono verificarsi durante l'esecuzione del criterio.

Codice di errore	Stato HTTP	Causa
`keymanagement.service.CompanyStatusNotActive`	401	La società associata all'app per sviluppatori che ha la chiave API che stai utilizzando ha uno stato inattivo. Quando lo stato di un'azienda è impostato su Non attiva, non puoi accedere agli sviluppatori o alle app associati a quell'azienda. Un amministratore dell'organizzazione può modificare lo stato di un'azienda utilizzando l'API di gestione. Consulta Impostare lo stato di un'azienda.
`keymanagement.service.DeveloperStatusNotActive`	401	Lo sviluppatore che ha creato l'app per sviluppatori con la chiave API che stai utilizzando ha uno stato inattivo. Quando lo stato di uno sviluppatore di app viene impostato su inattivo, tutte le app per sviluppatori create da questo sviluppatore vengono disattivate. Un utente amministratore con le autorizzazioni appropriate (ad esempio Amministratore dell'organizzazione) può modificare lo stato di uno sviluppatore nei seguenti modi: API Management: Imposta lo stato sviluppatore UI di gestione: in Registra sviluppatori di app, consulta le istruzioni per disattivare (e attivare) uno sviluppatore.
`keymanagement.service.invalid_client-app_not_approved`	401	L'app per sviluppatori associata alla chiave API è revocata. Un'app revocata non può accedere a nessun prodotto API e non può richiamare alcuna API gestita da Apigee Edge. Un amministratore dell'organizzazione può modificare lo stato di un'app per sviluppatori utilizzando l'API di gestione. Consulta Approvare o revocare l'app sviluppatore.
`oauth.v2.FailedToResolveAPIKey`	401	La norma prevede di trovare la chiave API in una variabile specificata nell'elemento <APIKey> della norma. Questo errore si verifica quando la variabile prevista non esiste (non può essere risolta).
`oauth.v2.InvalidApiKey`	401	Edge ha ricevuto una chiave API, ma non è valida. Quando Edge cerca la chiave nel suo database, questa deve corrispondere esattamente a quella inviata nella richiesta. Se l'API funzionava in precedenza, assicurati che la chiave non sia stata rigenerata. Se la chiave è stata rigenerata, visualizzerai questo errore se provi a utilizzare la chiave precedente. Per maggiori dettagli, vedi Registrare le app e gestire le chiavi API.
`oauth.v2.InvalidApiKeyForGivenResource`	401	Edge ha ricevuto una chiave API valida, ma non corrisponde a una chiave approvata nell'app per sviluppatori associata al proxy API tramite un prodotto.

Nota:al momento Edge non segnala l'errore ApiKeyNotApproved in modo accurato. Se una chiave non è approvata (il suo stato è impostato su "revocata" o "in attesa"), riceverai invece l'errore FailedToResolveAPIKey. Per ulteriori informazioni e una possibile soluzione alternativa, consulta questo post della community Apigee.

Errori di deployment

Questi errori possono verificarsi quando implementi un proxy contenente questo criterio.

Nome dell'errore	Causa
`SpecifyValueOrRefApiKey`	L'elemento `<APIKey>` non ha un valore o una chiave specificati.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per saperne di più, consulta Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella tabella Errori di runtime riportata sopra. Il nome del guasto è l'ultima parte del codice di errore.	`fault.name Matches "FailedToResolveAPIKey"`
`oauthV2.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`oauthV2.VK-VerifyAPIKey.failed = true`

Esempi di risposte di errore

Nota:per la gestione degli errori, la best practice consiste nell'intercettare la parte errorcode della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
   "fault":{
      "faultstring":"Invalid ApiKey",
      "detail":{
         "errorcode":"oauth.v2.InvalidApiKey"
      }
   }
}

{
   "fault":{
      "detail":{
         "errorcode":"keymanagement.service.DeveloperStatusNotActive"
      },
      "faultstring":"Developer Status is not Active"
   }
}

Regola di errore di esempio

<FaultRule name="FailedToResolveAPIKey">
    <Step>
        <Name>AM-FailedToResolveAPIKey</Name>
    </Step>
    <Condition>(fault.name Matches "FailedToResolveAPIKey") </Condition>
</FaultRule>

Policy VerifyJWS

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Si verifica quando
`steps.jws.AlgorithmInTokenNotPresentInConfiguration`	401	Si verifica quando il criterio di verifica ha più algoritmi
`steps.jws.AlgorithmMismatch`	401	L'algoritmo specificato nell'intestazione dal criterio di generazione non corrisponde a quello previsto nel criterio di verifica. Gli algoritmi specificati devono corrispondere.
`steps.jws.ContentIsNotDetached`	401	`<DetachedContent>` viene specificato quando il JWS non contiene un payload di contenuti scollegati.
`steps.jws.FailedToDecode`	401	Il criterio non è stato in grado di decodificare il JWS. Il JWS potrebbe essere danneggiato.
`steps.jws.InsufficientKeyLength`	401	Per una chiave di dimensioni inferiori a 32 byte per l'algoritmo HS256
`steps.jws.InvalidClaim`	401	Per una rivendicazione mancante o mancata corrispondenza di una rivendicazione oppure una mancata corrispondenza di intestazione o intestazione.
`steps.jws.InvalidCurve`	401	La curva specificata dalla chiave non è valida per l'algoritmo Curva ellittica.
`steps.jws.InvalidJsonFormat`	401	JSON non valido trovato nell'intestazione JWS.
`steps.jws.InvalidJws`	401	Questo errore si verifica quando la verifica della firma JWS non va a buon fine.
`steps.jws.InvalidPayload`	401	Il payload JWS non è valido.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` viene omesso e il JWS ha un payload di contenuti scollegato.
`steps.jws.KeyIdMissing`	401	Il criterio di verifica utilizza un JWKS come origine per le chiavi pubbliche, ma il JWS firmato non include una proprietà `kid` nell'intestazione.
`steps.jws.KeyParsingFailed`	401	Impossibile analizzare la chiave pubblica a partire dalle informazioni sulla chiave specificate.
`steps.jws.MissingPayload`	401	Payload JWS mancante.
`steps.jws.NoAlgorithmFoundInHeader`	401	Si verifica quando il JWS omette l'intestazione dell'algoritmo.
`steps.jws.NoMatchingPublicKey`	401	Il criterio di verifica utilizza un JWKS come origine per le chiavi pubbliche, ma il `kid` nel JWS firmato non è elencato nel JWKS.
`steps.jws.UnhandledCriticalHeader`	401	Un'intestazione trovata dal criterio Verification JWS nell'intestazione `crit` non è elencata in `KnownHeaders`.
`steps.jws.UnknownException`	401	Si è verificata un'eccezione sconosciuta.
`steps.jws.WrongKeyType`	401	Tipo di chiave specificato errato. Ad esempio, se specifichi una chiave RSA per un algoritmo Elliptic Curve o una chiave curva per un algoritmo RSA.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore Si verifica quando

InvalidAlgorithm Gli unici valori validi sono: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Altri possibili errori di deployment.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, consulta Informazioni importanti sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come indicato nella tabella Errori di runtime sopra. Il nome dell'errore è l'ultima parte del codice dell'errore.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tutti i criteri JWS impostano la stessa variabile in caso di errore.	`jws.JWS-Policy.failed = true`

Esempio di risposta di errore

Per la gestione degli errori, la best practice è intercettare la parte errorcode della risposta all'errore. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

Policy VerifyJWT

Questa sezione descrive i codici e i messaggi di errore restituiti e le variabili di errore impostate da Edge quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Si verifica quando
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	Si verifica quando il criterio di verifica ha più algoritmi.
`steps.jwt.AlgorithmMismatch`	401	L'algoritmo specificato nel criterio di generazione non corrisponde a quello previsto nel criterio di verifica. Gli algoritmi specificati devono corrispondere.
`steps.jwt.FailedToDecode`	401	Il criterio non è stato in grado di decodificare il JWT. Il JWT potrebbe essere danneggiato.
`steps.jwt.GenerationFailed`	401	Il criterio non è stato in grado di generare il JWT.
`steps.jwt.InsufficientKeyLength`	401	Per una chiave di dimensioni inferiori a 32 byte per l'algoritmo HS256, a meno di 48 byte per l'algoritmo HS386 e a meno di 64 byte per l'algoritmo HS512.
`steps.jwt.InvalidClaim`	401	Per una rivendicazione mancante o mancata corrispondenza di una rivendicazione oppure una mancata corrispondenza di intestazione o intestazione.
`steps.jwt.InvalidCurve`	401	La curva specificata dalla chiave non è valida per l'algoritmo Curva ellittica.
`steps.jwt.InvalidJsonFormat`	401	JSON non valido trovato nell'intestazione o nel payload.
`steps.jwt.InvalidToken`	401	Questo errore si verifica quando la verifica della firma JWT non va a buon fine.
`steps.jwt.JwtAudienceMismatch`	401	La rivendicazione del segmento di pubblico non è riuscita alla verifica del token.
`steps.jwt.JwtIssuerMismatch`	401	La rivendicazione dell'emittente non è andata a buon fine durante la verifica del token.
`steps.jwt.JwtSubjectMismatch`	401	La rivendicazione dell'oggetto non è andata a buon fine durante la verifica del token.
`steps.jwt.KeyIdMissing`	401	Il criterio di verifica utilizza un JWKS come origine per le chiavi pubbliche, ma il JWT firmato non include una proprietà `kid` nell'intestazione.
`steps.jwt.KeyParsingFailed`	401	Impossibile analizzare la chiave pubblica a partire dalle informazioni sulla chiave specificate.
`steps.jwt.NoAlgorithmFoundInHeader`	401	Si verifica quando il JWT non contiene un'intestazione dell'algoritmo.
`steps.jwt.NoMatchingPublicKey`	401	Il criterio di verifica utilizza un JWKS come origine per le chiavi pubbliche, ma il `kid` nel JWT firmato non è elencato nel JWKS.
`steps.jwt.SigningFailed`	401	In CreateJWT, per una chiave inferiore alla dimensione minima per gli algoritmi HS384 o HS512
`steps.jwt.TokenExpired`	401	Il criterio tenta di verificare un token scaduto.
`steps.jwt.TokenNotYetValid`	401	Il token non è ancora valido.
`steps.jwt.UnhandledCriticalHeader`	401	Un'intestazione trovata dal criterio JWT di verifica nell'intestazione `crit` non è elencata in `KnownHeaders`.
`steps.jwt.UnknownException`	401	Si è verificata un'eccezione sconosciuta.
`steps.jwt.WrongKeyType`	401	Tipo di chiave specificato errato. Ad esempio, se specifichi una chiave RSA per un algoritmo Elliptic Curve o una chiave curva per un algoritmo RSA.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`InvalidNameForAdditionalClaim`	Il deployment non andrà a buon fine se la dichiarazione utilizzata nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>` è uno dei seguenti nomi registrati: `kid`, `iss`, `sub`, `aud`, `iat`, `exp`, `nbf` o `jti`.
`InvalidTypeForAdditionalClaim`	Se la dichiarazione utilizzata nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>` non è di tipo `string`, `number`, `boolean` o `map`, il deployment non andrà a buon fine.
`MissingNameForAdditionalClaim`	Se il nome della richiesta non è specificato nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>`, il deployment non andrà a buon fine.
`InvalidNameForAdditionalHeader`	Questo errore si verifica quando il nome dell'attestazione utilizzata nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>` è `alg` o `typ`.
`InvalidTypeForAdditionalHeader`	Se il tipo di attestazione utilizzato nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>` non è di tipo `string`, `number`, `boolean` o `map`, il deployment non andrà a buon fine.
`InvalidValueOfArrayAttribute`	Questo errore si verifica quando il valore dell'attributo array nell'elemento secondario `<Claim>` dell'elemento `<AdditionalClaims>` non è impostato su `true` o `false`.
`InvalidValueForElement`	Se il valore specificato nell'elemento `<Algorithm>` non è supportato, il deployment non andrà a buon fine.
`MissingConfigurationElement`	Questo errore si verifica se l'elemento `<PrivateKey>` non viene utilizzato con gli algoritmi della famiglia RSA o se l'elemento `<SecretKey>` non viene utilizzato con gli algoritmi della famiglia HS.
`InvalidKeyConfiguration`	Se l'elemento secondario `<Value>` non è definito negli elementi `<PrivateKey>` o `<SecretKey>`, il deployment non andrà a buon fine.
`EmptyElementForKeyConfiguration`	Se l'attributo ref dell'elemento secondario `<Value>` degli elementi `<PrivateKey>` o `<SecretKey>` è vuoto o non specificato, il deployment non andrà a buon fine.
`InvalidConfigurationForVerify`	Questo errore si verifica se l'elemento `<Id>` viene definito all'interno dell'elemento `<SecretKey>`.
`InvalidEmptyElement`	Questo errore si verifica se l'elemento `<Source>` del criterio JWT di verifica è vuoto. Se presente, deve essere definita con un nome per la variabile di flusso perimetrale.
`InvalidPublicKeyValue`	Se il valore utilizzato nell'elemento secondario `<JWKS>` dell'elemento `<PublicKey>` non ha un formato valido, come specificato in RFC 7517, il deployment non andrà a buon fine.
`InvalidConfigurationForActionAndAlgorithm`	Se l'elemento `<PrivateKey>` viene utilizzato con gli algoritmi della famiglia HS o l'elemento `<SecretKey>` con gli algoritmi della famiglia RSA, il deployment non andrà a buon fine.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tutti i criteri JWT impostano la stessa variabile in caso di errore.	`JWT.failed = true`

Esempio di risposta di errore

Codici di errore dei criteri JWT

Per la gestione degli errori, la best practice è il trap della parte errorcode dell'errore la risposta corretta. Non fare affidamento sul testo in faultstring, perché potrebbe cambiare.

Esempio di regola di errore

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

Policy XMLThreatProtection

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.xmlthreatprotection.ExecutionFailed`	500	Il criterio XMLThreatProtection può generare molti tipi diversi di errori ExecutionFailed. La maggior parte di questi errori si verifica quando viene superata una soglia specifica impostata nel criterio. Questi tipi di errori includono: element name length, numero di bambini, profondità del nodo, conteggio attributi, lunghezza del nome dell'attributo, e molti altri. Puoi visualizzare l'elenco completo nell'argomento Risoluzione degli errori di runtime del criterio XMLThreatProtection.
`steps.xmlthreatprotection.InvalidXMLPayload`	500	Questo errore si verifica se il payload del messaggio di input specificato dall'elemento `<Source>` del criterio XMLThreatProtection non è un documento XML valido.
`steps.xmlthreatprotection.SourceUnavailable`	500	Questo errore si verifica se il messaggio specificata nell'elemento `<Source>` è: Fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) Non è uno dei valori validi `request`, `response`, o `message`
`steps.xmlthreatprotection.NonMessageVariable`	500	Questo errore si verifica se l'elemento `<Source>` è impostato su una variabile che non è di tipo messaggio.

Note:

Il nome dell'errore ExecutionFailed è il nome predefinito dell'errore e verrà restituito indipendentemente dal il tipo di errore rilevato; tuttavia, questo valore predefinito può essere modificato impostando a livello di organizzazione. Quando questa proprietà è impostata, il nome dell'errore rifletterà . Ad esempio, "TextExceeded" o "AttrValueExceeded". Vedi le Note di utilizzo per i dettagli.
Lo stato HTTP 500 è l'impostazione predefinita; tuttavia, lo stato HTTP può essere modificato in 400 per di errore nel flusso di richieste impostando una proprietà a livello di organizzazione. Vedi le Note di utilizzo per i dettagli.

Errori di deployment

Nessuno.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name Matches "SourceUnavailable"`
`xmlattack.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`xmlattack.XPT-SecureRequest.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "XMLThreatProtection[XPT-SecureRequest]: Execution failed. reason: XMLThreatProtection[XTP-SecureRequest]: Exceeded object entry name length at line 2",
    "detail": {
      "errorcode": "steps.xmlthreatprotection.ExecutionFailed"
    }
  }
}

Esempio di regola di errore

<FaultRule name="XML Threat Protection Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ExecutionFailed") </Condition>
    </Step>
    <Condition>(xmlattack.XPT-SecureRequest.failed = true) </Condition>
</FaultRule>

Policy XMLtoJSON

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa
`steps.xmltojson.ExecutionFailed`	500	Questo errore si verifica quando il payload di input (XML) è vuoto o il codice XML di input non è valido o è in un formato non corretto.
`steps.xmltojson.InCompatibleType`	500	Questo errore si verifica se il tipo di variabile definita nell'elemento `<Source>` e la L'elemento `<OutputVariable>` non è uguale. È obbligatorio che il tipo di variabili contenuto all'interno dell'elemento `<Source>` e dell'elemento `<OutputVariable>` corrisponde.
`steps.xmltojson.InvalidSourceType`	500	Questo errore si verifica se il tipo di variabile utilizzato per definire l'elemento `<Source>` è non valido.I tipi di variabili validi sono message e stringa.
`steps.xmltojson.OutputVariableIsNotAvailable`	500	Questo errore si verifica se la variabile specificata nell'elemento `<Source>` del codice XML da utilizzare Il criterio JSON è di tipo stringa e l'elemento `<OutputVariable>` non è definito. L'elemento `<OutputVariable>` è obbligatorio quando la variabile definita in `<Source>` è obbligatorio è di tipo stringa.
`steps.xmltojson.SourceUnavailable`	500	Questo errore si verifica se il messaggio specificata nell'elemento `<Source>` del criterio da XML a JSON è: fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o non può essere risolto (non è definito)

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`EitherOptionOrFormat`	Se uno degli elementi `<Options>` o `<Format>` non è dichiarato nel criterio da XML a JSON, il deployment del proxy API non va a buon fine.
`UnknownFormat`	Se l'elemento `<Format>` all'interno del criterio da XML a JSON presenta un valore sconosciuto definito, il deployment del proxy API non va a buon fine. I formati predefiniti includono: `xml.com`, `yahoo`, `google` e `badgerFish`.

Variabili di errore

Queste variabili vengono impostate quando si verifica un errore di runtime. Per ulteriori informazioni, vedi Cosa devi sapere sugli errori relativi alle norme.

Variabili	Dove	Esempio
`fault.name="fault_name"`	`fault_name` è il nome dell'errore, come elencato nella precedente tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice di errore.	`fault.name = "SourceUnavailable"`
`xmltojson.policy_name.failed`	`policy_name` è il nome specificato dall'utente del criterio che ha generato l'errore.	`xmltojson.XMLtoJSON-1.failed = true`

Esempio di risposta di errore

Nota: per la gestione degli errori, la best practice è il trap errorcode parte della risposta di errore. Non fare affidamento sul testo faultstring, perché potrebbe cambiare.

{
  "fault": {
    "faultstring": "XMLToJSON[XMLtoJSON-1]: Source xyz is not available",
    "detail": {
      "errorcode": "steps.xml2json.SourceUnavailable"
    }
  }
}

Esempio di regola di errore

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="XML to JSON Faults">
    <Step>
        <Name>AM-SourceUnavailableMessage</Name>
        <Condition>(fault.name Matches "SourceUnavailable") </Condition>
    </Step>
    <Step>
        <Name>AM-BadXML</Name>
        <Condition>(fault.name = "ExecutionFailed")</Condition>
    </Step>
    <Condition>(xmltojson.XMLtoJSON-1.failed = true) </Condition>
</FaultRule>

Policy XSLTransform

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore	Stato HTTP	Causa	Correggi
`steps.xsl.XSLSourceMessageNotAvailable`	500	Questo errore si verifica se la variabile del messaggio o della stringa specificata nell'elemento `<Source>` del criterio XSL Transform non rientra nell'ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o non può essere risolta (non è definita).
`steps.xsl.XSLEvaluationFailed`	500	Questo errore si verifica se il payload XML di input non è disponibile/non è in formato corretto oppure se il criterio XSLTransform ha esito negativo o non è in grado di trasformare il file XML di input in base alle regole di trasformazione fornite nel file XSL. L'errore del criterio XSLTransform può essere causato da molte cause diverse. Il motivo dell'errore nel messaggio di errore fornirà ulteriori informazioni sulla causa.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore	Causa	Correggi
`XSLEmptyResourceUrl`	Se l'elemento `<ResourceURL>` nel criterio XSL Transform è vuoto, il deployment del proxy API non va a buon fine.
`XSLInvalidResourceType`	Se il tipo di risorsa specificato nell'elemento `<ResourceURL>` del criterio XSL Transform non è di tipo `xsl`, il deployment del proxy API non riesce.