الانتقال إلى المحتوى الرئيسي
تتيح لك إشارات المخاطر إدخال بيانات اكتشاف الاحتيال في Truthlocks من أي مزود خارجي — خدمات بصمات الأجهزة، وواجهات برمجة تطبيقات سمعة IP، وأدوات التحقق من البريد الإلكتروني، ومحركات تحليل المستندات، أو قواعدك الداخلية الخاصة. بمجرد استيعابها، تتوفر الإشارات من خلال API وصفحة المخاطر والاحتيال > الإشارات في وحدة التحكم.
جدار الحماية لمكافحة الاحتيال والهوية متاح بشكل عام. جميع مسارات الكشف الخمسة — استيعاب الإشارة المباشر، وتطبيع الأحداث، ومسح التزييف العميق، واكتشاف الاستيلاء على الحساب (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.

إرشادات التسجيل

التسجيل المتسق عبر المصادر يجعل التحليل اللاحق أكثر موثوقية. نوصي بالنطاقات التالية:
الدرجات التي تبلغ 80 أو أعلى تؤدي إلى قرارات مراجعة تلقائية. تفسير الدرجات بما يتجاوز العتبة التلقائية متروك لك — تقوم المنصة بتخزين وإرجاع الدرجات كما هي ولا تقوم بتطبيعها عبر المصادر.

تسوية الأحداث

بدلاً من إنشاء إشارات المخاطر يدويًا، يمكنك إرسال أحداث الهوية الأولية والسماح للمنصة بتطبيعها إلى إشارات تلقائيًا. هذا مفيد عندما تريد تغذية الأحداث الأصلية للمنصة — عمليات تسجيل الدخول الفاشلة، التوقيعات غير الصالحة، المشتبه بهم في التزييف العميق — مباشرة في مسار المخاطر دون ربطها بأنواع الإشارات بنفسك. أرسل طلب 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 المقاسة وأسعارها الافتراضية.

ما التالي