שימוש ב-IDE
במאמר הזה מוסבר על מצב הייצור של סביבת הפיתוח המשולבת (IDE). סביבת הפיתוח המשולבת (IDE) היא מסגרת לצפייה בקוד, לעריכה שלו ולבדיקה שלו. אתם יכולים לראות את הקוד של שילובים מסחריים וליצור שילובים בהתאמה אישית מאפס או על ידי שכפול של קוד השילובים המסחריים.
ב-IDE אתם יכולים לנהל, לייבא ולייצא שילובים בהתאמה אישית.
פותחים את ה-IDE.
כדי לפתוח את ה-IDE:
- כדי לפתוח את ה-IDE, בתפריט הראשי עוברים אל אוטומציה > IDE. אם אתם משתמשים בפלטפורמה של SOAR בלבד, עוברים אל Response > IDE. הדף IDE נפתח.
בדף IDE אפשר לגשת לאפשרויות הבאות:
| אפשרות | תיאור |
|---|---|
| סוגי שילובים | בוחרים באפשרות שילובים או סוגים (מחברים, פעולות, משימות, מנהלים). |
| ייצוא ייבוא | לייצא פריטים בודדים או כמה פריטים משילוב. פריטים תלויים נכללים כשמייצאים פריטים בודדים, אבל לא כשמייצאים חבילה מלאה. הקובץ שמיוצא הוא ארכיון ZIP שמכיל קובץ JSON. כשמייבאים, אפשר להוסיף פריטים ספציפיים לשילוב קיים או לייבא חבילה מלאה. בפורמט הייצוא/ייבוא הקודם (V1 – מישור הנתונים מושבת), החבילה חייבת לכלול קובץ integrations.def ואת התיקיות: ActionsDefinitions, ActionsScripts, Dependencies ו-Managers. בפורמט החדש של ייצוא/ייבוא (V2 – מישור נתונים מופעל), תיקיית החבילה חייבת לכלול קובץ metadata.json ויכולה לכלול את התיקיות: actions, connectors, jobs ו-dependencies. חשוב לדעת: אין תמיכה בייצוא של אינטגרציה מסביבה שבה מישור הנתונים מופעל וייבוא שלה לסביבה שבה מישור הנתונים לא מופעל. אפשר לייצא נתונים מסביבה שבה מישור הנתונים לא מופעל לסביבה שבה מישור הנתונים מופעל. |
| לוחצים על המתג הסתרת פריטים לא פעילים/הצגת כל הפריטים כדי להציג או להסתיר פריטים שהושבתו (פעולות, מחברים). | |
| מוסיפים שילוב, מחבר, פעולה, משימה או מנהל חדשים בהתאמה אישית. |
הוספת מחבר
כדי להוסיף מחבר, פועלים לפי השלבים הבאים:
- לוחצים על Create New Item ובוחרים באפשרות Connector.
- מזינים שם ואת השילוב הנדרש.
- לוחצים על יצירה.
- מוסיפים את פרטי השילוב.
- מוסיפים את הפרמטרים הנדרשים.
- לוחצים על המתג מחבר כדי להפעיל את המחבר.
- כשמסיימים, לוחצים על שמירה או על
Ctrl + S.
בכרטיסייה פרטים אפשר לבחור מבין האפשרויות הבאות:
| אפשרות | תיאור |
|---|---|
| מחיקה | האפשרות הזו זמינה רק לפריטים בשילובים בהתאמה אישית. |
| Play | מפעילה את שיטת הבדיקה של הסקריפט. התוצאות מופיעות בכרטיסייה בדיקה, והפלט של ניפוי הבאגים מופיע בקטע פלט של ניפוי באגים. |
| file_json ניהול קובץ JSON לדוגמה | בתיבת הדו-שיח לייבוא או לייצוא של קובץ JSON לדוגמה, מוודאים שהאפשרות Include JSON Result (הכללת תוצאת JSON) מופעלת. אחר כך אפשר לייבא או לייצא דוגמאות של תוצאות JSON לפעולות. |
| פרטים | מזינים קלט שסופק על ידי המשתמש ופרמטרים אחרים, כמו שם השילוב. |
| ניהול גרסאות | ניהול גרסאות – בוחרים פעולה, משימה או מחבר ולוחצים כדי לראות את האפשרויות הבאות: שמירה כגרסה חדשה: שמירת האובייקט כגרסה חדשה עם הערות אופציונליות. הצגת היסטוריית הגרסאות: אפשר לראות ולשחזר גרסאות קודמות. האפשרות הזו זמינה רק אם נשמרה לפחות גרסה אחת. אפשר ללחוץ על "שחזור" כדי לחזור לכל אחת מהגרסאות הקודמות בכל שלב. האפשרות הזו זמינה רק אם לחצתם בעבר על שמירה כגרסה חדשה בפעולה, במשימה, במחבר או במנהל. |
| פריט כפול | שכפול פריט (משימה, פעולה, מחבר, מנהל). אחרי השמירה, העותק הכפול מופיע ברשימה בלי סמל המנעול נעילה. |
יצירת שילוב בהתאמה אישית
- לוחצים על Create New Item (יצירת פריט חדש) ובוחרים באפשרות Integration (שילוב).
- מזינים שם ולוחצים על יצירה.
-
בוחרים את השילוב שנוצר מהרשימה ומזינים את הפרטים הבאים:
- תיאור: מופיע ב-Content Hub וגלוי לכל משתמשי Google Security Operations.
- סמל SVG: מעלים סמל SVG שמופיע עם השילוב.
- תמונה: מעלים תמונה של Content Hub למשתמשי Google SecOps.
- ספריות: הוספת ספריות Python באמצעות pip.
- יחסי תלות של סקריפטים: מעלים קובצי .WHL, .PY, .TAR או .GZ. הסקריפטים האלה מוסיפים עוד פונקציונליות לשילוב.
- פרמטר: הוספת שדות שניתנים להגדרה עם סוגים מוגדרים, ערכי ברירת מחדל וסטטוס נדרש.
- כשמסיימים, לוחצים על שמירה.
יצירת משימה
כדי ליצור משימה, מבצעים את השלבים הבאים:
- לוחצים על Create New Item ובוחרים באפשרות Job.
- מזינים שם ואת השילוב הנדרש.
- לוחצים על יצירה.
- אופציונלי: מוסיפים פרמטרים לקלט של המשתמש או הסקריפט.
- לוחצים על שמירה או על
Ctrl + S. - לוחצים על arrow_right הפעלת פריט כדי להריץ את הסקריפט.
- עוברים אל Automation > Jobs Scheduler. אם אתם משתמשים בפלטפורמה של SOAR בלבד, עוברים אל Response > Jobs Scheduler.
- לוחצים על add Create New Job ובוחרים את המשימה שיצרתם.
- בקטע Automation > Jobs Scheduler (או Response > Jobs Scheduler בפלטפורמה של SOAR בלבד), בוחרים את הזמן הנדרש להפעלת המשימה (הסקריפט) שיצרתם.
יצירת פעולה חדשה לשימוש בפלייבוק
כדי ליצור פעולה חדשה בפלייבוק, פועלים לפי השלבים הבאים:
- לוחצים על Create New Item (יצירת פריט חדש) ובוחרים באפשרות Action (פעולה).
- מזינים שם ואת השילוב הנדרש > לוחצים על יצירה.
- עורכים את הקוד לפי הצורך.
- מפעילים את האפשרות Include JSON Result (הכללת תוצאת JSON) אם הפעולה צריכה להחזיר תוצאת JSON בפלייבוק.
- אופציונלי: מוסיפים פרמטרים שיוצגו כשדות להזנת קלט.
- מפעילים את הפעולה ולוחצים על שמירה.
- בקטע Polling Configuration, אפשר להגדיר זמן קצוב לתפוגה וערך החזרה שיוחזר כברירת מחדל אם הזמן הקצוב לתפוגה של הפעולה יסתיים. אפשר גם להגדיר ערך ברירת מחדל שיוחזר אם הפעולה לא תושלם בפרק הזמן שהוגדר.
הפעולה זמינה עכשיו לשימוש ב-Playbook > Actions.
יצירת מנהל בהתאמה אישית
כדי ליצור מנהל בהתאמה אישית, פועלים לפי השלבים הבאים:
- לוחצים על יצירת פריט חדש ובוחרים באפשרות מנהל. מזינים שם ואת השילוב הנדרש.
- לוחצים על יצירה.
- עורכים את הקוד לפי הצורך.
- לוחצים על Save.
אבטחת קוד בהתאמה אישית ב-IDE
כדי להבטיח סביבה מאובטחת להרצת קוד, כל קוד Python מותאם אישית ב-IDE פועל בסביבת ארגז חול (sandbox). הסביבה הזו מבודדת מהשרת הראשי ופועלת עם משתמש בעל הרשאות נמוכות. הגישה למערכת ההפעלה הבסיסית מוגבלת אך ורק לרשימת היתרים של פקודות וספריות שאינן ניהוליות, שנדרשות למשימות שילוב ואוטומציה אופייניות. הגישה הזו של ארגז חול מאפשרת אבטחה חזקה, וגם מספקת את הגמישות להריץ מגוון רחב של קוד Python.הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.