Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Lo que trae por defecto un proyecto nuevo
  2. Qué puedes agregar
  3. Enmascarar un elemento: data-sypnia-mask
  4. Dejar un elemento fuera: data-sypnia-block
  5. Enmascarar todo el texto: maskAllText
  6. Apagar la grabación en una ruta
  7. Qué hace exactamente el enmascarado
  8. Qué campos cuentan como contraseña, tarjeta o código de un solo uso
  9. Qué no cubre el enmascarado
  10. Comprueba tu enmascarado
  11. Abre la página en desarrollo
  12. Asegúrate de que la sesión se grabe
  13. Mira la grabación
  14. Arregla lo que ves, y repite
  15. Ejemplo: el checkout de la tienda
  16. 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

ContenidoPor 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, siempreNo. 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 usoEnmascarado, siempreNo.
Campos ocultosSe les quita el valorNo.
El texto que muestra la páginaSe graba tal como se veSí: enmascara un elemento, o todo el texto.
Marcos y videosQuedan fueraNo.
Dibujos en canvasNo se grabanNo.
ImágenesNo se copian; el reproductor las carga desde su propia direcciónDeja 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.

checkout.html
<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.

account.html
<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 textoUn asterisco cada uno. Los espacios y la puntuación se quedan, así se conserva la forma del texto.
Los valores de los camposUn asterisco por cada carácter.
Casillas, botones de opción, opciones seleccionadasSe muestran como no elegidos.
El texto de los atributos: títulos, texto alternativo, placeholders, etiquetas accesiblesSe enmascara de la misma forma.
Los enlaces a un correo o a un número de teléfonoSe enmascaran después de mailto: o tel:.
El contenido que se agrega despuésEnmascarado. 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 autocomplete es cc-number, cc-csc, cc-exp, cc-exp-month, cc-exp-year, one-time-code, current-password o new-password.
  • Los campos cuyo name o id contiene card, cvv, cvc, pin, otp o password.

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 lanza Customer 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-park conserva 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.

  1. Abre la página en desarrollo

    Corre tu app con el SDK enviando al entorno development, y abre una página que muestre datos sensibles.

    Deberías ver
    La página se ve normal. El enmascarado no cambia lo que ven tus usuarios.
  2. 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 ver
    Peticiones a tu dirección de ingesta en la pestaña Network del navegador.
  3. Mira la grabación

    Deja la página sin actividad 2 minutos, después abre la sesión en Sypnia y reprodúcela.

    Deberías ver
    Lo que escribiste son asteriscos. Cada elemento que marcaste con data-sypnia-mask son asteriscos. Cada elemento que marcaste con data-sypnia-block es una caja vacía.
  4. Arregla lo que ves, y repite

    Todo lo que se pueda leer y no debería: agrega data-sypnia-mask o data-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 checkoutEn la grabaciónPor qué
«Your order: Linen shirt, Shipping, Total $64.00»Se puede leerEl texto de la página se graba tal como se ve, y el pedido es lo que necesitas ver.
El campo del correoAsteriscosLo que se escribe siempre se enmascara.
Los campos de la tarjetaAsteriscos, o una caja vacía si viven en el marco del proveedor de pagosLos campos de tarjeta siempre se enmascaran; los marcos quedan fuera.
La dirección de envío, mostrada para confirmarAsteriscosLa tienda marcó esa sección con data-sypnia-mask.
El botón Pagar y los cinco clics sobre élVisiblesEse 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.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar