Déploiement dans le cloud

Vue d'ensemble

tracio.ai est une plateforme cloud entièrement managée. Votre application envoie des signaux depuis le navigateur, et le cloud renvoie un résultat d'identification. La plateforme prend en charge la mise à l'échelle, la redondance et la gestion de l'infrastructure.

La prise en main ne prend que quelques minutes : créez un compte, obtenez votre clé publique, installez le SDK et commencez à identifier les visiteurs.

Cloud managé uniquement. TRACIO ne propose pas de déploiement auto-hébergé ni on-premise : il n'existe aucun composant serveur installable. Ce que vous pouvez contrôler, c'est la région de données depuis laquelle votre trafic est servi (voir ci-dessous) et, si vous souhaitez servir l'agent depuis votre propre domaine, un proxy first-party devant l'endpoint managé via les options endpoint / scriptUrl.

Fonctionnement

Votre application communique avec le cloud via le SDK JavaScript côté client. Le SDK charge un agent dans le navigateur, collecte des signaux et renvoie le résultat d'identification :

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

1. Le SDK navigateur charge l'agent et collecte les signaux.
2. Les signaux sont envoyés au cloud tracio.ai.
3. Le cloud renvoie le résultat : les informations visitorId et bot.

Pour agir sur les résultats depuis votre propre serveur, recevez chaque identification sous forme de webhook signé, ou lisez-les à la demande via la Server API.

Prise en main

1. Inscrivez-vous et ouvrez votre tableau de bord.
2. Choisissez votre région de données (voir ci-dessous).
3. Copiez votre clé publique — elle peut être livrée en toute sécurité dans le code côté client.
4. Installez le SDK et initialisez-le :

import { Tracio } from "@tracio/sdk"

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

Régions de données

L'option region du SDK sélectionne la région de données avec laquelle le SDK communique. Elle accepte "us" ou "eu". Lorsqu'elle n'est pas définie, le SDK utilise l'endpoint générique https://edge.tracio.ai — définissez-la explicitement pour épingler une région.

Gestion des clés API

Votre espace de travail utilise deux types de clés, qui ne sont pas interchangeables :

• Créez et gérez les deux depuis votre tableau de bord, dans API Keys. Les clés secrètes nécessitent l'offre Pro ou supérieure.
• Une clé secrète n'est affichée qu'une seule fois, à la création — seul un hachage est conservé de notre côté. Si vous la perdez, elle ne se récupère pas : elle se remplace par rotation.
• Lors de la rotation d'une clé secrète, la précédente reste valide pendant 7 jours, ce qui vous permet de déployer sans interruption. Les clés publiques ne se renouvellent pas par rotation : ce ne sont pas des secrets et elles sont visibles dans le code source de votre page, par conception.

Pour exploiter les résultats côté serveur, vous disposez de deux options, qui se combinent bien :

• Configurez un webhook — chaque identification est livrée à votre endpoint, signée avec X-Tracio-Signature.
• Appelez la Server API avec votre clé secrète pour lire à la demande l'historique d'un visiteur, des sessions individuelles ou les compteurs velocity.

Webhooks

Vous pouvez configurer des webhooks pour recevoir les événements d'identification du cloud sur votre propre serveur. Les webhooks sont disponibles à partir de l'offre Pro — consultez Webhooks pour la configuration, le payload et les détails de vérification de signature.