# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/privacy/masking/

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](https://docs.sypnia.com/es/sdks/privacy-and-masking).

**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.

`checkout.html`

```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`

```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 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 `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](https://docs.sypnia.com/es/start/your-first-problem): 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](https://docs.sypnia.com/es/privacy/deleting-data).

## 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](https://docs.sypnia.com/es/sdks/privacy-and-masking). Qué registra una grabación en general: [Sesiones y grabación](https://docs.sypnia.com/es/concepts/sessions-and-replay).
