תרגום זה נוצר על ידי מכונה וממתין לבדיקה.מעבר לאנגלית
כהה
התחברותבקשת סיור מודרך

// הערכת מפתחים

דעו מה פועל היכן לפני שתבצעו אינטגרציה.

הדפדפן אוסף את הראיות הזמינות. השרת שלכם מבצע את הקריאה המאומתת. האפליקציה שלכם אחראית למדיניות הלקוח ולכל חלופה.

// גבולות אמון

העברה מדפדפן לשרת עם בעלות מפורשת.

  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. העריכו את המדיניות המוצעת במצב תצפית לפני אכיפה.