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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

באמצעות ה-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	ISP של הלקוח ששולח בקשות.
  ipCountry	המדינה שממנה הגיעו בקשות מהלקוח.
  botReason	כללי הזיהוי של Apigee Sense עומדים בדרישות של בקשות מכתובת ה-IP הזו.
  callCount	מספר הבקשות מכתובת ה-IP הזו.
  topUrl	כתובת ה-URL הנפוצה ביותר שנשלחה על ידי כתובת ה-IP של הלקוח. זהו ה-API המבוקש על ידי הלקוח.
  ipCity	העיר שממנה התקבלה הבקשה.

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

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

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

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