دریافت اعلان‌ها از Sense

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

می‌توانید Apigee Sense را پیکربندی کنید تا با فهرستی از درخواست‌های API شناسایی‌شده که ممکن است ناخواسته باشند، به شما اطلاع دهد. هنگامی که اعلان‌ها را تنظیم کردید، Apigee Sense هر 5 دقیقه یک گزارش به یک URI webhook که شما مشخص کرده‌اید ارسال می‌کند.

با استفاده از وب هوک 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"
            }
        ]
    }
}

این گزارش اطلاعات زیر را در مورد حملات ناخواسته احتمالی به API های شما جمع آوری می کند:

• سازمان و محیط Apigee که در آن درخواست های گزارش شده جمع آوری شده است.
• مهر زمانی گزارش
• شناسه پیام گزارش
• تعداد آدرس‌های IP درخواست‌هایی که ممکن است ناخواسته باشند.

• آرایه ای از داده های مشتری برای آدرس های IP که درخواست های ناخواسته بالقوه (مانند ربات ها) را ایجاد می کنند. برای هر مشتری، گزارش شامل:

  ویژگی مشتری	توضیحات
  آدرس IP	آدرس IP مشتری
  botDetectedLast	مهر زمانی آخرین درخواست مشتری.
  ipIsp	ISP مشتری درخواست کننده
  ipCountry	کشوری که درخواست‌های مشتری از آنجا شروع شده است.
  botReason	قوانین تشخیص Apigee Sense که درخواست‌های این آدرس IP مطابقت دارند.
  شمارش تماس	تعداد درخواست ها از این آدرس IP.
  topUrl	رایج ترین URL درخواست شده توسط IP مشتری. این API درخواستی مشتری است.
  ipCity	شهری که درخواست از آن دریافت شده است.

برای تنظیم اعلان ها

1. تجربه New Edge را باز کنید.
2. در تجربه New Edge، روی منوی Analyze کلیک کنید، سپس روی Sense کلیک کنید.
3. روی منوی تنظیمات کلیک کنید.

4. در صفحه تنظیمات ، مقادیری را برای پیکربندی اعلان‌ها وارد کنید:

   تنظیم	توضیحات
   اطلاع رسانی	برای فعال یا غیرفعال کردن این اعلان کلیک کنید.
   URI	URI که می‌خواهید Apigee Sense هنگام ارسال اعلان‌ها از آن استفاده کند. این معمولاً یک سیستم نظارتی است که وب هوک های دریافتی را می پذیرد. گزارش‌های Apigee Sense به این URI ارسال می‌شود.
   نام کلید API	اختیاری. نام کلید Apigee Sense باید هنگام احراز هویت با سیستم شما استفاده شود. از یک کلید API برای بهبود امنیت استفاده کنید.
   مقدار کلید API	اختیاری. مقدار کلیدی Apigee Sense باید هنگام احراز هویت با سیستم شما استفاده کند. از یک کلید API برای بهبود امنیت استفاده کنید.
   حداکثر تعداد IP	حداکثر تعداد (از 1 تا 300) آدرس IP مشتری برای درج در گزارش. Apigee Sense آدرس‌های IP را به ترتیب تعداد درخواست‌های مشکوک، از بیشترین تعداد درخواست‌ها تا کمترین، تا تعداد IP‌هایی که در اینجا مشخص می‌کنید، شامل می‌شود.