Personalizzazione degli Header HTTP restituiti al client

Per personalizzare gli header http restituiti al client è richiesto l’accesso alla govwayConsole in modalità avanzata (sezione Modalità Avanzata).

A partire dall’erogazione o fruizione di una API, accedendo alla sezione Configurazione dell’API in modalità avanzata compare una sezione precedentemente non documentata denominata Opzioni Avanzate. All’interno di tale sezione è possibile agire sulla configurazione della voce HTTP Headers nella sezione Rate Limiting per personalizzare la generazione degli header http (Fig. 113).

Le configurazioni attuabili sono:

• Default: vengono generati tutti gli header HTTP descritti nella sezione Header HTTP utilizzati nelle Policy di Rate Limiting. Il valore degli header “*-Limit” non contiene l’indicazione della finestra temporale;

• Disabilitato: gli header HTTP relativi al RateLimiting non vengono generati;

• Ridefinito: consente di personalizzare gli header HTTP restituiti.

La maschera di configurazione fornirà le seguenti ulteriori voci nel caso venga selezionata la ridefinizione degli header HTTP (Fig. 114):

• Limiti di Quota: consente di personalizzare la generazione degli header “*-Limit”:

  • Abilitato (senza finestra temporale): il valore contiene solamente il numero massimo di richieste effettuabili nella finestra temporale;

  • Abilitato (con finestra temporale): oltre al numero massimo di richieste, viene anche riportata la finestra temporale e le ulteriori finestre delle policy attive che possiedono una medesima metrica ma sono meno restrittive (esempio: X-RateLimit-Limit: 10, 10;w=60, 1000;w=3600);

  • Disabilitato: gli header “*-Limit” non verranno generati;

  • Default: viene utilizzata la modalità indicata nel file di proprietà «govway.properties» che nella configurazione di default del prodotto equivalente alla voce “Abilitato (senza finestra temporale)”.

• Rimanenza della Quota:

  • Abilitato: il valore contiene il numero di richieste ancora effettuabili nella finestra temporale in corso;

  • Disabilitato: gli header “*-Remaining” non verranno generati;

  • Default: viene utilizzata la modalità indicata nel file di proprietà «govway.properties» che nella configurazione di default del prodotto equivalente alla voce “Abilitato”;

• Reset della Quota (secondi):

  • Abilitato: il valore contiene il numero di secondi mancanti alla prossima finestra temporale;

  • Disabilitato: gli header “*-Reset” non verranno generati;

  • Default: viene utilizzata la modalità indicata nel file di proprietà «govway.properties» che nella configurazione di default del prodotto equivalente alla voce “Abilitato”;

• Retry-After:

  • Abilitato (con backoff): l’header viene valorizzato sommando al numero di secondi mancante alla prossima finestra temporale un tempo di backoff rappresentato da un numero random di secondi tra 0 e un intervallo massimo configurabile da console;

  • Abilitato (senza backoff): l’header viene valorizzato solamente con il numero di secondi mancante alla prossima finestra temporale;

  • Disabilitato: l’header non viene generato;

  • Default: viene utilizzata la modalità indicata nel file di proprietà «govway.properties» che nella configurazione di default del prodotto equivalente alla voce “Abilitato (con backoff)” dove l’intervallo massimo di backoff è 60 secondi.

Oltre a personalizzare la gestione degli header http puntualmente su una erogazione o fruizione è possibile attuare una configurazione, identica a quanto già precedentemente descritto, a livello globale di GovWay agendo nella sezione Rate Limiting presente nella maschera di configurazione del Controllo del Traffico (sezione Rate Limiting).