Bắt đầu nhanh

Hết trang này bạn sẽ có một lượt truy cập hiện trên dashboard và một lần kiểm tra phía máy chủ từ chối được một yêu cầu.

1. Lấy khoá của site#

Mở API keys trên dashboard. Mỗi site có hai khoá và chúng không thay thế nhau được:

• Khoá công khai (pk_live_…) — nằm trong mã nguồn trang, lộ ra là bình thường. Thứ bảo vệ nó là danh sách origin được phép, không phải sự bí mật.
• Khoá bí mật (sk_live_…) — chỉ ở phía máy chủ. Nó chỉ hiện một lần lúc tạo; mất thì xoay lại.

Khai báo luôn các origin mà trang của bạn được phục vụ từ đó. Collector từ chối lượt truy cập đến từ origin không có trong danh sách.

2. Gắn SDK#

Một thẻ, đặt ở cuối <body> của mọi trang bạn muốn bảo vệ. Không có gói npm — thẻ này là toàn bộ phần tích hợp phía trình duyệt.

<script src="https://hideguard.io/sdk/v1.js"
        data-site-key="pk_live_..."></script>

data-block="true" bật màn chặn có sẵn khi phán quyết là block. Nó tắt mặc định: một script có thể làm đen trang của khách ngay khi cài là script không nên cài.

Toàn bộ thuộc tính nằm ở SDK trình duyệt.

3. Đọc phán quyết trên trang#

window.addEventListener("fpc:verdict", (event) => {
  const { verdict, score, visitorId, requestId } = event.detail;
  console.log(verdict, score);
});

Phán quyết này là thông tin, không phải cổng chặn. Nó đến sau khi trang đã được phục vụ, nó do JavaScript vẽ ra, và một client không chạy JavaScript thì không bao giờ gặp nó.

4. Hỏi từ phía máy chủ#

Đây là nửa chặn được. Gọi nó ở nơi có thứ gì đáng giá đổi chủ — thanh toán, đăng nhập, đặt lại mật khẩu, dùng mã giảm giá.

curl -X POST https://hideguard.io/api/v1/verdict \
  -H 'x-api-key: sk_live_...' \
  -H 'content-type: application/json' \
  -d '{"visitorId":"<cookie fpc_vid>","ip":"<ip client>","userAgent":"<header user-agent>"}'

5. Kiểm chứng#

Mở trang của bạn, rồi vào Identification trên dashboard. Lượt truy cập xuất hiện trong vòng vài giây. Bấm vào nó để xem từng phép đo đứng sau điểm số.

Nếu không thấy gì, xem Health: nó đếm mọi câu trả lời của ingest, kể cả những lần bị từ chối vì sai khoá hoặc sai origin.