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

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

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

باستخدام معرّف الموارد المنتظم لنقطة اتصال الويب، سترسل 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، انقر على قائمة تحليل، ثمّ انقر على الاستشعار.
3. انقر على قائمة الإعدادات.

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

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