📘 תיעוד 122

תחילת העבודה

צור Schema Profile שנלמד עבור פעולה אחת. לאחר מכן בדוק את הזיהויים שלו לפני הגדרת mitigation.

הערה

לקוחות עם API Security כבר מקבלים גישה אל Schema Profiles דרך Schema Learning ו Schema Validation. Cloudflare פותחת בטא סגורה ללקוחות Enterprise מוזמנים בלי API Security. לקוחות מעוניינים יכולים לפנות לצוות החשבון שלהם כדי להביע עניין. גישה לבטא סגורה אינה מרמזת על זמינות עתידית של מסלול או על תמחור.

#בדיקת דרישות הלמידה

Cloudflare לומדת פרופילים מדי שבוע מתעבורה מתאימה במהלך שבעת הימים הקודמים. רק בקשות שקיבלו תשובת 2xx מתאימות.

פעולה זקוקה ל 1,000 בקשות מתאימות לסף הלמידה של שדות. היא זקוקה ל 10,000 בקשות מתאימות לסף הלמידה של גבולות.

אחרי עמידה בסף הלמידה של שדות, Cloudflare יכולה ללמוד שדות בקשה. אחרי עמידה בסף הלמידה של גבולות, Cloudflare יכולה ללמוד אילוצים כגון טווחים מספריים ואורכי מחרוזות.

עם למידה מתוזמנת, הפרופיל הראשון מופיע אחרי ההרצה השבועית הבאה. זה יכול לקחת עד שבעה ימים אחרי עמידה בסף הרלוונטי. אפשר גם לבקש הרצת schema learning אד הוק עבור כל האזור.

#לימוד ובדיקה של פרופיל

1. בלוח הבקרה של Cloudflare, עבור אל Web Assets > Operations. מעבר אל Web assets ↗
2. בחר פעולה שהתגלתה או הוסף אחת ידנית. פעולה משתמשת בשיטת HTTP, בתבנית hostname ובתבנית path.
3. מתפריט האפשרויות הנוספות של הפעולה, בחר Learn profile. גילוי ויצירה ידנית אינם מתחילים profiling.
4. אפשר ל Cloudflare לאסוף מספיק תעבורה מתאימה.
5. מתפריט האפשרויות הנוספות של הפעולה, בחר View details. בדוק את הסכמה שנלמדה תחת Security overview.
6. ב Security > Analytics, פתח את Profile Analysis. בדוק סדרות זמן של בקשות להתאמה לפרופיל ולהפרות. מעבר אל Analytics ↗
7. העמק ביומנים שנדגמו כדי לבדוק את סיבות ההפרה.
8. אחרי בדיקה של תעבורת ייצור מייצגת, צור Custom Rule.
9. הגבל את הכלל ל hostname, ל path או לפעולה המיועדים. לאחר מכן בחר פעולת mitigation.

אחרי שהפרופיל הופך לזמין, Cloudflare מריצה always-on detection. היא אינה ממתנת בקשות בלי Custom Rule.

אם לא מופיעה סכמה שנלמדה, אשר שבחרת Learn profile. ייתכן ש Cloudflare עדיין אוספת מספיק תעבורה מתאימה.

לפרטי למידה ולמגבלות, עיין ב Schema Profiles.

#שימוש בסכמה שהועלתה

אם יש לך סכמת OpenAPI, העלה אותה דרך Schema validation. סכמות שהועלו מייצרות זיהויים דרך cf.schema_validation.uploaded.violated.

הפניה של API Shield מכסה פורמטי העלאה, דרישות OpenAPI, הגדרת API, הגדרת Terraform ומגבלות.