RMT(Tableau Resource Monitoring Tool) 응답 헤더
이 문서에서는 Tableau Resource Monitoring Tool에서 사용자 지정 응답 헤더를 설정하는 방법을 설명합니다. 이 기능은 2024년 8월 RMT 유지 관리 버전에서 추가되었습니다.
응답 헤더를 변경하려면 RMT를 다시 시작해야 합니다.
중요: 응답 헤더를 변경하면 RMT가 중단될 수 있습니다. 헤더를 업데이트한 경우 변경 후 RMT가 제대로 작동하는지 확인하기 위해 테스트를 실시해야 합니다.
사용자 지정 응답 헤더 보기 및 업데이트
rmtadmin get 및 rmtadmin set 명령을 사용하여 사용자 지정 응답 헤더를 보고 변경할 수 있습니다.
모든 사용자 지정 응답 헤더 목록 가져오기
현재 설정된 사용자 지정 응답 헤더 목록을 보려면 다음 명령을 실행하십시오.
rmtadmin get server:web:responseheaders
예를 들면 다음과 같습니다.
> 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
특정 사용자 지정 응답 헤더의 값 가져오기
특정 사용자 지정 응답 헤더를 가져오려면 다음 명령을 실행하십시오.
rmtadmin get server:web:responseheader:<some header>
예를 들면 다음과 같습니다.
> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY
존재하지 않는 사용자 지정 응답 헤더를 가져오거나 설정하려고 하면 다음 오류가 표시됩니다.
> rmtadmin get server:web:responseheaders:<non-existent header> [ERR] Config key not found. Key: server:web:responseHeaders:<non-existent header>
여러 키를 가져올 수 있습니다. 모든 중복 항목은 삭제됩니다. 유효하지 않은 키는 끝에 나열됩니다.
> 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
특정 사용자 지정 응답 헤더 설정 또는 업데이트
특정 사용자 지정 응답 헤더를 설정하거나 변경하려면 다음 명령을 실행하십시오.
rmtadmin set server:web:responseheader:<some header>
예를 들면 다음과 같습니다.
> 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
헤더는 전체 헤더와 키-값 쌍(해당하는 경우)으로 구성된 문자열입니다.
예를 들어, 다음은 유지 제한 시간과 최대값을 설정합니다.
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"
사용자 지정 응답 헤더 제거
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options
일반 구성 값 제거
일반 구성 값은 제거할 수 없으며 제거하려고 하면 오류가 발생합니다.
> rmtadmin set db:username --remove [ERR] The --remove argument is not valid for this key. Key: db:username
사용자 지정 응답 헤더 값을 빈 값으로 설정
사용자 지정 응답 헤더를 제외한 모든 rmtadmin set 키에는 값을 포함해야 합니다. 사용자 지정 응답 헤더를 사용하면 키 값을 없음으로 설정할 수 있습니다. 다음 예에서는 X-Frame-Options 키를 빈 값으로 설정합니다.
> 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 =
이는 X-Frame-Options 헤더를 제거하는 것과 다릅니다.
이를 수행하는 이유는 무엇입니까? RMT는 기본적으로 몇 가지 사용자 지정 응답 헤더를 생성하며, RMT가 헤더를 포함하지 못하게 하려면 키를 빈 값으로 설정하면 됩니다.
예를 들어 기본적으로 RMT는 X-Frame-Options = Deny를 사용하여 응답 헤더를 생성합니다. 이 경우 다음과 같이 X-Frame-Options에 사용자 지정 응답 헤더를 만들 수 있습니다.
> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW
기본값으로 돌아가려면 완전히 제거하거나 DENY로 설정하면 됩니다.
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
그러나 RMT가 아무것도 전송하지 않게 하려면 빈 값으로 설정하면 됩니다.
> rmtadmin set server:web:responseheaders:X-Frame-Options
잘못된 헤더
RMT에서는 잘못된 응답 헤더 설정이 허용됩니다. 지정한 응답 헤더가 유효하지 않은 경우 RMT는 경고를 표시하지만 값을 설정할 수 있도록 허용합니다. 응답 헤더를 업데이트한 후 RMT가 제대로 작동하는지 확인하는 것은 사용자의 책임입니다.
'responseheaders'를 설정할 수 없습니다. 응답 헤더 내에서는 개별 하위 키만 설정할 수 있습니다.
rmtadmin set server:web:responseheaders [ERR] Key cannot be set: server:web:responseHeaders
중요: 응답 헤더를 변경한 후 RMT를 테스트하십시오.