Come Leggere un Header Personalizzato da un Server Upstream in Nginx?

Utilizzo delle Variabili Nginx per l'Accesso alle Intestazioni

Nginx offre un modo per accedere alle intestazioni personalizzate dai server upstream. Questo metodo utilizza le variabili Nginx, che sono valori che possono essere utilizzati in diverse parti della configurazione di Nginx.

Per accedere alle intestazioni personalizzate, Nginx utilizza un prefisso: $senthttp. Questo prefisso permette di creare variabili che corrispondono a specifiche intestazioni inviate dal server upstream. Il prefisso è seguito dal nome dell'intestazione che si desidera accedere, con i trattini sostituiti da underscore.

Per esempio, per accedere a un'intestazione personalizzata chiamata "My-Custom-Header", si utilizzerebbe la variabile Nginx $sent_http_My_Custom_Header. Questa variabile conterrà il valore di "My-Custom-Header" inviato dal server upstream.

Questo metodo funziona per qualsiasi intestazione personalizzata, rendendolo uno strumento utile per gli amministratori Nginx che devono lavorare con diversi tipi di risposte del server upstream.

log_format custom '$remote_addr - $remote_user [$time_local] "$request" '
                  '$status $body_bytes_sent "$http_referer" '
                  '"$http_user_agent" "$sent_http_My_Custom_Header"';

access_log /var/log/nginx/access.log custom;

Identificare l'Intestazione Personalizzata

Per leggere le intestazioni personalizzate in Nginx, devi trovare l'intestazione nella risposta del server upstream. Le intestazioni personalizzate sono spesso aggiunte dal server upstream (come Apache o un server applicativo) per fornire informazioni aggiuntive.

In questo esempio, l'intestazione personalizzata è:

My-custom-header: 1

Questa intestazione fa parte della risposta HTTP dal server upstream. Nota il nome e il formato dell'intestazione personalizzata, poiché avrai bisogno di queste informazioni per accedervi in Nginx.

Costruire la Variabile Nginx

Dopo aver trovato l'intestazione personalizzata, devi creare la corretta variabile Nginx per accedere al suo valore. Nginx utilizza un formato specifico per le variabili che rappresentano le intestazioni di risposta:

1. Inizia con il prefisso $sent_http_
2. Aggiungi il nome dell'intestazione, sostituendo i trattini con underscore
3. Il nome della variabile non è sensibile alle maiuscole/minuscole

Per l'intestazione personalizzata "My-custom-header", la corretta variabile Nginx sarebbe:

$sent_http_My_custom_header

Questa variabile conterrà il valore di "My-custom-header" inviato dal server upstream. In questo caso, conterrebbe il valore "1".

Aggiungere l'Intestazione al Blocco Location di Nginx

Per utilizzare la variabile dell'intestazione personalizzata in un blocco location, aggiungila al tuo file di configurazione Nginx. Questo ti permette di accedere al valore dell'intestazione all'interno di quella location.

Ecco come utilizzare la variabile dell'intestazione personalizzata in un blocco location:

location / {
    proxy_pass http://backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;

    # Accedi al valore dell'intestazione personalizzata
    add_header X-Custom-Header-Value $sent_http_My_custom_header;
}

In questa configurazione, il valore dell'intestazione personalizzata "My-custom-header" dal server upstream viene aggiunto alla risposta inviata al client utilizzando la direttiva add_header.

log_format custom '$remote_addr - $remote_user [$time_local] "$request" '
                  '$status $body_bytes_sent "$http_referer" '
                  '"$http_user_agent" "$sent_http_My_custom_header"';

access_log /var/log/nginx/access.log custom;

Utilizzo delle Intestazioni Personalizzate in Dichiarazioni Condizionali

Puoi utilizzare i valori delle intestazioni personalizzate in dichiarazioni condizionali nella tua configurazione Nginx. Questo ti permette di prendere decisioni basate sul valore dell'intestazione.

Ecco alcuni esempi di utilizzo delle intestazioni personalizzate in logica condizionale:

1. Reindirizzamento basato sul valore dell'intestazione:

location / {
    if ($sent_http_My_custom_header = "1") {
        return 301 /special-page;
    }
    # L'elaborazione regolare continua qui
}

2. Modifica della risposta basata sul valore dell'intestazione:

location / {
    proxy_pass http://backend;

    if ($sent_http_My_custom_header = "premium") {
        add_header X-User-Type "Premium";
    }
}

3. Controllo dell'accesso basato sul valore dell'intestazione:

location /restricted {
    if ($sent_http_My_custom_header != "authorized") {
        return 403;
    }
    # L'accesso autorizzato continua qui
}

Questi esempi mostrano come puoi utilizzare il valore dell'intestazione personalizzata per controllare il comportamento del tuo server Nginx, permettendo configurazioni più complesse e dinamiche basate sulle risposte del server upstream.