Deployment sul cloud

Panoramica

tracio.ai è una piattaforma cloud interamente gestita. La sua applicazione invia i segnali dal browser e il cloud restituisce un risultato di identificazione. La piattaforma si occupa dello scaling, della ridondanza e della gestione dell'infrastruttura.

Iniziare richiede pochi minuti: creare un account, ottenere la chiave pubblica, installare l'SDK e iniziare a identificare i visitatori.

Solo cloud gestito. TRACIO non offre un deployment self-hosted né on-premise: non esiste alcun componente server installabile. Ciò che è possibile controllare è la regione dati da cui viene servito il traffico (vedi sotto) e, se si desidera servire l'agente dal proprio dominio, un proxy first-party davanti all'endpoint gestito tramite le opzioni endpoint / scriptUrl.

Come funziona

La sua applicazione comunica con il cloud tramite l'SDK JavaScript lato client. L'SDK carica un agente nel browser, raccoglie i segnali e restituisce il risultato di identificazione:

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

1. L'SDK del browser carica l'agente e raccoglie i segnali.
2. I segnali vengono inviati al cloud tracio.ai.
3. Il cloud restituisce il risultato: informazioni su visitorId e bot.

Per agire sui risultati sul proprio server, ricevere ogni identificazione come webhook firmato, oppure leggerli su richiesta tramite la Server API.

Per iniziare

1. Registrarsi e aprire la propria dashboard.
2. Scegliere la propria regione dati (vedi sotto).
3. Copiare la propria chiave pubblica — è sicura da distribuire nel codice lato client.
4. Installare l'SDK e inizializzarlo:

import { Tracio } from "@tracio/sdk"

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

Regioni dati

L'opzione region dell'SDK seleziona con quale regione dati l'SDK comunica. Accetta "us" o "eu". Quando non è impostata, l'SDK utilizza l'endpoint generico https://edge.tracio.ai — impostarla esplicitamente per fissare una regione.

Gestione delle chiavi API

Il suo workspace usa due tipi di chiave, che non sono interscambiabili:

• Entrambe si creano e si gestiscono nella dashboard, nella sezione API Keys. Le chiavi segrete richiedono il piano Pro o superiore.
• Una chiave segreta viene mostrata una sola volta, alla creazione: dalla nostra parte resta soltanto un hash. Se la perde, non si recupera: si ruota.
• Ruotando una chiave segreta, la precedente continua a funzionare per 7 giorni, così può rilasciare senza interruzioni. Le chiavi pubbliche non si ruotano: non sono segrete e, per scelta progettuale, sono visibili nel sorgente della pagina.

Per usare i risultati lato server ci sono due possibilità, che si combinano bene:

• Configurare un webhook — ogni identificazione viene consegnata al proprio endpoint, firmata con X-Tracio-Signature.
• Chiamare la Server API con la propria chiave segreta per leggere su richiesta la cronologia di un visitatore, le singole sessioni o i contatori velocity.

Webhooks

È possibile configurare i webhook per ricevere gli eventi di identificazione dal cloud sul proprio server. I webhook sono disponibili dal piano Pro in su — vedere Webhooks per la configurazione, il payload e i dettagli sulla verifica della firma.