Resource Monitoring Tool van Tableau (RMT)-responskopteksten
In dit artikel wordt beschreven hoe u aangepaste responskopteksten instelt in Resource Monitoring Tool van Tableau. Deze mogelijkheid is toegevoegd in de onderhoudsreleases van RMT van augustus 2024.
Bij elke wijziging in de responskopteksten moet de RMT opnieuw worden gestart.
Belangrijk: wijzigingen in de responskopteksten kunnen de werking van RMT verstoren. Als u kopteksten bijwerkt, test dan direct nadat u de wijzigingen hebt aangebracht of RMT naar behoren functioneert.
Aangepaste responskopteksten bekijken en bijwerken
U kunt aangepaste responskopteksten bekijken en wijzigen met de opdracht rmtadmin get en de opdracht rmtadmin set.
Een lijst van alle aangepaste responskopteksten opvragen
Voer deze opdracht uit om een lijst met aangepaste responskopteksten te bekijken:
rmtadmin get server:web:responseheaders
Bijvoorbeeld:
> 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
De waarde van een specifieke aangepaste responskoptekst opvragen
Voer deze opdracht uit om een specifieke aangepaste responskoptekst op te vragen:
rmtadmin get server:web:responseheader:<some header>
Bijvoorbeeld:
> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY
Als u probeert een niet-bestaande aangepaste responskoptekst op te halen of in te stellen, wordt de volgende foutmelding weergegeven:
> rmtadmin get server:web:responseheaders:<non-existent header> [ERR] Config key not found. Key: server:web:responseHeaders:<non-existent header>
U kunt meerdere sleutels ophalen. Dubbele sleutels worden verwijderd. Ongeldige sleutels worden onder aan de lijst weergegeven:
> 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
Een specifieke aangepaste responskoptekst instellen of bijwerken
U kunt als volgt een specifieke responskoptekst instellen of wijzigen:
rmtadmin set server:web:responseheader:<some header>
Bijvoorbeeld:
> 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
Kopteksten bestaan uit een tekenreeks van de volledige koptekst en eventuele sleutel-waardeparen (indien van toepassing).
Hiermee worden bijvoorbeeld de keep alive-time-out en de maximale waarden ingesteld:
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"
Een aangepaste responskoptekst verwijderen
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options
Een normale configuratiewaarde verwijderen
U kunt een normale configuratiewaarde niet verwijderen en er wordt een foutmelding weergegeven als u dit probeert te doen:
> rmtadmin set db:username --remove [ERR] The --remove argument is not valid for this key. Key: db:username
Een aangepaste responskoptekstwaarde instellen op een lege waarde
U moet bij alle rmtadmin set-sleutels, met uitzondering van de aangepaste responskoptekst, een waarde opgeven. Bij aangepaste responskopteksten kunt u een sleutel instellen op een lege waarde. In dit voorbeeld wordt de sleutel X-Frame-Options ingesteld op een lege waarde:
> 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 =
Dit is iets anders dan het verwijderen van de X-Frame-Options-koptekst.
Waarom zou u dit willen doen? RMT genereert standaard een aantal aangepaste responskopteksten. Als u wilt voorkomen dat RMT een koptekst toevoegt, kunt u de sleutel instellen op een lege waarde.
Standaard genereert RMT bijvoorbeeld een responskoptekst met X-Frame-Options = Deny. U kunt een aangepaste responskoptekst maken voor X-Frame-Options:
> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW
Om terug te gaan naar het standaardgedrag, kunt u deze volledig verwijderen of instellen op DENY:
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
Als u echter niet wilt dat RMT iets verzendt, kunt u de waarde leeg laten:
> rmtadmin set server:web:responseheaders:X-Frame-Options
Ongeldige kopteksten
Met RMT kunt u ongeldige responskopteksten instellen. Als de door u opgegeven responskoptekst niet geldig is, waarschuwt RMT u en kunt u de waarde zelf instellen. Het is uw verantwoordelijkheid om te controleren of RMT juist werkt nadat u de responskopteksten hebt bijgewerkt.
U kunt 'responseheaders' niet instellen. U kunt alleen individuele onderliggende sleutels in de responskoptekst instellen.
rmtadmin set server:web:responseheaders [ERR] Key cannot be set: server:web:responseHeaders
Belangrijk: test RMT na het aanbrengen van elke verandering in de responskopteksten.