Che cos'è un criterio?

Guarda questo video per un'introduzione all'applicazione e all'associazione delle norme.

Tipi di criteri

Tecnicamente, un criterio è un file di configurazione in formato XML. Struttura di ogni tipo di criterio (ad es. gli elementi di configurazione obbligatori e facoltativi) viene definito da un Schema XML. Se conosci bene gli strumenti XML, vale la pena familiarizzare con gli schemi delle norme Esempi della piattaforma API su GitHub.

I tipi di criteri Apigee sono raggruppati nelle seguenti categorie funzionali:

Gestione del traffico

I criteri nella categoria di gestione del traffico ti consentono di controllare il flusso di messaggi di richiesta e risposta tramite un proxy API. Questi criteri supportano sia operazioni a livello aziendale. Ti consentono di controllare la larghezza di banda non elaborata e possono anche controllare il traffico su base app. I tipi di criteri di gestione del traffico ti consentono di applicare le quote e anche di mitigare gli attacchi di tipo denial of service.

Sicurezza

I criteri nella categoria Sicurezza supportano l'autenticazione, l'autorizzazione e la sicurezza basata sui contenuti.

Mediazione

I criteri nella categoria Mediazione ti consentono di manipolare attivamente i messaggi mentre passano attraverso i proxy API. Consentono di trasformare i formati dei messaggi, da XML a JSON (e viceversa) o di trasformare un formato XML in un altro. Ti consentono inoltre di analizzare i messaggi, generare nuovi messaggi e modificare i valori dei messaggi in uscita. Mediazione i criteri interagiscono anche con i servizi di base esposti da Apigee, consentendoti di recuperare i dati su app, sviluppatori, token di sicurezza e prodotti API in fase di runtime.

Estensione

I criteri nella categoria di estensione ti consentono di sfruttare l'estensibilità di Apigee per implementare un comportamento personalizzato nel linguaggio di programmazione che preferisci.

Ogni tipo di criterio è documentato in dettaglio nel Panoramica della sezione Riferimento alle norme. Questo argomento mostra l'interazione generale, spiegando come creare i criteri e come collegarli ai flussi in una configurazione del proxy API.

Implementazione di modifiche ai criteri

Affinché le modifiche ai criteri vengano applicate, devi eseguire il deployment della revisione del proxy API in un ambiente. Dopo aver allegato un criterio o apportato modifiche a un criterio esistente, utilizza l'interfaccia utente di Apigee o l'API Apigee per eseguire il deployment delle modifiche.

Verificare l'applicazione dei criteri

Per verificare che un criterio venga applicato correttamente, l'API deve essere invocata da un client HTTP. A verifica questa configurazione Quota, invia più richieste all'API, superando il limite di quota che hai impostato nel criterio per le quote. Il percorso URI, configurato come impostazione del percorso di base in ProxyEndpoint, nella richiesta di seguito è /weather.

http://{org_name}-test.apigee.net/weather/forecastrss?w=12797282

Dopo aver inviato più di una richiesta entro un minuto, dovresti visualizzare il seguente messaggio di errore:

{  
   "fault":{  
      "faultstring":"policies.ratelimit.QuotaViolation",
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      }
   }
}

Questo indica che il criterio Quota è applicato da Apigee.

Gestione degli errori basata su criteri

Prendi nota del formato del messaggio di errore riportato sopra. Contiene una proprietà faultstring e una proprietà errorcode. In molti casi, è necessario implementare un comportamento per a gestire questi errori. Ad esempio, potresti voler inviare un messaggio personalizzato a uno sviluppatore la cui l'app ha superato Quota.

Per saperne di più sulla gestione degli errori, consulta Gestione degli errori.

Best practice: insiemi di norme comuni

Per soddisfare i requisiti di gestione di base, i proxy API in genere applicano i seguenti criteri:

Convalida di base delle chiavi API

1. SpikeArrest
2. XMLThreatProtection o JSONThreatProtection
3. Convalida delle chiavi API
4. Quota
5. ResponseCache

1. ResponseCache

Trasformazione di base: da JSON a XML

1. SpikeArrest
2. JSONThreatProtection
3. Convalida delle chiavi API
4. Quota
5. JSONToXML

1. XMLToJSON
2. ResponseCache