Terjemahan ini dibuat oleh mesin dan menunggu peninjauan.Beralih ke bahasa Inggris
Gelap
MasukMinta tur produk

// EVALUASI PENGEMBANG

Pahami apa yang berjalan di mana sebelum Anda mengintegrasikan.

Browser mengumpulkan bukti yang tersedia. Server Anda melakukan pembacaan terautentikasi. Aplikasi Anda memiliki kebijakan pelanggan dan setiap cadangan.

// BATAS KEPERCAYAAN

Serah-terima dari browser ke server dengan kepemilikan yang jelas.

  1. Klien pelanggan

    Memuat kolektor publik dan meneruskan pengenal perangkat yang dikembalikan ke backend pelanggan.

    Cadangan: JavaScript yang diblokir, kemampuan browser yang terbatas, atau kegagalan pengumpulan tidak menghasilkan bukti baru.

  2. Pemrosesan Noxtica

    Memproses bukti yang diizinkan oleh kemampuan browser, kebijakan tenant, dan status persetujuan.

    Cadangan: Hasil yang tidak ada atau tidak tersedia bukanlah hasil berisiko rendah.

  3. Server pelanggan

    Menjaga kredensial API tetap rahasia dan melakukan pencarian perangkat yang terautentikasi.

    Cadangan: Respons yang tidak ada, tidak valid, dibatasi laju, dan tidak tersedia tetap dibedakan.

  4. Kebijakan pelanggan

    Menggabungkan hasil pencarian dengan konteks akun, operasi, dan penyalahgunaan milik pelanggan.

    Cadangan: Noxtica tidak membuat keputusan akhir untuk mengizinkan, meminta verifikasi tambahan, meninjau, atau menolak.

  5. Investigasi dan pengukuran

    Operator membandingkan tindakan yang diusulkan dengan hasil yang telah dikonfirmasi sebelum penegakan.

    Cadangan: Keberhasilan instalasi saja tidak membuktikan kebijakan siap digunakan di produksi.

// JALUR YANG DIPELIHARA

Jalur integrasi terkecil saat ini.

Contoh ini dirender dari fixture yang diperiksa oleh pengujian cuplikan pengembang. Ganti setiap nilai sintetis dengan kredensial dan pengenal yang diterbitkan untuk evaluasi Anda.

1. Kumpulkan di browser

Loader publik adalah satu-satunya rilis browser yang saat ini terverifikasi. Loader ini mengeluarkan pengenal perangkat atau status kesalahan; loader ini tidak pernah menerima kredensial server.

<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. Baca di server Anda

Kirim pengenal perangkat ke backend Anda, lalu panggil rute v1 yang terautentikasi dengan kunci yang disimpan di server.

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. Pisahkan status hasil

Hanya catatan lengkap berstatus diterima yang masuk ke kebijakan numerik. Status tidak ada, tidak valid, dibatasi laju, dan tidak tersedia mengikuti cadangan pelanggan yang eksplisit.

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,
  };
}

// DIVERIFIKASI 2026-09-20

Matriks dukungan publik saat ini.

Hanya antarmuka yang didukung oleh rilis publik atau batas API yang dapat dijangkau yang dicantumkan. Inventaris sumber privat bukan merupakan klaim dukungan.

AntarmukaKetersediaanRilis saat iniTanggung jawab dan batasanPanduan
Loader kolektor browserTersedia secara publik3.2.0Terverifikasi 2026-09-20

Memuat kolektor browser dari origin kolektor Noxtica. Melaporkan hasil pengumpulan atau status tidak tersedia ke kode aplikasi.

Bukti yang tersedia bagi browser saat ini, kebijakan tenant, dan status persetujuan. Memerlukan JavaScript. Kemampuan browser atau kebijakan dapat mengurangi bukti yang tersedia.

Lihat contohBaca panduan
API HTTP pencarian perangkat terautentikasiMemerlukan akses evaluasiv1Terverifikasi 2026-09-20

Hanya menerima pengenal perangkat dari server pelanggan. Mengembalikan catatan dalam cakupan tenant jika kredensial dan cakupan mengizinkan.

Catatan terautentikasi yang tersedia bagi tenant yang telah disediakan. Memerlukan akses evaluasi dan kredensial yang disimpan di server; permintaan tanpa autentikasi ditolak.

Lihat contohBaca panduan

// TITIK PEMERIKSAAN EVALUASI

Buktikan serah-terima sebelum mengubah kebijakan.

  1. Sediakan origin yang tepat dan Site Key publik untuk evaluasi.
  2. Amati penyelesaian pengumpulan maupun perilaku saat tidak tersedia.
  3. Teruskan hanya pengenal perangkat yang dikembalikan ke backend pelanggan.
  4. Lakukan pembacaan terautentikasi menggunakan kredensial yang disimpan di server.
  5. Uji status diterima, tidak ada, tidak valid, dibatasi laju, dan tidak tersedia.
  6. Evaluasi kebijakan yang diusulkan dalam mode observasi sebelum penegakan.

// LANGKAH BERIKUTNYA

Lanjutkan dari orientasi ke panduan yang dipelihara.