Bản dịch này được tạo bằng máy và đang chờ xem xét.Chuyển sang tiếng Anh
Tối
Đăng nhậpYêu cầu buổi hướng dẫn

// ĐÁNH GIÁ DÀNH CHO NHÀ PHÁT TRIỂN

Nắm rõ thành phần nào chạy ở đâu trước khi tích hợp.

Trình duyệt thu thập bằng chứng khả dụng. Máy chủ của bạn thực hiện truy xuất đã xác thực. Ứng dụng của bạn sở hữu chính sách khách hàng và mọi phương án dự phòng.

// RANH GIỚI TIN CẬY

Chuyển giao từ trình duyệt sang máy chủ với quyền sở hữu rõ ràng.

  1. Ứng dụng khách của khách hàng

    Tải trình thu thập công khai và chuyển mã nhận dạng thiết bị nhận được đến backend của khách hàng.

    Phương án dự phòng: JavaScript bị chặn, khả năng của trình duyệt bị hạn chế hoặc quá trình thu thập thất bại sẽ không tạo ra bằng chứng mới.

  2. Xử lý của Noxtica

    Xử lý bằng chứng được chấp nhận dựa trên khả năng của trình duyệt, chính sách tenant và trạng thái đồng ý.

    Phương án dự phòng: Kết quả bị thiếu hoặc không khả dụng không phải là kết quả có rủi ro thấp.

  3. Máy chủ của khách hàng

    Giữ kín thông tin xác thực API và thực hiện tra cứu thiết bị đã xác thực.

    Phương án dự phòng: Các phản hồi thiếu, không hợp lệ, bị giới hạn tốc độ và không khả dụng vẫn được phân biệt rõ.

  4. Chính sách của khách hàng

    Kết hợp tra cứu với ngữ cảnh tài khoản, hoạt động và lạm dụng do khách hàng sở hữu.

    Phương án dự phòng: Noxtica không đưa ra quyết định cuối cùng về cho phép, tăng cường xác thực, xem xét hoặc từ chối.

  5. Điều tra và đo lường

    Người vận hành đối chiếu các hành động đề xuất với kết quả đã xác nhận trước khi thực thi.

    Phương án dự phòng: Chỉ cài đặt thành công không đủ để thiết lập một chính sách sẵn sàng cho môi trường sản xuất.

// LỘ TRÌNH ĐƯỢC DUY TRÌ

Lộ trình tích hợp hiện tại tối giản nhất.

Các ví dụ này được hiển thị từ fixture đã được kiểm tra bởi kiểm thử đoạn mã dành cho nhà phát triển. Thay mọi giá trị tổng hợp bằng thông tin xác thực và mã nhận dạng được cấp cho đợt đánh giá của bạn.

1. Thu thập trên trình duyệt

Trình tải công khai là bản phát hành trên trình duyệt duy nhất hiện được xác minh. Trình này xuất mã nhận dạng thiết bị hoặc trạng thái lỗi; không bao giờ nhận thông tin xác thực máy chủ.

<script src="https://collect.noxtica.com/collector/noxtica-collector-core.js" data-site-key="pk_example_replace_me" data-extensions="auto" data-auto-init data-auto-check-once async></script>
<script>
  document.addEventListener('noxtica:collected', (event) => {
    const deviceId = event.detail?.fingerprintId;
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: deviceId ? { state: 'received', deviceId } : { state: 'invalid' },
    }));
  });

  document.addEventListener('noxtica:error', () => {
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: { state: 'unavailable' },
    }));
  });
</script>

2. Truy xuất trên máy chủ của bạn

Gửi mã nhận dạng thiết bị đến backend của bạn, rồi gọi tuyến v1 đã xác thực bằng khóa lưu trên máy chủ.

export async function lookupDevice({ deviceId, apiKey, fetchImpl = fetch }) {
  const response = await fetchImpl(
    `https://collect.noxtica.com/v1/device/${encodeURIComponent(deviceId)}`,
    { headers: { Authorization: `Bearer ${apiKey}` } },
  );

  if (response.status === 404) return { state: 'missing' };
  if (response.status === 429) return { state: 'rate_limited' };
  if (!response.ok) return { state: 'unavailable' };

  return { state: 'received', record: await response.json() };
}

3. Giữ riêng các trạng thái kết quả

Chỉ bản ghi đã nhận đầy đủ mới đi vào chính sách số. Các trạng thái thiếu, không hợp lệ, bị giới hạn tốc độ và không khả dụng tuân theo phương án dự phòng rõ ràng của khách hàng.

export function classifyLookup(result) {
  if (!result || result.state === 'unavailable') return { state: 'unavailable' };
  if (result.state === 'rate_limited') return { state: 'rate_limited' };
  if (result.state === 'missing') return { state: 'missing' };

  const record = result.record;
  if (!record || typeof record.score !== 'number' || typeof record.confidence !== 'number') {
    return { state: 'invalid' };
  }

  return {
    state: 'received',
    score: record.score,
    riskLevel: record.riskLevel,
    confidence: record.confidence,
  };
}

// ĐÃ XÁC MINH 2026-09-20

Ma trận hỗ trợ công khai hiện tại.

Chỉ liệt kê các bề mặt có bản phát hành công khai hoặc ranh giới API có thể truy cập. Danh mục mã nguồn riêng tư không phải là tuyên bố về hỗ trợ.

Bề mặtKhả dụngBản phát hành hiện tạiTrách nhiệm và giới hạnHướng dẫn
Trình tải bộ thu thập dữ liệu cho trình duyệtCông khai3.2.0Đã xác minh 2026-09-20

Tải trình thu thập dữ liệu cho trình duyệt từ origin của trình thu thập Noxtica. Báo cáo kết quả thu thập hoặc trạng thái không khả dụng cho mã ứng dụng.

Bằng chứng có sẵn cho trình duyệt hiện tại, chính sách tenant và trạng thái đồng ý. Yêu cầu JavaScript. Khả năng hoặc chính sách của trình duyệt có thể làm giảm lượng bằng chứng sẵn có.

Xem mẫuXem hướng dẫn
HTTP API tra cứu thiết bị đã xác thựcCần quyền truy cập đánh giáv1Đã xác minh 2026-09-20

Chỉ nhận mã định danh thiết bị từ máy chủ của khách hàng. Trả về bản ghi theo phạm vi tenant khi thông tin xác thực và phạm vi cho phép.

Bản ghi đã xác thực có sẵn cho tenant đã được cấp phát. Yêu cầu quyền truy cập đánh giá và thông tin xác thực do máy chủ lưu giữ; yêu cầu chưa xác thực sẽ bị từ chối.

Xem mẫuXem hướng dẫn

// CÁC ĐIỂM KIỂM TRA ĐÁNH GIÁ

Xác minh việc chuyển giao trước khi thay đổi chính sách.

  1. Cấp phát đúng origin và Site Key công khai cho đợt đánh giá.
  2. Theo dõi cả việc hoàn tất thu thập lẫn hành vi khi không khả dụng.
  3. Chỉ chuyển mã nhận dạng thiết bị nhận được đến backend của khách hàng.
  4. Thực hiện truy xuất đã xác thực bằng thông tin xác thực được lưu trên máy chủ.
  5. Kiểm thử các trạng thái đã nhận, thiếu, không hợp lệ, bị giới hạn tốc độ và không khả dụng.
  6. Đánh giá chính sách đề xuất ở chế độ quan sát trước khi thực thi.