تلقّي إشعارات من Sense

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

يمكنك ضبط Apigee Sense لإرسال إشعار إليك بقائمة من طلبات واجهة برمجة التطبيقات التي تم رصدها والتي قد تكون غير مرغوب فيها. بعد إعداد الإشعارات، يرسل Apigee Sense تقريرًا كل 5 دقائق إلى معرِّف الموارد المنتظم (URI) للردّ التلقائي على الويب الذي تحدِّده.

باستخدام معرّف الموارد المنتظم (URI) للردّ التلقائي على الويب، سترسل Apigee Sense سلسلة بتنسيق JSON (ستحتاج إلى رمز يحلّل السلسلة إلى JSON). تم تنسيق المثال الموجز التالي لتقرير من سلسلة إلى JSON لتسهيل قراءته:

{
    "text": {
        "metadata": {
            "org": "my-org",
            "env": "prod",
            "reportTimestamp": "2018-10-09T17:25:12Z",
            "messageId": "1539105912220"
        },
        "totalNumberOfBots": 1,
        "bots": [
            {
                "ipAddress": "11.111.111.11",
                "botDetectedLast": "2018-10-0917:04:48Z",
                "ipIsp": "Their ISP",
                "ipCountry": "United States",
                "botReason": [
                    "Flooder",
                    "Content Robber"
                ],
                "callCount": "274529",
                "topUrl": "/v1/my/url",
                "ipCity": "Los Angeles"
            }
        ]
    }
}

يسجل التقرير المعلومات التالية حول الهجمات المحتملة غير المرغوب فيها على واجهات برمجة التطبيقات:

• مؤسسة وبيئة Apigee حيث تم جمع الطلبات المبلّغ عنها.
• الطابع الزمني للتقرير
• رقم تعريف رسالة التقرير
• عدد عناوين IP التي ترسل طلبات قد تكون غير مرغوب فيها

• يشير ذلك المصطلح إلى مصفوفة من بيانات العميل الخاصة بعناوين IP التي ترسل طلبات يُحتمل أن تكون غير مرغوب فيها (مثل برامج التتبُّع). بالنسبة إلى كل عميل، يتضمن التقرير ما يلي:

  خاصية العميل	الوصف
  ipAddress	عنوان IP للعميل.
  botDetectedLast	الطابع الزمني لأحدث طلب من العميل.
  ipIsp	مزوّد خدمة الإنترنت للعميل الذي يقدم الطلبات.
  ipCountry	البلد الذي نشأت منه الطلبات من العميل.
  botReason	قواعد رصد Apigee Sense التي تتوافق معها الطلبات الواردة من عنوان IP هذا.
  callCount	عدد الطلبات الواردة من عنوان IP هذا.
  topUrl	عنوان URL الأكثر شيوعًا الذي يطلبه عنوان IP للعميل. هذه هي واجهة برمجة التطبيقات التي يطلبها العميل.
  ipCity	المدينة التي تم تلقّي الطلب منها

لإعداد الإشعارات:

1. افتح تجربة New Edge.
2. في تجربة New Edge، انقر على القائمة تحليل، ثم انقر على Sense.
3. انقر على قائمة الإعدادات.

4. في صفحة الإعدادات، أدخِل قيمًا لضبط الإشعارات:

   الإعدادات	الوصف
   إشعار	انقر لتفعيل هذا الإشعار أو إيقافه.
   معرّف الموارد المنتظم (URI)	معرّف الموارد المنتظم (URI) الذي تريد أن يستخدمه Apigee Sense عند إرسال الإشعارات. وعادةً ما يكون هذا نظام مراقبة يقبل الردود التلقائية الواردة على الويب. سيتم إرسال التقارير من Apigee Sense إلى معرّف الموارد المنتظم هذا.
   اسم مفتاح واجهة برمجة التطبيقات	اختياريّ. اسم المفتاح الذي يجب أن تستخدمه Apigee Sense عند المصادقة باستخدام نظامك. استخدام مفتاح واجهة برمجة التطبيقات لتحسين مستوى الأمان
   قيمة مفتاح واجهة برمجة التطبيقات	اختياريّ. القيمة الأساسية التي يجب أن تستخدمها Apigee Sense عند المصادقة باستخدام نظامك. استخدام مفتاح واجهة برمجة التطبيقات لتحسين مستوى الأمان
   الحد الأقصى لعدد عناوين IP	يتم تضمين الحد الأقصى لعدد عناوين IP للعملاء (من 1 إلى 300) في التقرير. ستتضمّن ميزة Apigee Sense عناوين IP بترتيب عدد الطلبات المشبوهة، بدءًا من أكبر عدد من الطلبات إلى الأقل ووصولاً إلى عدد عناوين IP التي تحدِّدها هنا.