Triển khai trên cloud

Tổng quan

tracio.ai là một nền tảng cloud được quản lý hoàn toàn. Ứng dụng của bạn gửi các tín hiệu từ trình duyệt, và cloud trả về kết quả nhận dạng. Nền tảng lo việc mở rộng quy mô, dự phòng và quản lý hạ tầng.

Bắt đầu chỉ mất vài phút: tạo tài khoản, lấy public key, cài đặt SDK, và bắt đầu nhận dạng khách truy cập.

Chỉ có managed cloud. TRACIO không cung cấp bản triển khai self-hosted hay on-premise — không có thành phần máy chủ nào để cài đặt. Thứ bạn kiểm soát được là khu vực dữ liệu phục vụ lưu lượng của bạn (xem bên dưới) và, nếu muốn phân phối agent từ tên miền của chính bạn, một proxy first-party đặt trước endpoint được quản lý thông qua tùy chọn endpoint / scriptUrl.

Cách hoạt động

Ứng dụng của bạn giao tiếp với cloud thông qua JavaScript SDK phía client. SDK tải một agent trong trình duyệt, thu thập tín hiệu, và trả về kết quả nhận dạng:

Text

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

SDK trong trình duyệt tải agent và thu thập tín hiệu.
Các tín hiệu được gửi đến cloud tracio.ai.
Cloud trả về kết quả: thông tin visitorId và bot.

Để xử lý kết quả trên máy chủ của riêng bạn, hãy nhận mỗi lần nhận dạng dưới dạng webhook có chữ ký, hoặc đọc chúng theo yêu cầu qua Data API.

Bắt đầu

Đăng ký và mở dashboard của bạn.
Chọn khu vực dữ liệu (xem bên dưới).
Sao chép public key — có thể đưa vào code phía client một cách an toàn.
Cài đặt SDK và khởi tạo nó:

TypeScript

import { Tracio } from "@tracio/sdk"

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

Khu vực dữ liệu

Tùy chọn region của SDK chọn khu vực dữ liệu mà SDK sẽ giao tiếp. Nó nhận giá trị "us" hoặc "eu". Khi không được đặt, SDK sử dụng endpoint chung https://edge.tracio.ai — hãy đặt nó một cách rõ ràng để ghim vào một khu vực.

Khu vực	Mô tả
không đặt	Endpoint chung `edge.tracio.ai` (không ghim khu vực nào)
`us`	Khu vực dữ liệu US
`eu`	Khu vực dữ liệu EU

Quản lý API key

Workspace của bạn dùng hai loại key, và chúng không thể thay thế cho nhau:

Key	Dùng ở đâu	Trông như thế nào
Công khai	Trình duyệt — an toàn khi đưa vào code phía client	40 ký tự, không có tiền tố
Bí mật	Chỉ backend của bạn — xác thực Data API	`tracio_sk_` cộng 43 ký tự

Cả hai đều được tạo và quản lý trong dashboard, ở mục API Keys. Key bí mật cần gói Pro trở lên.
Key bí mật chỉ hiển thị một lần, khi tạo — phía chúng tôi chỉ lưu một hash. Nếu bạn làm mất, key không được khôi phục mà được xoay vòng.
Khi xoay vòng key bí mật, key trước đó vẫn hoạt động thêm 7 ngày để bạn triển khai mà không gián đoạn. Key công khai không xoay vòng: chúng không phải bí mật và theo thiết kế vẫn hiển thị trong mã nguồn trang của bạn.

Để sử dụng kết quả ở phía máy chủ, bạn có hai lựa chọn và chúng kết hợp tốt với nhau:

Cấu hình một webhook — mỗi lần nhận dạng được gửi đến endpoint của bạn, có chữ ký bằng X-Tracio-Signature.
Gọi Data API bằng key bí mật của bạn để đọc theo yêu cầu lịch sử của khách truy cập, từng phiên riêng lẻ hoặc các bộ đếm velocity.

Webhooks

Bạn có thể cấu hình webhook để nhận sự kiện nhận dạng từ cloud về máy chủ của chính bạn. Webhook có sẵn từ gói Pro trở lên — xem Webhooks để biết chi tiết về thiết lập, payload và xác minh chữ ký.