جدار الحماية لمكافحة الاحتيال والهوية متاح بشكل عام. جميع مسارات الكشف الخمسة — استيعاب الإشارة المباشر، وتطبيع الأحداث، ومسح التزييف العميق، واكتشاف الاستيلاء على الحساب (ATO)، وتسجيل السرعة — هي تكامل مع أمثلة API متعددة اللغات (cURL، JavaScript، Python)، وأدلة شاملة، وإشعارات الويب هوك في الوقت الفعلي لجميع أنواع الإشارات. أصبحت قرارات المخاطر الآلية، وإدارة الحالات، وتصدير SIEM للاحتيال متاحة الآن.
- الاستيعاب المباشر - أرسل إشارة مسجلة بالكامل عبر
POST /v1/risk/signalsعندما يكون لديك بالفعل درجة مخاطر من مزود خارجي. يدعم عمليات إعادة المحاولة المتطابقة عبر رأسIdempotency-Key. - تسوية الأحداث - أرسل حدث هوية خام عبر
POST /v1/risk/eventsودع المنصة تقوم بتعيينه تلقائيًا إلى نوع إشارة ودرجة أساسية. راجع تسوية الأحداث. - تسجيل إشارات التزييف العميق وانتحال الشخصية - إرسال مؤشرات أو درجات منتجة خارجيًا لتقييم العتبة عبر
POST /v1/risk/deepfake/scan. تؤدي عمليات الفحص التي تسجل 60 أو أعلى إلى استيعاب إشارة مخاطر تلقائيًا. راجع دليل اكتشاف التزييف العميق. - اكتشاف الاستيلاء على الحساب — تقييم أحداث تسجيل الدخول مقابل الاستدلالات القائمة على السرعة عبر
POST /v1/risk/ato/evaluate. يتم إنشاء التنبيهات وإدخال إشارات المخاطر تلقائيًا عند تجاوز العتبات. راجع دليل اكتشاف ATO. - تسجيل السرعة والشذوذ — سجل إجراءات الموضوع عبر
POST /v1/risk/velocity/recordواجعل المنصة تتتبع التكرار عبر نوافذ زمنية متجددة (1 دقيقة، 5 دقائق، 1 ساعة، 24 ساعة). الإجراءات التي تنتج درجة سرعة مرجحة تبلغ 60 أو أعلى تستوعب تلقائيًا إشارة خطر. انظر دليل تسجيل السرعة.
اختيار مسار الاستيعاب
تنتج جميع المسارات الخمسة نفس سجلات إشارة المخاطر. يمكنك الاستعلام عن الإشارات وتصفيتها ومراجعتها من أي مسار باستخدام نقطة النهاية القائمة وصفحة وحدة التحكم المخاطر والاحتيال > الإشارات.
كيف يعمل
1
استيعاب الإشارات
أرسل طلب
POST إلى /v1/risk/signals مع مصدر الإشارة، والنوع، ودرجة المخاطرة، والموضوع الذي يتعلق به. أرفق أي سياق إضافي في كائن payload.2
الاستعلام والتصفية
استخدم
GET /v1/risk/signals لسرد الإشارات مع عوامل تصفية للمصدر ونوع الإشارة والموضوع والحد الأدنى للنتيجة. يتم تقسيم النتائج إلى صفحات باستخدام ترقيم الصفحات المستند إلى المؤشر.3
المراجعة في وحدة التحكم
افتح المخاطر والاحتيال > الإشارات في وحدة تحكم المستأجر لتصفح الإشارات، والتصفية حسب المصدر أو النتيجة، وفحص تفاصيل الإشارة الفردية.
المتطلبات الأساسية
- مستأجر Truthlocks نشط مع مفتاح API
- مصدر واحد على الأقل للكشف عن الاحتيال في المنبع ينتج إشارات مسجلة
استيعاب إشارة
أرسل طلبPOST بالحقول المطلوبة:
الحقول المطلوبة
الحقول الاختيارية
الثبات
قم بتضمين رأسIdempotency-Key (UUID) لمنع الإشارات المكررة أثناء عمليات إعادة المحاولة. إذا أرسلت نفس المفتاح مرتين، يتم تجاهل التكرار بصمت.
الاستعلام عن الإشارات
قائمة مع عوامل التصفية
الحصول على إشارة واحدة
عرض Console
توفر صفحة المخاطر والاحتيال > الإشارات في وحدة التحكم قائمة قابلة للبحث والتصفية لجميع الإشارات المستوعبة. يعرض كل صف المصدر، والنوع، والنتيجة (ملونة حسب الخطورة)، ومرجع الموضوع، والطابع الزمني. استخدم المرشحات الموجودة في الجزء العلوي من الصفحة لتضييق النتائج حسب المصدر أو نوع الإشارة أو الحد الأدنى للدرجة. انقر فوق أي صف لعرض تفاصيل الإشارة الكاملة بما في ذلك كائن بيانات التعريفpayload.
إرشادات التسجيل
التسجيل المتسق عبر المصادر يجعل التحليل اللاحق أكثر موثوقية. نوصي بالنطاقات التالية:تسوية الأحداث
بدلاً من إنشاء إشارات المخاطر يدويًا، يمكنك إرسال أحداث الهوية الأولية والسماح للمنصة بتطبيعها إلى إشارات تلقائيًا. هذا مفيد عندما تريد تغذية الأحداث الأصلية للمنصة — عمليات تسجيل الدخول الفاشلة، التوقيعات غير الصالحة، المشتبه بهم في التزييف العميق — مباشرة في مسار المخاطر دون ربطها بأنواع الإشارات بنفسك. أرسل طلبPOST إلى /v1/risk/events مع مصدر الحدث ونوعه وموضوعه:
event_id الخام وsignal_id المعياري، حتى تتمكن من تتبع المسار الكامل من الحدث إلى الإشارة:
normalized هو true، تطابق الحدث مع تعيين معروف. عندما يكون false، استخدمت المنصة البديل العام.
تعيينات الأحداث المضمنة
تأتي المنصة مع تعيينات معايرة مسبقًا لأحداث الهوية الشائعة:
يتم قبول أنواع الأحداث غير المعروفة بنوع الإشارة
behavior ودرجة أساسية 10.
حقول الحدث
مطلوب:
اختياري:
استخدم تسوية الأحداث عندما تنشأ أحداثك من داخل المنصة (تسجيلات الدخول، التحقق، الشهادات). استخدم نقطة نهاية استيعاب الإشارة المباشرة عندما يكون لديك بالفعل إشارة مسجلة من مصدر خارجي.
عزل المستأجر
إشارات المخاطر معزولة تمامًا للمستأجر باستخدام أمان على مستوى الصف (RLS). ترتبط كل إشارة بالمستأجر المصادق عليه وقت الاستيعاب، ويمكن للاستعلامات فقط إرجاع الإشارات التي تنتمي إلى المستأجر المتصل.اكتشاف التزييف العميق وانتحال الشخصية
توسع واجهة برمجة تطبيقات اكتشاف التزييف العميق مسار إشارة المخاطر من خلال المسح التلقائي للمحتوى المتلاعب والاحتيال في الهوية. أرسل الصور أو مقاطع الفيديو أو المستندات أو الشهادات للتحليل، وتقوم عمليات المسح التي تتجاوز عتبة المخاطر بإنشاء إشارة مخاطر تلقائيًا - لا حاجة إلى استدعاء API إضافي. راجع دليل اكتشاف التزييف العميق وانتحال الشخصية لسير العمل الكامل، ومرجع المؤشرات، وأمثلة التعليمات البرمجية.الكشف عن الاستيلاء على الحساب
توسع واجهة برمجة تطبيقات اكتشاف ATO مسار إشارة المخاطر من خلال مراقبة تسجيل الدخول المستندة إلى السرعة. أرسل أحداث تسجيل الدخول إلىPOST /v1/risk/ato/evaluate وتتتبع المنصة المحاولات الفاشلة لكل موضوع في نافذة متجددة مدتها ساعة واحدة. عندما يتجاوز الموضوع عتبة (5 أو 10 أو 20 محاولة تسجيل دخول فاشلة)، يتم إنشاء تنبيه ويتم استيعاب إشارة مخاطر تلقائيًا - لا حاجة إلى استدعاء API إضافي.
راجع دليل اكتشاف الاستيلاء على الحساب لسير العمل الكامل، ومرجع العتبة، وأنماط التكامل.
تسجيل السرعة والشذوذ
توسع واجهة برمجة تطبيقات تسجيل السرعة مسار إشارة المخاطر من خلال تتبع الإجراءات متعددة النوافذ واكتشاف الشذوذ. سجل أي إجراء للموضوع عبرPOST /v1/risk/velocity/record وتتتبع المنصة التردد عبر أربع نوافذ متجددة (دقيقة واحدة، 5 دقائق، ساعة واحدة، 24 ساعة). يتم حساب درجة سرعة مرجحة من عدد النوافذ، مع الانحياز نحو النوافذ القصيرة لاكتشاف الاندفاع. عندما تصل النتيجة إلى 60 أو أعلى، يتم استيعاب إشارة مخاطر مع signal_type: "velocity" تلقائيًا - لا حاجة إلى استدعاء API إضافي.
راجع دليل تسجيل السرعة والشذوذ لسير العمل الكامل، ونموذج التسجيل، وأنماط التكامل.
إشعارات خطاف الويب (Webhook)
يمكن لإشارات المخاطر التي تم إنشاؤها بواسطة أي من مسارات الكشف الخمسة أن تؤدي إلى إشعارات webhook في الوقت الفعلي. اشترك فيrisk.signal.created أو risk.signal.escalated للتفاعل مع الإشارات الجديدة دون استقصاء. يغطي هذا الإشارات من الاستيعاب المباشر، وتطبيع الأحداث، ومسح التزييف العميق، وتنبيهات ATO، وشذوذ السرعة.
راجع دليل الويب هوكس لأمثلة الحمولة وأنماط التكامل.
قياس الاستخدام
يتم قياس ميزات مكافحة الاحتيال لكل دورة فوترة. يزيد كل مسار اكتشاف عداد الاستخدام الخاص به:
تختلف الحصص حسب مستوى الخطة. يمكنك التحقق من استهلاكك الحالي باستخدام واجهة برمجة تطبيقات الاستخدام أو في وحدة التحكم ضمن الإعدادات > الفوترة > الاستخدام في قسم مكافحة الاحتيال. للتحقق مما إذا كانت عملية معينة مسموح بها قبل إجرائها، استخدم نقطة نهاية التحقق من الحد.
used، limit، وperiod حتى تتمكن من مراقبة الاستهلاك برمجيًا.
راجع نظرة عامة على الفواتير للحصول على القائمة الكاملة للمنتجات الـ 16 المقاسة وأسعارها الافتراضية.

