יצירת פעולות בהתאמה אישית
בקטע יצירת שילוב בהתאמה אישית, יצרתם פעולת פינג לשילוב של Armis. במאמר הזה מוסבר איך ליצור פעולה מותאמת אישית לשילוב של Armis שמעשיר ישויות. ההנחה היא שיש לכם ידע בעבודה עם Python ותכנות מונחה-עצמים. כדי להבין מה נדרש, עיינו במסמכי התיעוד של ה-SDK ובתהליך השילוב בהתאמה אישית, ובדקו את המודולים של ה-SDK.
יצירת פעולה מותאמת אישית
כדי ליצור פעולה מותאמת אישית:
- עוברים אל Automation > IDE; הדף IDE מופיע.
- לוחצים על Create New Item (יצירת פריט חדש) ובוחרים באפשרות Action (פעולה). מזינים שם ובוחרים את השילוב.
- לוחצים על יצירה. סביבת הפיתוח המשולבת (IDE) יוצרת תבנית חדשה עם הערות והסברים על הקוד.
אובייקט הפעולה של Siemplify
כדי לבצע פעולה ב-Siemplify, צריך לבצע את השלבים הבאים:
- צריך ליצור מופע של אובייקט מהמחלקה
SiemplifyAction. - האובייקט צריך להשתמש ב-method
endשל המחלקה כדי להחזיר הודעת פלט וערך תוצאה.
ערכי התוצאות
לכל פעולה יש שם פלט שמייצג את ערך התוצאה שמוחזר על ידי השיטה end של SiemplifyAction. כברירת מחדל, השם הוא is_success, אבל אפשר לשנות אותו בסביבת הפיתוח המשולבת (IDE). אפשר גם להגדיר ערך החזרה שישמש כברירת מחדל במקרה שפעולה נכשלת.
לדוגמה, אם הזמן הקצוב לתפוגה של הפעולה מסתיים אחרי חמש דקות (או שהיא נכשלת מכל סיבה אחרת), הערך של ScriptResult מוגדר כ-Timeout.
ערך התוצאה ב-JSON
אפשר גם להוסיף תוצאת JSON, שמועילה לשינוי ציר הנתונים בפלייבוקים או לניתוח ידני. כדי לעשות את זה, משתמשים ב-method add_result_json במאפיין התוצאה SiemplifyAction או ב-method add_entity_json כדי לצרף תוצאת JSON ישירות לישות.
ייבוא וקבועים
המחלקה `SiemplifyAction` מהמודול `SiemplifyAction` תמיד מיובאת. ייבואים נפוצים אחרים כוללים:
-
output_handlerמ-SiemplifyUtilsלצורך ניפוי באגים. -
add_prefix_to_dict_keysו-convert_dict_to_json_result_dictלטרנספורמציית נתונים. EntityTypesכדי לקבוע את סוג הישות שעליה תתבצע הפעולה.
הפעולה הזו גם עושה שימוש חוזר ב-"ArmisManager" שנוצר בהליך השילוב בהתאמה אישית, ומייבאת את ספריית ה-"json" הרגילה.
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.