Ir al contenido
Consola

Controles de privacidad

Enmascarar el texto por defecto, ocultar zonas y dejar requests de red o sus bodies fuera de las grabaciones.

Espejo ya redacta secretos y enmascara todos los inputs antes de subir nada (ver Seguridad y aislamiento). Esta página cubre lo que vos decidís dejar afuera: datos personales que están en pantalla o en las respuestas de tu API. Todas las opciones de abajo solo pueden restringir lo que se graba. Ninguna puede prender algo que tu proyecto tiene apagado.

No hace falta tocar tu HTML. En la consola, abrí Ajustes del proyecto → Grabación → Privacidad y elegí:

  • Texto de la página en el replay: solo lo que marques, o todo el texto.
  • Bodies de requests y respuestas de red: grabarlos, o nunca.
  • Rutas cuyos bodies nunca se graban y Rutas que nunca se graban: un fragmento por línea, con las mismas reglas de coincidencia que los atributos de abajo.
  • Grabación de pantalla: disponible, o desactivada.

Aplica a todos los visitantes del proyecto. Las cargas de página nuevas toman un cambio en unos 5 minutos. Todo lo de esta página solo puede restringir: la configuración del proyecto y los atributos del script se combinan quedándose con lo más restrictivo de los dos, así que ninguno puede aflojar lo que puso el otro. El replay espera la configuración del proyecto (2 segundos como máximo) antes de grabar nada. Si la configuración del proyecto no se puede traer, valen solo los atributos del script.

En el replay del DOM (data-capture="dom", o espejo.dom.js), por defecto solo se enmascaran los valores de los inputs. El texto del resto de la página se graba tal cual.

AtributoEfecto
data-espejo-maskConserva la forma del elemento y reemplaza su texto por *. Lo mejor para depurar bugs de layout.
data-espejo-blockAbre un hueco en el replay. Los clics dentro no se describen.
data-espejo-unmaskSolo con data-mask-text="all": deja legible el texto de ese elemento y de todo lo que tiene adentro.

Poné data-mask-text="all" en la etiqueta del script. Todo el texto de la página queda enmascarado en el replay del DOM y en la foto de la página que sirve de fondo a los heatmaps. Una página nueva que nadie marcó nace cubierta.

<script src="https://app.espejo.dev/sdk/espejo.dom.js"
data-key="pk_live_…"
data-mask-text="all"></script>

Después marcá lo que es seguro leer, como el menú, los encabezados y los botones:

<nav data-espejo-unmask>…</nav>
<h1 data-espejo-unmask>Tickets</h1>
<main>
<!-- enmascarado: el layout queda, el texto pasa a asteriscos -->
<p data-espejo-unmask>Cliente: <span data-espejo-mask>Ana Pérez</span></p>
</main>

Un data-espejo-mask o un data-espejo-block dentro de una zona visible sigue aplicando. El texto enmascarado conserva su largo, así que el layout se ve igual en el replay.

Con un bundler, la misma opción es maskText: "all" en la configuración. Sin ella, el valor es "marked": solo los elementos con data-espejo-mask.

Por defecto se graba cada fetch, XMLHttpRequest y sendBeacon con su método, URL, status, duración, headers redactados y los bodies del request y de la respuesta (solo texto y JSON, hasta un tope de tamaño, con las claves secretas redactadas). Un dato personal que no es un secreto, como un email o un nombre, no se saca de los bodies.

AtributoEfecto
data-network-bodies="off"No se graba ningún body, ni de request ni de respuesta. Quedan método, URL, status, duración y headers redactados.
data-network-body-exclude="/api/contactos,/api/tickets"Se graba todo salvo los bodies de los requests cuya URL contiene alguno de los fragmentos.
data-network-ignore="/api/contactos"Los requests cuya URL contiene alguno de los fragmentos no se graban en absoluto.

Los fragmentos se separan con comas y se buscan como texto simple en la URL tal como la escribió la página. No hay comodines ni expresiones regulares. Una URL absoluta (https://api.ejemplo.com/contactos) y una relativa (/contactos) coinciden las dos con /contactos.

<script src="https://app.espejo.dev/sdk/espejo.dom.js"
data-key="pk_live_…"
data-mask-text="all"
data-network-body-exclude="/api/"></script>

Con un bundler, las opciones son networkBodies: "off", networkBodyExclude: string[] y networkIgnore: string[].

Una grabación de la pantalla muestra lo que muestra la pantalla, así que los atributos de enmascarado no le aplican. Es opcional y la persona decide iniciarlo. Los reportes automáticos nunca llevan video. Si tus páginas muestran datos personales, desactivalo: data-video="off" en el script (o video: "off" con un bundler), o el interruptor Grabación de pantalla en la consola. El botón de reporte deja de ofrecerlo y espejo.startVideo() falla.

  • La salida de consola. No loguees datos personales en la consola.
  • La identidad. data-user-ref e identify() reciben un id opaco, nunca un email ni un nombre.