Capacidad

Modificación del Cuerpo de Respuesta

Aplique enmascaramiento, sustitución e inyección HTML al cuerpo de respuesta sin tocar el código del backend.

TR7 Modificación del Cuerpo de Respuesta le permite transformar el contenido que devuelve su backend antes de que llegue al cliente — completamente en la capa ADC/WAAP. El enmascaramiento de datos sensibles, la sustitución basada en cadenas o regex, la inyección de etiquetas HTML y las pequeñas correcciones de respuesta pueden aplicarse sin cambiar ningún código de la aplicación. Esta capacidad es especialmente valiosa para aplicaciones heredadas. Un servicio más antiguo puede exponer campos sensibles demasiado abiertamente, producir enlaces codificados de forma fija, omitir banners requeridos o devolver contenido HTML/JSON que necesita ajustes. TR7 aplica estas transformaciones como reglas de tráfico centralizadas sobre el cuerpo de respuesta. Los modos mask, replace y htmlTag se gestionan bajo la misma familia de acciones. El comportamiento de las reglas puede ajustarse con precisión a través de parámetros como el carácter de máscara, offset, conteo mínimo de coincidencias, sensibilidad a mayúsculas y tipo de coincidencia. El resultado: TR7 ajusta la respuesta que produce su backend para cumplir con los requisitos de seguridad, cumplimiento y modernización en el punto de salida final — resolviendo fugas de datos sensibles, problemas de enlaces heredados y necesidades de corrección de contenido de forma independiente al ciclo de release de la aplicación.

3
Modos de modificación: mask, replace, htmlTag
16 KB
Límite de cuerpo predeterminado — puede elevarse a cientos de MB cuando sea necesario
0
Cambios en el código de la aplicación — todas las transformaciones en la capa ADC/WAAP

Una pequeña fuga de datos en el cuerpo de respuesta es un riesgo operacional si no puede cerrarse sin un cambio de código.

Los backends no siempre producen respuestas ideales. Las aplicaciones heredadas pueden devolver números de identidad, números de tarjeta, direcciones de email, nombres de host internos, enlaces antiguos o información técnica innecesaria. Dado que estos valores aparecen dentro del cuerpo de respuesta en lugar de en los headers, no pueden corregirse con una regla de header estándar.

Corregir el problema en el código de la aplicación es a menudo lento. El servicio puede pertenecer a un equipo diferente, el calendario de releases puede estar a meses de distancia, o el código fuente puede ser difícil de cambiar debido a tecnología envejecida. Sin embargo, el equipo de seguridad y cumplimiento necesita que la fuga se cierre de inmediato.

Intervenir en el cuerpo de respuesta sin cuidado puede crear nuevos riesgos. Un regex mal escrito puede corromper una página completa, la inyección HTML puede aterrizar en el lugar equivocado, y procesar respuestas muy grandes puede afectar el rendimiento. Las reglas de modificación del cuerpo deben aplicarse por lo tanto con parámetros controlados y un alcance bien definido.

El enfoque correcto es gestionar las operaciones de mask, replace y HTML tag sobre el cuerpo de respuesta como reglas de tráfico centralizadas. Una regla debe saber a qué path, content-type o condición aplica; el comportamiento de coincidencia y los límites de tamaño del cuerpo deben estar definidos explícitamente.

TR7 Modificación del Cuerpo de Respuesta enmascara, sustituye o inyecta HTML en el contenido de respuesta sin cambiar el código del backend — resolviendo fugas de datos y necesidades de corrección heredada en la capa ADC/WAAP.

Nuestro enfoque

TR7 gestiona la modificación del cuerpo de respuesta a través de tres modos principales: enmascaramiento, sustitución e inyección de etiquetas HTML.

El modo mask oculta valores sensibles antes de que se vean

El modo mask reemplaza una porción de una cadena o valor coincidente con regex con un carácter de máscara. La configuración de offset y coincidencia mínima reduce el riesgo de falsos positivos.

El modo replace sustituye el contenido de respuesta de forma controlada

El modo replace intercambia una cadena específica o coincidencia regex por un nuevo valor. Se usa para corregir enlaces heredados, ocultar nombres de host internos o normalizar pequeños problemas de respuesta.

El modo HTML tag inyecta contenido controlado en la página

El modo htmlTag puede insertar scripts, banners, meta tags o fragmentos HTML similares en una respuesta — sin tocar la plantilla de la aplicación.

Las condiciones y límites de tamaño aseguran una aplicación segura

Las reglas de modificación del cuerpo pueden delimitarse a un vService, path, content-type o condición de tráfico específicos. El límite de cuerpo predeterminado se mantiene bajo y puede elevarse deliberadamente cuando sea necesario.

Capacidades

La Modificación del Cuerpo de Respuesta realiza cambios controlados en los cuerpos de respuesta para propósitos de seguridad, cumplimiento y modernización heredada.

La acción modifyResponse centraliza la edición del cuerpo de respuesta

TR7 convierte los cambios de contenido en reglas centralizadas a través de la acción modifyResponse, que opera sobre el cuerpo de respuesta. La regla se ejecuta durante la fase de respuesta y procesa el cuerpo que llega del backend antes de reenviarlo al cliente. Esta estructura permite correcciones rápidas sin depender del código de la aplicación, las plantillas o el proceso de release del backend — y es especialmente valiosa para cerrar brechas de seguridad críticas en aplicaciones heredadas.

El modo mask puede ocultar campos sensibles carácter por carácter

El modo mask reemplaza un valor capturado con un carácter de máscara elegido. El carácter de máscara se define como un único carácter y por defecto es `*`. Una configuración de offset permite que un número especificado de caracteres al inicio o al final permanezcan visibles. Esto protege los datos sensibles en campos como números de tarjeta, números de identidad, IDs de pacientes o direcciones de email preservando la visibilidad parcial.

El modo replace sustituye texto obsoleto o arriesgado por un nuevo valor

El modo replace intercambia una cadena específica o coincidencia regex por un nuevo valor. Los nombres de host internos, dominios antiguos, enlaces incorrectos, endpoints deprecated o detalles técnicos en una respuesta pueden corregirse. La operación normaliza la salida del backend en el punto de salida final. El cliente recibe contenido correcto y seguro sin ningún cambio en el código de la aplicación.

El modo htmlTag puede añadir banners, scripts o meta contenido a una página

El modo htmlTag inserta etiquetas específicas o contenido en una respuesta HTML. Es útil para avisos de mantenimiento, banners de seguridad, texto de cumplimiento o pequeñas correcciones del lado del cliente. El enfoque añade contenido a nivel de respuesta sin modificar la plantilla de la aplicación. Las reglas pueden delimitarse a un path específico o condición de host para una aplicación controlada.

Los matchers de cadenas y regex cubren diferentes patrones de contenido

Un matcher de cadenas está disponible para la coincidencia literal simple. Puede seleccionarse un matcher regex para patrones más complejos. El regex ayuda a capturar valores variables como números de identidad, formatos de tarjeta, direcciones de email o patrones personalizados de la organización. Los operadores pueden elegir la coincidencia literal rápida o la coincidencia flexible basada en patrones según sus necesidades.

La configuración de sensibilidad a mayúsculas y caracteres omitidos refina la precisión de coincidencia

La sensibilidad a mayúsculas puede ser crítica en algún contenido de respuesta. TR7 puede controlar el comportamiento del matcher con una configuración de sensibilidad a mayúsculas. Opciones como caracteres omitidos permiten preservar caracteres específicos durante el enmascaramiento. Esto produce una salida de enmascaramiento más legible para números de teléfono, IBANs, números de tarjeta o valores con formato personalizado.

El offset de máscara proporciona visibilidad controlada como mostrar los últimos cuatro dígitos

El enmascaramiento completo no siempre es deseable. Para propósitos de auditoría o experiencia de usuario, los últimos cuatro dígitos, los primeros caracteres o una sección de formato específica pueden dejarse visibles. El offset de máscara convierte este comportamiento en un parámetro de regla. Se aplica un estándar de enmascaramiento parcial sin ningún código de aplicación.

El umbral de coincidencia mínimo reduce el impacto de los falsos positivos

Algunos patrones pueden producir coincidencias accidentales únicas. Una configuración de conteo mínimo de coincidencias significa que una regla solo se aplica cuando se encuentra un número especificado de coincidencias. Esto ayuda a evitar que un enmascaramiento demasiado agresivo corrompa una página. Los patrones de datos sensibles se aplican de manera más segura y predecible.

El límite de tamaño del cuerpo mantiene el equilibrio entre rendimiento y seguridad

Procesar el cuerpo de respuesta es más costoso que las reglas de header. TR7 opera con un tamaño de cuerpo limitado por defecto; este valor puede elevarse cuando sea necesario. El impacto en rendimiento y memoria debe considerarse para respuestas muy grandes. Los operadores deben ejecutar reglas de modificación del cuerpo solo en los servicios y content-types donde sean necesarias.

Aplicable a escenarios de respuesta JSON, HTML y texto plano

La modificación del cuerpo puede aplicarse a respuestas de API JSON, páginas HTML o salida en texto plano. El enmascaramiento de campos sensibles en JSON, la inyección de banners en HTML y la ocultación de información interna en texto plano están todos soportados. Las reglas pueden restringirse por condiciones de content-type y path. Esta flexibilidad permite gestionar diferentes tipos de aplicaciones con la misma acción.

Funciona junto con el enmascaramiento de datos sensibles y la prevención de fuga de datos

La modificación del cuerpo de respuesta es uno de los mecanismos de cumplimiento en el lado de la respuesta de una estrategia de enmascaramiento de datos sensibles. Cuando el enmascaramiento de IP en logs, el cifrado de cookies y el enmascaramiento del cuerpo de respuesta se usan juntos, se logra un control más amplio de fuga de datos. Incluso si el backend devuelve más datos de los previstos, TR7 puede intervenir en el punto de salida final. Esto proporciona a los equipos de cumplimiento una sólida capa de seguridad adicional.

La modificación condicional del cuerpo puede construirse con el motor de reglas de tráfico

Una regla de modificación del cuerpo no tiene que ejecutarse en cada respuesta. Puede dispararse por host, path, código de estado, content-type, usuario, IP de origen u otras condiciones FX. Esto asegura que la modificación se aplique solo en endpoints sensibles o para grupos de usuarios específicos. Se reduce tanto el coste de rendimiento innecesario como el riesgo de sustitución no deseada.

Profundidad operacional

La modificación del cuerpo de respuesta debe diseñarse junto con el tipo de matcher, el tamaño del cuerpo, el alcance de content-type, la compresión, el comportamiento de streaming y la visibilidad de auditoría.

01

Tipo de matcher

Un matcher de cadenas es adecuado para coincidencias rápidas y deterministas. Un matcher regex es más flexible pero puede coincidir demasiado ampliamente si está mal escrito. Se recomienda la prueba en una condición de alcance estrecho para reglas críticas.

02

Tamaño del cuerpo

El límite de cuerpo predeterminado se mantiene pequeño y puede elevarse cuando sea necesario. Procesar respuestas grandes crea overhead de memoria y latencia. Si el límite necesita elevarse a cientos de MB, el alcance del endpoint debe restringirse cuidadosamente.

03

Alcance de content-type

Las reglas deben restringirse solo a respuestas JSON, HTML o de texto. La modificación del cuerpo no debe aplicarse a archivos binarios, archivos comprimidos o respuestas multimedia. Un filtro de content-type es importante para la operación segura.

04

Comportamiento de compresión

Si una respuesta está comprimida, el contenido debe estar en un estado procesable antes de que pueda ejecutarse la modificación del cuerpo. La secuencia de compresión y modificación debe planificarse correctamente. De lo contrario, el matcher no verá el texto esperado.

05

Impacto en streaming

La modificación del cuerpo en respuestas de streaming requiere un manejo más cuidadoso. Los límites de coincidencia y el comportamiento del buffer importan para el contenido chunked. El alcance de la regla debe mantenerse estrecho para streams grandes o continuos.

06

Visibilidad de auditoría

Qué regla se ejecutó contra qué respuesta puede registrarse. En lugar de registrar el valor sensible en sí, deben conservarse metadatos como nombre de regla, endpoint y conteo de coincidencias. Esto produce un registro de auditoría más seguro para la revisión de cumplimiento y seguridad.

Cuándo usarlo

Enmascaramiento parcial de números de tarjeta en respuestas de API

Una aplicación financiera puede devolver números de tarjeta en su respuesta. TR7 enmascara todo excepto los últimos cuatro dígitos, reduciendo el riesgo de exposición de datos sensibles.

Ocultación de identidad del paciente en un portal de salud

Una aplicación de salud heredada puede devolver IDs de pacientes o información de identidad en su respuesta. TR7 oculta estos campos con enmascaramiento basado en regex antes de que lleguen al usuario.

Reescritura de enlaces de dominio antiguo a un nuevo dominio

Una respuesta HTML puede contener referencias a dominios antiguos o nombres de host internos. El modo replace sustituye estos enlaces por el nuevo dominio público, facilitando el proceso de migración.

Inyección de un banner de seguridad o mantenimiento en páginas HTML

Cuando la plantilla de la aplicación no puede cambiarse, TR7 puede usar el modo htmlTag para añadir un banner o fragmento informativo a la página. Esto proporciona una solución práctica para avisos temporales de mantenimiento y cumplimiento.

Limpieza de fugas de información interna en la salida de respuesta

Un backend puede devolver direcciones IP internas, nombres de host o información de versión técnica en su respuesta. TR7 elimina esta información antes de que llegue al cliente usando una regla de replace o mask.

Preguntas frecuentes

¿Pueden usarse los modos mask, replace y htmlTag juntos en la misma configuración?
Cada modo se define con su propio parámetro de acción y puede vincularse a reglas separadas dentro del mismo vService. Por ejemplo, una regla puede enmascarar números de tarjeta mientras otra reemplaza enlaces de dominio antiguo. Cada regla debe delimitarse con su propia condición de path y content-type.
¿Cómo funciona el offset de máscara y cómo se dejan visibles los últimos cuatro dígitos?
El offset de máscara define el inicio o el final del enmascaramiento por conteo de caracteres. Para dejar visibles los últimos cuatro caracteres, el valor de offset puede establecerse en -4. Este enfoque aplica un estándar de visibilidad parcial para números de tarjeta, campos de identidad o IBANs sin ningún código de aplicación.
¿Por qué importa el tamaño del cuerpo y cómo se configura?
Procesar el cuerpo de respuesta es más costoso que aplicar reglas de header. El límite predeterminado se mantiene pequeño; puede elevarse deliberadamente cuando sea necesario. Si el límite necesita alcanzar cientos de MB, las reglas solo deben ejecutarse en los endpoints y content-types relevantes.
¿Cómo puedo reducir el riesgo de falsos positivos al usar un matcher regex?
Puede configurarse un umbral de conteo mínimo de coincidencias para que la regla solo se active cuando se encuentra un número especificado de coincidencias. La regla también debe restringirse con un path, content-type o condición de código de estado específico. Se recomienda la verificación en un entorno de prueba de alcance estrecho antes de aplicar reglas críticas en producción.
¿Cuál es la diferencia entre esta capacidad y la reescritura de respuesta mencionada en la página de Reglas Conscientes del Contenido?
La página de Reglas Conscientes del Contenido cubre el lado de enrutamiento de tráfico y scoring WAAP de la inspección del cuerpo. La Modificación del Cuerpo de Respuesta se enfoca en el mecanismo de transformación — los modos mask, replace y htmlTag — aplicados al cuerpo de respuesta. Usados juntos, tanto la decisión como la transformación se gestionan en la misma plataforma.
¿Afecta esta capacidad a CSP, HSTS u otros headers de seguridad?
La modificación del cuerpo de respuesta opera solo sobre el cuerpo de respuesta. Los headers de seguridad como CSP, HSTS y X-Frame-Options no se ven afectados. Debe usarse una familia de reglas de header separada para la manipulación de headers. Las reglas de cuerpo y header pueden aplicarse independientemente entre sí.

Transforme el contenido de respuesta sin tocar el código del backend

Enmascaramiento de datos sensibles, reescritura de enlaces heredados e inyección de banners mediante los modos mask, replace y htmlTag. Déjenos guiarle por una configuración en vivo sobre sus propios servicios.