קבלת התראות מ-Sense

אתם צופים במסמכי התיעוד של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

אתם יכולים להגדיר את Apigee Sense כך שיודיע לכם על רשימה של בקשות API שזוהו ועשויות להיות לא רצויות. אחרי שמגדירים התראות, מערכת Apigee Sense שולחת דוח כל 5 דקות לכתובת URI של webhook שציינתם.

באמצעות מזהה ה-URI של ה-webhook, 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 ששולחות בקשות שעשויות להיות לא רצויות (כמו בוטים). לגבי כל לקוח, הדוח כולל את הפרטים הבאים:

  מאפיין לקוח	תיאור
  ipAddress	כתובת ה-IP של הלקוח.
  botDetectedLast	חותמת הזמן של הבקשה האחרונה מהלקוח.
  ipIsp	ספק האינטרנט של הלקוח ששולח את הבקשות.
  ipCountry	המדינה שממנה הגיעו הבקשות מהלקוח.
  botReason	כללי הזיהוי של Apigee Sense שאליהם נשלחו בקשות מכתובת ה-IP הזו.
  callCount	מספר הבקשות מכתובת ה-IP הזו.
  topUrl	כתובת ה-URL הנפוצה ביותר שהתקבלה מה-IP של הלקוח. זהו ממשק ה-API שהלקוח ביקש.
  ipCity	העיר שממנה התקבלה הבקשה.

כדי להגדיר התראות:

1. פותחים את החוויה החדשה של Edge.
2. בממשק החדש של Edge, לוחצים על התפריט ניתוח ואז על חישה.
3. לוחצים על התפריט הגדרות.

4. בדף Settings, מזינים ערכים כדי להגדיר את ההתראות:

   הגדרה	תיאור
   התראה	לוחצים כדי להפעיל או להשבית את ההתראה הזו.
   URI	ה-URI שבו רוצים ש-Apigee Sense ישתמש כששולחים התראות. בדרך כלל מדובר במערכת ניטור שמקבלת אירועי webhook נכנסים. דוחות מ-Apigee Sense יישלחו לכתובת ה-URI הזו.
   שם מפתח ה-API	אופציונלי. שם המפתח ש-Apigee Sense צריך להשתמש בו כשמבצעים אימות מול המערכת. שימוש במפתח API כדי לשפר את האבטחה.
   הערך של מפתח ה-API	אופציונלי. ערך המפתח ש-Apigee Sense צריך להשתמש בו כשמבצע אימות מול המערכת שלכם. שימוש במפתח API כדי לשפר את האבטחה.
   מספר כתובות ה-IP המקסימלי	המספר המקסימלי (מ-1 עד 300) של כתובות IP של לקוחות שרוצים לכלול בדוח. Apigee Sense יכלול כתובות IP לפי מספר הבקשות החשודות, מהמספר הגבוה ביותר של בקשות למספר הנמוך ביותר, עד למספר כתובות ה-IP שתציינו כאן.