Trend Micro Cloud App Security

במאמר הזה מוסבר איך לשלב את Trend Micro Cloud App Security עם Google SecOps.

תרחישי שימוש במוצר

ביצוע פעולות אקטיביות – העשרת ישויות, חיפוש אימיילים, עדכון רשימת החסימה, טיפול באימיילים או בחשבונות וכו'.

איך יוצרים אסימון API

  1. עוברים אל Administration > Automation and Integration APIs.
  2. לוחצים על הכפתור "הוספה".
  3. בוחרים באפשרות "לאפליקציה חיצונית".
  4. מזינים "שם" ומסמנים את כל התיבות.
  5. לוחצים על Create Token (יצירת טוקן).
  6. מעתיקים את "האסימון".
  7. מעדכנים את הפרמטר "מפתח API" בהגדרות השילוב.
  8. בודקים את הקישוריות.

הגדרת השילוב של Trend Micro Cloud App Security ב-Google Security Operations

איך מגדירים שילובים ב-Google SecOps

פרמטרים של שילוב

כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
הרמה הבסיסית (root) של ה-API String https://api-eu.tmcas.trendmicro.com כן שורש ה-API של המכונה של Trend Micro Cloud App Security.
מפתח API סיסמה לא רלוונטי כן מפתח ה-API של המכונה של Trend Micro Cloud App Security.
אימות SSL תיבת סימון סימן אישור כן אם המדיניות מופעלת, המערכת מאמתת שאישור ה-SSL לחיבור לשרת Trend Micro Cloud App Security תקף.

פעולות

פינג

תיאור

בודקים את הקישוריות ל-Trend Micro Cloud App Security באמצעות הפרמטרים שמופיעים בדף הגדרת השילוב בדף Google SecOps Content Hub.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים
is_success is_success=False
is_success is_success=True
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

אם החיבור הצליח (is success = true) – החיבור לשרת Trend Micro Cloud App Security בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו.

אם התגובה נכשלה (is success = false) – החיבור לשרת Trend Micro Cloud App Security נכשל. Error: {0}".format(exception.stacktrace)

 כללי

הוספת ישויות לרשימת החסימה

תיאור

הוספת ישויות לרשימת חסימה ב-Trend Micro Cloud App Security. ישויות נתמכות: כתובת URL, גיבוב ואימייל (ישות משתמש שתואמת לתבנית של כתובת אימייל).

פרמטרים

שם ערך ברירת המחדל חובה תיאור
לא רלוונטי לא רלוונטי לא רלוונטי לא רלוונטי

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת URL
  • גיבוב (hash)
  • אימייל

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר נרתיקים
גודל אות הפעולה הצליחה האימות נכשל הודעה
אם הפעולה בוצעה בהצלחה בישות אחת TRUE FALSE הישויות הבאות נוספו לרשימת החסימה ב-Trend Micro Cloud App Security:‏ {\n entity.identifier}
אם התגובה נכשלה לישות אחת TRUE FALSE הפעולה לא הצליחה להוסיף את הישויות הבאות לרשימת החסימה ב-Trend Micro Cloud App Security:‏ {\n entity.identifier}
אם יש כפילויות TRUE FALSE הישויות הבאות כבר נכללות ברשימת החסימה ב-Trend Micro Cloud App Security:‏ {\n entity.identifier}
לא הצליח לכולם FALSE FALSE לא נוספו ישויות באמצעות מידע מ-Trend Micro Cloud App Security
שגיאה חמורה, פרטי כניסה לא תקינים, שורש ה-API FALSE TRUE הייתה שגיאה בביצוע הפעולה "הוספת ישויות לרשימת החסימה". הסיבה: {error traceback}

השבתה זמנית של אותות אכיפה באימיילים

תיאור

למחוק או להעביר להסגר אימיילים באמצעות Trend Micro Cloud App Security. הערה: ב-Gmail אפשר רק למחוק אימיילים.

פרמטרים

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

מחיקה

ערכים אפשריים:

מחיקה

הסגר

 כן מציינים איזו פעולה להפחתת הסיכון צריך לבצע.
שירות

Gmail

ערכים אפשריים

Gmail

Exchange

 כן מציינים את השירות שמשמש לאימיילים.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר נרתיקים
גודל אות הפעולה הצליחה האימות נכשל הודעה
אם הפעולה הצליחה עבור message_id אחד True FALSE האימיילים הבאים טופלו בהצלחה ב-Trend Micro Cloud App Security:‏ {\n unique message ids}
אם התגובה נכשלה עבור message_id אחד True FALSE הפעולה לא הצליחה לצמצם את האימיילים הבאים ב-Trend Micro Cloud App Security:‏ {\n unique message ids}
לא הצליח לכולם FALSE FALSE לא הוסרו אימיילים על ידי Trend Micro Cloud App Security.
שגיאה חמורה, פרטי כניסה לא תקינים, שורש ה-API FALSE TRUE הייתה שגיאה בביצוע הפעולה "הפחתת אימיילים". הסיבה: {error traceback}
אם נבחרה האפשרות "הסגר" והשירות הוא "Gmail" FALSE TRUE הייתה שגיאה בביצוע הפעולה "הפחתת אימיילים". הסיבה: אפשר למחוק אימיילים רק בשירות Gmail.

תיאור

חיפוש אימיילים על סמך ישויות ב-Trend Micro Cloud App Security. ישויות נתמכות: כתובת URL, גיבוב (hash), אימייל (ישות משתמש שתואמת לתבנית של כתובת אימייל), נושא האימייל, שם הקובץ, כתובת IP.

פרמטרים

שם ערך ברירת המחדל חובה תיאור
מספר הימים המקסימלי אחורה 30 לא מציינים כמה ימים אחורה לחפש אימיילים. המספר המקסימלי הוא 90. ברירת המחדל: 30.
מספר האימיילים המקסימלי להחזרה 100 לא מציינים כמה אימיילים להחזיר. ברירת המחדל: 100.

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת URL
  • גיבוב (hash)
  • אימייל
  • נושא האימייל
  • שם קובץ
  • כתובת IP

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
emails=[{list of unique emails}]
קיר נרתיקים
גודל אות הפעולה הצליחה האימות נכשל הודעה
אם יש נתונים: TRUE FALSE הוחזר מידע על אימיילים שקשורים לישויות שצוינו ב-Trend Micro Cloud App Security.
אם אין נתונים זמינים FALSE FALSE לא נמצא מידע על אימיילים שקשורים לישויות ב-Trend Micro Cloud App Security.
שגיאה חמורה, פרטי כניסה לא תקינים, שורש ה-API FALSE TRUE הייתה שגיאה בביצוע הפעולה "חיפוש אימייל של ישות". הסיבה: {error traceback}
אם "מספר הימים המקסימלי לאחור" > 90 FALSE TRUE הייתה שגיאה בביצוע הפעולה "חיפוש אימייל של ישות". הסיבה: הערך של "מספר הימים המקסימלי לאחור" צריך להיות בין 1 ל-90.

העשרת ישויות

תיאור

העשרת ישויות במידע מ-Trend Micro Cloud App Security. ישויות נתמכות: כתובת URL, גיבוב ואימייל (ישות משתמש שתואמת לתבנית של כתובת אימייל).

פרמטרים

שם ערך ברירת המחדל חובה תיאור
לא רלוונטי לא רלוונטי לא רלוונטי לא רלוונטי

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת URL
  • גיבוב (hash)
  • אימייל

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
קיר נרתיקים
גודל אות הפעולה הצליחה האימות נכשל הודעה
אם הפעולה בוצעה בהצלחה בישות אחת TRUE FALSE המידע על הישויות הבאות אוחזר בהצלחה מ-Trend Micro Cloud App Security:‏ {\n entity.identifier}
אם הפעולה נכשלה בישות אחת TRUE FALSE הפעולה לא הצליחה לאחזר מידע על הישויות הבאות מ-Trend Micro Cloud App Security:‏ {\n entity.identifier}
לא הצליח לכולם FALSE FALSE לא הועשרו ישויות באמצעות מידע מ-Trend Micro Cloud App Security
שגיאה חמורה, פרטי כניסה לא תקינים, שורש ה-API FALSE TRUE הייתה שגיאה בביצוע הפעולה "העשרת ישויות". הסיבה: {error traceback}

השבתה זמנית של אותות אכיפה בחשבונות

תיאור

מבצעים פעולות להפחתת הסיכון בחשבון המשתמש באמצעות Trend Micro Cloud App Security.

פרמטרים

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

השבתת החשבון

הפעלת אימות רב-שלבי (MFA)

איפוס הסיסמה

ביטול סשנים של כניסה לחשבון

 כן צריך לציין איזו פעולה להפחתת הסיכון צריך לבצע.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר נרתיקים
גודל אות הפעולה הצליחה האימות נכשל הודעה
אם הפעולה הצליחה עבור כתובת אימייל אחת. TRUE FALSE החשבונות הבאים טופלו בהצלחה ב-Trend Micro Cloud App Security:‏ {\n email addresses}
אם הפעולה נכשלה בישות אחת TRUE FALSE הפעולה לא הצליחה להשבית זמנית את אותות האכיפה בחשבונות הבאים ב-Trend Micro Cloud App Security:‏ {\n email addresses}
לא הצליח לכולם FALSE FALSE לא בוצעה השבתה זמנית של אותות אכיפה באף חשבון באמצעות מידע מ-Trend Micro Cloud App Security.
הודעה אסינכרונית FALSE FALSE בהמתנה לסיום פעולות ההפחתה…
שגיאה חמורה, פרטי כניסה לא תקינים, שורש ה-API FALSE TRUE הייתה שגיאה בביצוע הפעולה "השבתה זמנית של אותות אכיפה בחשבון". הסיבה: {error traceback}

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