- Guías
- Controles de privacidad
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.
Configuralo una vez para todo el proyecto
Sección titulada «Configuralo una vez para todo el proyecto»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.
Texto en pantalla
Sección titulada «Texto en pantalla»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.
| Atributo | Efecto |
|---|---|
data-espejo-mask | Conserva la forma del elemento y reemplaza su texto por *. Lo mejor para depurar bugs de layout. |
data-espejo-block | Abre un hueco en el replay. Los clics dentro no se describen. |
data-espejo-unmask | Solo con data-mask-text="all": deja legible el texto de ese elemento y de todo lo que tiene adentro. |
Enmascarar todo por defecto
Sección titulada «Enmascarar todo por defecto»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.
Requests de red
Sección titulada «Requests de red»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.
| Atributo | Efecto |
|---|---|
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[].
Video de pantalla
Sección titulada «Video de pantalla»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.
Lo que estas opciones no cubren
Sección titulada «Lo que estas opciones no cubren»- La salida de consola. No loguees datos personales en la consola.
- La identidad.
data-user-refeidentify()reciben un id opaco, nunca un email ni un nombre.