trustapi/1.1.0 · حُدّث في ٠٩‏/٠٧‏/٢٠٢٦

مؤشر الثقة والأتمتة

كيفية قراءة ما إذا كانت الزيارة تبدو بشرية أو مؤتمتة أو منسقة وتحديد الخطوة التالية.

يلخص مؤشر الثقة في مكان واحد تقييم IP أو النطاق أو الجلسة أو الحملة، ويدعم الحكم البشري بأسباب صريحة وإجراء مقترح.

لا تحل قراءة score محل قرار المشغل، بل توجهه. توضّح reason codes لماذا تبدو الحالة سليمة أو مختلطة أو خطرة، وتساعد على التصعيد إلى التحقق أو التقييد أو watchlist أو Evidence.

عندما يظهر النمط نفسه في أكثر من واجهة، تزداد قيمة score عند استخدامه مع incidents أو tasks أو Access أو Mail أو WAF أو Intel.

قائمة التحقق

• مقارنة قراءة الأتمتة بقراءتي الجلسة والنطاق.
• التأكد من توافق الإجراء المقترح مع درجة الخطورة.
• تسجيل الملاحظات إذا لم تكن الأسباب كافية لتفسير القرار.

بدء سريع

1. اقرأ severity وaction وreason codes كجملة تشغيلية واحدة.
2. اربط score مع الوحدة المتأثرة قبل الحظر الافتراضي.
3. في الحالات الحساسة، انقل القراءة إلى incident أو task أو Evidence.

التدفق التشغيلي

الاستعلام

احصل على قراءة لـIP أو نطاق أو جلسة أو حملة.

استخدم نوع score الأنسب للحالة.

التفسير

حوّل reason codes إلى معايير مشتركة للفريق.

وحّد اللغة التقنية والتشغيلية.

اتخاذ القرار

اربط الإجراء المقترح بالوحدة التي ستنفذ الإجراء فعليًا.

لا تعامل score كما لو كان الإجراء نفسه.

flowchart LR
  S1["الاستعلام"]
  S2["التفسير"]
  S3["اتخاذ القرار"]
  S1 --> S2
  S2 --> S3

أدوات التحقق والفحوص

تنفذ قراءة سياقية لهذه الواجهة وتعيد خطوات مقترحة بتركيز تشغيلي.

التحقق من قراءة TrustAPI

يلخص المقالات وchecks والخطوات التالية حول score وتفسيره.

أمثلة

Payload لـscore الجلسة

{
  "sessionId": "sess_ops_001",
  "domain": "login.capacero.ar",
  "ip": "198.51.100.18"
}

الروابط والمراجع

المسارات ذات الصلة

BotRadar في وحدة التحكم TrustAPI العامة

APIs

/api/adda/v1/trust/score
/api/adda/v1/score/ip
/api/adda/v1/score/domain

Docs ومسارات الدعم

docs/ADDA_API.md
docs/ADDA_PROTOCOLO.md

المشكلات الشائعة

• معاملة الإجراء المقترح كأمر آلي من دون مراجعة الوحدة المتأثرة.
• يمنع عدم تسجيل الأسباب عند اختلاط الإشارة المراجعة اللاحقة.

الإجراءات المقترحة

• استخدم Copilot وManual عندما لا تكفي score لتبرير الإجراء.
• صعّد إلى Evidence إذا أدت القراءة إلى حظر أو إلغاء أو احتواء قوي.

Reason Codes مفيدة

BOT_HIGH

الأتمتة المقدرة مرتفعة بالنسبة إلى السياق الذي جرى تحليله.

طبّق تحققًا أو تقييدًا تدريجيًا.

GEO_ANOMALY

المصدر أو المسار المتوقع غير متسق.

اربط مع Access أو DNS أو incident قبل منح الثقة.

SESSION_RISK

تُظهر الجلسة سمات تستدعي متابعة دقيقة.

راجع الاستمرارية والضوابط على الجلسة أو الجهاز.

قاموس Score

severity

الأولوية المؤسسية للإشارة على مقياس ADDA.

action

الخطوة التشغيلية التالية التي يوصي بها المحرك.

reasonCodes

أسباب قابلة للتفسير لتبرير القراءة.

ملاحظات البروتوكول

• تكتسب score قيمة عندما ترتبط بواجهة استجابة ملموسة.

سجل المقالة

٠٩‏/٠٧‏/٢٠٢٦

جرى توسيع مسرد score ومسارها التشغيلي.