Tableau Resource Monitoring Tool (RMT) Response Header
In diesem Artikel wird beschrieben, wie Sie benutzerdefinierte Response Header (Anwortkopfzeilen) in Tableau Resource Monitoring Tool festlegen. Diese Möglichkeit wurde in den RMT-Wartungsversionen vom August 2024 hinzugefügt.
Jede Änderung an Response Headern erfordert einen Neustart von RMT.
Wichtig: Änderungen an Response Headern können RMT zum Absturz bringen. Wenn Sie Aktualisierungen an Headern vornehmen, testen Sie nach etwaigen Änderungen, ob RMT wie erwartet funktioniert.
Anzeigen und Aktualisieren von benutzerdefinierten Response Headern
Sie können benutzerdefinierte Response Header mithilfe der Befehle rmtadmin get und rmtadmin set anzeigen und ändern.
Abrufen einer Liste aller benutzerdefinierten Response Header
Um eine Liste der aktuell festgelegten benutzerdefinierten Response Header anzuzeigen, führen Sie den folgenden Befehl aus:
rmtadmin get server:web:responseheaders
Beispiel:
> 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
Abrufen des Werts eines bestimmten benutzerdefinierten Response Headers
So rufen Sie einen bestimmten benutzerdefinierten Response Header ab:
rmtadmin get server:web:responseheader:<some header>
Beispiel:
> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY
Wenn Sie versuchen, einen nicht vorhandenen benutzerdefinierten Response Header abzurufen oder festzulegen, wird dieser Fehler angezeigt:
> rmtadmin get server:web:responseheaders:<non-existent header> [ERR] Config key not found. Key: server:web:responseHeaders:<non-existent header>
Sie können mehrere Schlüssel erhalten. Alle Duplikate werden verworfen. Ungültige Schlüssel werden am Ende aufgelistet:
> 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
Festlegen oder Aktualisieren eines bestimmten benutzerdefinierten Response Headers
Wenn Sie einen benutzerdefinierten Response Header festlegen oder ändern möchten, führen Sie den folgenden Befehl aus:
rmtadmin set server:web:responseheader:<some header>
Beispiel:
> 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
Header bestehen aus einer Zeichenfolge des vollständigen Headers sowie etwaigen Schlüssel-Wert-Paaren (sofern vorhanden).
Beispiel: Der folgende Befehl legt Timeout- und Maximalwerte für „Keep-Alive“ fest:
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"
Entfernen eines benutzerdefinierten Response Headers
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options
Entfernen eines regulären Konfigurationswerts
Sie können keinen regulären Konfigurationswert entfernen. Wenn Sie dies versuchen, erhalten Sie eine Fehlermeldung:
> rmtadmin set db:username --remove [ERR] The --remove argument is not valid for this key. Key: db:username
Festlegen eines benutzerdefinierten Response Header-Werts auf einen leeren Wert
Sie müssen für alle rmtadmin set-Schlüssel mit Ausnahme des benutzerdefinierten Response Headers ie einen Wert angeben. Mit benutzerdefinierten Response Headern können Sie einen Schlüssel auf keinen Wert festlegen. In diesem Beispiel wird der Schlüssel „X-Frame-Options“ auf und einen leeren Wert festgelegt:
> 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 =
Dies unterscheidet sich vom Entfernen des X-Frame-Options-Headers.
Was sind die möglichen Gründe für eine solche Aktion? RMT generiert standardmäßig einige benutzerdefinierte Response Header. Wenn Sie verhindern möchten, dass RMT einen Header einschließt, können Sie den Schlüssel auf einen leeren Wert festlegen.
Beispielsweise generiert RMT standardmäßig einen Response Header mit X-Frame-Options = Deny. Sie können einen benutzerdefinierten Response Header für X-Frame-Optionen erstellen:
> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW
Um zum Standardzustand zurückzukehren, können Sie ihn vollständig entfernen oder auf DENY setzen:
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
Wenn Sie jedoch nicht möchten, dass RMT etwas sendet, können Sie einen leeren Wert festlegen:
> rmtadmin set server:web:responseheaders:X-Frame-Options
Ungültige Header
RMT erlaubt Ihnen, ungültige Response Header festzulegen. Wenn der von Ihnen angegebene Response Header ungültig ist, wird RMT Sie zwar warnen, Ihnen jedoch erlauben, den Wert festzulegen. Es liegt in Ihrer Verantwortung, zu überprüfen, dass RMT nach dem Aktualisieren von Response Headern ordnungsgemäß funktioniert.
Sie können keine „responseheaders“ festlegen. Sie können nur einzelne untergeordnete Schlüssel innerhalb des Response Headers festlegen.
rmtadmin set server:web:responseheaders [ERR] Key cannot be set: server:web:responseHeaders
Wichtig: Testen Sie RMT, nachdem Sie Änderungen an Response Headern vorgenommen haben.