Ang pagsasaling ito ay ginawa ng makina at naghihintay ng pagsusuri.Lumipat sa Ingles
Madilim
Mag-log inHumiling ng walkthrough

// PAGSUSURI PARA SA DEVELOPER

Alamin kung ano ang tumatakbo saan bago mag-integrate.

Kinokolekta ng browser ang available na ebidensiya. Isinasagawa ng iyong server ang authenticated na read. Ang iyong application ang may-ari ng patakaran para sa customer at ng bawat alternatibo.

// MGA HANGGANAN NG TIWALA

Pagpapasa mula browser patungong server na may malinaw na pagmamay-ari.

  1. Client ng customer

    Nilo-load ang pampublikong collector at ipinapasa ang ibinalik na identifier ng device sa backend ng customer.

    Alternatibo: Kapag naka-block ang JavaScript, limitado ang kakayahan ng browser, o nabigo ang pagkolekta, walang bagong ebidensiyang makukuha.

  2. Pagproseso ng Noxtica

    Pinoproseso ang ebidensiyang pinapayagan ng kakayahan ng browser, patakaran ng tenant, at estado ng pahintulot.

    Alternatibo: Ang nawawala o hindi available na resulta ay hindi nangangahulugang mababa ang panganib.

  3. Server ng customer

    Pinananatiling lihim ang credential ng API at isinasagawa ang authenticated na lookup ng device.

    Alternatibo: Nananatiling magkakaiba ang mga tugong nawawala, hindi wasto, na-rate-limit, at hindi available.

  4. Patakaran ng customer

    Pinagsasama ang lookup sa konteksto ng account, operasyon, at pang-aabuso na pagmamay-ari ng customer.

    Alternatibo: Hindi ang Noxtica ang gumagawa ng pinal na desisyong payagan, magpatupad ng step-up, suriin, o tanggihan.

  5. Pagsisiyasat at pagsukat

    Inihahambing ng mga operator ang mga iminungkahing pagkilos sa mga kumpirmadong resulta bago magpatupad.

    Alternatibo: Hindi sapat ang matagumpay na pag-install upang makapagtatag ng patakarang handa para sa production.

// PINANANATILING LANDAS

Ang pinakamaliit na kasalukuyang landas para sa integration.

Ang mga halimbawang ito ay ni-render mula sa mga fixture na sinusuri ng developer snippet test. Palitan ang bawat synthetic na value ng mga credential at identifier na inilaan para sa iyong pagsusuri.

1. Mangolekta sa browser

Ang pampublikong loader lamang ang kasalukuyang na-verify na release para sa browser. Naglalabas ito ng identifier ng device o error state; hindi ito kailanman tumatanggap ng credential ng 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. Magbasa sa iyong server

Ipadala ang identifier ng device sa iyong backend, pagkatapos ay tawagin ang authenticated na v1 route gamit ang key na nasa 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. Panatilihing magkahiwalay ang mga estado ng resulta

Tanging kumpletong natanggap na record ang pumapasok sa numeric na patakaran. Ang mga estadong nawawala, hindi wasto, na-rate-limit, at hindi available ay sumusunod sa malinaw na alternatibo ng customer.

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

// NA-VERIFY NOONG 2026-09-20

Kasalukuyang matrix ng pampublikong suporta.

Tanging mga surface na suportado ng pampublikong release o maaabot na hangganan ng API ang nakalista. Ang imbentaryo ng pribadong source ay hindi pahayag ng suporta.

SurfaceAvailabilityKasalukuyang releaseResponsibilidad at mga limitasyonGabay
Loader ng collector sa browserPampublikong available3.2.0Na-verify 2026-09-20

Nilo-load ang collector ng browser mula sa origin ng collector ng Noxtica. Nag-uulat ng resulta ng pagkolekta o unavailable state sa application code.

Ebidensiyang available sa kasalukuyang browser, patakaran ng tenant, at estado ng pahintulot. Nangangailangan ng JavaScript. Maaaring mabawasan ng kakayahan ng browser o patakaran ang available na ebidensiya.

Tingnan ang halimbawaBasahin ang gabay
Authenticated na HTTP API para sa lookup ng deviceKailangan ang access para sa pagsusuriv1Na-verify 2026-09-20

Tumatanggap lamang ng identifier ng device mula sa server ng customer. Ibinabalik ang record na saklaw ng tenant kapag pinapayagan ng mga credential at scope.

Ang authenticated na record na available sa na-provision na tenant. Nangangailangan ng access para sa pagsusuri at credential na nasa server; tinatanggihan ang request na walang authentication.

Tingnan ang halimbawaBasahin ang gabay

// MGA CHECKPOINT SA PAGSUSURI

Patunayan ang pagpapasa bago baguhin ang patakaran.

  1. I-provision ang eksaktong origin at pampublikong Site Key para sa pagsusuri.
  2. Obserbahan kapwa ang pagkumpleto ng pagkolekta at ang gawi kapag hindi available.
  3. Ipadala lamang ang ibinalik na identifier ng device sa backend ng customer.
  4. Isagawa ang authenticated na read gamit ang credential na nasa server.
  5. Subukan ang mga estadong natanggap, nawawala, hindi wasto, na-rate-limit, at hindi available.
  6. Suriin ang iminungkahing patakaran sa observation mode bago magpatupad.