Intestazioni di risposta in Tableau Resource Monitoring Tool (RMT)
Questo articolo illustra come impostare le intestazioni di risposta personalizzate in Tableau Resource Monitoring Tool. Questa possibilità è stata aggiunta nelle versioni di manutenzione di Resource Monitoring Tool di agosto 2024.
Eventuali modifiche apportate alle intestazioni di risposta richiedono un riavvio di RMT.
Importante: le modifiche alle intestazioni di risposta possono causare un'interruzione di Resource Monitoring Tool. Se apporti aggiornamenti alle intestazioni, effettua un test per verificare il funzionamento di Resource Monitoring Tool.
Visualizzazione e aggiornamento delle intestazioni di risposta personalizzate
È possibile visualizzare e modificare le intestazioni di risposta personalizzate utilizzando i comandi rmtadmin get e rmtadmin set.
Ottenere un elenco di tutte le intestazioni di risposta personalizzate
Per visualizzare un elenco delle intestazioni di risposta personalizzate attualmente impostate, esegui questo comando:
rmtadmin get server:web:responseheaders
Ad esempio:
> rmtadmin get server:web:responseheaders server:web:responseHeaders:Access-Control-Allow-Origin = * server:web:responseHeaders:Connection = Keep-Alive server:web:responseHeaders:X-Frame-Options = DENY server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large
Ottenere il valore di un’intestazione di risposta personalizzata specifica
Per ottenere un’intestazione di risposta personalizzata specifica:
rmtadmin get server:web:responseheader:<some header>
Ad esempio:
> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY
Se tenti di ottenere o impostare un’intestazione di risposta personalizzata inesistente, viene visualizzato questo errore:
> rmtadmin get server:web:responseheaders:<non-existent header> [ERR] Config key not found. Key: server:web:responseHeaders:<non-existent header>
È possibile ottenere più chiavi. Eventuali duplicati vengono eliminati. Le chiavi non valide saranno elencate alla fine:
> rmtadmin get server:web:responseheaders server:web:responseheaders:SomethingNew server:web:responseHeaders:Connection server:web:responseHeaders:Access-Control-Allow-Origin = * server:web:responseHeaders:Connection = Keep-Alive server:web:responseHeaders:X-Frame-Options = DENY server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large [ERR] Config key not found. Key: server:web:responseheaders:SomethingNew
Impostare o aggiornare un’intestazione di risposta personalizzata specifica
Per impostare o modificare un’intestazione di risposta personalizzata specifica:
rmtadmin set server:web:responseheader:<some header>
Ad esempio:
> rmtadmin set server:web:responseheaders:X-Frame-Options = Allow Config value set successfully. Key: server:web:responseHeaders:X-Frame-Options server:web:responseHeaders:X-Frame-Options = Allow
Le intestazioni sono una stringa composta dall’intestazione completa e da eventuali coppie chiave-valore (se applicabili).
Ad esempio, questa stringa imposta il timeout keep-alive e i valori massimi:
rmtadmin set server:web:responseheader:connection "Keep-Alive: timeout=5, max=997" Config value set successfully. Key: server:web:responseHeaders:Connection server:web:responseHeaders:Connection = "Keep-Alive: timeout=5, max=997"
Rimuovere un’intestazione di risposta personalizzata
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options
Rimuovere un valore di configurazione normale
Non è possibile rimuovere un valore di configurazione normale. Se tenti di eseguire questa operazione, verrà visualizzato un errore:
> rmtadmin set db:username --remove [ERR] The --remove argument is not valid for this key. Key: db:username
Impostazione di un valore di intestazione di risposta personalizzata su un valore vuoto
Con tutte le chiavi rmtadmin set eccetto l’intestazione di risposta personalizzata, è necessario includere un valore. Con le intestazioni di risposta personalizzate puoi impostare una chiave su nessun valore. In questo esempio la chiave X-Frame-Options viene impostata su un valore vuoto:
> rmtadmin set server:web:responseheaders:X-Frame-Options Config value set successfully. Key: server:web:responseheaders:X-Frame-Options server:web:responseheaders:X-Frame-Options =
Questa operazione è diversa dalla rimozione dell’intestazione X-Frame-Options.
Perché eseguire questa operazione? RMT genera alcune intestazioni di risposta personalizzate per impostazione predefinita. Se vuoi impedire a RMT di includere un’intestazione, puoi impostare la chiave su un valore vuoto.
Ad esempio, per impostazione predefinita RMT genera un’intestazione di risposta con X-Frame-Options = Deny. Puoi creare un’intestazione di risposta personalizzata per X-Frame-Options:
> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW
Per tornare all’impostazione predefinita, puoi rimuoverla completamente o impostarla su DENY:
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
Ma se non desideri che RMT invii un’intestazione, puoi impostarla su un valore vuoto:
> rmtadmin set server:web:responseheaders:X-Frame-Options
Intestazioni non valide
Resource Monitoring Tool consente di impostare intestazioni di risposta non valide. Se l'intestazione della risposta specificata non è valida, Resource Monitoring Tool ti avviserà ma ti consentirà di impostare il valore. Devi assicurarti che Resource Monitoring Tool funzioni correttamente dopo aver aggiornato le intestazioni di risposta.
Non è possibile impostare “responseheaders”. È possibile impostare solo singole chiavi figlio all’interno dell’intestazione di risposta.
rmtadmin set server:web:responseheaders [ERR] Key cannot be set: server:web:responseHeaders
Importante: verifica il funzionamento di Resource Monitoring Tool dopo aver apportato un qualunque cambiamento alle intestazioni di risposta.