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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يمكنك إعداد 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. افتح تجربة Edge الجديدة.
2. في تجربة New Edge، انقر على قائمة تحليل، ثم انقر على Sense.
3. انقر على قائمة الإعدادات.

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

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