Dominio de captura (DNS)

El Web SDK envía su captura a través de un subdominio suyo, collect.<your-domain>. El SDK en sí se entrega como un paquete privado aprobado que se empaqueta dentro de su frontend. Esta es la captura first-party. Es obligatoria para la captura del SDK: no hay un dominio compartido como alternativa automática y, sin un dominio de captura activo, el SDK no se habilita para su aplicación. Preparar el DNS no lo activa. Cada solicitud debe coincidir con su host de captura verificado vigente, con uno de los orígenes de sitio web permitidos de su aplicación bajo ese dominio y con la clave de la aplicación. No hay enrutamiento alternativo hacia el host de la API ni hacia el colector de otra empresa.

Solicite la preparación del dominio

En la consola, abra Início y complete Criar a aplicação (crear la aplicación) con los orígenes HTTPS exactos de su sitio web. Después, en Configurar a coleta web (configurar la captura web), elija la Origem registrada da aplicação (uno de esos orígenes) e introduzca su Domínio-base de coleta da sua empresa (dominio base de su propiedad), como yourcompany.com. El colector resultante es collect.yourcompany.com. A partir de ahí, el SDK captura desde todo origen permitido de la aplicación cuyo host sea yourcompany.com o uno de sus subdominios, como https://yourcompany.com, https://www.yourcompany.com y https://app.yourcompany.com; usted edita esa lista más adelante en Integração e saúde › Origens das páginas. Consulte el alta de su empresa.

Después, la plataforma prepara por sí sola el certificado vinculado a la aplicación, el enrutamiento y el desafío de titularidad, sin ninguna solicitud a FingerTrackID y sin ningún paso de un operador. Su única acción es publicar los tres registros DNS públicos que le muestra y configurar el colector aprobado en la aplicación. Los planes de infraestructura privados, las credenciales de nube y el acceso al gestor de secretos no son datos de entrada de la integración.

Quién actúa: “Depende de você” y “Automático”

Cada paso del progreso de la configuración en Início lleva una de dos etiquetas:

Depende de você (depende de usted): la configuración espera algo que solo usted puede hacer, como publicar los registros DNS o ajustar su política CAA.
Automático: la plataforma está haciendo el trabajo; usted no tiene nada que hacer. El paso avanza por sí solo.

El paso Confirmar o domínio de coleta (confirmar el dominio de captura) pasa por estos estados:

En pantalla	Etiqueta	Qué significa
Preparando el certificado y los registros	Automático	La plataforma está preparando el certificado y los registros DNS por usted.
Publique los tres registros	Depende de você	Publique los tres registros que se muestran, exactamente como aparecen.
Registros encontrados, verificando	Automático	Sus registros se encontraron; la plataforma está verificando el certificado y la ruta de captura.
Registros aún no encontrados	Depende de você	Sus registros todavía no se han visto. Revise su DNS y elija Verificar agora (verificar ahora); los valores siguen siendo los mismos, por lo que usted no cambia lo que publicó.
Nueva verificación en preparación	Automático	La plataforma está preparando una nueva verificación, con los mismos registros. No hay nada que cambiar en su DNS.
CAA no permite la autoridad de certificación	Depende de você	La política CAA de su dominio bloquea el certificado. Consulte CAA.
Volviendo a comprobar el dominio	Automático	La plataforma está comprobando el dominio de nuevo. No hay nada que hacer.
Todos los registros encontrados, finalizando	Automático	Todos los registros muestran Encontrado; la plataforma está finalizando la verificación y activando el dominio. No hay nada que hacer.
Pausado por el soporte	—	El soporte de FingerTrackID pausó este paso. Póngase en contacto con el soporte para reanudarlo.
Concluído	—	El dominio de captura está confirmado.

El paso Definir a guarda dos dados (definir la custodia de los datos) siempre es Automático: la plataforma aplica por sí sola la retención gestionada a su aplicación: los datos se conservan durante al menos 10 años y no se elimina ninguno de ellos (retención). Usted nunca actúa en este paso.

Si un paso automático no avanza durante 30 minutos, muestra Algo travou (algo se atascó): póngase en contacto con el soporte de FingerTrackID con la referencia de la solicitud que se muestra en Início. La espera de sus registros DNS nunca se muestra como atascada.

Los registros que usted publica

Usted publica dos registros CNAME y un registro TXT de titularidad, todos bajo collect.<your-domain>. Los valores exactos aparecen en el progreso de la configuración de su aplicación en la consola en cuanto están listos, cada uno con un botón para copiar y con la indicación de si la plataforma ya lo encontró (Encontrado, Ainda não encontrado o Ainda não conferido). Se generan para su aplicación y no deben adivinarse ni copiarse de otro cliente.

Se muestra como	Tipo	Nombre	Valor	Finalidad
Endereço de coleta	`CNAME`	`collect.<your-domain>`	El host de captura de FingerTrackID, que se le proporciona	Dirige el tráfico del SDK a FingerTrackID
Validação do certificado	`CNAME`	`_acme-challenge.collect.<your-domain>` o `_acme-challenge_<suffix>.collect.<your-domain>` (nombre exacto que se le proporciona)	El destino de autorización del certificado, que se le proporciona	Autoriza la emisión del certificado TLS para `collect.<your-domain>`
Prova de propriedade	`TXT`	`_ftid-ownership.collect.<your-domain>`	`ftid-domain-verification-v1=…`, que se le proporciona	Demuestra que su empresa controla el dominio

Ejemplo con un dominio ficticio, yourcompany.com — los valores de destino son marcadores de posición:

collect.yourcompany.com.                          CNAME  <collection-host-provided>.
_acme-challenge_<suffix>.collect.yourcompany.com. CNAME  <authorization-target-provided>.
_ftid-ownership.collect.yourcompany.com.          TXT    "ftid-domain-verification-v1=<value-provided>"

Reglas:

Exactamente un registro por nombre CNAME. Exactamente un CNAME en collect.<your-domain> y exactamente un CNAME en el nombre de autorización del certificado; la verificación falla si el nombre responde con más de un valor o con uno diferente. No cree ningún otro tipo de registro (A, AAAA, TXT) con el mismo nombre que un CNAME.
Solo DNS, sin proxy delante. Publique los CNAME como registros DNS simples, sin un proxy, una CDN ni un WAF suyos entre el navegador y FingerTrackID. Un registro con proxy no responde como el CNAME esperado, por lo que la verificación no se supera.
Publique los registros y, después, elija Verificar agora. No hay ningún plazo que usted deba cumplir: la plataforma sigue comprobando por sí sola, y el botón Verificar agora (verificar ahora) comprueba los registros de inmediato. Si la verificación de la plataforma necesita renovarse, el mismo clic la renueva con el mismo valor TXT, así que usted nunca cambia su DNS. Un valor que usted reconstruya por su cuenta nunca se acepta como prueba de titularidad.
CAA. Si su dominio publica registros CAA, estos deben permitir las autoridades de certificación que Google usa para los certificados gestionados: agregue pki.goog y letsencrypt.org (por ejemplo, 0 issue "pki.goog" y 0 issue "letsencrypt.org"). La plataforma vuelve a intentarlo por sí sola una vez que la política las permite. Si ningún registro CAA se aplica a collect.<your-domain>, no hay nada que hacer.

Cookies que recibe el host de captura

collect.<your-domain> es un host bajo su propio dominio, por lo que el navegador le envía todas las cookies de su sitio cuyo alcance lo cubre. Una cookie de sesión creada con Domain=.<your-domain> (o para un dominio padre de este) llega al host de captura en cada solicitud del SDK, porque el SDK lo llama con credentials: "include".

Qué hace FingerTrackID con ellas: el colector lee el encabezado Cookie solo en memoria, durante la solicitud, y usa únicamente su propia cookie de instalación (__Host-ftid_i). Todas las demás cookies se descartan con la solicitud: no se escriben en logs, en el monitoreo de errores, en la captura almacenada ni en la base de datos.
Por qué credentials: "include": es lo que permite que el navegador devuelva la cookie de instalación, que es HttpOnly y está restringida al host de captura, y que mantiene la continuidad del dispositivo entre visitas. Sin ello, la captura sigue funcionando, pero pierde esa continuidad.
Lo que recomendamos: mantenga sus cookies de sesión restringidas al host de su aplicación (sin atributo Domain, idealmente con el prefijo __Host-), para que nunca lleguen a collect.<your-domain> ni a ningún otro subdominio.

Cómo comprobarlo

Después de publicar, compruebe desde cualquier máquina con dig (sustituya yourcompany.com por su dominio):

dig +short CNAME collect.yourcompany.com
dig +short CNAME _acme-challenge_<suffix>.collect.yourcompany.com
dig +short TXT _ftid-ownership.collect.yourcompany.com
dig +short CAA collect.yourcompany.com
dig +short CAA yourcompany.com

Cada comando CNAME debe devolver exactamente una línea, igual al valor que usted recibió (dig puede añadir un punto final al nombre). La respuesta TXT debe contener el valor que usted recibió, entre comillas. Una respuesta vacía significa que el registro todavía no se ha propagado o que se creó con otro nombre. Los comandos CAA son un diagnóstico inicial. No prueban que la emisión del certificado esté autorizada: la plataforma también comprueba los alias y la cadena aplicable de dominios padre antes de la activación, y muestra un problema de CAA en el progreso de la configuración.

Qué sucede después

La plataforma comprueba los tres registros por sí sola, cada cierto tiempo. Para comprobarlos justo después de publicarlos, elija Verificar agora (verificar ahora): el botón muestra Verificando… y la página se actualiza por sí sola hasta que vuelve el resultado de la comprobación, normalmente en menos de un minuto. Después, cada registro muestra Encontrado o Ainda não encontrado (aún no encontrado). Si todavía falta algo, corríjalo en su DNS y vuelva a elegir Verificar agora (como máximo una vez por minuto). Cuando todo se ha encontrado, el paso pasa a Automático mientras se verifican el certificado y la ruta de captura y se activa el dominio.
Con el dominio confirmado y la configuración predefinida de custodia de datos aplicada, la plataforma completa los pasos automáticos restantes y activa la captura para la aplicación, sin ninguna solicitud a FingerTrackID.
Configurar a coleta web en Início muestra entonces Concluída (completada), e Integração e saúde (integración y salud) muestra el dominio first-party como activo. Los recuentos de capturas anteriores no prueban que la verificación del dominio siga activa hoy (vea la pantalla).

Una vez que la captura esté activa, continúe con la instalación del Web SDK.