שילוב של AlgoSec עם Google SecOps
במאמר הזה מוסבר איך לשלב את AlgoSec עם Google Security Operations.
תרחישים לדוגמה
השילוב של AlgoSec משתמש ביכולות של Google SecOps כדי לתמוך בתרחישים הבאים:
הכלה אוטומטית של איומים: חסימה של כתובות IP זדוניות בחומות אש מנוהלות, על ידי שליחת בקשות אוטומטיות לשינוי תנועה במהלך חקירות אבטחה.
הרשאת תנועה מבוקרת: מאפשרים תנועה עסקית לגיטימית לכתובות IP מאומתות של יעדים, על ידי יצירת כללי הרשאה סטנדרטיים ב-AlgoSec FireFlow.
חיפוש וניהול של תבניות: אחזור תבניות זמינות של בקשות לשינוי ב-FireFlow כדי להתאים את פעולות התגובה האוטומטיות למדיניות ניהול השינויים בארגון.
מעקב אסינכרוני אחרי מחזור החיים של השינויים: מעקב אחרי בקשות לשינוי תנועה שנשלחו עד שהן מגיעות לסטטוסים תפעוליים כמו "נפתרה" או "הוטמעה".
לפני שמתחילים
לפני שמגדירים את השילוב של AlgoSec ב-Google SecOps, צריך לוודא שהסביבה עומדת בדרישות הבאות:
קישוריות לרשת: ודאו ש-Google SecOps (או נציג מרוחק שנפרס לסביבות מקומיות) יכול להגיע לשרת AlgoSec דרך HTTPS ביציאת TCP
443.FireFlow templates: מפעילים לפחות תבנית אחת של בקשה לשינוי תנועה (כמו
Standard) ב-AlgoSec FireFlow לפני שמריצים פעולות ששולחות בקשות לשינוי.הרשאות משתמש מינימליות: מגדירים חשבון שירות ייעודי ל-AlgoSec FireFlow עם ההרשאות המינימליות שנדרשות לפעולות שבהן משתמשים בפלייבוקים, כמו שמפורט בטבלה הבאה:
| פעולה | הרשאות נדרשות ב-AlgoSec FireFlow |
|---|---|
Allow IP |
אימות באמצעות FireFlow, יצירת בקשות לשינוי תנועה עבור כללי הרשאה וקריאת פרטי בקשות לשינוי תנועה. |
Block IP |
אימות באמצעות FireFlow, יצירת בקשות לשינוי תנועה עבור כללי השמטה וקריאת פרטים של בקשות לשינוי תנועה. |
List Templates |
מאמתים באמצעות FireFlow וצופים בתבניות הזמינות לבקשות שינוי. |
Ping |
מאמתים באמצעות FireFlow וצופים בתבניות הזמינות של בקשות לשינוי כדי לאמת את הקישוריות. |
Wait for Change Request Status Update |
אימות באמצעות FireFlow וקריאת הפרטים של בקשות לשינוי תנועה וסטטוסים של מחזור חיים. |
למידע נוסף על הגדרת תפקידים, חשבונות משתמשים ותבניות של בקשות לשינוי ב-FireFlow, עיינו במסמכי התיעוד הרשמיים של AlgoSec FireFlow.
פרמטרים של שילוב
כדי לשלב את AlgoSec, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה. כתובת ה-URL הבסיסית של שרת AlgoSec, בפורמט |
Username |
חובה. שם המשתמש של חשבון AlgoSec FireFlow שמשמש לאימות. |
Password |
חובה. הסיסמה של חשבון AlgoSec FireFlow שמשמש לאימות. |
Verify SSL |
חובה. אם בוחרים באפשרות הזו, האינטגרציה מאמתת את אישור ה-SSL כשמתחברים לשרת AlgoSec. מופעלת כברירת מחדל. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של שילוב, אפשר להשתמש בו בפלייבוקים. למידע נוסף על הגדרה ותמיכה במספר מופעים, ראו תמיכה במספר מופעים.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה של פעולה ידנית בבקשה.
כתובת IP מותרת
משתמשים בפעולה Allow IP כדי לשלוח בקשה לשינוי תעבורת הנתונים ב-AlgoSec FireFlow, שמאפשרת תעבורת נתונים לישויות IP Address של הבקשה (שמשמשות ככתובות היעד).
הפעולה הזו פועלת בישות IP Address של Google SecOps.
קלט של הפעולה
הפעולה אישור כתובת IP דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Template |
חובה. השם של תבנית AlgoSec FireFlow שבה רוצים להשתמש לבקשה לשינוי התנועה. ערך ברירת המחדל הוא |
Source |
חובה. רשימה מופרדת בפסיקים של כתובות IP או אובייקטים ברשת של המקורות לכלל ההרשאה, או מילת המפתח ערך ברירת המחדל הוא |
Service |
חובה. רשימה מופרדת בפסיקים של שירותי רשת שמותרים, בפורמט של זוגות של פרוטוקול ויציאה כמו ערך ברירת המחדל הוא |
Subject |
זה שינוי אופציונלי. שורת נושא לבקשה לשינוי תנועה ב-AlgoSec FireFlow. ערך ברירת המחדל הוא |
Owner |
זה שינוי אופציונלי. שם המשתמש או המזהה של המשתמש שהגיש את בקשת השינוי. אם לא תספקו ערך, AlgoSec תקצה את המשתמש המאומת שיצר את הכרטיס כבעלים. |
Due Date |
זה שינוי אופציונלי. תאריך ושעה להשלמת בקשת השינוי, בפורמט ISO 8601, למשל |
Expiration Date |
זה שינוי אופציונלי. תאריך ושעת התפוגה של הכלל שמאפשר תנועה, בפורמט ISO 8601, למשל |
Custom Fields |
זה שינוי אופציונלי. שדות נוספים של בקשות לשינוי ב-FireFlow שסופקו כצמדי מפתח/ערך, כמו אם הפרמטר הזה צוין, הוא מבטל את הפרמטרים |
ערכי פלט של פעולות
הפעולה Allow IP מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של מארז | לא זמין |
| קישור לקיר של התיק | יש גישה |
| שולחן קונסולה | לא זמין |
| טבלת העשרת ישויות | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
קישור לקיר של התיק
הפעולה אישור כתובת IP מספקת את הקישור הבא ב-Case Wall:
שם הקישור:
Change Request LinkLink target: פותח את הבקשה שנוצרה לשינוי תנועה בממשק האינטרנט של AlgoSec FireFlow.
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Allow IP:
{
"status": "Success",
"messages": [],
"data": {
"id": 10,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:31:23"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
הודעות פלט
הפעולה Allow IP מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully created a traffic change request to allow traffic
to the provided entities in AlgoSec |
הפעולה בוצעה בהצלחה. |
Error executing action AlgoSec - Allow IP. Reason:
ERROR_REASON |
הפעולה נכשלה. מוודאים שכתובת ה-URL ופרטי הכניסה של שרת AlgoSec תקינים, מוודאים ששם התבנית שצוין קיים ב-FireFlow, מעצבים את הפרמטרים של התאריך בפורמט ISO 8601 ומעצבים את השדות בהתאמה אישית כצמדי מפתח/ערך תקינים. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Allow IP:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
חסימת כתובת IP
משתמשים בפעולה Block IP כדי לשלוח בקשה לשינוי תנועה ב-AlgoSec FireFlow שחוסמת תנועה לישויות IP Address של האירוע (שמשמשות ככתובות היעד).
הפעולה הזו פועלת בישות IP Address של Google SecOps.
קלט של הפעולה
הפעולה Block IP דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Template |
חובה. השם של תבנית AlgoSec FireFlow שבה רוצים להשתמש לבקשה לשינוי התנועה. ערך ברירת המחדל הוא |
Source |
חובה. רשימה מופרדת בפסיקים של כתובות IP או אובייקטים ברשת של המקורות לכלל החסימה, או מילת המפתח ערך ברירת המחדל הוא |
Service |
חובה. רשימה מופרדת בפסיקים של שירותי רשת שצריך לחסום, בפורמט של זוגות של פרוטוקול ויציאה כמו ערך ברירת המחדל הוא |
Subject |
זה שינוי אופציונלי. שורת נושא לבקשה לשינוי תנועה ב-AlgoSec FireFlow. ערך ברירת המחדל הוא |
Owner |
זה שינוי אופציונלי. שם המשתמש או המזהה של המשתמש שהגיש את בקשת השינוי. אם לא מציינים את הפרמטר הזה, AlgoSec מקצה את המשתמש המאומת שיצר את הכרטיס כבעלים. |
Due Date |
זה שינוי אופציונלי. תאריך ושעה להשלמת בקשת השינוי, בפורמט ISO 8601, למשל |
Expiration Date |
זה שינוי אופציונלי. תאריך ושעת התפוגה של הכלל לחסימת תנועה בפורמט ISO 8601, למשל |
Custom Fields |
זה שינוי אופציונלי. שדות נוספים של בקשות לשינוי ב-FireFlow שסופקו כצמדי מפתח/ערך, כמו אם הפרמטר הזה צוין, הוא מבטל את הפרמטרים |
ערכי פלט של פעולות
הפעולה חסימת כתובת IP מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של מארז | לא זמין |
| קישור לקיר של התיק | יש גישה |
| שולחן קונסולה | לא זמין |
| טבלת העשרת ישויות | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
קישור לקיר של התיק
הפעולה חסימת כתובת IP מספקת את הקישור הבא ב-Case Wall:
שם הקישור:
Change Request LinkLink target: פותח את הבקשה שנוצרה לשינוי תנועה בממשק האינטרנט של AlgoSec FireFlow.
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Block IP:
{
"status": "Success",
"messages": [],
"data": {
"id": 11,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:35:10"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
]
}
}
הודעות פלט
הפעולה חסימת כתובת IP מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully created a traffic change request to block traffic
to the provided entities in AlgoSec |
הפעולה בוצעה בהצלחה. |
Error executing action AlgoSec - Block IP. Reason:
ERROR_REASON |
הפעולה נכשלה. מוודאים שכתובת ה-URL ופרטי הכניסה של שרת AlgoSec תקינים, מוודאים ששם התבנית שצוין קיים ב-FireFlow, מעצבים את הפרמטרים של התאריך בפורמט ISO 8601 ומעצבים את השדות בהתאמה אישית כצמדי מפתח/ערך תקינים. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה Block IP:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
רשימת תבניות
משתמשים בפעולה List Templates כדי לאחזר תבניות זמינות של בקשות לשינוי שהוגדרו ב-AlgoSec FireFlow. אתם יכולים לסנן תבניות לפי שם כדי לזהות את שם התבנית המדויק שנדרש כשמבצעים אוטומציה של בקשות לשינוי תנועה.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה List Templates דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Filter Logic |
זה שינוי אופציונלי. לוגיקת ההתאמה שמופעלת כשמסננים שמות של תבניות באמצעות הפרמטר הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Filter Value |
זה שינוי אופציונלי. שם התבנית או מחרוזת המשנה (תלוי אותיות רישיות) שמשמשים לסינון התבניות הזמינות על סמך ה- אם לא מציינים ערך מסנן, הפעולה מחזירה את כל התבניות עד למגבלה שהוגדרה. |
Max Templates To Return |
זה שינוי אופציונלי. המספר המקסימלי של תבניות שיוחזרו. ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה List Templates מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של מארז | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קונסולה | יש גישה |
| טבלת העשרת ישויות | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קונסולה
הפעולה List Templates מציגה את הטבלה הבאה ב-Case Wall:
שם הטבלה:
Available Templatesעמודות:
NameDescriptionType
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Templates:
[
{
"id": 142,
"name": "110: Multi-Approval Request",
"description": "Create a traffic change request which requires multiple approvals",
"type": "Traffic Change",
"enabled": true
},
{
"id": 597,
"name": "190: Verbatim Rule Addition",
"description": "Create a traffic change request for bulk rules addition as specified",
"type": "Traffic Change",
"enabled": true
},
{
"id": 550,
"name": "Basic Change Traffic Request",
"description": "Create a basic change traffic request",
"type": "Traffic Change",
"enabled": true
}
]
הודעות פלט
הפעולה List Templates מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully found templates for the provided criteria in
AlgoSec. |
הפעולה בוצעה בהצלחה. |
No templates were found for the provided criteria in
AlgoSec. |
הפעולה נכשלה. מוודאים שהתבניות קיימות ב-AlgoSec FireFlow ובודקים את האיות ואת השימוש באותיות רישיות בפרמטר |
Error executing action AlgoSec - List Templates. Reason:
ERROR_REASON |
הפעולה נכשלה. מוודאים שהפרמטרים של החיבור לשרת AlgoSec תקינים, ושהערך של |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה List Templates:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
פינג
משתמשים בפעולה Ping כדי לבדוק את הקישוריות והאימות לשרת AlgoSec באמצעות פרמטרי השילוב שהוגדרו.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
הפעולה פינג מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של מארז | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קונסולה | לא זמין |
| טבלת העשרת ישויות | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה פינג מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully connected to the AlgoSec server with the provided
connection parameters! |
הפעולה בוצעה בהצלחה. |
Failed to connect to the AlgoSec server! Error is
ERROR_REASON |
הפעולה נכשלה. מוודאים שאפשר להגיע לכתובת ה-URL של |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה פינג:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
המתנה לעדכון הסטטוס של בקשת השינוי
משתמשים בפעולה Wait for Change Request Status Update כדי לעקוב אחרי בקשה לשינוי תנועה ב-AlgoSec FireFlow עד שהיא מגיעה לסטטוס היעד.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
כדי להשתמש בפעולה Wait for Change Request Status Update, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Request ID |
חובה. המזהה המספרי של הבקשה לשינוי תנועה ב-AlgoSec שרוצים לעקוב אחריה. |
Status |
חובה. רשימה מופרדת בפסיקים של סטטוסים של מחזור חיים, שאם הם תואמים, הפעולה תושלם. הפעולה מתעלמת משמות סטטוסים לא חוקיים אם ציינתם לפחות סטטוס חוקי אחד. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה Wait for Change Request Status Update מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של מארז | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קונסולה | לא זמין |
| טבלת העשרת ישויות | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Wait for Change Request Status Update:
{
"status": "Success",
"messages": [],
"data": {
"id": 6,
"subChangeRequests": [
12
],
"fields": [
{
"name": "Risk Level",
"values": [
"No Risk"
]
},
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 13:50:58"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
},
{
"name": "Form Type",
"values": [
"Traffic Change"
]
},
{
"name": "Risks Number",
"values": [
"0"
]
},
{
"name": "Initial Plan status",
"values": [
"Result OK"
]
},
{
"name": "Workflow",
"values": [
"Basic"
]
},
{
"name": "Subject",
"values": [
"1"
]
},
{
"name": "status",
"values": [
"resolved"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
הודעות פלט
הפעולה Wait for Change Request Status Update מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Status of the change request with ID
REQUEST_ID was updated to status:
STATUS. |
הפעולה בוצעה בהצלחה. |
Waiting for a change request to be updated... |
הפעולה עדיין פועלת ודוגמת את AlgoSec FireFlow עד שהבקשה לשינוי מגיעה לאחד מהסטטוסים של היעד. |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason: action ran into a timeout during execution. Current status
of the change request: STATUS.
Please increase the timeout for the action in the IDE. |
הפעולה נכשלה. מגדילים את זמן הקצוב לתפוגה של הפעולה ב-Google SecOps IDE או מוודאים שהבקשה לשינוי מתקדמת בתהליך העבודה לאישור ב-AlgoSec FireFlow. |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason:
ERROR_REASON |
הפעולה נכשלה. מוודאים שהערך של |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Wait for Change Request Status Update:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.