שימוש ב-IDE
במאמר הזה מוסבר על מצב הייצור של סביבת הפיתוח המשולבת (IDE). סביבת הפיתוח המשולבת (IDE) היא מסגרת לצפייה בקוד, לעריכה שלו ולבדיקה שלו. אתם יכולים לראות את הקוד של שילובים מסחריים וליצור שילובים בהתאמה אישית מאפס או על ידי שכפול של קוד השילובים המסחריים.
ב-IDE אתם יכולים לנהל, לייבא ולייצא שילובים בהתאמה אישית.
פותחים את ה-IDE.
כדי לפתוח את ה-IDE:
- כדי לפתוח את ה-IDE, בתפריט הראשי עוברים אל אוטומציה > 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 Play Item כדי להריץ את הסקריפט.
- עוברים אל Automation > Jobs Scheduler.
- לוחצים על addCreate New Job ובוחרים את המשימה שיצרתם.
- בקטע Response >Jobs Scheduler (תגובה > מתזמן המשימות), בוחרים את השעה שבה רוצים להריץ את המשימה (הסקריפט) שיצרתם.
יצירת פעולה חדשה לשימוש בפלייבוק
כדי ליצור פעולה חדשה בפלייבוק, פועלים לפי השלבים הבאים:
- לוחצים על Create New Item (יצירת פריט חדש) ובוחרים באפשרות Action (פעולה).
- מזינים שם ואת השילוב הנדרש > לוחצים על יצירה.
- עורכים את הקוד לפי הצורך.
- מפעילים את האפשרות Include JSON Result (הכללת תוצאת JSON) אם הפעולה צריכה להחזיר תוצאת JSON בפלייבוק.
- אופציונלי: מוסיפים פרמטרים שיוצגו כשדות להזנת קלט.
- מפעילים את הפעולה ולוחצים על שמירה.
- ב-Polling Configuration, אפשר להגדיר זמן קצוב לתפוגה וערך החזרה שיוגדר כברירת מחדל אם הזמן הקצוב לתפוגה של הפעולה יסתיים. אפשר גם להגדיר ערך ברירת מחדל שיוחזר אם הפעולה לא תושלם בפרק הזמן שהוגדר.
הפעולה זמינה עכשיו לשימוש ב-Playbook > Actions.
יצירת מנהל בהתאמה אישית
כדי ליצור מנהל בהתאמה אישית, פועלים לפי השלבים הבאים:
- לוחצים על יצירת פריט חדש ובוחרים באפשרות מנהל. מזינים שם ובוחרים את השילוב הנדרש.
- לוחצים על יצירה.
- עורכים את הקוד לפי הצורך.
- לוחצים על Save.
אבטחת קוד בהתאמה אישית ב-IDE
כדי להבטיח סביבה מאובטחת להרצת קוד, כל קוד Python מותאם אישית ב-IDE פועל בסביבת ארגז חול (sandbox). הסביבה הזו מבודדת מהשרת הראשי ופועלת עם משתמש בעל הרשאות נמוכות. הגישה למערכת ההפעלה הבסיסית מוגבלת אך ורק לרשימת היתרים של פקודות וספריות שאינן ניהוליות, שנדרשות למשימות שילוב ואוטומציה אופייניות. הגישה הזו של ארגז חול מאפשרת אבטחה חזקה, וגם מספקת את הגמישות להריץ מגוון רחב של קוד Python.הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.