این ترجمه به‌صورت ماشینی تولید شده و در انتظار بازبینی است.تغییر به انگلیسی
تیره
وروددرخواست نمایش محصول

// ارزیابی توسعه‌دهندگان

پیش از یکپارچه‌سازی، بدانید چه چیزی کجا اجرا می‌شود.

مرورگر شواهد در‌دسترس را گردآوری می‌کند. سرور شما خواندن احرازشده را انجام می‌دهد. مالکیت سیاست مشتری و همهٔ راه‌حل‌های جایگزین با برنامهٔ شماست.

// مرزهای اعتماد

انتقال از مرورگر به سرور، با مالکیت‌های صریح.

  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 نیاز دارد. توانمندی مرورگر یا سیاست می‌تواند شواهد در‌دسترس را کاهش دهد.

مشاهدهٔ نمونهراهنما را بخوانید
API HTTP جست‌وجوی احرازشدهٔ دستگاهنیازمند دسترسی ارزیابیv1تأییدشده 2026-09-20

شناسهٔ دستگاه را فقط از سرور مشتری دریافت می‌کند. هرگاه اعتبارنامه‌ها و محدوده اجازه دهند، رکورد محدودشده به مستأجر را برمی‌گرداند.

رکورد احرازشدهٔ در‌دسترس برای مستأجر فراهم‌شده. به دسترسی ارزیابی و اعتبارنامه‌ای نگه‌داری‌شده روی سرور نیاز دارد؛ درخواست بدون احراز هویت رد می‌شود.

مشاهدهٔ نمونهراهنما را بخوانید

// ایست‌های ارزیابی

پیش از تغییر سیاست، انتقال را اثبات کنید.

  1. مبدأ دقیق و کلید سایت عمومی را برای ارزیابی فراهم کنید.
  2. هم تکمیل گردآوری و هم رفتار در حالت در‌دسترس‌نبودن را مشاهده کنید.
  3. فقط شناسهٔ دستگاه بازگشتی را به بک‌اند مشتری ارسال کنید.
  4. خواندن احرازشده را با اعتبارنامه‌ای که روی سرور نگه‌داری می‌شود انجام دهید.
  5. وضعیت‌های دریافت‌شده، مفقود، نامعتبر، دارای محدودیت نرخ و در‌دسترس‌نبودن را بررسی کنید.
  6. پیش از اعمال، سیاست پیشنهادی را در حالت مشاهده ارزیابی کنید.