📘 תיעוד 129

מושגי Bulk Redirects

הפניות מרובות (Bulk Redirects) כוללות את הרכיבים הבאים:

• הפניית URL: רשומה עם כתובת מקור, כתובת יעד, קוד סטטוס ופרמטרי הפניה. הפניות URL הן הפריטים הבודדים ברשימות Bulk Redirect.
• רשימת Bulk Redirect: אוסף בעל שם שמכיל הפניית URL אחת או יותר. כדי להפעיל את כל הפניות ה-URL ברשימת Bulk Redirect, יש להפנות לרשימה בכלל Bulk Redirect. כללי Bulk Redirect שונים יכולים להפנות לאותה רשימת Bulk Redirect.
• כלל Bulk Redirect: כלל שמופעל על ידי Ruleset Engine, המערכת ש-Cloudflare משתמשת בה כדי להעריך ולבצע כללים. לכלל Bulk Redirect יש רשימת Bulk Redirect משויכת.

כלל Bulk Redirect מפעיל רשימת Bulk Redirect, שמכילה הפניית URL אחת או יותר.

הדוגמה הבאה מגדירה רשימת Bulk Redirect בשם list_b עם שתי הפניות URL:

רשימת Bulk Redirect בשם list_b

כלל Bulk Redirect הבא, בשם Rule 2, מפעיל את הפניות ה-URL ברשימת Bulk Redirect בשם list_b:

כלל Bulk Redirect בשם Rule 2

• שם הכלל: Rule 2
• רשימה משויכת: list_b

#הפניות URL

הפניית URL מאפשרת להגדיר כתובת מקור, כתובת יעד, קוד סטטוס ופרמטרי הפניה.

כשמציינים את כתובת המקור, יש להשתמש בפרמטרי ההפניה הזמינים במקום בתווים כלליים (wildcards), שאינם נתמכים. לדוגמה, הפרמטר Include subdomains מאפשר להגדיר הפניית URL אחת שחלה גם על תת-דומיינים (לדוגמה, https://b.example.com ו-https://a.b.example.com) וגם על דומיין ה-apex (דומיין השורש בלי תת-דומיין, לדוגמה https://example.com). פרמטרים אחרים מאפשרים לציין איך מטפלים בנתיב ובמחרוזת השאילתה של כתובת המקור. למידע נוסף, ראו איך Bulk Redirects עובדים.

הפניות URL הן פריטי הרשימה של רשימות Bulk Redirect.

#רשימות Bulk Redirect

רשימות Bulk Redirect מאפשרות ליצור קבוצות נפרדות של הפניות URL למטרות שונות. אפשר להשתמש ברשימת Bulk Redirect בכלל Bulk Redirect אחד או יותר.

רשימת Bulk Redirect אינה מבצעת הפניות בעצמה. כדי להפעיל את ההפניות ברשימה, חובה להפנות לרשימה בכלל Bulk Redirect.

רשימת Bulk Redirect אינה יכולה להכיל כמה הפניות URL עם אותה כתובת מקור בדיוק.

לפרטים על פורמט ה-CSV לייבוא פריטים לרשימת Bulk Redirect, ראו פורמט קובץ CSV עבור Bulk Redirects.

הערה

אפשר להפנות לרשימות Bulk Redirect רק בכללי Bulk Redirect. סוגים אחרים של כללים שמופעלים על ידי Ruleset Engine אינם תומכים ברשימות Bulk Redirect.

#כללי Bulk Redirect

כללי Bulk Redirect הם כללים שמופעלים על ידי Ruleset Engine ומפעילים הפניית URL אחת או יותר דרך רשימת Bulk Redirect.

כשמגדירים כלל Bulk Redirect, משייכים אליו רשימת Bulk Redirect, וכך מופעלות כל הפניות ה-URL ברשימה הזו. אפשר ליצור כלל לכל רשימה, או שיהיו כללי Bulk Redirect רבים שמפנים לאותה רשימת Bulk Redirect.

לכלל Bulk Redirect, כמו לכל הכללים שמופעלים על ידי Ruleset Engine, יש פעולה (מה קורה כשהכלל מופעל) וביטוי (התנאים שצריכים להתקיים). מלבד שתי התכונות האלה, יש לו גם שם, תיאור אופציונלי, רשימת Bulk Redirect משויכת ומפתח.

#ביטוי

ביטוי הכלל, או ביטוי הסינון, מציין את התנאים שצריכים להתקיים כדי שהכלל ירוץ. כברירת מחדל, כל הפניות ה-URL של הרשימה שצוינה יחולו.

ביטוי ברירת המחדל של כלל Bulk Redirect הוא:

http.request.full_uri in $<LIST_NAME>

הביטוי הזה אומר שכתובת ה-URL של הבקשה, אחרי נרמול בסיסי (אם נרמול URL מופעל), צריכה להתאים לכתובת המקור של הפניית URL ברשימה <LIST_NAME> כדי שההפניה תוחל.

אפשר להשתמש בביטוי שונה מביטוי ברירת המחדל כדי להגדיל את הספציפיות של התאמות הפניית URL. לדוגמה, אם מגדירים את הביטוי של כלל Bulk Redirect לביטוי הבא, תהיה התאמה רק לבקשות שמגיעות מהממלכה המאוחדת:

ip.src.country == "GB" and http.request.full_uri in $<LIST_NAME>

למידע נוסף על השדות הזמינים, ראו שדות ופונקציות זמינים.

הערה

משמאל לאופרטור in אפשר להשתמש רק בשדות באופן ישיר, ולא בערכים שמוחזרים מפונקציה. ברוב המצבים כדאי להשתמש באחד מהשדות הבאים עם האופרטור in:

• http.request.full_uri
• raw.http.request.full_uri

ראו את הפניית השדות למידע נוסף.

#מפתח

מפתח הכלל מציין באיזה שדה בקשה Cloudflare משתמשת כדי לחפש הפניית URL תואמת ברשימת Bulk Redirect המשויכת.

כשיש התאמה לביטוי הכלל, Cloudflare משווה את הערך של מפתח הכלל לכתובת המקור של כל הפניית URL ברשימת Bulk Redirect המשויכת, ומחפשת התאמה.

המפתח צריך להיות http.request.full_uri או raw.http.request.full_uri. השתמשו ב-raw.http.request.full_uri כדי להשוות את ה-URI שהתקבל בשרת האינטרנט, לפני נרמול, לכתובות המקור ברשימת Bulk Redirect.

שדה ה-URI שבשימוש במפתח חייב להיות זהה לשדה ה-URI שבשימוש בביטוי. אחרת, ייתכן שתהיה התאמה לביטוי הכלל, אבל לא תהיה התאמה לאף אחת מכתובות המקור ברשימה. לדוגמה, אם מגדירים את המפתח ל-http.request.full_uri, השדה שבשימוש בביטוי הכלל חייב להיות גם http.request.full_uri. אם מגדירים את המפתח ל-raw.http.request.full_uri, השדה שבשימוש בביטוי חייב להיות raw.http.request.full_uri.