الانتقال إلى المحتوى الرئيسي
يراقب واجهة برمجة تطبيقات اكتشاف الاستيلاء على الحساب (ATO) نشاط تسجيل الدخول لكل موضوع ويحدد الأنماط المشبوهة في الوقت الفعلي. يتتبع سرعة تسجيل الدخول الفاشلة في نافذة متجددة مدتها ساعة واحدة، ويخصص مستوى مخاطر بناءً على عتبات قابلة للتكوين، وينشئ تلقائيًا تنبيهات وإشارات مخاطر عند تجاوز هذه العتبات.
يعد اكتشاف ATO جزءًا من جدار حماية الهوية لمكافحة الاحتيال. تتدفق التنبيهات وإشارات المخاطر إلى نفس المسار مثل إشارات الاحتيال الأخرى، بحيث يمكنك الاستعلام عنها ومراجعتها من صفحة وحدة التحكم المخاطر والاحتيال > الإشارات أو نقطة نهاية إشارات القائمة.

كيف يعمل

1

إرسال أحداث تسجيل الدخول

استدعِ POST /v1/risk/ato/evaluate في كل مرة يحدث فيها حدث تسجيل دخول — محاولات فاشلة، إخفاقات متكررة، عمليات تسجيل دخول من جهاز جديد، أو عمليات تسجيل دخول ناجحة.
2

تتبع السرعة

تزيد المنصة (أو تعيد تعيين) عداد تسجيلات الدخول الفاشلة للموضوع في نافذة متجددة مدتها ساعة واحدة. تؤدي تسجيلات الدخول الناجحة إلى إعادة تعيين النافذة.
3

تعيين مستوى المخاطر

يتم اشتقاق مستوى المخاطر من العدد الحالي لتسجيلات الدخول الفاشلة. يتضمن الرد مستوى المخاطر، والنتيجة الرقمية، وقيمة العداد الحالية.
4

تنبيهات وإشارات تلقائية

عندما يتجاوز الموضوع عتبة معينة، تقوم المنصة بإنشاء تنبيه وإدخال إشارة مخاطر باستخدام signal_type: "ato". لا تحتاج إلى استدعاء API منفصل.
5

المراجعة والرد

استعلم عن ملفات تعريف ATO، وسرد التنبيهات، وراجع الإشارات في وحدة التحكم أو عبر API للتحقيق في التهديدات والاستجابة لها.

المتطلبات الأساسية

  • مستأجر Truthlocks نشط مع مفتاح API
  • بيانات أحداث تسجيل الدخول من نظام المصادقة الخاص بك (تسجيلات الدخول الفاشلة، النجاحات، أحداث الجهاز الجديد)

تقييم حدث تسجيل الدخول

أرسل طلب POST إلى /v1/risk/ato/evaluate مع الموضوع وتفاصيل الحدث:
تخبرك الاستجابة بوضع المخاطر الحالي وما إذا تم تشغيل تنبيه:

قواعد العتبة

تُعيّن المنصة مستوى مخاطر بناءً على عدد محاولات تسجيل الدخول الفاشلة ضمن نافذة متجددة مدتها ساعة واحدة: عند تجاوز العتبة:
  1. يتم إنشاء تنبيه في جدول تنبيهات ATO
  2. يتم استيعاب إشارة مخاطر تلقائيًا مع signal_type: "ato" والنتيجة المقابلة
  3. يتضمن الرد alert: true، وalert_type، وsignal_id

أنواع الأحداث

التحقق من ملف تعريف مخاطر الموضوع

استرداد ملف تعريف مخاطر ATO الحالي لموضوع دون تشغيل تقييم جديد:
يتضمن الملف الشخصي مستوى المخاطر الحالي، وعدد محاولات تسجيل الدخول الفاشلة، وقوائم عناوين IP والأجهزة المعروفة المرتبطة بالموضوع.

سرد التنبيهات

استعلام عن تنبيهات ATO لمستأجرك، مع إمكانية التصفية حسب الموضوع:
يتضمن كل تنبيه الموضوع ونوع التنبيه ومستوى المخاطر وقت التشغيل ومرجعًا لإشارة المخاطر التي تم استيعابها تلقائيًا.

أنماط التكامل

الحظر أو التحدي عند ارتفاع المخاطر

استخدم risk_level من استجابة التقييم لتحديد ما إذا كنت ستسمح بتسجيل الدخول أو تتحدّاه أو تحظره:

الدمج مع تسوية الأحداث

يمكن أن يكمل تقييم ATO مسار تسوية الأحداث. استخدم تسوية الأحداث لتسجيل المخاطر الواسع عبر جميع أحداث الهوية، وتقييم ATO لمراقبة الاستيلاء على الحسابات المركزة مع التنبيهات المستندة إلى العتبة.

الدمج مع تسجيل السرعة

يركز اكتشاف ATO على أنماط الاستيلاء على الحسابات المستندة إلى تسجيل الدخول مع قواعد عتبة مدمجة وإدارة التنبيهات. تسجيل السرعة يتتبع أي نوع من الإجراءات عبر نوافذ زمنية متجددة متعددة (1 دقيقة، 5 دقائق، 1 ساعة، 24 ساعة) مع اكتشاف الاندفاع الموزون. استخدم كلاهما معًا للحماية متعددة الطبقات:
  • اكتشاف ATO لأمان تسجيل الدخول المركز — سرعة تسجيل الدخول الفاشلة، تنبيهات حشو بيانات الاعتماد، ملفات تعريف مخاطر الموضوع
  • تسجيل السرعة لاكتشاف إساءة الاستخدام العامة — إساءة استخدام معدل واجهة برمجة التطبيقات، إغراق المعاملات، البريد العشوائي للتسجيل، أو أي نوع إجراء مخصص
كلاهما ينتج إشارات مخاطر في نفس مسار موحد، بحيث يمكنك الاستعلام عن جميع الإشارات ومراجعتها من مكان واحد.

المراقبة عبر webhooks

قم بتكوين نقطة نهاية webhook لتلقي إشعارات في الوقت الفعلي عند إنشاء تنبيهات ATO، حتى يتمكن فريق الأمان لديك من الاستجابة دون استقصاء.

ما التالي