Despliegue en la nube

Visión general

tracio.ai es una plataforma cloud totalmente gestionada. Su aplicación envía señales desde el navegador, y la nube devuelve un resultado de identificación. La plataforma se encarga del escalado, la redundancia y la gestión de la infraestructura.

Empezar lleva minutos: cree una cuenta, obtenga su clave pública, instale el SDK y empiece a identificar visitantes.

Solo nube gestionada. TRACIO no ofrece un despliegue self-hosted ni on-premise: no existe ningún componente de servidor instalable. Lo que sí puede controlar es la región de datos desde la que se sirve su tráfico (ver abajo) y, si desea servir el agente desde su propio dominio, un proxy de primera parte delante del endpoint gestionado mediante las opciones endpoint / scriptUrl.

Cómo funciona

Su aplicación se comunica con la nube a través del SDK de JavaScript del lado del cliente. El SDK carga un agente en el navegador, recopila señales y devuelve el resultado de identificación:

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. El SDK del navegador carga el agente y recopila señales.
2. Las señales se envían a la nube de tracio.ai.
3. La nube devuelve el resultado: información de visitorId y bot.

Para actuar sobre los resultados en su propio servidor, reciba cada identificación como un webhook firmado, o léalos bajo demanda a través de la Server API.

Primeros pasos

1. Regístrese y abra su panel.
2. Elija su región de datos (ver abajo).
3. Copie su clave pública: es seguro incluirla en el código del cliente.
4. Instale el SDK e inicialícelo:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

Regiones de datos

La opción region del SDK selecciona con qué región de datos se comunica el SDK. Acepta "us" o "eu". Si no se establece, el SDK usa el endpoint genérico https://edge.tracio.ai — establézcala explícitamente para fijar una región.

Gestión de claves de API

Su workspace utiliza dos tipos de clave, y no son intercambiables:

• Cree y gestione ambas en el panel, en la sección API Keys. Las claves secretas requieren el plan Pro o superior.
• Una clave secreta se muestra una sola vez, al crearla: de nuestro lado solo se guarda un hash. Si la pierde, no se recupera, se rota.
• Al rotar una clave secreta, la anterior sigue funcionando durante 7 días para que pueda desplegar sin interrupciones. Las claves públicas no se rotan: no son secretas y, por diseño, están visibles en el código fuente de su página.

Para consumir los resultados en el servidor tiene dos opciones, y se combinan bien:

• Configure un webhook: cada identificación se entrega a su endpoint, firmada con X-Tracio-Signature.
• Llame a la Server API con su clave secreta para leer bajo demanda el historial de un visitante, sesiones individuales o los contadores de velocity.

Webhooks

Puede configurar webhooks para recibir eventos de identificación desde la nube en su propio servidor. Los webhooks están disponibles a partir del plan Pro — consulte Webhooks para los detalles de configuración, payload y verificación de firma.