Цей переклад згенеровано машиною та очікує перевірки.Перейти на англійську
Темна
УвійтиЗапросити демонстрацію

// ОЦІНЮВАННЯ ДЛЯ РОЗРОБНИКІВ

Перед інтеграцією дізнайтеся, що і де виконується.

Браузер збирає доступні докази. Ваш сервер виконує автентифіковане читання. Ваш застосунок відповідає за політику щодо клієнтів і кожен резервний сценарій.

// МЕЖІ ДОВІРИ

Передавання від браузера на сервер із чітко визначеною відповідальністю.

  1. Клієнтський застосунок

    Завантажує публічний збирач і передає повернений ідентифікатор пристрою на бекенд клієнта.

    Резервний варіант: Заблокований JavaScript, обмежені можливості браузера або збій збору даних означають відсутність нових доказових даних.

  2. Обробка Noxtica

    Обробляє докази, допустимі з огляду на можливості браузера, політику тенанта та стан згоди.

    Резервний варіант: Відсутній або недоступний результат не означає низького ризику.

  3. Сервер клієнта

    Зберігає облікові дані API в таємниці та виконує автентифікований пошук пристрою.

    Резервний варіант: Відсутні, недійсні, обмежені за частотою й недоступні відповіді розглядаються окремо.

  4. Політика клієнта

    Поєднує результат пошуку з контекстом облікового запису, операції та зловживань, що належить клієнту.

    Резервний варіант: Noxtica не ухвалює остаточного рішення: дозволити, вимагати додаткову перевірку, переглянути чи відхилити.

  5. Розслідування та вимірювання

    Оператори порівнюють запропоновані дії з підтвердженими результатами перед застосуванням.

    Резервний варіант: Лише успішне встановлення не означає готовності політики до використання у виробничому середовищі.

// ШЛЯХ, ЩО ПІДТРИМУЄТЬСЯ

Найменший поточний шлях інтеграції.

Ці приклади відтворено на основі фікстур, перевірених тестом фрагментів коду для розробників. Замініть усі синтетичні значення обліковими даними та ідентифікаторами, виданими для вашого оцінювання.

1. Зберіть дані в браузері

Публічний завантажувач — єдиний наразі перевірений браузерний реліз. Він повертає ідентифікатор пристрою або стан помилки; серверні облікові дані він ніколи не отримує.

<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. Виконайте читання на своєму сервері

Передайте ідентифікатор пристрою на свій бекенд, а потім зверніться до автентифікованого маршруту v1 за допомогою ключа, що зберігається на сервері.

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. Розділяйте стани результатів

Лише повний отриманий запис переходить до числової політики. Відсутні, недійсні, обмежені за частотою та недоступні стани обробляються за явними резервними сценаріями клієнта.

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

// ПЕРЕВІРЕНО 2026-09-20

Поточна матриця публічної підтримки.

У переліку наведено лише інтерфейси, що мають публічний реліз або доступну межу API. Інвентаризація приватного вихідного коду не є заявою про підтримку.

ІнтерфейсДоступністьПоточний релізВідповідальність і обмеженняНастанови
Завантажувач збирача даних браузераПублічно доступно3.2.0Перевірено 2026-09-20

Завантажує збирач даних браузера з походження збирача Noxtica. Повідомляє коду застосунку про результат збору або недоступний стан.

Доказові дані, доступні поточному браузеру відповідно до політики тенанта та стану згоди. Потребує JavaScript. Можливості браузера або політика можуть зменшити обсяг доступних доказових даних.

Переглянути прикладЧитати настанови
HTTP API для автентифікованого пошуку пристроївПотрібен доступ для оцінюванняv1Перевірено 2026-09-20

Приймає ідентифікатор пристрою лише від сервера клієнта. Повертає запис у межах тенанта, якщо це дозволяють облікові дані та область доступу.

Автентифікований запис, доступний для тенанта, для якого налаштовано доступ. Потрібні доступ для оцінювання та облікові дані на сервері; неавтентифікований запит відхиляється.

Переглянути прикладЧитати настанови

// КОНТРОЛЬНІ ТОЧКИ ОЦІНЮВАННЯ

Підтвердьте передавання даних до внесення змін до політики.

  1. Надайте точне походження та публічний Site Key для оцінювання.
  2. Відстежуйте і завершення збору, і поведінку за недоступності.
  3. Передавайте на бекенд клієнта лише повернений ідентифікатор пристрою.
  4. Виконайте автентифіковане читання з обліковими даними, що зберігаються на сервері.
  5. Перевірте стани: отримано, відсутній, недійсний, обмежений за частотою та недоступний.
  6. Оцініть запропоновану політику в режимі спостереження перед застосуванням.