Encabezado de respuesta de Resource Monitoring Tool de Tableau (RMT)
Este artículo describe cómo configurar encabezados de respuesta personalizados en Resource Monitoring Tool de Tableau. La capacidad de hacer esto se agregó en las versiones de mantenimiento de RMT de agosto de 2024.
Cualquier cambio en los encabezados de respuesta requiere un reinicio de RMT.
Importante: Los cambios en los encabezados de respuesta pueden interrumpir RMT. Si realiza actualizaciones en los encabezados, realice una prueba después de los cambios para confirmar que RMT esté funcionando como debería.
Visualización y actualización de encabezados de respuesta personalizados
Puede ver y cambiar los encabezados de respuesta personalizados usando los comandos rmtadmin get y rmtadmin set.
Obtener una lista de todos los encabezados de respuesta personalizados
Para ver una lista de los encabezados de respuesta personalizados configurados actualmente, ejecute este comando:
rmtadmin get server:web:responseheaders
Por ejemplo:
> 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
Obtener el valor de un encabezado de respuesta personalizado específico
Para obtener un encabezado de respuesta personalizado específico:
rmtadmin get server:web:responseheader:<some header>
Por ejemplo:
> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY
Si intenta obtener o establecer un encabezado de respuesta personalizado inexistente, se muestra este error:
> rmtadmin get server:web:responseheaders:<non-existent header> [ERR] Config key not found. Key: server:web:responseHeaders:<non-existent header>
Puede obtener varias claves. Los duplicados se descartan. Las claves no válidas aparecerán al final:
> 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
Establecer o actualizar un encabezado de respuesta personalizado específico
Para establecer o cambiar un encabezado de respuesta personalizado específico:
rmtadmin set server:web:responseheader:<some header>
Por ejemplo:
> 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
Los encabezados son una cadena del encabezado completo y cualquier par clave-valor (si corresponde).
Por ejemplo, esto establece el tiempo de espera para mantener la conexión y los valores máximos:
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"
Eliminar un encabezado de respuesta personalizado
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options
Eliminar un valor de configuración normal
No puede eliminar un valor de configuración normal y obtendrá un error si intenta hacerlo:
> rmtadmin set db:username --remove [ERR] The --remove argument is not valid for this key. Key: db:username
Establecer un valor de encabezado de respuesta personalizado como un valor vacío
Con todas las claves de rmtadmin set excepto el encabezado de respuesta personalizado, debe incluir un valor. Con los encabezados de respuesta personalizados, puede establecer una clave sin valor. En este ejemplo se establece la clave X-Frame-Options en un valor vacío:
> 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 =
Esto es diferente a eliminar el encabezado X-Frame-Options.
¿Por qué quiere hacer esto? RMT genera algunos encabezados de respuesta personalizados de forma predeterminada y, si desea evitar que RMT incluya un encabezado, puede establecer la clave en un valor vacío.
Por ejemplo, de forma predeterminada, RMT genera un encabezado de respuesta con X-Frame-Options = Deny. Puede crear un encabezado de respuesta personalizado para X-Frame-Options:
> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW
Para volver al valor predeterminado, puede eliminarlo por completo o configurarlo en DENY:
> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
Pero si no desea que RMT envíe nada, puede configurarlo en un valor vacío:
> rmtadmin set server:web:responseheaders:X-Frame-Options
Encabezados no válidos
RMT le permite establecer encabezados de respuesta no válidos. Si el encabezado de respuesta que especifica no es válido, RMT le advertirá pero le permitirá establecer el valor. Es su responsabilidad verificar que RMT esté funcionando correctamente después de actualizar los encabezados de respuesta.
No se puede configurar “responseheaders”. Solo puede establecer claves secundarias individuales dentro del encabezado de respuesta.
rmtadmin set server:web:responseheaders [ERR] Key cannot be set: server:web:responseHeaders
Importante: Pruebe RMT después de realizar cualquier cambio a los encabezados de respuesta.