שימוש ב-IDE

נתמך ב:

במסמך הזה מוסבר על מצב הייצור של סביבת פיתוח משולבת (IDE). סביבת הפיתוח המשולבת (IDE) היא מסגרת להצגה, לעריכה ולבדיקה של קוד. אתם יכולים לראות את הקוד של שילובים מסחריים וליצור שילובים מותאמים אישית מאפס או על ידי שכפול קוד של שילובים מסחריים.

ב-IDE אתם יכולים לנהל, לייבא ולייצא שילובים בהתאמה אישית.

פותחים את סביבת הפיתוח המשולבת (IDE).

כדי לפתוח את סביבת הפיתוח המשולבת:

  • כדי לפתוח את ה-IDE, בתפריט הראשי לוחצים על Response > IDE. הדף IDE נפתח.

בדף IDE אפשר לגשת לאפשרויות הבאות:

אפשרות תיאור
סוגי
שילובים		 בוחרים באפשרות Integrations (שילובים) או Types (סוגים) (מחברים, פעולות, משימות, מנהלים).
ייצוא
ייבוא		 ייצוא של פריט אחד או יותר משילוב. פריטים שתלויים בפריטים אחרים נכללים בייצוא של פריטים בודדים, אבל לא בייצוא של חבילה מלאה.
הקובץ המיוצא הוא ארכיון ZIP שמכיל קובץ JSON. במהלך הייבוא, אתם יכולים להוסיף פריטים ספציפיים לשילוב קיים או לייבא חבילה מלאה. בפורמט הייצוא/ייבוא מדור קודם (גרסה 1 – שכבת הנתונים מושבתת), החבילה צריכה לכלול קובץ integrations.def ואת התיקיות: ActionsDefinitions,‏ ActionsScripts,‏ Dependencies ו-Managers. בפורמט החדש (גרסה 2 – הפעלת מישור הנתונים) לייצוא ולייבוא, תיקיית החבילה חייבת לכלול קובץ metadata.json, ויכולה לכלול את התיקיות: actions, ‏ connectors, ‏ jobs ו-dependencies.
שימו לב: לא ניתן לייצא שילוב מסביבה שמישור הנתונים מופעל בה ולייבא אותו לסביבה שמישור הנתונים לא מופעל בה. הכיוון השני (ייצוא מסביבה שבה מישור הנתונים לא מופעל לסביבה שבה מישור הנתונים מופעל) נתמך.
לוחצים על המתג הסתרת פריטים לא פעילים/הצגת כל הפריטים כדי להציג או להסתיר פריטים שהושבתו (פעולות, מחברים).
מוסיפים שילוב, מחבר, פעולה, משימה או מנהל חדשים בהתאמה אישית.

הוספת מחבר

כדי להוסיף מחבר:

  1. לוחצים על Create New Item (יצירת פריט חדש) ובוחרים באפשרות Connector (מחבר).
  2. מזינים שם ואת השילוב הנדרש.
  3. לוחצים על יצירה.
  4. מוסיפים את פרטי השילוב.
  5. מוסיפים את הפרמטרים הנדרשים.
  6. לוחצים על המתג Connector (מחבר) כדי להפעיל את המחבר.
  7. בסיום, לוחצים על שמירה או על מקש Ctrl + S.

בכרטיסייה פרטים יש את האפשרויות הבאות:

אפשרות תיאור
מחיקה האפשרות זמינה רק לפריטים בשילובים בהתאמה אישית.
Play מריץ את שיטת הבדיקה של הסקריפט. התוצאות מופיעות בכרטיסייה בדיקה, והפלט של ניפוי הבאגים מופיע בקטע פלט של ניפוי באגים.
file_json ניהול דוגמה של JSON בתיבת הדו-שיח של ייבוא/ייצוא של קובץ JSON לדוגמה, מוודאים שהאפשרות Include JSON Result (הכללת תוצאת JSON) מופעלת. אחר כך תוכלו לייבא או לייצא דוגמאות של תוצאות JSON לפעולות.
פרטיםמזינים קלט שסופק על ידי המשתמש ופרמטרים אחרים, כמו שם השילוב.
ניהול גרסאות ניהול גרסאות – בוחרים פעולה, משימה או מחבר ולוחצים כדי לראות את האפשרויות הבאות: שמירה כגרסה חדשה: שמירת האובייקט כגרסה חדשה עם הערות אופציונליות. צפייה בהיסטוריית הגרסאות: צפייה בגרסאות קודמות ושחזור שלהן. האפשרות הזו זמינה רק אם נשמרה לפחות גרסה אחת. אפשר ללחוץ על "שחזור" כדי לחזור לכל אחת מהגרסאות הקודמות בכל שלב. האפשרות הזו זמינה רק אם לחצתם בעבר על Save as New Version בפעולה, בעבודה, במחבר או במנהל.
פריט כפול שכפול פריט (משימה, פעולה, מחבר, מנהל). אחרי השמירה, העותק הכפול מופיע ברשימה בלי סמל המנעול.

יצירת שילוב בהתאמה אישית

  1. לוחצים על יצירת פריט חדש ובוחרים באפשרות שילוב.
  2. מזינים שם ולוחצים על יצירה.
  3. בוחרים את השילוב שנוצר מהרשימה ומזינים את הפרטים הבאים:
    • תיאור: מופיע ב-Content Hub וגלוי לכל משתמשי Google Security Operations.
    • סמל SVG: העלאת סמל SVG שמופיע עם השילוב.
    • תמונה: מעלים תמונה ל-Content Hub עבור משתמשי Google SecOps.
    • ספריות: מוסיפים ספריות Python באמצעות pip.
    • תלות בסקריפט: מעלים קבצים מסוג ‎.WHL,‏ ‎.PY,‏ ‎.TAR או ‎.GZ. הסקריפטים האלה מוסיפים עוד פונקציונליות לשילוב.
    • פרמטר: מוסיפים שדות שאפשר להגדיר עם סוגים מוגדרים, ערכי ברירת מחדל וסטטוס חובה.
  4. בסיום, לוחצים על שמירה.

יצירת משימה

כדי ליצור משרה, מבצעים את השלבים הבאים:

  1. לוחצים על יצירת פריט חדש ובוחרים באפשרות משרה.
  2. מזינים שם ואת השילוב הנדרש.
  3. לוחצים על יצירה.
  4. אופציונלי: מוסיפים פרמטרים לקלט של משתמש או סקריפט.
  5. לוחצים על שמירה או על מקש Ctrl + S.
  6. לוחצים על arrow_right Play Item כדי להריץ את הסקריפט.
  7. עוברים אל תגובה > מתזמן המשימות.
  8. לוחצים על add Create New Job (הוספה) ובוחרים את המשימה שיצרתם.
  9. בקטע Response >Jobs Scheduler (תגובה > תזמון משימות), בוחרים את השעה שבה רוצים להריץ את המשימה (הסקריפט) שיצרתם.

יצירת פעולה חדשה לשימוש ב-Playbook

כדי ליצור פעולה חדשה ל-Playbook, פועלים לפי השלבים הבאים:

  1. לוחצים על יצירת פריט חדש ובוחרים באפשרות פעולה.
  2. מזינים שם ואת השילוב הנדרש > לוחצים על יצירה.
  3. עורכים את הקוד לפי הצורך.
  4. מפעילים את האפשרות Include JSON Result (הכללת תוצאת JSON) אם הפעולה צריכה להחזיר תוצאת JSON ב-playbook.
  5. אופציונלי: מוסיפים פרמטרים להצגה כשדות להזנת קלט.
  6. מפעילים את הפעולה ולוחצים על שמירה.
  7. בקטע Polling Configuration (הגדרת בדיקת סטטוס), אפשר להגדיר זמן קצוב לתפוגה וערך ברירת מחדל להחזרה אם הפעולה נכשלת בגלל חריגה מהזמן הקצוב. אפשר גם להגדיר ערך ברירת מחדל שיוחזר אם הפעולה לא תושלם בפרק הזמן שהוגדר.

הפעולה זמינה עכשיו לשימוש בPlaybook > Actions.

יצירת חשבון ניהול בהתאמה אישית

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

  1. לוחצים על יצירת פריט חדש ובוחרים באפשרות חשבון ניהול. מזינים שם ואת השילוב הנדרש.
  2. לוחצים על יצירה.
  3. עורכים את הקוד לפי הצורך.
  4. לוחצים על Save.

אבטחת קוד בהתאמה אישית ב-IDE

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

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