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

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

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