Bu çeviri makine tarafından oluşturulmuştur ve inceleme beklemektedir.İngilizceye geç
Koyu
Oturum açÜrün tanıtımı talep edin

// GELİŞTİRİCİ DEĞERLENDİRMESİ

Entegrasyondan önce neyin nerede çalıştığını bilin.

Tarayıcı, mevcut kanıtları toplar. Sunucunuz kimliği doğrulanmış okumayı gerçekleştirir. Müşteri politikasının ve tüm geri dönüşlerin sorumluluğu uygulamanıza aittir.

// GÜVEN SINIRLARI

Açık sorumluluklarla tarayıcıdan sunucuya aktarım.

  1. Müşteri istemcisi

    Herkese açık toplayıcıyı yükler ve dönen cihaz tanımlayıcısını müşteri arka ucuna iletir.

    Geri dönüş: JavaScript engellendiğinde, tarayıcı yetenekleri kısıtlandığında veya toplama başarısız olduğunda yeni kanıt elde edilmez.

  2. Noxtica işleme

    Tarayıcı yetenekleri, kiracı politikası ve rıza durumu tarafından kabul edilen kanıtları işler.

    Geri dönüş: Eksik veya kullanılamayan bir sonuç, düşük riskli bir sonuç değildir.

  3. Müşteri sunucusu

    API kimlik bilgisini gizli tutar ve kimliği doğrulanmış cihaz sorgusunu gerçekleştirir.

    Geri dönüş: Eksik, geçersiz, hız sınırlı ve kullanılamayan yanıtlar birbirinden ayrı kalır.

  4. Müşteri politikası

    Sorguyu, müşterinin sahip olduğu hesap, işlem ve kötüye kullanım bağlamıyla birleştirir.

    Geri dönüş: Noxtica, nihai izin verme, ek doğrulama, inceleme veya reddetme kararını vermez.

  5. İnceleme ve ölçüm

    Operatörler, uygulamadan önce önerilen eylemleri doğrulanmış sonuçlarla karşılaştırır.

    Geri dönüş: Yalnızca kurulumun başarılı olması, üretime hazır bir politika oluşturmaz.

// GÜNCEL TUTULAN YOL

Mevcut en küçük entegrasyon yolu.

Bu örnekler, geliştirici kod parçacığı testi tarafından denetlenen fikstürlerden oluşturulur. Her sentetik değeri, değerlendirmeniz için verilen kimlik bilgileri ve tanımlayıcılarla değiştirin.

1. Tarayıcıda toplayın

Herkese açık yükleyici, şu anda doğrulanmış tek tarayıcı sürümüdür. Bir cihaz tanımlayıcısı veya hata durumu üretir; hiçbir zaman sunucu kimlik bilgisi almaz.

<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. Sunucunuzda okuyun

Cihaz tanımlayıcısını arka ucunuza gönderin, ardından sunucuda tutulan bir anahtarla kimliği doğrulanmış v1 rotasını çağırın.

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. Sonuç durumlarını ayrı tutun

Sayısal politikaya yalnızca eksiksiz alınmış bir kayıt girer. Eksik, geçersiz, hız sınırlı ve kullanılamayan durumlar açık müşteri geri dönüşlerini izler.

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

// DOĞRULANDI 2026-09-20

Mevcut herkese açık destek matrisi.

Yalnızca herkese açık bir sürüm veya erişilebilir bir API sınırı tarafından desteklenen arayüzler listelenir. Özel kaynak envanteri bir destek iddiası oluşturmaz.

ArayüzKullanılabilirlikGüncel sürümSorumluluk ve sınırlarRehberlik
Tarayıcı toplayıcı yükleyicisiHerkese açık3.2.0Doğrulandı 2026-09-20

Tarayıcı toplayıcısını Noxtica toplayıcı origin'inden yükler. Uygulama koduna bir toplama sonucu veya kullanılamama durumu bildirir.

Mevcut tarayıcı, kiracı politikası ve rıza durumunun kullanılmasına izin verdiği kanıtlar. JavaScript gerektirir. Tarayıcı yetenekleri veya politika, mevcut kanıtları azaltabilir.

Örneği görüntüleyinRehberliği okuyun
Kimliği doğrulanmış cihaz sorgusu HTTP APIDeğerlendirme erişimi gerekliv1Doğrulandı 2026-09-20

Yalnızca müşteri sunucusundan bir cihaz tanımlayıcısı alır. Kimlik bilgileri ve kapsam izin verdiğinde kiracı kapsamındaki kaydı döndürür.

Sağlanan kiracının erişebildiği kimliği doğrulanmış kayıt. Değerlendirme erişimi ve sunucuda tutulan bir kimlik bilgisi gerektirir; kimliği doğrulanmamış bir istek reddedilir.

Örneği görüntüleyinRehberliği okuyun

// DEĞERLENDİRME KONTROL NOKTALARI

Politikayı değiştirmeden önce aktarımı kanıtlayın.

  1. Değerlendirme için tam origin'i ve herkese açık Site Key'i sağlayın.
  2. Hem toplamanın tamamlanmasını hem de kullanılamama davranışını gözlemleyin.
  3. Müşteri arka ucuna yalnızca dönen cihaz tanımlayıcısını iletin.
  4. Kimliği doğrulanmış okumayı sunucuda tutulan bir kimlik bilgisiyle gerçekleştirin.
  5. Alınan, eksik, geçersiz, hız sınırlı ve kullanılamayan durumları test edin.
  6. Önerilen politikayı uygulamadan önce gözlem modunda değerlendirin.