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

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

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

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

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

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

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

  ویژگی مشتری	توضیحات
  آدرس آی‌پی	آدرس IP کلاینت.
  botDetectedLast	مهر زمانی آخرین درخواست از طرف کلاینت.
  آی‌پی‌آی‌اس‌پی	ارائه دهنده خدمات اینترنتی (ISP) کلاینتی که درخواست‌ها را ارسال می‌کند.
  کشور آی‌پی	کشوری که درخواست‌های مشتری از آنجا ارسال شده است.
  دلیل بات	قوانین تشخیص Apigee Sense که درخواست‌های ارسالی از این آدرس IP با آنها مطابقت دارند.
  callCount	تعداد درخواست‌ها از این آدرس IP.
  آدرس بالا	رایج‌ترین آدرس اینترنتی (URL) درخواست شده توسط IP کلاینت. این API درخواست شده توسط کلاینت است.
  آی‌پی‌سیتی	شهری که درخواست از آن دریافت شده است.

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

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

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

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