שילוב של AWS WAF עם Google SecOps

במאמר הזה מוסבר איך לשלב את AWS WAF עם Google Security Operations ‏ (Google SecOps).

תרחישים לדוגמה

השילוב של AWS WAF עוזר לאבטח את אפליקציות האינטרנט שלכם, ומאפשר לכם:

  • חסימת כתובות IP באופן אוטומטי: הוספה אוטומטית של כתובות IP זדוניות שזוהו על ידי Google SecOps לקבוצות של כתובות IP ב-AWS WAF, כדי לחסום תנועה בקצה הרשת.
  • ניהול רשימות של בקרת גישה (ACL): יצירה ועדכון של רשימות ACL לאינטרנט באופן דינמי כדי להגיב לאיומים חדשים.
  • ניהול אבטחה גלובלית ואזורית: ניהול כללים של משאבים אזוריים (כמו מאזני עומסים של אפליקציות) ומשאבים גלובליים (Amazon CloudFront) מממשק אחד.

פרמטרים של שילוב

כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה מפתח הגישה של AWS String לא רלוונטי כן מזהה מפתח הגישה ל-AWS שבו משתמשים בשילוב.
מפתח סודי של AWS סיסמה לא רלוונטי כן מפתח סודי של AWS לשימוש בשילוב.
אזור ברירת המחדל של AWS String לא רלוונטי כן אזור ברירת המחדל של AWS לשימוש בשילוב, לדוגמה us-west-2.

ההיקף Regional ב-AWS WAF תואם לאזור שמוגדר כאן. ההיקף של CloudFront הוא גלובלי ולא תלוי באזור הזה, אבל המשאבים שנוצרו ב-Regional מוגבלים לערך הזה.

כדי לנהל משאבי AWS WAF בכמה אזורי AWS, צריך להגדיר מופע שילוב נפרד לכל אזור.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

פינג

בודקים את הקישוריות ל-AWS WAF.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם החיבור הצליח: "החיבור לשרת AWS WAF בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם התגובה נכשלה: "Failed to connect to the AWS WAF server!‎ השגיאה היא {0}".format(exception.stacktrace)

כללי

יצירת קבוצת כתובות IP

יוצרים קבוצת כתובות IP ב-AWS WAF, על סמך ישויות.

קבוצת כתובות ה-IP נוצרת בפורמט הבא:

Siemplify_NAME_IP Type`

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם String לא רלוונטי כן מציינים את השם של קבוצת כתובות ה-IP. הערה: הפעולה תיצור קבוצת כתובות IP בפורמט הבא: Siemplify_{Name}_{IP Type}. השם צריך להכיל 1-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף ליצירת קבוצות של כתובות IP. אם בוחרים באפשרות "Both" (שניהם), הפעולה תיצור קבוצת כתובות IP בהיקפים Regional ו-Amazon CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

תיאור String לא רלוונטי לא מציינים את התיאור של קבוצת כתובות ה-IP.
תגים CSV לא רלוונטי לא צריך לציין תגים נוספים שרוצים להוסיף לקבוצת כתובות ה-IP. פורמט: key_1:value_1,key_2:value_1.

ריצה

הפעולה הזו פועלת על הישות "כתובת IP".

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
"Regional": ["IPv4_set", "IPv6_set"]
"Cloudfront":  ["IPv4_set", "IPv6_set"]
}
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה ולפחות אחת מהישויות שסופקו שימשה ליצירת קבוצת כתובות IP ‏ (is_success = true): "Successfully created {0} {1} IP Set '{2}' in AWS WAF with the following IPs: \n {3}".format("Regional"/"Cloudfront", "IPv4"/"IPv6", full_name, entity.identifier list)

אם לא הצלחתם להשתמש בישויות ספציפיות(is_success = true): "Action was not able to use the following IPs in order to create AWS WAF IP Set\n: {0}".format([entity.identifier])‎

אם לא הצלחתם להשתמש בכל הישויות (is_success = false): "לא נוצרו קבוצות של כתובות IP. הסיבה: אף אחת מישויות ה-IP שסופקו לא הייתה תקינה".

אם כל הקבוצות כבר קיימות (is_success=false) או אם רק חלק מהקבוצות כבר קיימות (is_success=true): "The following {0} IP Pattern Sets '{1}' already exist: \n.".format("Regional/CloudFront", list_of_full_names)

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או בעיה אחרת: "שגיאה בביצוע הפעולה 'יצירת קבוצת כתובות IP'. הסיבה: {0}''.format(error.Stacktrace)

הוספת כתובת IP לקבוצת כתובות IP

מוסיפים כתובות IP לקבוצת כתובות ה-IP ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות IP CSV לא רלוונטי כן מציינים את הרשימה המופרדת בפסיקים של שמות קבוצות ה-IP. דוגמה: name_1,name_2
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של קבוצת כתובות ה-IP. אם בוחרים באפשרות "שניהם", הפעולה תוסיף כתובות IP לקבוצות של כתובות IP בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

ריצה

הפעולה הזו פועלת על הישות "כתובת IP".

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה וכתובת IP אחת לפחות נוספה לקבוצת כתובות IP אחת(is_success = true): "Successfully added the following IPs to the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

אם לא הצלחתם להוסיף ישויות ספציפיות לאחת מקבוצות כתובות ה-IP‏(is_success = true): "Action was not able to add the following IPs to the {0} IP Set '{1}' in AWS WAF\n: {2}".format("Regional"/"Cloudfront", full_name,[entity.identifier])

אם לא נמצאה אחת מקבוצות כתובות ה-IP‏ (is_success = true): "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

אם לא נמצאו כל קבוצות ה-IP שצוינו בהיקף או בהיקפים שנבחרו (is_success=false): "הפעולה לא מצאה את קבוצות ה-IP שצוינו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "הוספת כתובת IP לקבוצת כתובות IP". הסיבה: {0}''.format(error.Stacktrace)

כללי

יצירת קבוצת תבניות של ביטויים רגולריים

יוצרים קבוצת תבניות של ביטויים רגולריים ב-AWS WAF על סמך ישויות.

כל קבוצה של תבניות ביטויים רגולריים יכולה להכיל רק 10 תבניות, ויכולות להיות רק 10 קבוצות של תבניות ביטויים רגולריים בסך הכול.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם String לא רלוונטי כן מציינים את השם של קבוצת התבניות של הביטויים הרגולריים. הערה: השם צריך להיות באורך של 1-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף ליצירת קבוצות של תבניות ביטויים רגולריים. אם בוחרים באפשרות "שניהם", הפעולה יוצרת קבוצת תבניות של ביטויים רגולריים בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

תיאור String לא רלוונטי לא מציינים את התיאור של קבוצת התבניות של הביטויים הרגולריים.
תגים CSV לא רלוונטי לא צריך לציין תגים נוספים שרוצים להוסיף לקבוצת התבניות של הביטויים הרגולריים. פורמט: key_1:value_1,key_2:value_1.
תבנית דומיין תיבת סימון סימן אישור לא אם האפשרות מופעלת, הפעולה מאחזרת את החלק של הדומיין מכתובות ה-URL ויוצרת תבנית של ביטוי רגולרי על סמך כתובות ה-URL האלה. לדוגמה, http://test.com/folder מומר ל-^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity).
תבנית IP תיבת סימון סימן אישור לא אם הפעולה מופעלת, היא יוצרת תבנית ביטוי רגולרי תקינה מכתובת ה-IP במקום להשתמש בערך הגולמי, למשל 10.0.0.1 מומרת ל-^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity).

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • כתובת URL

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
"Regional": "Regex_set"
"Cloudfront": "Regex_set"
}
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה ולפחות אחת מהישויות שסופקו שימשה ליצירת קבוצה של ביטויים רגולריים (is_success = true): "Successfully created {0} Regex Pattern Set '{1}' in AWS WAF with the following entities: \n {2}".format("Regional"/"Cloudfront", name, entity.identifier list)

אם משתמשים ביותר מ-10 ישויות כדי ליצור קבוצת תבניות של ביטויים רגולריים: "לא ניתן היה ליצור קבוצות של תבניות של ביטויים רגולריים עם כל הישויות שצוינו, כי חרגת מהמגבלה. המערכת דילגה על הישויות הבאות: {0}".format(entity.identifier)

אם קבוצת הכללים כבר קיימת (is_success=false): "{0} Regex Pattern Set '{1}' already exists.".format("Regional/CloudFront", name)

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "יצירת קבוצת דפוסי ביטויים רגולריים". הסיבה: {0}''.format(error.Stacktrace)

כללי

יצירת רשימות ACL לאינטרנט

יוצרים רשימת ACL לאינטרנט ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם String לא רלוונטי כן מציינים את השם של רשימת ה-ACL באינטרנט. הערה: השם צריך להכיל בין 1 ל-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
סוג מקור הכלל DDL

קבוצת כתובות IP

ערך אפשרי

קבוצת כתובות IP

קבוצת כללים

כן מציינים באיזה סוג כלל להשתמש.
שם מקור הכלל String לא רלוונטי כן צריך לציין את שם המקור שבו רוצים להשתמש לרשימת בקרת הגישה (ACL) לאינטרנט. אם "סוג מקור הכלל" הוא "קבוצת כתובות IP", הפעולה תחפש קבוצות של כתובות IP עם השם הזה. אם "סוג מקור הכלל" הוא "קבוצת כללים", הפעולה תחפש קבוצות כללים עם השם הזה.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף ליצירת רשימת ה-ACL לאינטרנט. אם בוחרים באפשרות "Both", הפעולה תיצור רשימת ACL לאינטרנט בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

הפעלת בקשות שנדגמו תיבת סימון התיבה לא מסומנת כן אם המדיניות מופעלת, AWS WAF יאחסן דגימה של הבקשות לאחזור מהרשת שתואמות לכללים.
הפעלת מדדי CloudWatch תיבת סימון התיבה לא מסומנת כן אם האפשרות הזו מופעלת, המשאב המשויך שולח מדדים ל-CloudWatch.
שם המדד ב-CloudWatch תיבת סימון התיבה לא מסומנת כן מציינים את השם של המדד ב-CloudWatch. הערה: השם צריך להכיל בין 1 ל-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
פעולת ברירת המחדל DDL

אישור

ערכים אפשריים:

  • אישור
  • חסימה
כן מציינים את פעולת ברירת המחדל לבקשות שלא תואמות לאף כלל.
פעולה של קבוצת כתובות IP DDL

חסימה

ערך אפשרי:

  • אישור
  • חסימה
  • ספירה
לא מציינים את הפעולה לכללים שמבוססים על קבוצת כתובות ה-IP.
עדיפות הכלל מספר שלם לא רלוונטי כן מציינים את העדיפות של הכלל. העדיפויות ברשימת ה-ACL של האינטרנט צריכות להיות ייחודיות.
תיאור String לא רלוונטי לא מציינים את התיאור של רשימת ה-ACL לאינטרנט.
תגים CSV לא רלוונטי לא צריך לציין את התגים הנוספים שרוצים להוסיף ל-Web ACL. פורמט: key_1:value_1,key_2:value_1.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
"Regional": "Web_Acl_name"
"Cloudfront": "Web_Acl_name"
}
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Both": "Successfully created Web ACL {0} in Regional and CloudFront scopes.".format(name)

אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Regional": "Successfully created Web ACL {0} in Regional.".format(name)

אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Cloudfront": "Successfully created Web ACL {0} in Cloudfront scope.".format(name)

אם רשימת ה-ACL לאינטרנט קיימת:

מדפיסים את ההודעה "The Web ACL {} already exists in {} scope.".format(web ACL name, scope).

אם לא נמצאה קבוצת כללים או קבוצת כתובות IP: "הפעולה לא הצליחה ליצור רשימת ACL לאינטרנט. סיבה: {0} {1} לא נמצא ב-AWS WAF".format("IP Set/Rule Group", Rule Source Name)

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה 'יצירת רשימת בקרת גישה (ACL) לאינטרנט'. הסיבה: {0}''.format(error.Stacktrace)

הוספת כלל ל-ACL של האינטרנט

מוסיפים כלל שמבוסס על קבוצות של כתובות IP או קבוצות של כללים לרשימת ה-ACL של האינטרנט ב-AWS WAF. רשימת ה-ACL של האינטרנט יכולה להכיל עד 1,500 כללים.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של רשימות ACL לאינטרנט CSV לא רלוונטי כן

מציינים את הרשימה המופרדת בפסיקים של שמות רשימות ה-ACL לאינטרנט. דוגמה: name_1,name_2

סוג מקור הכלל DDL

קבוצת כתובות IP

ערכים אפשריים:

  • קבוצת כתובות IP
  • קבוצת כללים
כן מציינים באיזה סוג כלל להשתמש.
שם מקור הכלל String לא רלוונטי כן צריך לציין את שם המקור שבו רוצים להשתמש לרשימת בקרת הגישה (ACL) לאינטרנט. אם "סוג מקור הכלל" הוא "קבוצת כתובות IP", הפעולה תחפש קבוצות של כתובות IP עם השם הזה. אם "סוג מקור הכלל" הוא "קבוצת כללים", הפעולה תחפש קבוצות כללים עם השם הזה.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של הכללים החדשים. אם בוחרים באפשרות "שניהם", הפעולה תוסיף כלל ל-Web ACL בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

עדיפות הכלל מספר שלם לא רלוונטי כן מציינים את העדיפות של הכלל. העדיפויות ברשימת ה-ACL של האינטרנט צריכות להיות ייחודיות.
פעולה של קבוצת כתובות IP DDL

חסימה

ערך אפשרי:

  • אישור
  • חסימה
  • ספירה
לא מציינים את הפעולה לכללים שמבוססים על קבוצת כתובות ה-IP.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה ונוסף לפחות כלל אחד לרשימת ACL אחת לאינטרנט(is_success = true): "Successfully added a rule to the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of name)

אם לא נמצאה אחת מרשימות ה-Web ACL‏(is_success = true): "Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Web ACLs that were not found in that scope)

אם כבר קיים כלל עם שם לכל רשימת ACL לאינטרנט בהיקף (is_success=true): "הפעולה לא הצליחה להוסיף {0} כללים לרשימת ה-ACL לאינטרנט ב-AWS WAF. הסיבה: {0} עם השם "{1}" כבר קיים ברשימות ה-ACL הבאות לאינטרנט:\n{2}".format( rule source type, rule source name, list Web ACL with scope - structure {0} - {1}.format(scope, web acl name))

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה חמורה, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "הוספת כלל ל-Web ACL". הסיבה: {0}''.format(error.Stacktrace)

כללי

יצירת קבוצת כללים

יוצרים קבוצת כללים ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם String לא רלוונטי כן מציינים את השם של קבוצת הכללים. הערה: השם צריך להכיל בין 1 ל-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של קבוצת הכללים שרוצים ליצור. אם בוחרים באפשרות "שניהם", הפעולה תיצור קבוצת כללים בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

קיבולת מספר שלם 100 כן מציינים את הקיבולת של קבוצת הכללים. הערה: אי אפשר לשנות את הקיבולת אחרי שיוצרים את הקבוצה. המספר המקסימלי הוא 1,500.
הפעלת בקשות שנדגמו תיבת סימון התיבה לא מסומנת כן אם המדיניות מופעלת, AWS WAF יאחסן דגימה של הבקשות לאחזור מהרשת שתואמות לכללים.
הפעלת מדדי CloudWatch תיבת סימון התיבה לא מסומנת כן אם האפשרות הזו מופעלת, המשאב המשויך שולח מדדים ל-CloudWatch.
שם המדד ב-CloudWatch תיבת סימון התיבה לא מסומנת כן מציינים את השם של המדד ב-CloudWatch. הערה: השם צריך להכיל בין 1 ל-128 תווים. תווים תקינים: A-Z,‏ a-z,‏ 0-9, - (מקף) ו- _ (קו תחתון).
תיאור String לא רלוונטי לא מציינים את התיאור של קבוצת הכללים.
תגים CSV לא רלוונטי לא צריך לציין את התגים הנוספים שרוצים להוסיף לקבוצת הכללים. פורמט: key_1:value_1,key_2:value_1.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Both": "Successfully created Rule Group {0} in Regional and CloudFront scopes.".format(name)

>אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Regional": "The Rule Group {} already exists in {} scope.".format(web ACL name, scope).

אם קבוצות ה-IP הזמינות מופיעות ברשימה(is_success = true) ו-"Scope" == "Cloudfront": "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

אם קבוצת הכללים קיימת: "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

אם יצירת קבוצת הכללים נכשלת, תופיע ההודעה "Action was not able to create Rule Group {} in {} scope".format(web ACL name, scope).

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "יצירת קבוצת כללים". הסיבה: {0}''.format(error.Stacktrace)

כללי

הוספת ישות לקבוצת תבניות של ביטויים רגולריים (regex)

מוסיפים תבניות של מחרוזות שמבוססות על ישויות לקבוצת התבניות של הביטויים הרגולריים ב-AWS WAF.

כל קבוצה של תבניות ביטויים רגולריים יכולה להכיל רק 10 תבניות.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות דפוסים של ביטויים רגולריים (regex) CSV לא רלוונטי כן מציינים את רשימת השמות של קבוצות התבניות של הביטויים הרגולריים, מופרדים בפסיקים, למשל name_1,name_2.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן היקף קבוצת התבניות של הביטוי הרגולרי. אם בוחרים באפשרות "שניהם", הפעולה מוסיפה תבניות שמבוססות על ישויות לקבוצות של תבניות ביטויים רגולריים גם בהיקף Regional וגם בהיקף CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

תבנית דומיין תיבת סימון סימן אישור לא אם הפעולה מופעלת, היא מאחזרת את החלק של הדומיין מכתובות ה-URL ויוצרת תבנית של ביטוי רגולרי על סמך הדומיינים האלה. לדוגמה, http://test.com/folder מומר ל-^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity).
תבנית IP תיבת סימון סימן אישור

לא

אם הפעולה מופעלת, היא יוצרת תבנית ביטוי רגולרי תקינה מכתובת ה-IP במקום להשתמש בערך הגולמי, למשל 10.0.0.1 מומרת ל-^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity).

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • כתובת URL

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה ולפחות ישות אחת נוספה לקבוצה אחת של תבניות ביטויים רגולריים(is_success = true): "Successfully added the following entity patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of entity patterns)

אם יותר מ-10 ישויות ישמשו ליצירת קבוצת תבניות של ביטויים רגולריים: "הפעולה לא הצליחה להוסיף תבניות לקבוצת התבניות של הביטויים הרגולריים {0} של {1} על סמך כל הישויות שסופקו, כי חרגת מהמגבלה. המערכת דילגה על הישויות הבאות: {2}".forma("Regional"/"Cloudfront", name, entity.identifier)

אם לא נמצאה אחת מהקבוצות (is_success = true): "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope)

אם לא נמצאו כל הקבוצות שצוינו בהיקף או בהיקפים שנבחרו (is_success=false): "הפעולה לא מצאה את קבוצות התבניות של הביטויים הרגולריים שצוינו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "הוספת ישות לקבוצת תבניות של ביטויים רגולריים". הסיבה: {0}''.format(error.Stacktrace)

כללי

הוספת תבנית לקבוצת תבניות של ביטויים רגולריים (regex)

מוסיפים תבניות של מחרוזות לקבוצת התבניות של הביטויים הרגולריים ב-AWS WAF.

כל קבוצה של תבניות ביטויים רגולריים יכולה להכיל רק 10 תבניות.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות דפוסים של ביטויים רגולריים (regex) CSV לא רלוונטי כן מציינים את רשימת השמות של קבוצות התבניות של הביטויים הרגולריים, מופרדים בפסיקים, למשל name_1,name_2.
דפוסים CSV לא רלוונטי כן מציינים את רשימת התבניות שמופרדות בפסיקים שרוצים להוסיף לקבוצת התבניות של הביטויים הרגולריים, כמו pattern_1,pattern_2.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן היקף קבוצת התבניות של הביטוי הרגולרי. אם בוחרים באפשרות "שניהם", הפעולה מוסיפה תבניות שמבוססות על ישויות לקבוצות של תבניות ביטויים רגולריים גם בהיקף Regional וגם בהיקף CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה ולפחות תבנית אחת נוספה לקבוצה אחת של תבניות ביטויים רגולריים(is_success = true):"Successfully added the following patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of patterns)

אם לא נמצאה אחת מהקבוצות (is_success = true):t "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope).

אם לא נמצאו כל הקבוצות שצוינו בהיקף או בהיקפים שנבחרו (is_success=false): "הפעולה לא מצאה את קבוצות התבניות של הביטויים הרגולריים שצוינו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "הוספת תבנית לקבוצת תבניות של ביטויים רגולריים". הסיבה: {0}''.format(error.Stacktrace)

כללי

הסרת כלל מ-Web ACL

הסרת כלל מ-Web ACL ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של רשימות ACL לאינטרנט CSV כן

מציינים את הרשימה המופרדת בפסיקים של שמות רשימות ה-ACL לאינטרנט. דוגמה: name_1,name_2

היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של הסרת רשימת ה-ACL של האתר. אם בוחרים באפשרות "Both" (שניהם), הפעולה תסיר רשימת בקרת גישה לאינטרנט בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

שם הכלל String

לא רלוונטי

כן מציינים את שם הכלל שרוצים למחוק.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה וכלל אחד לפחות הוסר מקבוצת כללים אחת: מדפיסים את ההודעה "Successfully removed a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

אם הפעולה נכשלה בקבוצת כללים אחת: מדפיסים את ההודעה "הפעולה לא הצליחה להסיר כלל מרשימות ה-ACL הבאות של {0} באינטרנט '{1}' ב-AWS WAF".format("Regional"/"Cloudfront", list of names)

אם הפעולה נכשלה ברשימת ACL אחת לאינטרנט, כי הכלל לא נמצא ברשימת ACL אחת: מדפיסים את ההודעה "Action wasn't able to find the specified rule in the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names Web ACL)

אם לא נמצאה אחת מקבוצות הכללים: מדפיסים את ההודעה "Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Rule Group that were not found in that scope)

אם לא נמצאו כל הקבוצות שסופקו בהיקף או בהיקפים הרצויים: מדפיסים את ההודעה "הפעולה לא מצאה את רשימות ה-ACL שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: print "Error executing action "Remove Rule From Web ACL". הסיבה: {0}''.format(error.Stacktrace)

כללי

רשימת רשימות ACL לאינטרנט

רשימה של רשימות ה-ACL הזמינות לאינטרנט ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
מציינים את ההיקף של רשימת ה-ACL באינטרנט.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

מספר מקסימלי של רשימות ACL להחזרה מספר שלם 50 לא מציינים כמה רשימות ACL של אינטרנט להחזיר. ברירת המחדל היא 50. המספר המקסימלי הוא 100.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
תוצאת JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
קיר תיקים
סוג התוצאות ערך/תיאור סוג (ישות \ כללי)
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם רשימת קבוצות ה-IP הזמינות הופיעה בהצלחה ו "היקף" == "שניהם": "רשימת רשימות ה-ACL הזמינות לאינטרנט הופיעה בהצלחה בהיקפים של Cloudfront ושל האזור".

אם קבוצות ה-IP הזמינות מופיעות בהצלחה(is_success = true) ו-"Scope" == "Regional": "Successfully listed available Web ACLs in Regional scope."‎

אם קבוצות ה-IP הזמינות מופיעות בהצלחה(is_success = true) ו-"Scope" == "Cloudfront": "Successfully listed available Web ACLs in Cloudfront scope."‎

אם אין ערכים זמינים(is_success = false) ו-"Scope" == "Both": "No available Web ACLs were found in Regional and Cloudfront scopes."‎

אם אין ערכים זמינים (is_success = false) ו-"Scope" == "Regional": "No available Web ACLs were found in Regional scope."‎

אם אין ערכים זמינים(is_success = false) ו-"Scope" == "Cloudfront": "No available Web ACLs were found in Cloudfront scope."

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם יש שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה "רשימת רשימות ACL באינטרנט". הסיבה: {0}''.format(error.Stacktrace)

כללי

שולחן קיר עם ויטרינה

(אם "היקף" == "אזורי" או "שניהם")

שם הטבלה: רשימות ACL של כללים אזוריים

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

שולחן קיר עם ויטרינה

(אם "Scope" == "CloudFront" או "Both")

שם הטבלה: CloudFront Rule ACLs

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

הסרת כלל מקבוצת כללים

מסירים כלל מקבוצת הכללים ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות כללים CSV כן צריך לציין את הרשימה המופרדת בפסיקים של שמות קבוצות הכללים. דוגמה: name_1,name_2
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של הסרת קבוצת הכללים. אם בוחרים באפשרות "שניהם", הפעולה תסיר קבוצת כללים בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

שם הכלל String

לא רלוונטי

כן מציינים את שם הכלל שרוצים למחוק.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה וכלל אחד לפחות הוסר מקבוצת כללים אחת: "Successfully removed a rule from the following {0} Rule Groups '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

אם הפעולה נכשלה בקבוצת כללים אחת: "הפעולה לא הצליחה להסיר כלל מקבוצת הכללים הבאה {0} '{1}' ב-AWS WAF".format("Regional"/"Cloudfront", list of names)

אם הפעולה נכשלה בקבוצת כללים אחת, כי הכלל לא נמצא בקבוצת כללים אחת: "הפעולה לא הצליחה למצוא את הכלל שצוין בקבוצות הכללים הבאות {0} '{1}' ב-AWS WAF".format("Regional"/"Cloudfront", list of rule group names)

אם לא נמצאה אחת מקבוצות הכללים: "Action wasn't able to find the following '{0}' Rule Groups in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Rule Group that were not found in that scope)

אם לא נמצאו כל הקבוצות שצוינו בהיקף או בהיקפים הרצויים: "הפעולה לא מצאה את קבוצות הכללים שצוינו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בביצוע הפעולה "הסרת כלל מקבוצת כללים". הסיבה: {0}''.format(error.Stacktrace)

כללי

רשימת קבוצות של כללים

רשימת קבוצות הכללים שזמינות ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
מציינים את ההיקף של רשימת קבוצות הכללים.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

מספר מקסימלי של קבוצות כללים להחזרה מספר שלם 50 לא מציינים כמה קבוצות של כללים להחזיר. ברירת המחדל היא 50. המספר המקסימלי הוא 100.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
תוצאת JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
קיר תיקים
סוג התוצאות ערך/תיאור סוג (ישות \ כללי)
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-Scope (היקף) == Both (שניהם): "Successfully listed available Rule groups in Regional and Cloudfront scopes" (קבוצות הכללים הזמינות מופיעות ברשימה בהיקפים Regional ו-Cloudfront).

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-"Scope" == "Regional": "Successfully listed available Rule groups in Regional scope."‎

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-"Scope" == "Cloudfront": "Successfully listed available Rule groups in Cloudfront scope.">

אם אין ערכים זמינים ו "היקף" == "שניהם": "לא נמצאו קבוצות כללים זמינות בהיקפים של Regional ו-Cloudfront".

אם אין ערכים זמינים ו "היקף" == "אזורי": "לא נמצאו קבוצות כללים זמינות בהיקף אזורי".

אם אין ערכים זמינים ו-"Scope" == "Cloudfront": "No available Rule groups were found in Cloudfront scope."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "Error executing action "List Rule Groups"‎. הסיבה: {0}''.format(error.Stacktrace)

כללי

טבלת קיר של ארון תצוגה

(אם "היקף" == "אזורי" או "שניהם")

שם הטבלה: קבוצות של כללים אזוריים

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

טבלת קיר של ארון תצוגה

(אם "Scope" == "CloudFront" או "Both")

שם הטבלה: קבוצות של כללים ב-CloudFront

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

הצגת רשימה של קבוצות כתובות IP

רשימת קבוצות ה-IP שזמינות ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
מציינים את ההיקף של רשימת קבוצות כתובות ה-IP.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

מספר מקסימלי של קבוצות IP להחזרה מספר שלם 50 לא מציינים כמה קבוצות של כתובות IP רוצים לקבל. ברירת המחדל היא 50. המספר המקסימלי הוא 100.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
תוצאת JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
קיר תיקים
סוג התוצאות ערך/תיאור סוג (ישות \ כללי)
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-"Scope" == "Both": "Successfully listed available IP sets in Regional and Cloudfront scopes."‎

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-"Scope" == "Regional": "Successfully listed available IP sets in Regional scope."‎

אם קבוצות ה-IP הזמינות מופיעות ברשימה ו-"Scope" == "Cloudfront": "Successfully listed available IP sets in Cloudfront scope."‎

אם אין ערכים זמינים ו-"Scope" == "Both": מדפיסים את ההודעה "No available IP Sets were found in Regional and Cloudfront scopes".

אם אין ערכים זמינים ו-"Scope" == "Regional": "No available IP Sets were found in Regional scope."‎

אם אין ערכים זמינים ו-"Scope" == "Cloudfront": "No available IP Sets were found in Cloudfront scope."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "Error executing action "List IP Sets".‎ הסיבה: {0}''.format(error.Stacktrace)

כללי

טבלת קיר של ארון תצוגה

(אם "היקף" == "אזורי" או "שניהם")

שם הטבלה: קבוצות של כללים אזוריים

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

טבלת קיר של ארון תצוגה

(אם "Scope" == "CloudFront" או "Both")

שם הטבלה: קבוצות של כללים ב-CloudFront

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

הסרת תבנית מקבוצת תבניות של ביטויים רגולריים

מסירים תבניות מקבוצת הביטויים הרגולריים שמוגדרת ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות דפוסים של ביטויים רגולריים (regex) CSV כן מציינים את הרשימה המופרדת בפסיקים של שמות קבוצות הביטויים הרגולריים, כמו name_1,name_2.
דפוסים CSV כן מציינים את רשימה מופרדת בפסיקים של תבניות שצריך להסיר מקבוצת הביטויים הרגולריים, כמו pattern_1,pattern_2.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן היקף הקבוצה. אם בוחרים באפשרות "שניהם", הפעולה מסירה תבניות מקבוצות של ביטויים רגולריים גם בהיקף Regional וגם בהיקף CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה וקבוצת תבניות אחת לפחות הוסרה מקבוצת ביטויים רגולריים אחת: "Successfully removed the following patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

אם התבנית אף פעם לא הייתה קיימת בקבוצת התבניות הזו: "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of patterns)

אם לא הצלחתם להסיר את כל התבניות בכל קבוצות התבניות של הביטויים הרגולריים: "לא הוסרו תבניות מקבוצות התבניות של הביטויים הרגולריים שצוינו".

אם לא נמצאה אחת מקבוצות התבניות: "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of sets that were not found in that scope)

אם לא נמצאו כל קבוצות התבניות של הביטויים הרגולריים שסופקו בהיקף או בהיקפים הרצויים: "הפעולה לא מצאה את קבוצות התבניות של הביטויים הרגולריים שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בביצוע הפעולה 'הסרת תבנית מקבוצת תבניות של ביטויים רגולריים'. הסיבה: {0}''.format(error.Stacktrace)

כללי

הסרת כתובת IP מקבוצת כתובות IP

מסירים כתובות IP מקבוצת כתובות ה-IP ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות IP CSV כן מציינים את הרשימה המופרדת בפסיקים של שמות קבוצות ה-IP. דוגמה: name_1,name_2
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן מציינים את ההיקף של קבוצת כתובות ה-IP. אם בוחרים באפשרות "שניהם", הפעולה תסיר כתובות IP מקבוצות של כתובות IP בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

ריצה

הפעולה הזו פועלת על ישויות IP.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה וכתובת IP אחת לפחות הוסרה מקבוצת כתובות IP אחת: "Successfully removed the following IPs from the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

אם כתובות ה-IP לא היו קיימות בקבוצת כתובות ה-IP הזו: "The following IPs were not a part of the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

אם לא הצלחתם להסיר את כל הישויות בכל קבוצות כתובות ה-IP: "לא הוסרו כתובות IP מקבוצות כתובות ה-IP שצוינו".

אם לא נמצאה אחת מקבוצות ה-IP:P "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

אם לא נמצאו כל קבוצות ה-IP שצוינו בהיקף או בהיקפים הרצויים: "הפעולה לא מצאה את קבוצות ה-IP שצוינו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בביצוע הפעולה "הסרת כתובת IP מקבוצת כתובות IP". הסיבה: {0}''.format(error.Stacktrace)

כללי

הצגת רשימה של קבוצות תבניות של ביטויים רגולריים (regex)

רשימה של קבוצות הביטויים הרגולריים שזמינות ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
מציינים את ההיקף של רשימת קבוצות כתובות ה-IP.
המספר המקסימלי של קבוצות תבניות של ביטויים רגולריים שיוחזרו מספר שלם 5 לא מציינים כמה קבוצות של ביטויים רגולריים להחזיר. ברירת המחדל היא 5. המספר המקסימלי הוא 10.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
תוצאת JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
קיר תיקים
סוג התוצאות ערך/תיאור סוג (ישות \ כללי)
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם קבוצות הביטויים הרגולריים הזמינות מופיעות ברשימה ו-"Scope" == "Both": "Successfully listed available Regex Pattern sets in Regional and Cloudfront scopes."‎

אם הצלחתם להציג את קבוצות כתובות ה-IP הזמינות ו-"Scope" == "Regional": "Successfully listed available Regex Pattern sets in Regional scope."‎

אם הצלחתם להציג את קבוצות כתובות ה-IP הזמינות ו-"Scope" == "Cloudfront": "Successfully listed available Regex Pattern sets in Cloudfront scope."‎

אם אין ערכים זמינים ו-"Scope" == "Both": "No available Regex Pattern sets were found in Regional and Cloudfront scopes."‎

אם אין ערכים זמינים ו "היקף" == "אזורי": "לא נמצאו קבוצות זמינות של תבניות ביטויים רגולריים בהיקף אזורי".

אם אין ערכים זמינים ו-"Scope" == "Cloudfront": "No available Regex Pattern sets were found in Cloudfront scope."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה קריטית, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בביצוע הפעולה "רשימת קבוצות של דפוסי ביטויים רגולריים". הסיבה: {0}''.format(error.Stacktrace)

כללי

טבלת קיר של ארון תצוגה

(אם "היקף" == "אזורי" או "שניהם")

שם הטבלה: קבוצות של כללים אזוריים

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

טבלת קיר של ארון תצוגה

(אם "Scope" == "CloudFront" או "Both")

שם הטבלה: קבוצות של כללים ב-CloudFront

עמודות בטבלה:

  • שם
  • מזהה
  • תיאור
  • טוקן נעילה
  • ARN
כללי

הסרת ישות מקבוצת תבניות של ביטויים רגולריים

מסירים תבניות של מחרוזות שמבוססות על ישויות מקבוצת הביטויים הרגולריים ב-AWS WAF.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שמות של קבוצות דפוסים של ביטויים רגולריים (regex) CSV כן מציינים את הרשימה המופרדת בפסיקים של שמות קבוצות הביטויים הרגולריים, כמו name_1,name_2.
היקף DDL

CloudFront

ערכים אפשריים:

  • CloudFront
  • אזורי
  • שני הסוגים
כן היקף הקבוצה. אם בוחרים באפשרות "שניהם", הפעולה מסירה תבניות שמבוססות על ישויות מקבוצות של ביטויים רגולריים בהיקפים Regional ו-CloudFront.

‫CloudFront הוא היקף גלובלי למשאבים שמשמשים את Amazon CloudFront. ‫Regional מתייחס לאזור הספציפי ב-AWS שמוגדר בפרמטר השילוב AWS Default Region.

תבנית דומיין תיבת סימון True לא

אם הפעולה מופעלת, היא מאחזרת את החלק של הדומיין מכתובות ה-URL ומחפשת ביטוי רגולרי שמבוסס עליהן בקבוצת הביטויים הרגולריים. לדוגמה, http://test.com/folder הופך ל-^(http|https)(:\/\/)(\Qtest.com\E).*.

תבנית IP תיבת סימון True לא אם הפעולה מופעלת, היא מחפשת ביטוי רגולרי מתוך כתובת ה-IP במקום הערך הגולמי, למשל 10.0.0.1 הופך ל-^(http|https)(:\/\/)(\Q10.0.1\E).*.

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • כתובת URL

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך
is_success is_success=False
is_success is_success=True
קיר תיקים
סוג התוצאות ערך/תיאור סוג (ישות \ כללי)
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה הצליחה וישות אחת לפחות הוסרה מקבוצת כתובות IP אחת: "Successfully removed the following entity patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

אם הישות אף פעם לא הייתה קיימת בקבוצת דפוסי הביטויים הרגולריים הזו: "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

אם לא הצלחתם להסיר את כל הישויות בכל קבוצות כתובות ה-IP: "לא הוסרו תבניות מקבוצות התבניות של הביטויים הרגולריים שסופקו".

אם לא נמצאה אחת מקבוצות כתובות ה-IP: "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

אם לא נמצאו כל קבוצות התבניות של הביטויים הרגולריים שסופקו בהיקף או בהיקפים הרצויים: "הפעולה לא מצאה את קבוצות התבניות של הביטויים הרגולריים שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, שגיאת SDK, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בביצוע הפעולה "הסרת ישות מקבוצת תבניות של ביטויים רגולריים". הסיבה: {0}''.format(error.Stacktrace)

כללי

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.