Implementatie in de cloud

Overzicht

tracio.ai is een volledig beheerd cloudplatform. Je 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 je 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 je wel kunt bepalen, is de dataregio van waaruit je verkeer wordt bediend (zie hieronder) en het domein waarvandaan het script wordt geserveerd: koppel een eigen subdomein in het dashboard, zie Eigen domeinen.

Hoe het werkt

Je 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 je eigen server, ontvang je elke identificatie als een ondertekende webhook, of lees je ze op aanvraag via de Data API.

Aan de slag

Registreer je en open je dashboard.
Kies je dataregio (zie hieronder).
Kopieer je 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

Je 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 je backend — authenticeert de Data API	`tracio_sk_` plus 43 tekens

Beide maak en beheer je 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. Raak je hem kwijt, dan herstel je hem niet, maar roteer je hem.
Bij het roteren van een secret key blijft de vorige nog 7 dagen werken, zodat je zonder downtime kunt deployen. Public keys worden niet geroteerd: het zijn geen geheimen en ze zijn bewust zichtbaar in de broncode van je pagina.

Om resultaten server-side te verwerken heb je twee opties, die goed samengaan:

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

Webhooks

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