Implementatie in de cloud

Overzicht

tracio.ai is een volledig beheerd cloudplatform. Uw applicatie stuurt signalen vanuit de browser en de cloud retourneert een identificatieresultaat. Het platform verzorgt schaalvergroting, redundantie en infrastructuurbeheer.

Aan de slag gaan kost slechts enkele minuten: maak een account aan, verkrijg uw public key, installeer de SDK en begin met het identificeren van bezoekers.

Alleen managed cloud. TRACIO levert geen self-hosted of on-premise installatie — er is geen installeerbare servercomponent. Wat u wel kunt bepalen, is de dataregio van waaruit uw verkeer wordt bediend (zie hieronder) en, als u de agent vanaf uw eigen domein wilt serveren, een first-party proxy vóór het beheerde endpoint via de opties endpoint / scriptUrl.

Hoe het werkt

Uw applicatie communiceert met de cloud via de client-side JavaScript-SDK. De SDK laadt een agent in de browser, verzamelt signalen en retourneert het identificatieresultaat:

Text

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

De browser-SDK laadt de agent en verzamelt signalen.
De signalen worden naar de tracio.ai-cloud gestuurd.
De cloud retourneert het resultaat: visitorId en bot-informatie.

Om op resultaten te reageren op uw eigen server, ontvangt u elke identificatie als een ondertekende webhook, of leest u ze op aanvraag via de Data API.

Aan de slag

Registreer u en open uw dashboard.
Kies uw dataregio (zie hieronder).
Kopieer uw public key — deze kan veilig worden meegeleverd in client-side code.
Installeer de SDK en initialiseer deze:

TypeScript

import { Tracio } from "@tracio/sdk"

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

Dataregio's

De SDK-optie region bepaalt met welke dataregio de SDK communiceert. Deze accepteert "us" of "eu". Wanneer niet ingesteld, gebruikt de SDK het generieke endpoint https://edge.tracio.ai — stel deze expliciet in om een regio vast te leggen.

Regio	Beschrijving
niet ingesteld	Generiek `edge.tracio.ai`-endpoint (geen regio vastgelegd)
`us`	US-dataregio
`eu`	EU-dataregio

Beheer van API-sleutels

Uw workspace gebruikt twee soorten sleutels, en ze zijn niet uitwisselbaar:

Sleutel	Waar hij thuishoort	Ziet eruit als
Public key	De browser — veilig mee te leveren in client-side code	40 tekens, zonder prefix
Secret key	Alleen uw backend — authenticeert de Data API	`tracio_sk_` plus 43 tekens

Beide maakt en beheert u in het dashboard onder API Keys. Secret keys vereisen minimaal het Pro-plan.
Een secret key wordt één keer getoond, bij het aanmaken — aan onze kant wordt alleen een hash bewaard. Raakt u hem kwijt, dan herstelt u hem niet, maar roteert u hem.
Bij het roteren van een secret key blijft de vorige nog 7 dagen werken, zodat u zonder downtime kunt deployen. Public keys worden niet geroteerd: het zijn geen geheimen en ze zijn bewust zichtbaar in de broncode van uw pagina.

Om resultaten server-side te verwerken heeft u twee opties, die goed samengaan:

Configureer een webhook — elke identificatie wordt aan uw endpoint bezorgd, ondertekend met X-Tracio-Signature.
Roep de Data API aan met uw secret key om op aanvraag de geschiedenis van een bezoeker, afzonderlijke sessies of velocity-tellers te lezen.

Webhooks

U kunt webhooks configureren om identificatie-events vanuit de cloud op uw eigen server te ontvangen. Webhooks zijn beschikbaar vanaf het Pro-plan — zie Webhooks voor de instellingen, de payload en de details over handtekeningverificatie.