Enmascarado
Qué oculta Sypnia en las grabaciones y en los eventos sin que se lo pidas, qué puedes ocultar tú, qué le hace exactamente el enmascarado a la página, y cómo comprobarlo.
En esta página
- Lo que trae por defecto un proyecto nuevo
- Qué puedes agregar
- Enmascarar un elemento: data-sypnia-mask
- Dejar un elemento fuera: data-sypnia-block
- Enmascarar todo el texto: maskAllText
- Apagar la grabación en una ruta
- Qué hace exactamente el enmascarado
- Qué campos cuentan como contraseña, tarjeta o código de un solo uso
- Qué no cubre el enmascarado
- Comprueba tu enmascarado
- Abre la página en desarrollo
- Asegúrate de que la sesión se grabe
- Mira la grabación
- Arregla lo que ves, y repite
- Ejemplo: el checkout de la tienda
- Referencia
Esta página es para quien decide qué puede mostrar una grabación. El enmascarado lo hace el SDK del navegador, así que funciona igual para el motor de código abierto y para Sypnia Cloud. Esta página da las reglas; las opciones y sus nombres exactos en código están en Privacidad y enmascarado.
El enmascarado ocurre en el navegador de la persona, antes de enviar nada. El contenido enmascarado nunca llega a Sypnia, así que después no se puede mostrar, filtrar ni enviar a un modelo.
Lo que trae por defecto un proyecto nuevo
| Contenido | Por defecto | ¿Lo puedes cambiar? |
|---|---|---|
| Lo que una persona escribe, en cualquier campo. Incluye la opción elegida en una lista desplegable y el texto de un área editable. | Enmascarado, siempre | No. No hay ninguna opción para grabar texto escrito. |
| El contenido de los campos de contraseña, de tarjeta y de código de un solo uso | Enmascarado, siempre | No. |
| Campos ocultos | Se les quita el valor | No. |
| El texto que muestra la página | Se graba tal como se ve | Sí: enmascara un elemento, o todo el texto. |
| Marcos y videos | Quedan fuera | No. |
| Dibujos en canvas | No se graban | No. |
| Imágenes | No se copian; el reproductor las carga desde su propia dirección | Deja una fuera con un bloqueo. |
El valor por defecto está hecho para que un proyecto que nadie configuró no grabe secretos. Igual graba el texto que muestran tus páginas. Si tus páginas muestran cosas que no se deben ver, usa las opciones de abajo.
Qué puedes agregar
Enmascarar un elemento: data-sypnia-mask
Pon el atributo en cualquier elemento. Todo lo que hay dentro se enmascara: el texto, los valores de los campos, y lo que aparezca ahí después.
<section data-sypnia-mask>
<h2>Dirección de envío</h2>
<p>Ada Park, Calle Olmo 12, Springfield</p>
</section>En la grabación la sección conserva su forma, y la dirección se lee *** ****, ***** **** **, ***********.
Dejar un elemento fuera: data-sypnia-block
Pon el atributo en cualquier elemento. No se graba en absoluto. La grabación muestra una caja vacía del mismo tamaño, así la página conserva su forma.
<div data-sypnia-block>
<img src="/documents/id-card.jpg" alt="Documento de identidad" />
</div>Usa un bloqueo para las imágenes y para cualquier cosa cuya sola forma diga demasiado.
Para los elementos a los que no puedes ponerles un atributo, como un widget de otra empresa, el SDK recibe una lista de selectores para enmascarar y otra para bloquear.
Enmascarar todo el texto: maskAllText
Una opción del SDK enmascara todo el texto de todas las páginas. Las grabaciones muestran entonces la disposición, los clics y el movimiento, con cada palabra reemplazada. Los eventos también cambian: los clics no llevan etiqueta, y las fallas de formulario no llevan el nombre del campo. Elígela para una app que es sensible de principio a fin, como las de salud, las de finanzas o cualquiera que trate de niños.
Un proyecto también puede encenderla en su configuración, para todos los navegadores a la vez y sin volver a publicar la app. Con una de las dos basta: todo el texto se enmascara cuando lo dice la opción o lo dice el ajuste.
Apagar la grabación en una ruta
Un proyecto puede listar rutas donde no se graba nada: ni grabación ni captura de página. La grabación se detiene cuando la persona entra a una de esas rutas y se retoma cuando sale. Desde esas páginas se siguen enviando eventos, así que ahí se siguen encontrando problemas. La lista es parte de la configuración del proyecto, así que la puedes cambiar sin volver a publicar tu app, y el motor rechaza las grabaciones de las rutas que están en ella, para que una pestaña que todavía corre código viejo no pueda enviarlas.
Qué hace exactamente el enmascarado
Dentro de un elemento enmascarado, y en todas partes cuando todo el texto está enmascarado:
| Qué | Se vuelve |
|---|---|
| Las letras y los dígitos del texto | Un asterisco cada uno. Los espacios y la puntuación se quedan, así se conserva la forma del texto. |
| Los valores de los campos | Un asterisco por cada carácter. |
| Casillas, botones de opción, opciones seleccionadas | Se muestran como no elegidos. |
| El texto de los atributos: títulos, texto alternativo, placeholders, etiquetas accesibles | Se enmascara de la misma forma. |
| Los enlaces a un correo o a un número de teléfono | Se enmascaran después de mailto: o tel:. |
| El contenido que se agrega después | Enmascarado. Un área enmascarada sigue enmascarada cuando la página cambia. |
Y fuera de las grabaciones:
- Clics. Un elemento dentro de un área enmascarada se reporta sin etiqueta. Un clic que cae sobre contenido enmascarado no tiene etiqueta, aunque el botón que lo rodea esté fuera de la máscara.
- Las capturas de página siguen las mismas reglas que las grabaciones.
- Direcciones. Los parámetros de inicio de sesión (
access_token,refresh_token,token,code) se quitan de los enlaces dentro de las grabaciones, estén enmascarados o no.
Qué campos cuentan como contraseña, tarjeta o código de un solo uso
Todo lo que se escribe se enmascara, así que esta lista no cambia nada que puedas ver. Importa porque estos campos además están protegidos contra cualquier opción futura: nunca se podrán grabar.
- Los campos de tipo
password. - Los campos cuyo
autocompleteescc-number,cc-csc,cc-exp,cc-exp-month,cc-exp-year,one-time-code,current-passwordonew-password. - Los campos cuyo
nameoidcontienecard,cvv,cvc,pin,otpopassword.
Qué no cubre el enmascarado
El enmascarado trabaja sobre texto y campos. Conoce sus bordes:
- El texto dentro de una imagen no se enmascara, porque la grabación solo guarda la dirección de la imagen. Bloquea la imagen.
- Los mensajes de error se envían como los escribió tu código, hasta 500 caracteres, con una excepción: los correos se reemplazan por
[email]. Si tu código lanzaCustomer Ada Park not found, ese nombre queda en el error. Lo mismo pasa con el mensaje de error que devuelve tu API en una llamada fallida, y con las propiedades de los eventos propios. El SDK te deja cambiar o descartar cualquier evento antes de enviarlo. - Las rutas se envían como son.
/customers/ada-parkconserva el nombre. Las consultas y los hashes no se envían nunca. - La ingesta no inspecciona las grabaciones. Guarda lo que envía el SDK y confía en el enmascarado del SDK. Cada grabación lleva la versión de las reglas de enmascarado con las que se hizo.
Comprueba tu enmascarado
Al final habrás visto con tus propios ojos qué muestra una grabación de tus páginas sensibles.
Asegúrate de que la sesión se grabe
Escribe algo en un campo y haz clic por ahí. Después causa un error, por ejemplo con el botón de prueba de Tu primer problema: una sesión con un error siempre se graba.
Deberías verPeticiones a tu dirección de ingesta en la pestaña Network del navegador.Arregla lo que ves, y repite
Todo lo que se pueda leer y no debería: agrega
data-sypnia-maskodata-sypnia-block, recarga y graba otra vez. Las grabaciones hechas antes del cambio conservan lo que grabaron; elimínalas si hace falta. Mira Eliminar datos.
Ejemplo: el checkout de la tienda
| Parte del checkout | En la grabación | Por qué |
|---|---|---|
| «Your order: Linen shirt, Shipping, Total $64.00» | Se puede leer | El texto de la página se graba tal como se ve, y el pedido es lo que necesitas ver. |
| El campo del correo | Asteriscos | Lo que se escribe siempre se enmascara. |
| Los campos de la tarjeta | Asteriscos, o una caja vacía si viven en el marco del proveedor de pagos | Los campos de tarjeta siempre se enmascaran; los marcos quedan fuera. |
| La dirección de envío, mostrada para confirmar | Asteriscos | La tienda marcó esa sección con data-sypnia-mask. |
| El botón Pagar y los cinco clics sobre él | Visibles | Ese es el problema que Sypnia está ahí para mostrar. |
Referencia
Los nombres de las opciones, sus valores por defecto y cómo ponerlas: Privacidad y enmascarado. Qué registra una grabación en general: Sesiones y grabación.