חבילת תוספים ל-Exchange

במאמר הזה מוסבר איך לשלב את Exchange Extension Pack עם Google Security Operations.

הגדרת השילוב לעבודה עם Exchange

שלבי ההגדרה משתנים בהתאם לשרת הדואר שהשילוב מוגדר עבורו.

בהמשך מופיעות הוראות להגדרת Microsoft 365 ו-Exchange בארגון החל מגרסה 2016. אין תמיכה בגרסאות קודמות.

הגדרת השילוב לעבודה עם Microsoft 365

השילוב הזה משתמש בסקריפטים של PowerShell כדי לבצע פעולות. צריך להתקין את חבילת PowerShell בשרת של Google Security Operations או בסוכן המרוחק של Google SecOps שמשתמש בשילוב של Exchange Extension Pack.

דוגמה להגדרת PowerShell ל-CentOS7:

  1. מתקינים את חבילת PowerShell.

    > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
    > sudo yum install -y powershell
    
  2. פותחים את המפרש של PowerShell ומתקינים את המודולים Exchange Online PowerShell V3 ו-WSMan:

    > pwsh
    > Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.5.0 -Force -Scope AllUsers
    > Install-Module -Name PSWSMan
    > Install-WSMan
    > exit
    
  3. נכנסים לכתובת https://github.com/jborean93/omi/releases כדי להוריד את הקבצים libmi.so ו-libpsrpclient.so ל-openssl 1.1. מורידים את הגרסה האחרונה של glibc-1.1.tar.gz למארח CentOS.

  4. מחלצים את ארכיון ה-tar שהורדתם:

    > tar -xzvf glibc-1.1.tar.gz
    
  5. מחליפים את הקבצים הקיימים libmi.so ו-libpsrpclient.so בספרייה /opt/microsoft/powershell/7.

הגדרת החשבון

מוסיפים את החשבון שישמש לשילוב לתפקיד האדמין Discover Management במרכז הניהול של Exchange.

הקצאת הרשאות למשתמש

מקצים למשתמש את התפקיד אדמין של נתוני תאימות.

הגדרת השילוב כך שיפעל עם Exchange מקומי

ההוראות הבאות רלוונטיות ל-Exchange 2016, אין תמיכה בגרסאות קודמות.

השילוב הזה משתמש בסקריפטים של PowerShell כדי לבצע פעולות. צריך להתקין את חבילת PowerShell בשרת Google SecOps או בסוכן המרוחק של Google SecOps שמשתמש בשילוב של Exchange Extension Pack.

דוגמה להגדרת PowerShell ל-CentOS7:

  1. מתקינים את חבילת PowerShell.

    > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
    > sudo yum install -y powershell
    
  2. מתקינים את החבילה gssapi.

    חבילת gssapi נדרשת לאימות משרת Google SecOps Linux או מסוכן מרוחק לשרת Windows שבו Exchange פועל בסשן PowerShell.

    דוגמה להתקנת gssapi ב-CentOS 7:

    > sudo yum install -y gssntlmssp
    
  3. מפעילים את Powershell remoting בשרת Windows שבו פועל Exchange, לפי המסמך Enable-PSRemoting שזמין במרכז העזרה של מיקרוסופט.

  4. מפעילים אימות בסיסי ב-Exchange.

    השילוב הזה משתמש באימות בסיסי שצריך להפעיל באופן מפורש בשרת Exchange.

    הפעלת אימות בסיסי ב-Exchange

  5. מגדירים את החשבון.

    צריך להוסיף את החשבון שבו רוצים להשתמש בשילוב לתפקיד האדמין "ניהול גילוי" במסוף Exchange Admin Center ‏ (EAC). כדי להפעיל את הפעולה "כללים של זרימת דואר", צריך להוסיף את התפקיד "כללי תעבורה" למשתמש הרלוונטי:

    • עוברים אל EAC ולוחצים על permissions (הרשאות).
    • בוחרים באפשרות ניהול Discovery ופותחים אותה.

    מרכז הניהול של Exchange

    • בקטע Roles, לוחצים על סמל
ההוספה Add ובוחרים באפשרות Transport Rules.

    עוברים אל Transport Rules (כללי העברה)

    • לוחצים על add ->‎ (הוספה), ואז על OK (אישור) ועל Save (שמירה).

    הוספת כללי
    תעבורה

    • התפקיד יתווסף לקטע "תפקידים שהוקצו". יכול להיות שיעבור קצת זמן עד שההרשאות ישוכפלו.

    אימות התפקידים שהוקצו

הגדרת השילוב של Exchange Extension Pack ב-Google SecOps

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

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

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

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
כתובת השרת המקומי של Exchange String x.x.x.x לא כתובת שרת הדואר (שם המארח או כתובת ה-IP) שאליו מתחברים.
כתובת ה-URI של Exchange Office365 Compliance String https://ps.compliance.protection.outlook.com/powershell-liveid/ לא

כתובת ה-URI של PowerShell במרכז האבטחה והתאימות של Microsoft 365, שמשמשת לביצוע פעולות תאימות.

מידע נוסף זמין במסמך Connect to Security Compliance PowerShell.

Exchange Office365 Online Powershell Uri String https://outlook.office365.com/powershell-liveid לא

כתובת ה-URI של Microsoft 365 Online Powershell שמשמשת לביצוע פעולות ניהול ב-Microsoft 365.

מידע נוסף זמין במסמך Connect to Security Compliance PowerShell.

דומיין String example.com לא הדומיין לאימות בשרת הדואר.
שם משתמש String משתמש לא

שם המשתמש לאימות בשרת הדואר.

ב-Microsoft 365, צריך להזין את כתובת האימייל של המשתמש בתור שם המשתמש.

סיסמה סיסמה לא רלוונטי לא סיסמה לאימות בשרת הדואר.
האם Exchange מקומי? תיבת סימון התיבה לא מסומנת לא מציינים אם שרת הדואר המיועד הוא Exchange On-Prem.
האם זה Office365‏ (Exchange Online)? תיבת סימון התיבה לא מסומנת לא מציינים אם שרת הדואר המקבל הוא Microsoft 365 ‏ (Exchange Online).

פעולות

תיאור

מוחקים את החיפוש לצורכי תאימות ואת כל התוצאות שאוחזרו או משימות הטיהור של האימיילים שמשויכות אליו.

פרמטרים

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

שם החיפוש לצורך תאימות שרוצים למחוק.

השם לא יכול להכיל תווים מיוחדים.

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
N/A
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה, החיפוש והפעולות של התאימות נמחקים (is_success=true): "הפעולה בוצעה בהצלחה, והחיפוש של התאימות וכל המשימות שמשויכות אליו לאחזור תוצאות או לטיהור אימיילים נמחקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם היעד הוא Exchange מקומי או Microsoft 365 אבל PowerShell לא מותקן בשרת Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם היעד הוא Exchange מקומי אבל חבילת מערכת ההפעלה gssntlmssp לא מותקנת בשרת Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם דווחה שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "ביצוע הפעולה נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי

אחזור תוצאות החיפוש של התאימות

תיאור

אחזור תוצאות של חיפוש תאימות שהושלם.

פרמטרים

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

שם לחיפוש התאימות.

השם לא יכול להכיל תווים מיוחדים.

מספר האימיילים המקסימלי להחזרה מספר שלם לא רלוונטי לא מציינים את מספר האימיילים שהפעולה יכולה להחזיר.
להסיר את החיפוש לצורך תאימות אחרי שהפעולה מסתיימת? תיבת סימון סימן אישור לא מציינים אם הפעולה צריכה להסיר משרת Exchange את פעולת החיפוש וכל משימת אחזור או מחיקה שקשורה אליה, אחרי שהפעולה מסתיימת.
ליצור טבלת פלט של Case Wall? תיבת סימון סימן אישור לא

מציינים אם הפעולה צריכה ליצור טבלת פלט של קיר בקשות התמיכה.

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

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test",
    "Type": "Email",
    "Size": "61772",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG192bc965-18c9-4c06-8834-2cxxxxxxxxxx.eml",
    "Name": "test"
  },
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test 2",
    "Type": "Email",
    "Size": "60881",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG9eefda9c-b1b5-46f0-8a54-bdxxxxxxxxxx.eml",
    "Name": "test"
  }
]
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה ונוצרה פעולת תאימות (is_success=true): "הפעולה בוצעה בהצלחה ונוצרה משימה לאחזור תוצאות חיפוש של תאימות"

אחרי שהפעולה הושלמה: "התוצאות של חיפוש התאימות {0} אוחזרו בהצלחה".format(compliance search name)

אם הפעולה לא מצליחה למצוא חיפוש תאימות על סמך השם שצוין (is_success=false): "Action was not able to find compliance search {0}".format(compliance_search_name)

אם הפעולה נכשלה בגלל שגיאה אחרת שהיא לא קריטית (is_success=false): "הפעולה לא הושלמה בגלל שגיאות. פרטי השגיאות: {0}".format(error.stacktrace)‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם היעד הוא Exchange מקומי או Microsoft 365 אבל PowerShell לא מותקן בשרת Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם היעד הוא Exchange on prem אבל חבילת מערכת ההפעלה gssntlmssp לא מותקנת בשרת Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם דווחה שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "ביצוע הפעולה נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי
טבלה

כותרת הטבלה: תוצאות הפעולה של חיפוש תאימות

עמודות בטבלה:

  • זמן קבלה
  • השולח
  • הנמען
  • נושא
כללי

פינג

תיאור

בודקים את הקישוריות לשרת Exchange או Microsoft 365 באמצעות הפרמטרים שמופיעים בדף הגדרת השילוב ב-Google SecOps Content Hub.

פרמטרים

לא רלוונטי

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
N/A
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם החיבור הצליח: "החיבור לשרת Exchange או Microsoft 365 בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם אף אחת מתיבות הסימון לא מסומנת (Microsoft 365/Exchange on prem): "צריך לציין את סוג שרת הדואר שאליו רוצים להתחבר – Exchange on-prem או Microsoft 365"

אם שתי התיבות מסומנות (Microsoft 365/Exchange מקומי): "אפשר להשתמש רק בסוג אחד של שרת אימייל בכל פעם. צריך לציין את סוג שרת הדואר שאליו רוצים להתחבר – Exchange מקומי או Microsoft 365"

אם היעד הוא Exchange מקומי או Microsoft 365 אבל PowerShell לא מותקן בשרת Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם היעד הוא Exchange on prem אבל חבילת מערכת ההפעלה gssntlmssp לא מותקנת בשרת Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם דווחה שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "ביצוע הפעולה נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי

מחיקת תוצאות החיפוש של התאימות

תיאור

מחיקה של הודעות אימייל שנמצאו בחיפוש התאימות שהושלם.

פרמטרים

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

שם לחיפוש התאימות.

השם לא יכול להכיל תווים מיוחדים.

לבצע מחיקה סופית של אימיילים שנמחקו? תיבת סימון התיבה לא מסומנת לא

מציינים אם צריך לבצע HardDelete.

האפשרות הזו רלוונטית רק ל-Microsoft 365, והיא מסמנת אימיילים להסרה סופית מתיבת הדואר.

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

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "Item count": "5",
  "Purge Type": "SoftDelete"
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה ונוצרה פעולת תאימות (is_success=true): "הפעולה בוצעה בהצלחה ונוצרה משימה למחיקת אימיילים שנמצאו בחיפוש התאימות"

Once the action is completed: "Results for the Compliance Search {0} were successfully purged".format(compliance search name)

אם הפעולה לא מצליחה למצוא חיפוש תאימות על סמך השם שצוין (is_success=false): "Action was not able to find compliance search {0}".format(compliance_search_name)

אם הפעולה לא מחזירה תוצאות: "החיפוש {0} לא החזיר תוצאות . צריך לעדכן את תוצאות החיפוש או לערוך את שאילתת החיפוש בנושא תאימות ולהריץ את החיפוש שוב".format(compliance search name)

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם היעד הוא Exchange מקומי או Microsoft 365 אבל PowerShell לא מותקן בשרת Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם היעד הוא Exchange מקומי אבל חבילת מערכת ההפעלה gssntlmssp לא מותקנת בשרת Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם דווחה שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "ביצוע הפעולה נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי

תיאור

מריצים חיפוש תאימות ב-Exchange על סמך תנאי החיפוש שצוינו. אם תיבת הסימון "אחזור תוצאות חיפוש תואמות" מסומנת, הפעולה מחזירה את תוצאות החיפוש בדומה לפעולה "אחזור תוצאות חיפוש תואמות".

התכונה Exchange Compliance Search מספקת מנגנון מהיר לחיפוש בכמה תיבות דואר, והיא שימושית במיוחד לארגונים גדולים עם יותר מ-1,000 תיבות דואר.

אם התיבה "Fetch Compliance Search Results?‎" מסומנת, יוצגו עד 200 פריטים, אבל יכול להיות שבחיפוש בפועל יימצאו יותר פריטים.

פרמטרים

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

שם לחיפוש התאימות.

השם לא יכול להכיל תווים מיוחדים.

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

המיקום שבו מחפשים אימיילים. אפשר לבחור אחת מהאפשרויות הבאות:

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

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

מוצגים עד 200 רכיבים, אבל החיפוש בפועל יכול להניב יותר תוצאות.

מספר האימיילים המקסימלי להחזרה מספר שלם לא רלוונטי לא מציינים את מספר האימיילים שהפעולה יכולה להחזיר.
ליצור טבלת פלט של Case Wall? תיבת סימון סימן אישור לא

מציינים אם הפעולה צריכה ליצור טבלת פלט של קיר בקשות התמיכה.

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

שאילתה מתקדמת String לא רלוונטי לא

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

למידע נוסף, אפשר לעיין במסמכים הפניית תחביר של Keyword Query Language (KQL)‎ ומאפייני הודעות שנוספו לאינדקס על ידי Exchange Search.

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "Name": "test",
  "RunBy": "James Bond",
  "JobEndTime": "2021-03-18T12:42:49.92",
  "Status": "Completed"
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הפעולה בוצעה בהצלחה והתאימות נוצרה (is_success=true): "הפעולה בוצעה בהצלחה וחיפוש התאימות נוצר"

אחרי שהפעולה השלימה את החיפוש: "Compliance Search {0} successfully completed".format(compliance search name)

אם תיבת הסימון לאחזור תוצאות חיפוש תאימות מסומנת: "Results for the Compliance Search {0} were successfully fetched".format(compliance search name)

אם תיבת הסימון לאחזור תוצאות חיפוש תאימות מוגדרת, אבל הפעולה לא מחזירה תוצאות: "חיפוש התאימות {0} לא החזיר תוצאות . צריך לעדכן את תוצאות החיפוש או לערוך את שאילתת החיפוש בנושא תאימות ולהריץ את החיפוש שוב".format(compliance search name)

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם היעד הוא Exchange מקומי או Microsoft 365 אבל PowerShell לא מותקן בשרת Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם היעד הוא Exchange on prem אבל חבילת מערכת ההפעלה gssntlmssp לא מותקנת בשרת Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server!‎ כדי להתקין את PowerShell, צריך לפעול לפי הוראות ההגדרה. השגיאה היא {0}".format(exception.stacktrace)

אם דווחה שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "ביצוע הפעולה נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי

הוספת דומיינים לכללי זרימת הדואר של Exchange-Siemplify

תיאור

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

פרמטרים

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
דומיינים String לא רלוונטי לא מציינים את הדומיינים שרוצים להוסיף לכלל, ברשימה מופרדת בפסיקים.
הכלל שלפיו יתווספו דומיינים אל DDL Siemplify - Domains List - Permanently Delete כן

מציינים את הכלל שאליו רוצים להוסיף את הדומיינים.

אם הכלל לא קיים, הפעולה יוצרת אותו במקום שבו הוא חסר.

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "already_available": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל ולא אמורה לעצור את ההפעלה של הפלייבוק:

אם הפעולה הצליחה (הכללים עודכנו בהתאם, הקלט נכון): "הקלט הבא נוסף לכללים המתאימים:
דומיינים:
successfull_domains

הכללים שעודכנו:
Rules_updated_names_list

אם לפחות אחד מהקלטים לא תקין (כתובת אימייל לא תקינה בפרמטר, אימייל לא תקין בשם הישות): "לא ניתן להוסיף את הקלטים הבאים לכלל:"+
Unsuccessful_email_addresses

הפעולה אמורה להיכשל ולעצור את הפעלת הפלייבוק:

אם מדווחת שגיאה: "Error performing "Add Domains to Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

כללי

הוספת שולחים לכללי זרימת הדואר של Exchange-Siemplify

תיאור

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

פרמטרים

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

מציינים את כתובות האימייל שרוצים להוסיף לכלל, ברשימה מופרדת בפסיקים.

אם לא מציינים פרמטר, הפעולה פועלת עם ישויות המשתמש.

הכלל שאליו יתווספו השולחים DDL Siemplify - Senders List - Permanently Delete כן

מציינים את הכלל שאליו רוצים להוסיף את השולח.

אם הכלל לא קיים, הפעולה יוצרת אותו במקום שבו הוא חסר.

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

ריצה

הפעולה הזו פועלת על ישות המשתמש, אם הביטוי הרגולרי של האימייל תקין עבורה, ואם לא צוינו פרמטרים.

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "already_available": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל ולא אמורה לעצור את ההפעלה של הפלייבוק:

אם הפעולה הצליחה (הכללים עודכנו בהתאם, הקלט נכון): "הקלט הבא נוסף לכללים המתאימים:
כתובות אימייל:"+
Successful_email_addresses+
"דומיינים:"+
successfull_domains+

"הכללים שעודכנו:"+
rules_updated_names_list

אם לפחות אחד מהקלטים לא תקין (כתובת אימייל לא תקינה בפרמטר, אימייל לא תקין בשם הישות): "לא ניתן להוסיף את הקלטים הבאים לכלל:"+
Unsuccessful_email_addresses

הפעולה אמורה להיכשל ולעצור את הפעלת הפלייבוק:

אם מדווחת שגיאה: "Error performing "Add Senders to Exchange-Siemplify Mail Flow Rule" action : {0}".format(exception.stacktrace)

כללי

מחיקת כללים לזרימת דואר ב-Exchange-Siemplify

תיאור

הפעולה מקבלת שם של כלל כפרמטר ומוחקת אותו.

פרמטרים

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

Siemplify - Senders List - Permanently Delete

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

  • Siemplify - Senders List - Permanently Delete
  • Siemplify - Domains List - Permanently Delete
  • כל הכללים הזמינים של זרימת דואר ב-Exchange-Siemplify
כן מציינים את שם הכלל שרוצים למחוק לגמרי.

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
N/A
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל ולא אמורה לעצור את ההפעלה של הפלייבוק:

אם הכללים נמחקו: "Successfully deleted the following rules :" succesful_rule_names

אם לא נמצאו כללים ב-Exchange: "לא ניתן למחוק את הכללים הבאים: "+unseccessful_rule_names+", כי הם לא נמצאו ב-Exchange. צריך לוודא שבחרת את שמות הכללים המתאימים ולנסות שוב".

אם לא נמצאו כללים ב-Exchange: "לא ניתן למחוק אף אחד משמות הכללים שצוינו, כי הם לא נמצאו ב-Exchange. צריך לוודא שבחרת את שמות הכללים המתאימים ולנסות שוב".

הפעולה אמורה להיכשל ולעצור את הפעלת הפלייבוק:

אם מדווחת שגיאה: "Error performing "Delete Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

כללי

רשימת כללי זרימת הדואר של Exchange-Siemplify

תיאור

הפעולה מקבלת שם של כלל כפרמטר ומציגה אותו.

פרמטרים

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
שם הכלל לרשימה DDL

Siemplify - Senders List - Permanently Delete

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

  • Siemplify - Senders List - Permanently Delete
  • Siemplify - Domains List - Permanently Delete
  • כל הכללים הזמינים של זרימת דואר ב-Exchange-Siemplify
כן מציינים את שם הכלל שרוצים להציג.

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[
  {
    "Priority": 0,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIs received from 'test@example1.com' or 'test@example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": null,
    "Identity": "Siemplify - Senders List - Permanently Delete",
    "Name": "Siemplify - Senders List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Senders List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": [
      "test@example1.com",
      "test@example2.com"
    ],
    "Guid": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "ImmutableId": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "WhenChanged": "/Date(1621952909000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  },
  {
    "Priority": 1,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIncludes these words in the sender's address: 'example1.com' or 'example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromAddressContainsPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": [
      "example1.com",
      "example2.com"
    ],
    "Identity": "Siemplify - Domains List - Permanently Delete",
    "Name": "Siemplify - Domains List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Domains List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": null,
    "Guid": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "ImmutableId": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "WhenChanged": "/Date(1621952960000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  }
]
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם נמצאו כללים: "Successfully listed the following rules :" succesful_rule_names

אם לא נמצאו כללים ב-Exchange: "לא ניתן היה להציג את הכללים הבאים: "+unseccessful_rule_names+", כי הם לא נמצאו ב-Exchange. צריך לוודא שבחרת את שמות הכללים המתאימים ולנסות שוב".

אם לא נמצאו כללים ב-Exchange: "לא ניתן היה להציג אף אחד משמות הכללים שסופקו, כי הם לא נמצאו ב-Exchange. צריך לוודא שבחרת את שמות הכללים המתאימים ולנסות שוב".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה: "Error performing "List Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

כללי

הסרת דומיינים מכללי זרימת הדואר של Exchange-Siemplify

תיאור

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

פרמטרים

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
דומיינים String לא רלוונטי לא

מציינים את הדומיינים שרוצים להסיר מהכלל, ברשימה מופרדת בפסיקים.

אם לא מציינים פרמטר, הפעולה פועלת עם ישויות.

הכלל שממנו יוסרו הדומיינים DDL Siemplify - Domains List - Permanently Delete כן

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

אם הכלל לא קיים, הפעולה לא עושה כלום.

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

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "didn't_exist": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל ולא אמורה לעצור את ההפעלה של הפלייבוק:

אם הפעולה הצליחה (הכללים עודכנו בהתאם, הקלט נכון): "הקלט הבא הוסר מהכללים המתאימים:"
דומיינים:
successfull_domains

הכללים שעודכנו:
Rules_updated_names_list

הפעולה אמורה להיכשל ולעצור את הפעלת הפלייבוק:

אם מדווחת שגיאה: "Error performing "Remove Domains from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

כללי

הסרת שולחים מכללי זרימת הדואר של Exchange-Siemplify

תיאור

הפעולה מקבלת רשימה של שולחים כפרמטר או פועלת על ישויות המשתמש (אם לא צוינו פרמטרים), ויכולה להסיר את השולחים שצוינו מהכללים הקיימים.

פרמטרים

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
שולחים String לא רלוונטי לא

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

אם לא מציינים פרמטר, הפעולה פועלת עם ישויות.

הכלל להסרת שולחים DDL רשימת השולחים של Siemplify – מחיקה סופית כן

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

אם הכלל לא קיים, הפעולה לא עושה כלום.

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

ריצה

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "didn't_exist": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל ולא אמורה לעצור את ההפעלה של הפלייבוק:

אם הפעולה הצליחה (הכללים עודכנו בהתאם, הקלטים נכונים): הודעה: "הקלטים הבאים הוסרו מהכללים המתאימים:"
שולחים :
successfull_senders

הכללים שעודכנו:
rules_updated_names_list

אם לפחות אחד מהקלטים לא תקין (כתובת אימייל לא תקינה בפרמטר, אימייל לא תקין בשם הישות): "לא ניתן להוסיף את הקלטים הבאים לכלל:"+
Unsuccessful_email_addresses

הפעולה אמורה להיכשל ולעצור את הפעלת הפלייבוק:

אם מדווחת שגיאה: "Error performing "Remove Senders from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

כללי

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