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

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

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

بااستفاده از نشانی وب‌قلاب، 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 رایج‌ترین نشانی وب درخواست‌شده توسط IP کارخواه. این API درخواستی ازسوی کلاینت است.
    ipCity شهری که درخواست از آن دریافت شده است.

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

  1. تجربه جدید Edge را باز کنید.
  2. در تجربه «Edge جدید»، روی منو تجزیه‌وتحلیل کلیک کنید، سپس روی حس کلیک کنید.
  3. روی منو تنظیمات کلیک کنید.
  4. در صفحه تنظیمات، مقادیر را برای پیکربندی اعلان‌ها وارد کنید:

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