Exchange

במסמך הזה מוסבר איך לשלב את Exchange עם Google SecOps.

אזהרה: החל ממאי 2024, לא תוכלו להקצות את התפקיד ApplicationImpersonation ב-Microsoft Exchange Online. בפברואר 2025, התפקיד ApplicationImpersonation יוסר מ-Exchange Online. פרטים על השינויים שמיקרוסופט מבצעת בתפקיד ApplicationImpersonation מופיעים במאמר הוצאה משימוש של התחזות לאפליקציה ב-RBAC ב-Exchange Online. אם התפקיד ApplicationImperonation הוגדר לפני מאי 2024, הוא יפעל עד פברואר 2025. השינויים לא משפיעים על הגרסאות המקומיות של Exchange Server. מומלץ להשתמש ב-Microsoft Graph Mail כדי לעבוד עם Exchange Online.

השילוב הזה משתמש ברכיב אחד או יותר של קוד פתוח. אפשר להוריד עותק מכווץ של קוד המקור המלא של השילוב הזה ממאגר Cloud Storage.

הגדרת Exchange Online

הדרישות המוקדמות ושלבי ההגדרה משתנים בהתאם להגדרה של השילוב ב-Exchange Online או ב-Exchange Server.

• כדי להגדיר את Exchange Online, עוברים לקטע הבא.

• הוראות להגדרת שרת Exchange מופיעות במאמר הגדרת שרת Exchange.

השילוב של Exchange Online תומך רק באימות מוקצה של OAuth עם טוקנים מוקצים, שדורש הגדרה נוספת.

יכול להיות שיעברו עד 24 שעות עד שהשינויים בהרשאות בסביבת Azure ייכנסו לתוקף.

לפני שמתחילים

לפני שמגדירים את השילוב עם Exchange Online, צריך לבחור שיטת אימות ולהשלים את כל שלבי ההגדרה שלה. בוחרים אחת מהשיטות הבאות:

• שיטה 1: הקצאת הרשאות להתחזות למשתמש: האינטגרציה פועלת כמשתמש יחיד שמוגדר לכך.
• שיטה 2: הענקת גישה: השילוב ניגש ישירות לכמה תיבות דואר.

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

בשיטה הזו צריך ליצור אפליקציה ב-Microsoft Entra ID ולהקצות לה הרשאות להתחזות למשתמש יחיד.

יצירת אפליקציה ב-Microsoft Entra

כדי להתחיל בהגדרת ההתחזות, צריך לרשום אפליקציה חדשה ב-Microsoft Entra ID.

1. נכנסים אל Microsoft Azure ועוברים אל Microsoft Entra ID > App registrations > New registration.
2. מזינים שם לאפליקציה ובוחרים סוג חשבון נתמך.
3. בקטע Redirect URI (מזהה URI להפניה אוטומטית), מציינים את הערכים הבאים:
   1. פלטפורמה: Web
   2. כתובת URL להפניה אוטומטית: http://localhost
4. לוחצים על הרשמה.
5. שומרים את הערכים של מזהה האפליקציה (הלקוח) ושל מזהה הספרייה (הדייר).

הגדרת הרשאות API

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

1. עוברים אל הרשאות ל-API > הוספת הרשאה.
2. בוחרים באפשרות Microsoft Graph > Delegated permissions (הרשאות שהוקצו).
3. בקטע Select permissions, בוחרים באפשרות EWS ואז בהרשאה Ews.AccessAsUser.All.
4. לוחצים על הוספת הרשאה > מתן הסכמת אדמין.

יצירת סוד לקוח

צריך ליצור סוד לקוח שישמש כסיסמה לאפליקציה.

1. עוברים אל Certificates and secrets > New client secret (אישורים וסודות > סוד לקוח חדש).
2. מזינים תיאור, מגדירים תאריך תפוגה ולוחצים על הוספה.
3. שומרים את הערך של הסוד.

הקצאת הרשאות ב-Exchange Online:

כדי להשלים את ההגדרה, צריך להקצות את התפקיד ApplicationImpersonation למשתמש שרוצים להתחזות אליו.

1. במרכז האדמינים של Exchange, עוברים אל Roles > Admin Roles ומחפשים את קבוצת התפקידים שמכילה את התפקיד ApplicationImpersonation (למשל Discovery Management).
2. מוסיפים את המשתמש שמתחזים לו לקבוצת התפקידים הזו.

הענקת גישה

כדי להשתמש בשיטה הזו, צריך להעניק לחשבון השירות הרשאות ישירות לתיבת דואר באמצעות Exchange Online PowerShell.

1. מתחברים ל-Exchange Online PowerShell.

2. משתמשים ב-cmdlet‏ Add-MailboxPermission כדי להקצות הרשאות.

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

   Add-MailboxPermission -Identity "[e-mail]" -User "your_service_account" -AccessRights FullAccess
   

   מידע נוסף זמין במאמר בנושא בקרת גישה מבוססת-תפקידים לאפליקציות ב-Exchange Online.

שילוב של Exchange Online עם Google SecOps

הוראות להתקנה ולהגדרה של השילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

כדי לשלב את Exchange Online עם פלטפורמת Google SecOps, צריך לבצע את השלבים הבאים ב-Google SecOps:

1. מגדירים את הפרמטרים הראשוניים ושומרים אותם.

2. יצירת טוקן רענון:

   • הדמיה של תרחיש ב-Google SecOps.

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

   • מריצים את הפעולה Generate Token (יצירת טוקן).

3. מזינים את טוקן הרענון שהתקבל כערך הפרמטר Refresh Token ושומרים את ההגדרה.

הגדרת פרמטרים ראשוניים

השילוב עם Exchange Online דורש את הפרמטרים הראשוניים הבאים:

פרמטר	תיאור
Mail Server Address	חובה כתובת של שרת דואר (שם מארח או כתובת IP) להתחברות אליו.
Mail address	חובה כתובת אימייל לשימוש בשילוב כדי לעבוד עם האימיילים שנשלחו ושהתקבלו בתיבת הדואר.
Client ID	חובה מזהה האפליקציה (הלקוח) של אפליקציית Microsoft Entra שמשמשת לשילוב. זהו ערך מזהה האפליקציה (הלקוח) ששמרתם כשיצרתם את אפליקציית Microsoft Entra.
Client Secret	חובה ערך סוד הלקוח של אפליקציית Microsoft Entra שמשמשת לשילוב. זהו הערך של סוד הלקוח ששמרתם כשיצרתם סוד לקוח.
Tenant (Directory) ID	חובה מזהה ספרייה (דייר) של אפליקציית Microsoft Entra ID שמשמשת לשילוב. זהו ערך המזהה של הספרייה (הדייר) ששמרתם כשיצרתם את אפליקציית Microsoft Entra.
Redirect URL	חובה URI של הפניה אוטומטית שמוגדר באפליקציית Microsoft Entra. משאירים את ערך ברירת המחדל http://localhost.

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

יצירת טוקן רענון

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

סימולציה של פנייה

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

1. בחלונית הניווט שמימין, בוחרים באפשרות פניות.

2. בדף Cases (פניות), לוחצים על add > Simulate Cases (הדמיית פניות).

3. בוחרים באחד מהתרחישים שמוגדרים כברירת מחדל ולוחצים על יצירה. לא משנה איזה תרחיש בוחרים כדי לבצע סימולציה.

4. לוחצים על הדמיה.

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

5. בכרטיסייה Cases, לוחצים על Refresh. בקשת התמיכה שסימלתם תופיע ברשימת בקשות התמיכה.

הפעלת הפעולה Get Authorization (קבלת הרשאה)

משתמשים בתיק לדוגמה של Google SecOps שיצרתם כדי להריץ את הפעולה קבלת הרשאה באופן ידני.

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

2. לוחצים על פעולה ידנית.

3. בשדה חיפוש של הפעולה הידנית, מזינים Exchange.

4. בתוצאות שמופיעות בקטע Exchange integration, לוחצים על Get Authorization (קבלת הרשאה). הפעולה הזו מחזירה קישור הרשאה שמשמש לכניסה אינטראקטיבית לאפליקציית Microsoft Entra.

5. לוחצים על Execute.

6. אחרי שהפעולה מבוצעת, עוברים ל-Case Wall של המקרה המדומה. ברשומה של הפעולה Exchange_Get Authorization, לוחצים על View More. מעתיקים את קישור ההרשאה.

7. פותחים חלון חדש בדפדפן במצב פרטי ומדביקים את כתובת ה-URL של ההרשאה שנוצרה. נפתח דף הכניסה של Azure.

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

   הדפדפן צפוי להציג שגיאה כי האפליקציה מפנה אתכם לכתובת http://localhost.

9. מעתיקים את כתובת ה-URL המלאה עם קוד הגישה מסרגל הכתובות.

הפעלת הפעולה Generate Token (יצירת טוקן)

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

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

2. לוחצים על פעולה ידנית.

3. בשדה חיפוש של הפעולה הידנית, מזינים Exchange.

4. בתוצאות שמופיעות בקטע Exchange integration (שילוב עם Exchange), לוחצים על Generate Token (יצירת טוקן).

5. בשדה Authorization URL, מדביקים את כתובת ה-URL המלאה עם קוד הגישה שהועתק אחרי הפעלת הפעולה קבלת אימות.

6. לוחצים על Execute.

7. אחרי שהפעולה מבוצעת, עוברים ל-Case Wall של המקרה המדומה. ברשומת הפעולה Exchange_Generate Token, לוחצים על View More (הצגת פרטים נוספים).

8. מעתיקים את כל הערך של טוקן הרענון שנוצר.

הגדרת הפרמטר Refresh Token

1. עוברים לתיבת הדו-שיח של ההגדרות לשילוב עם Exchange.

2. בשדה Refresh Token (אסימון רענון), מזינים את הערך של אסימון הרענון שהתקבל כשמריצים את הפעולה Generate Token (יצירת אסימון).

3. לוחצים על Save.

4. לוחצים על בדיקה כדי לבדוק אם ההגדרה נכונה והשילוב פועל כמצופה.

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

הגדרת שרת Exchange

לפני שמשלבים את Exchange Server עם Google SecOps, צריך להגדיר את האימות הבסיסי עבור Exchange Server.

כדי לבצע אימות בשרת Exchange, צריך להשתמש בשם משתמש ובסיסמה.

הגדרת אימות בסיסי

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

1. מוודאים שאפשר לגשת ל-Exchange Server (אחד השרתים באשכול) משרת Google SecOps, ושהוא עומד בדרישות הבאות:

   • שם ה-DNS של שרת Exchange מפענח.

   • יש גישה לכתובת ה-IP של שרת Exchange.

   • ‫Exchange Web Services (EWS) מופעל ומאוחסן ביציאה שנגישה לשרת Google SecOps.

   אם אין גישה ל-Exchange Server משרת Google SecOps SOAR, כדאי להשתמש בסוכן מרוחק של Google SecOps.

2. מספקים לשילוב שם משתמש (כתובת אימייל של חשבון משתמש) וסיסמה. בוחרים את המשתמש לשילוב.

3. כדי לבצע פעולות שמשתמשות בהרשאות שהוקצו או בהתחזות, צריך לבצע את השלבים הבאים:

   1. מעניקים גישה מוקצית או גישה עם התחזות לתיבות הדואר הנדרשות לחשבון אימייל שבו אתם משתמשים בשילוב.

      מומלץ להגדיר גישה עם הרשאות התחזות. מידע נוסף זמין במאמר Impersonation and EWS in Exchange במסמכי העזרה של מוצרי Microsoft.

   2. כדי לגשת לתיבות דואר אחרות, צריך להקצות למשתמש (תיבת הדואר) שהוגדר לשילוב את התפקידים הבאים ב-Exchange:

      • Discovery Management קבוצת תפקידים במסמכי התיעוד של מוצרי מיקרוסופט.

      • תפקיד ApplicationImpersonation במסמכי המוצר של מיקרוסופט.

      • תפקיד Compliance Management במאמרי העזרה של מוצרי Microsoft.

      • תפקיד Organization Management במאמרי העזרה של מוצרי Microsoft.

שילוב של Exchange Server עם Google SecOps

הוראות להתקנה ולהגדרה של השילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

נתוני קלט של שילוב

השילוב עם Exchange Server דורש את הפרמטרים הבאים:

פרמטר	תיאור
Mail Server Address	חובה כתובת של שרת דואר (שם מארח או כתובת IP) להתחברות אליו.
Mail address	חובה כתובת אימייל שמשמשת בשילוב כדי לעבוד עם האימיילים שנשלחים ומתקבלים בתיבת הדואר.
Username	חובה שם משתמש לאימות בשרת הדואר, למשל [e-mail].
Password	חובה סיסמה לאימות בשרת הדואר.

פעולות

הפעולות שמפורטות בקטע הזה מתחלקות לשתי קטגוריות:

1. הפעולות הנפוצות בשילוב עם Exchange.

2. פעולות שספציפיות לפונקציונליות של חסימת שולח ודומיין ב-Exchange.

ההרשאות הנדרשות

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

פעולה	ההרשאות הנדרשות
מחיקת אימייל	ApplicationImpersonation Mailbox Search
הורדת קובץ מצורף	ApplicationImpersonation Mailbox Search
חיפוש אימיילים	ApplicationImpersonation Mailbox Search MailboxSearchApplication

בטבלה הבאה מפורטות ההרשאות המינימליות שנדרשות כדי להריץ פעולות מתוך הפונקציונליות של חסימת שולח ודומיין:

פעולה	ההרשאות הנדרשות
הוספת שולחים לכלל תיבת הדואר הנכנס של Exchange-Siemplify	EDiscovery Group Author
הוספת שולחים לכלל תיבת הדואר הנכנס של Exchange-Siemplify	EDiscovery Group Author
מחיקת כללים של תיבת דואר נכנס ב-Exchange-Siemplify	EDiscovery Group Author
List Exchange-Siemplify Inbox Rules	EDiscovery Group Author
הסרת דומיינים מכללי תיבת הדואר הנכנס של Exchange-Siemplify	EDiscovery Group Author
הסרת שולחים מכללי תיבת הדואר הנכנס של Exchange-Siemplify	EDiscovery Group Author

מחיקת אימייל

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

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

בקטע הרשאות הפעולה במסמך הזה מפורטות ההרשאות שנדרשות להרצת הפעולה הזו.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה מחיקת אימייל דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Folder Name	אופציונלי תיקיית תיבת דואר שבה יתבצע החיפוש של האימייל. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Message IDs	אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי הודעות כדי לחפש אותם. אם מספקים את מזהה ההודעה, הפעולה מתעלמת מהפרמטרים Subject Filter, Sender Filter ו-Recipient Filter.
Subject Filter	אופציונלי תנאי סינון שמציין את נושא האימייל שרוצים לחפש.
Sender Filter	אופציונלי תנאי סינון שמציין את השולח של הודעות האימייל המבוקשות.
Recipient Filter	אופציונלי תנאי סינון שמציין את הנמען של האימיילים המבוקשים.
Delete All Matching Emails	אופציונלי אם בוחרים באפשרות הזו, הפעולה מוחקת את כל האימיילים שתואמים לקריטריונים. אם לא בוחרים באפשרות הזו, הפעולה מוחקת רק את האימייל הראשון שתואם. האפשרות הזו לא מסומנת כברירת מחדל.
Delete from all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה מוחקת אימיילים מכל תיבות הדואר שאפשר לגשת אליהן באמצעות הגדרות ההתחזות הנוכחיות.
How many mailboxes to process in a single batch	חובה מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). אם בחרתם בפרמטר Delete from all mailboxes, הפעולה מתבצעת בקבוצות. ערך ברירת המחדל הוא 25.
Time Frame (minutes)	אופציונלי התקופה בדקות שבה יתבצע החיפוש של הודעות אימייל.

פלט של פעולות

הפעולה מחיקת אימייל מספקת את הפלט הבא:

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

הודעות פלט

הפעולה מחיקת אימייל יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
NUMBER_OF_EMAILS email(s) were deleted successfully.	הפעולה הסתיימה בהצלחה.
Error deleting emails.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

הורדת קבצים מצורפים

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה הורדת קבצים מצורפים דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Folder Name	אופציונלי תיקיית תיבת דואר שבה יתבצע החיפוש של האימייל. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Download Path	חובה נתיב בשרת Google SecOps להורדה של קבצים שמצורפים לאימייל.
Message IDs	אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי הודעות כדי לחפש אותם. אם מציינים את מזהה ההודעה, הפעולה מתעלמת מהפרמטר Subject Filter.
Subject Filter	אופציונלי תנאי סינון שמציין את נושא האימייל שרוצים לחפש.
Sender Filter	אופציונלי תנאי סינון שמציין את שולח האימייל שרוצים לחפש.
Only Unread	אופציונלי אם בוחרים באפשרות הזו, הפעולה מורידה קבצים מצורפים רק מהודעות אימייל שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Download Attachments from EML	אופציונלי אם האפשרות הזו נבחרה, הפעולה תוריד קבצים מצורפים מקובצי EML מצורפים. האפשרות הזו לא מסומנת כברירת מחדל.
Download Attachments to unique path?	אופציונלי אם האפשרות הזו מסומנת, הפעולה מורידה קבצים מצורפים לנתיב ייחודי מתחת לערך שצוין בפרמטר Download Path, כדי למנוע החלפה של הקבצים המצורפים שהורדו קודם. האפשרות הזו לא מסומנת כברירת מחדל.
Search in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה מריצה חיפוש בכל תיבות הדואר שאפשר לגשת אליהן באמצעות הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	חובה מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). אם בחרתם בפרמטר Search in all mailboxes, הפעולה מתבצעת בקבוצות. ערך ברירת המחדל הוא 25.
Mailboxes	אופציונלי רשימה מופרדת בפסיקים של תיבות דואר שבהן יתבצע החיפוש. הפרמטר הזה מקבל עדיפות על פני הפרמטר Search in all mailboxes.

פלט של פעולות

הפעולה הורדת קבצים מצורפים מספקת את הפלט הבא:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Download Attachments:

[
   {
       "attachment_name": "ATTACHMENT_NAME",
       "downloaded_path": "readonly" translate="no">FULL_PATH"
   },
   {
       "attachment_name": "ATTACHMENT_NAME",
       "downloaded_path": "readonly" translate="no">FULL_PATH"
   }
]

הודעות פלט

הפעולה Download Attachments יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: LIST_OF_LOCAL_PATHS_FOR_ATTACHMENTS	הפעולה הסתיימה בהצלחה.
Failed to download email attachments, the error is: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

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

חילוץ נתוני EML

משתמשים בפעולה Extract EML Data (חילוץ נתוני EML) כדי לחלץ נתונים מהקבצים המצורפים של הודעות האימייל בפורמט EML.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Extract EML Data (חילוץ נתוני EML) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Folder Name	אופציונלי התיקייה שממנה יאוחזר האימייל. ערך ברירת המחדל הוא Inbox. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Message ID	חובה מזהה ההודעה, למשל [e-mail].
Regex Map JSON	אופציונלי ביטוי רגולרי לבחירת אימיילים על סמך התאמה לתוכן האימייל, לדוגמה, {ips: \b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\b}.

פלט של פעולות

הפעולה Extract EML Data (חילוץ נתוני EML) מספקת את הפלטים הבאים:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל באמצעות הפעולה Extract EML Data:

[
    {
        "count": 3,
        "files": {
            "mxtoolbox_test_case.case": "090a131a0726dea8f5b0c2205ffc9527"
        },
        "from": "Exam <[e-mail]>",
        "text": "hello eml test", "regex": {

        },
        "to": "Test Test <[e-mail]>",
        "html": "<html><div></div></html>",
        "date": "Wed, 12 Sep 2018 12:36:17 +0300",
        "subject": "eml test"
    }
]

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Extract EML Data:

שם התוצאה של הסקריפט	ערך
eml_data	EML_DATA

יצירת טוקן

משתמשים בפעולה Generate Token כדי לקבל טוקן רענון עבור הגדרת השילוב עם אימות OAuth. משתמשים בכתובת ה-URL להרשאה שקיבלתם בפעולה Get Authorization.

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Generate Token (יצירת טוקן) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Authorization URL	חובה כתובת ה-URL של ההרשאה שהתקבלה בפעולה קבלת הרשאה כדי לבקש טוקן רענון.

פלט של פעולות

הפעולה Generate Token (יצירת אסימון) מספקת את הפלט הבא:

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

הודעות פלט

הפעולה Generate Token יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully fetched the refresh token: REFRESH_TOKEN_VALUE. Copy this refresh token to the Integration Configuration. Note: This Token is valid for 90 days only.	הפעולה הסתיימה בהצלחה.
Failed to get the refresh token! The Error is ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Generate Token:

שם התוצאה של הסקריפט	ערך
is_success	True או False

הוצאת החשבון מהגדרות המתקן

משתמשים בפעולה Get Account Out Of Facility Settings כדי להוציא את החשבון מההגדרות של המתקן (OOF) עבור ישות Google SecOps User שסופקה.

אם ישות המשתמש היעד היא שם משתמש ולא כתובת אימייל, מריצים את הפעולה Active Directory Enrich Entities כדי לאחזר מידע על כתובת האימייל של המשתמש שמאוחסן ב-Active Directory.

הפעולה הזו מופעלת בישות User של Google SecOps.

הוספת נתונים לפעולה

אין.

פלט של פעולות

הפעולה Get Account Out Of Facility Settings מספקת את הפלט הבא:

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

טבלת קיר עם תושבת

הפעולה Get Account Out Of Facility Settings מחזירה את הטבלה הבאה ב-Case Wall ב-Google SecOps:

שם הטבלה: Out of Facility Settings

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

• פרמטר
• ערך

העשרה של ישויות

הפעולה Get Account Out Of Facility Settings תומכת בהעשרת הישויות הבאה:

שדה העשרה	מקור (מפתח JSON)	לוגיקה
Exchange.oof_settings	OofSettings	הפעולה מחזירה את המצב המושבת או המופעל על סמך תגובת ה-API.

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל באמצעות הפעולה Get Account Out Of Facility Settings:

OofSettings(state='Disabled', external_audience='All', start=EWSDateTime(2020, 10, 1, 3, 0, tzinfo=<UTC>), end=EWSDateTime(2020, 10, 2, 3, 0, tzinfo=<UTC>))

הודעות פלט

הפעולה Get Account Out Of Facility Settings יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully returned OOF settings for ENTITY_ID Action wasn't able to find OOF settings for ENTITY_ID	הפעולה הסתיימה בהצלחה.
Error executing action "Get Account Out Of Facility Settings". Reason: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

קבלת הרשאה

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

אין.

פלט של פעולות

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

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

קישור לקיר של הפנייה

הפעולה קבלת הרשאה מחזירה את הקישור הבא:

שם: Browse to this authorization link

קישור: AUTHORIZATION_LINK

הודעות פלט

הפעולה קבלת הרשאה יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Authorization URL generated successfully. Please navigate to the link below as the user that you want to run integration with, to get a URL with access code. The URL with access code should be provided next in the Generate Token action.	הפעולה הסתיימה בהצלחה.
Failed to generate authorization URL! The Error is ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

קבלת קובץ EML של אימייל

משתמשים בפעולה Get Mail EML File כדי לאחזר קובץ EML של הודעה.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Get Mail EML File (קבלת קובץ EML של אימייל) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Folder Name	אופציונלי תיקייה שממנה יאוחזר אימייל. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Message ID	חובה מזהה ההודעה, למשל [e-mail].
Base64 Encode	אופציונלי אם הפעולה הזו נבחרה, קובץ האימייל מקודד בפורמט base64. האפשרות הזו לא מסומנת כברירת מחדל.

פלט של פעולות

הפעולה Get Mail EML File מספקת את הפלטים הבאים:

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

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה קבלת קובץ EML של אימייל:

שם התוצאה של הסקריפט	ערך
eml_info	EML_INFORMATION

העברת אימייל לתיקייה

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

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

אם בוחרים בפרמטר Limit the amount of information in the JSON result, תוצאת ה-JSON מכילה רק את שדות האימייל הבאים: datetime_received, message_id, sender, subject, to_recipients. אחרת, התוצאה ב-JSON מכילה את כל המידע שזמין על האימייל שעבר עיבוד.

אם בוחרים את הפרמטר Disable the Action JSON Result, הפעולה לא מחזירה את תוצאת ה-JSON בכלל.

הפעולה העברת אימייל לתיקייה לא פועלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה העברת אימייל לתיקייה דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Source Folder Name	חובה תיקיית מקור שממנה רוצים להעביר אימיילים.
Destination Folder Name	חובה תיקיית יעד להעברת אימיילים.
Subject Filter	אופציונלי תנאי סינון לחיפוש אימיילים לפי נושא ספציפי.
Message IDs	אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל גם רשימה מופרדת בפסיקים של מזהי הודעות כדי לחפש אותם. אם תספקו את מזהה ההודעה, הפעולה תתעלם מהפרמטר Subject Filter.
Only Unread	אופציונלי תנאי מסנן לחיפוש רק של הודעות אימייל שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Move In All Mailboxes	אופציונלי אם האפשרות הזו נבחרה, הפעולה מחפשת ומעבירה אימיילים בכל תיבות הדואר שאפשר לגשת אליהן דרך ההגדרות הנוכחיות של ביטול ההתאמה האישית. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	חובה מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). אם בוחרים את הפרמטר Move In All Mailboxes, הפעולה מתבצעת באצווה. ערך ברירת המחדל הוא 25.
Time Frame (minutes)	אופציונלי תקופה בדקות לחיפוש הודעות אימייל.
Limit the Amount of Information Returned in the JSON Result	אופציונלי אם האפשרות הזו נבחרה, הפעולה מחזירה מידע רק על שדות האימייל המרכזיים. אם היא לא נבחרה, הפעולה מחזירה מידע על כל שדות האימייל. האפשרות הזו מסומנת כברירת מחדל.
Disable the Action JSON Result	אופציונלי אם בוחרים באפשרות הזו, הפעולה לא מחזירה את תוצאת ה-JSON. האפשרות הזו לא מסומנת כברירת מחדל.

פלט של פעולות

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

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

הודעות פלט

הפעולה העברת אימייל לתיקייה יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
NUMBER_OF_EMAILS mails were successfully moved from SOURCE_FOLDER to DESTINATION FOLDER No mails were found matching the search criteria!	הפעולה הסתיימה בהצלחה.
Error search emails: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

פינג

משתמשים בפעולה Ping כדי לבדוק את החיבור למופע של Microsoft Exchange.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

לא רלוונטי

פלט של פעולות

הפעולה Ping מספקת את הפלטים הבאים:

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

הודעות פלט

הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully connected to the Microsoft Exchange server with the provided connection parameters!	הפעולה הסתיימה בהצלחה.
Failed to connect to the Microsoft Exchange server! Error is ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Ping:

שם התוצאה של הסקריפט	ערך
is_success	True או False

שמירת קבצים מצורפים של אימייל בפנייה

אפשר להשתמש בפעולה Save Mail Attachments To The Case כדי לשמור קבצים מצורפים לאימייל מאימייל שמאוחסן בתיבת הדואר שבמעקב, ב-Case Wall ב-Google SecOps.

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

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

פרמטר	תיאור
Folder Name	חובה תיקיית תיבת דואר שבה יתבצע החיפוש של האימייל. הפרמטר הזה מקבל גם רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Message IDs	חובה מזהה ההודעה לחיפוש אימייל ספציפי ולהורדת קבצים מצורפים ממנו.
Attachment To Save	אופציונלי אם לא מגדירים את הפרמטר הזה, הפעולה שומרת כברירת מחדל את כל הקבצים המצורפים להודעת האימייל ב-Case Wall. אחרת, הפעולה שומרת רק את הקובץ המצורף שציינתם ב-Case Wall.

פלט של פעולות

הפעולה Save Mail Attachments To The Case מספקת את התוצאות הבאות:

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

הודעות פלט

הפעולה Save Mail Attachments To The Case יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully saved the following attachments from the email MESSAGE_ID: ATTACHMENT_LIST No attachments found in email MESSAGE_ID	הפעולה הסתיימה בהצלחה.
Failed to save the email attachments to the case, the error is: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

חיפוש אימיילים

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה חיפוש הודעות אימייל דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Folder Name	אופציונלי תיקיית תיבת דואר שבה יתבצע החיפוש של האימייל. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Subject Filter	אופציונלי תנאי סינון שמציין את נושא האימייל שרוצים לחפש.
Sender Filter	אופציונלי תנאי סינון כדי לציין את השולח של האימיילים המבוקשים.
Recipient Filter	אופציונלי תנאי סינון לציון הנמען של האימיילים המבוקשים.
Time Frame (minutes)	אופציונלי תקופה בדקות לחיפוש הודעות אימייל.
Only Unread	אופציונלי אם בוחרים באפשרות הזו, הפעולה מחפשת רק אימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Max Emails To Return	אופציונלי המספר המקסימלי של אימיילים שיוחזרו בתוצאת הפעולה.
Search in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה מריצה חיפוש בכל תיבות הדואר שאפשר לגשת אליהן באמצעות הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	חובה מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). אם בוחרים את הפרמטר Search in all mailboxes, הפעולה מתבצעת באצווה. ערך ברירת המחדל הוא 25.
Start Time	אופציונלי שעת ההתחלה של חיפוש האימייל. הפורמט שבו צריך להשתמש הוא ISO 8601. לפרמטר הזה יש עדיפות על פני הפרמטר Time Frame (minutes).
End Time	אופציונלי שעת הסיום של החיפוש באימייל. הפורמט שבו צריך להשתמש הוא ISO 8601. אם לא מגדירים ערך והפרמטר Start Time תקף, הפעולה מגדירה את הערך End Time לשעה הנוכחית.
Mailboxes	אופציונלי רשימה מופרדת בפסיקים של תיבות דואר שבהן יתבצע החיפוש. הפרמטר הזה מקבל עדיפות על פני הפרמטר Search in all mailboxes.
Message IDs	אופציונלי רשימה מופרדת בפסיקים של מזהי הודעות לחיפוש. למסנן הזה יש עדיפות על פני תנאי מסנן אחרים.
Body Regex Filter	אופציונלי תבנית של ביטוי רגולרי לחיפוש בתוכן האימייל.

פלט של פעולות

הפעולה חיפוש הודעות אימייל מספקת את התוצאות הבאות:

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

טבלת קיר עם תושבת

הפעולה חיפוש הודעות אימייל מחזירה את הטבלה הבאה ב-Case Wall ב-Google SecOps:

שם הטבלה: הודעות תואמות

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

• Message_id
• תאריך הקבלה
• השולח
• נמענים
• נושא
• תוכן האימייל
• שמות הקבצים המצורפים (כמו רשימה של שמות קבצים מצורפים שמופרדים בפסיקים)

אם בוחרים בפרמטר Search in all mailboxes, הפעולה מוסיפה את העמודה Found in mailbox (נמצא בתיבת הדואר) לטבלה כדי לציין באיזו תיבת דואר נמצא האימייל.

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Search Mails:

[
    {
        "body": "Mail Body",
        "subject": "Mail Subject",
        "author": "[e-mail]"
    }, {
        "body": " ",
        "subject": "Mail Subject",
        "author": "[e-mail]"
    }
]

הודעות פלט

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

הודעת פלט	תיאור ההודעה
Search found NUMBER_OF EMAILS emails based on the provided search criteria. Search didn't find any matching emails. The following mailboxes were not found in the Mail Server: MAILBOX_LIST	הפעולה הסתיימה בהצלחה.
Search didn't completed successfully due to error: ERROR_REASON Error executing action "Exchange - Search Mails". Reason: the following mailboxes were not found: MAILBOX_LIST. Please check the spelling.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Search Mails:

שם התוצאה של הסקריפט	ערך
mails_json	לא זמין

שליחת אימייל והמתנה – הוצא משימוש

הוצא משימוש: הפעולה הזו הוצאה משימוש. מומלץ להשתמש בשילוב של Send Mail ו-Wait For Mail From.

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

הוספת נתונים לפעולה

השם המוצג של הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
נושא	String	לא רלוונטי	כן	נושא האימייל.
למי לשלוח?	String	[e-mail]	כן	כתובת האימייל של הנמען. אפשר להפריד בין כמה כתובות באמצעות פסיקים.
עותק	String	[e-mail]	לא	כתובת אימייל להעברת עותקים (CC). אפשר להפריד בין כמה כתובות באמצעות פסיקים.
עותק מוסתר	String	לא רלוונטי	לא	כתובת אימייל בשדה "עותק מוסתר". אפשר להפריד בין כמה כתובות באמצעות פסיקים.
תוכן האימייל	String	לא רלוונטי	כן	תוכן האימייל.
אחזור קבצים מצורפים לתגובה	תיבת סימון	התיבה לא מסומנת	לא	מאפשר לצרף קבצים מאימייל עם תשובה.
תיקייה לבדיקת תשובות	String	תיבת דואר נכנס	לא	אפשר להשתמש בפרמטר כדי לציין את תיקיית האימייל של תיבת הדואר (תיבת הדואר ששימשה לשליחת האימייל עם השאלה) כדי לחפש את תשובת המשתמש בתיקייה הזו. הפרמטר מקבל גם רשימה מופרדת בפסיקים של תיקיות, כדי לבדוק את תגובת המשתמש בכמה תיקיות. הפרמטר תלוי אותיות רישיות.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
Mail_body	לא רלוונטי	לא רלוונטי

תוצאת JSON

  [
      {
          "EntityResult": {
              "attachments": [],
              "sensitivity": "Normal",
              "effective_rights": " test",
              "has_attachments": "false",
              "last_modified_name": "mail",
              "is_submitted": "false"
          },
          "Entity": "[e-mail]"
      }
  ]
  

שליחת אימייל

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

• התראות ספציפיות שנוצרו ב-Google SecOps.
• תוצאות העיבוד של ההתראות הספציפיות.

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה שליחת אימייל דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Subject	חובה נושא האימייל.
Send to	חובה רשימה של כתובות אימייל של נמעני האימייל, שמופרדות באמצעות פסיקים, כמו [e-mail], [e-mail].
CC	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים בשדה העותק של האימייל, למשל [e-mail], [e-mail].
BCC	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים בשדה 'עותק מוסתר' של האימייל, למשל: [e-mail], [e-mail].
Attachments Paths	אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים להודעה ושנשמרים בשרת, לדוגמה: C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Mail content	חובה תוכן האימייל.
Reply-To Recipients	אופציונלי רשימה מופרדת בפסיקים של הנמענים שמופיעים בכותרת Reply-To. הפעולה מוסיפה את הכותרת Reply-To כדי לשלוח תשובות לאימייל לכתובות אימייל ספציפיות במקום לכתובת האימייל של השולח שמופיעה בשדה From.
Base64 Encoded Certificate	אופציונלי אישור בקידוד Base64 שמשמש להצפנת אימייל. כדי להצפין את האימייל, הפרמטר הזה מספיק. כדי לחתום על האימייל, צריך לספק גם את הפרמטר Base64 Encoded Signature.
Base64 Encoded Signature	אופציונלי אישור בקידוד Base64 שמשמש לחתימה על אימייל. כדי שהחתימה תפעל ותכיל אישור חתימה, צריך לספק את הפרמטרים Base64 Encoded Signature ו-Base64 Encoded Certificate.

פלט של פעולות

הפעולה שליחת אימייל מספקת את הפלטים הבאים:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Send Mail:

{
    "mime_content": "b'From: exchange_online_test\\r\\n\\t<[e-mail]>\\r\\nTo: =?iso-8859-8-i?B?4ifp6e7xIOHl8OM=?=\\r\\n\\t<[e-mail]>\\r\\nSubject: test email\\r\\nThread-Topic: test email\\r\\nThread-Index: AQHZI2sS6qOMRJL5hkWATMpRN9fv4Q==\\r\\nDate: Sun, 8 Jan 2023 14:11:15 +0000\\r\\nMessage-ID: <message_id@example>\\r\\nAccept-Language: en-US\\r\\nContent-Language: en-US\\r\\nX-MS-Has-Attach:\\r\\nContent-Type: multipart/alternative;\\r\\n\\tboundary=\"_000_1673187082551404817642532883270906446a69558cb5108_\"\\r\\nMIME-Version: 1.0\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_\\r\\nContent-Type: text/plain; charset=\"iso-8859-8-i\"\\r\\nContent-Transfer-Encoding: quoted-printable\\r\\n\\r\\ntest content\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_\\r\\nContent-Type: text/html; charset=\"iso-8859-8-i\"\\r\\nContent-Transfer-Encoding: quoted-printable\\r\\n\\r\\n<html>\\r\\n<head>\\r\\n<meta http-equiv=3D\"Content-Type\" content=3D\"text/html; charset=3Diso-8859-=\\r\\n8-i\">\\r\\n</head>\\r\\n<body>\\r\\n<p>test content </p>\\r\\n</body>\\r\\n</html>\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_--\\r\\n'",
    "_id": "ItemId(id='AAMkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQBGAAAAAABZKh7ro7RoSpjbI663J/SqBwDjM1k0xgBMR6sDaC+Azo7rAAAAAAEJAADjM1k0xgBMR6sDaC+Azo7rAAAAEth6AAA=', changekey='CQAAABYAAADjM1k0xgBMR6sDaC+Azo7rAAAAEm3h')",
    "parent_folder_id": "ParentFolderId(id='AAMkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQAuAAAAAABZKh7ro7RoSpjbI663J/SqAQDjM1k0xgBMR6sDaC+Azo7rAAAAAAEJAAA=', changekey='AQAAAA==')",
    "item_class": "IPM.Note",
    "subject": "test email",
    "sensitivity": "Normal",
    "text_body": "test content\r\n",
    "body": "<html><head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>test content </p></body></html>",
    "attachments": [],
    "datetime_received": "2023-01-08 14:11:15+00:00",
    "size": 2928,
    "categories": null,
    "importance": "Normal",
    "in_reply_to": null,
    "is_submitted": true,
    "is_draft": true,
    "is_from_me": false,
    "is_resend": false,
    "is_unmodified": false,
    "headers": null,
    "datetime_sent": "2023-01-08 14:11:15+00:00",
    "datetime_created": "2023-01-08 14:11:15+00:00",
    "reminder_due_by": null,
    "reminder_is_set": false,
    "reminder_minutes_before_start": 0,
    "display_cc": null,
    "display_to": "\u05d2'\u05d9\u05d9\u05de\u05e1 \u05d1\u05d5\u05e0\u05d3",
    "has_attachments": false,
    "vote_request": null,
    "culture": "en-US",
    "effective_rights": "EffectiveRights(create_associated=False, create_contents=False, create_hierarchy=False, delete=True, modify=True, read=True, view_private_items=True)",
    "last_modified_name": "exchange_online_test",
    "last_modified_time": "2023-01-08 14:11:15+00:00",
    "is_associated": false,
    "web_client_read_form_query_string": "https://example.com/&exvsurl=1&viewmodel=ReadMessageItem",
    "web_client_edit_form_query_string": null,
    "conversation_id": "ConversationId(id='AAQkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQAQAOqjjESS+YZFgEzKUTfX7+E=')",
    "unique_body": "<html><body><div>\r\n<div>\r\n<p>test content </p></div></div>\r\n</body></html>",
    "sender": "Mailbox(name='exchange_online_test', email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')",
    "to_recipients": [
        "Mailbox(name=\"\u05d2'\u05d9\u05d9\u05de\u05e1 \u05d1\u05d5\u05e0\u05d3\", email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')"
    ],
    "cc_recipients": null,
    "bcc_recipients": null,
    "is_read_receipt_requested": false,
    "is_delivery_receipt_requested": false,
    "conversation_index": "b'\\x01\\x01\\xd9#k\\x12\\xea\\xa3\\x8cD\\x92\\xf9\\x86E\\x80L\\xcaQ7\\xd7\\xef\\xe1'",
    "conversation_topic": "test email",
    "author": "Mailbox(name='exchange_online_test', email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')",
    "message_id": "<167318708255.14048.17642532883270906446@a69558cb5108>",
    "is_read": true,
    "is_response_requested": false,
    "references": null,
    "reply_to": null,
    "received_by": null,
    "received_representing": null,
    "vote_response": null,
    "email_date": 1673187075
}

בנוסף לתוצאה הטכנית של אובייקט האימייל ב-JSON, הפעולה מחזירה גם את מזהה ההודעה ואת התאריך שבו האימייל נשלח. הנתונים הנוספים משמשים בפעולה Wait for Mail (המתנה למייל), אם צריך:

{
…
"message_id": "<[e-mail]>",
"email_date": "1583916838"
...
}

הודעות פלט

הפעולה Send Mail יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Mail sent successfully.	הפעולה הסתיימה בהצלחה.
Failed to send email! The Error is ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
Success_Inidicator	לא זמין

שליחת אימייל בפורמט HTML

משתמשים בפעולה Send Mail HTML כדי לשלוח אימייל עם תוכן תבנית ה-HTML. השדה Send to מופרד בפסיקים.

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

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Send Mail HTML דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Subject	חובה נושא האימייל.
Send to	חובה רשימה של כתובות אימייל שמופרדות בפסיקים של נמעני האימייל.
CC	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים, לשדה העותק של האימייל.
BCC	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים בשדה 'עותק מוסתר' של האימייל.
Attachments Paths	אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים ומאוחסנים בשרת, לדוגמה, C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Mail content	חובה תוכן האימייל.

פלט של פעולות

הפעולה שליחת אימייל בפורמט HTML מספקת את הפלט הבא:

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

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Ping:

שם התוצאה של הסקריפט	ערך
is_success	True או False

שליחת תשובה לשרשור

משתמשים בפעולה Send Thread Reply כדי לשלוח הודעה כתשובה לשרשור האימייל.

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Send Thread Reply (שליחת תשובה לשרשור) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Message ID	חובה המזהה של ההודעה שרוצים לשלוח לה תשובה.
Folder Name	חובה רשימה מופרדת בפסיקים של תיקיות בתיבת הדואר שבהן יתבצע חיפוש של הודעת אימייל. אתם יכולים להגדיר תיקיות ספציפיות לאימייל, למשל, Gmail/All Mail כדי להריץ חיפוש בכל התיקיות של תיבת הדואר ב-Gmail. בנוסף, שם התיקייה חייב להיות זהה לתיקיית ה-IMAP. אם שם התיקייה מכיל רווחים, צריך להקיף את הרווחים במירכאות כפולות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון.
Content	חובה תוכן התשובה.
Attachment Paths	אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים להודעה ושמורים בשרת.
Reply All	אופציונלי אם בוחרים באפשרות הזו, הפעולה שולחת תשובה לכל הנמענים שקשורים להודעת האימייל המקורית, ומתעלמת מהפרמטר Reply To. האפשרות הזו מסומנת כברירת מחדל.
Reply To	חובה רשימה של כתובות אימייל שמופרדות בפסיקים שאליהן יישלח המענה. אם לא מגדירים ערך ולא בוחרים בפרמטר Reply All, הפעולה רק שולחת תשובה לשולח האימייל. אם בוחרים את הפרמטר Reply All, המערכת מתעלמת מהפרמטר הזה בפעולה.

פלט הפעולה

הפעולה שליחת תגובה לשרשור מספקת את הפלטים הבאים:

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

הודעות פלט

הפעולה Send Thread Reply יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully sent reply to the message with ID MESSAGE_ID in Exchange.	הפעולה הסתיימה בהצלחה.
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.	הפעולה נכשלה. בודקים את הפרמטר Reply To כדי לשלוח תשובות רק לכתובת שלכם.
Error executing action "Send Thread Reply". Reason: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Send Thread Reply:

שם התוצאה של הסקריפט	ערך
is_success	True או False

שליחת אימייל להצבעה

כדי לכלול בתהליכים אוטומטיים משתמשים שאין להם גישה לממשק המשתמש של Google SecOps, אפשר להשתמש בפעולה Send Vote Mail (שליחת אימייל להצבעה) כדי לשלוח אימיילים עם אפשרויות תשובה שהוגדרו מראש.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Send Vote Mail (שליחת אימייל להצבעה) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Subject	חובה נושא האימייל.
Send to	חובה רשימה של כתובות אימייל של נמעני האימייל, שמופרדות באמצעות פסיקים, כמו [e-mail], [e-mail].
CC	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים בשדה העותק של האימייל, למשל [e-mail], [e-mail].
BCC	אופציונלי רשימה של כתובות אימייל שמופרדות באמצעות פסיקים בשדה 'עותק מוסתר' של האימייל, כמו [e-mail], [e-mail].
Attachments Paths	אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים ומאוחסנים בשרת, לדוגמה, C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Question or Decision Description	חובה השאלה שצריך לשאול את הנמענים או ההחלטה שהנמענים צריכים להגיב עליה.
Structure of voting options	חובה מבנה ההצבעה שיישלח לנמענים. הערכים האפשריים הם: Yes/No Approve/Reject ערך ברירת המחדל הוא Yes/No.

פלט של פעולות

הפעולה שליחת אימייל להצבעה מספקת את הפלט הבא:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Send Vote Mail:

{

…

"message_id": "[e-mail]>",

"email_date": "1583916838"

...

}

הודעות פלט

הפעולה Send Vote Mail יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Vote Mail was sent successfully Could not send vote mail for the following mailboxes: MAILBOX_LIST	הפעולה הסתיימה בהצלחה.
Could not send vote mail to any of the provided mailboxes. Please check the action parameters and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Send Vote Mail:

שם התוצאה של הסקריפט	ערך
is_success	True או False

המתנה לכתובת האימייל של המשתמש

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

הפעולה הזו פועלת באופן אסינכרוני. אפשר לשנות את ערך הזמן הקצוב לתפוגה של הסקריפט בסביבת הפיתוח המשולבת (IDE) של Google SecOps לפעולה לפי הצורך.

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Wait for Mail From User (המתנה למייל ממשתמש) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Mail message_id	חובה המזהה של הודעת האימייל. אם ההודעה נשלחת באמצעות הפעולה Send Mail, בוחרים את השדה SendEmail.JSONResult|message_id כפלייסהולדר.
Mail Date	חובה חותמת זמן של האימייל שנשלח, שהפעולה הנוכחית ממתינה לו. אם הודעה נשלחת באמצעות הפעולה שליחת אימייל, בוחרים בשדה SendEmail.JSONResult|email_date כמחזיק מקום.
Mail Recipients	חובה רשימה של נמעני אימייל שמופרדת בפסיקים, שהפעולה הנוכחית ממתינה לתשובה מהם. אם הודעה נשלחת באמצעות הפעולה Send Mail, בוחרים בשדה SendEmail.JSONResult|to_recipients כמחזיק מקום.
How long to wait for recipient reply (minutes)	חובה פרק זמן להמתנה לתשובת המשתמש לפני סימון הפעולה ככזו שחלף הזמן שהוקצב לה. ערך ברירת המחדל הוא 1,440 דקות.
Wait for All Recipients to Reply?	אופציונלי אם בוחרים באפשרות הזו, הפעולה תמתין לתשובות מכל הנמענים עד שיחלוף הזמן הקצוב לתפוגה או עד שתתקבל התשובה הראשונה. האפשרות הזו מסומנת כברירת מחדל.
Wait Stage Exclude pattern	אופציונלי ביטוי רגולרי להחרגת תשובות ספציפיות משלב ההמתנה. הפרמטר הזה פועל עם תוכן האימייל. לדוגמה, אתם יכולים להגדיר את הפעולה כך שלא תתייחס להודעות אוטומטיות על היעדרות מהמשרד כתשובות של הנמען, אלא תחכה לתשובה ממשית של המשתמש.
Folder to Check for Reply	אופציונלי תיקיית אימייל בתיבת הדואר שבה יתבצע החיפוש של תשובת המשתמש. הפעולה מריצה חיפוש בתיבת הדואר שממנה נשלח האימייל עם השאלה. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. הפרמטר הזה הוא תלוי אותיות רישיות. ערך ברירת המחדל הוא Inbox.
Fetch Response Attachments	אופציונלי אם האפשרות הזו נבחרה והתשובה של הנמען מכילה קבצים מצורפים, הפעולה מאחזרת את התשובה ומוסיפה אותה כקובץ מצורף לתוצאת הפעולה. האפשרות הזו לא מסומנת כברירת מחדל.

פלט של פעולות

הפעולה המתנה להודעת אימייל מהמשתמש מספקת את הפלט הבא:

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

קיר המארז

הפעולה Wait for Mail From User מחזירה את הקובץ המצורף הבא ב-Case wall ב-Google SecOps:

שדה קובץ מצורף	תיאור
title	קובץ מצורף מהתשובה של הנמען RECIPIENT_EMAIL
filename	ATTACHMENT_NAME. EXTENSION
fileContent	ATTACHED_FILE_CONTENT

סוג הקובץ המצורף הוא Entity, והוא ממופה לנמען שהשיב לmessage_id שהשרת של Google SecOps עוקב אחרי התשובות שלו.

תוצאה בפורמט JSON

הפעולה מחזירה תוצאה בפורמט JSON, שהיא שילוב של שני הפלטים הבאים:

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

   הפעולה עוקבת אחרי התשובה באימייל באמצעות message_id.

2. פלט JSON לתהליך של מעקב אחרי תשובות ממשתמשים.

השיטה למיזוג נתוני הפלט מוגדרת בשלב ההטמעה.

התהליך ליצירת פלט JSON של אובייקט דואר הוא כזה:

1. הפעולה ממתינה לתגובה של משתמש אחד לפחות כדי להמשיך.

2. אחרי קבלת התשובה מנקודת הצירוף של המשתמש, הפעולה מעדכנת את תוצאת ה-JSON וממשיכה עם תוצאות הפעולה.

   {
   "Responses":
   {[
       "[e-mail]": "Approved",
       "[e-mail]": "",
       "[e-mail]": ""
   ]}
   }
   

התרשים הבא מציג את התהליך של מעקב אחר פלט התגובה:

1. הפעולה ממתינה לתשובות של כל המשתמשים כדי להמשיך.

2. אחרי קבלת תשובות מהמשתמשים או אחרי שהפעולה מגיעה לזמן קצוב לתפוגה, הפעולה מעדכנת את תוצאת ה-JSON.

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

   {
   "Responses":
   {[
       "[e-mail]": "Approved",
       "[e-mail]": "Approved",
       "[e-mail]": "Timeout"
   ]}
   }
   

הודעות פלט

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

הודעת פלט	תיאור ההודעה
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT	הפעולה הסתיימה בהצלחה.
Failed to execute action, the error is: ERROR_REASON Failed to get user EMAIL_RECIPIENT reply, the error is: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

המתנה לתוצאות ההצבעה באימייל

משתמשים בפעולה Wait for Vote Mail Results כדי להמתין לתשובות של הצבעה שנשלחה באמצעות הפעולה Send Vote Mail ולאחזר אותן. הפעולה Wait for Vote Mail Results מעבירה את התשובות שנשלפו אל Google SecOps.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Wait for Vote Mail Results (המתנה לתוצאות ההצבעה בדואר) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Vote Mail message_id	חובה מזהה ההודעה של האימייל עם ההצבעה. אם ההודעה נשלחת באמצעות הפעולה Send Vote Mail, בוחרים את השדה SendVoteMail.JSONResult|message_id כפלייסהולדר.
Mail Recipients	חובה רשימה של כתובות אימייל של נמענים, שמופרדות באמצעות פסיקים, שהפעולה הנוכחית ממתינה לתשובה מהם. בוחרים את השדה SendVoteMail.JSONResult|to_recipients כמחזיק מקום.
Folder to Check for Reply	חובה תיקייה בתיבת הדואר שבה יתבצע החיפוש של תשובת המשתמש. הפעולה מריצה חיפוש בתיבת הדואר שממנה נשלח האימייל עם השאלה. הפרמטר הזה מקבל גם רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. הפרמטר הזה הוא תלוי אותיות רישיות. ערך ברירת המחדל הוא Inbox.
Folder to Check for Sent Mail	חובה תיקיית תיבת הדואר שבה יתבצע החיפוש של הדואר שנשלח. הפעולה מריצה חיפוש בתיבת הדואר שממנה נשלח האימייל עם השאלה. הפרמטר הזה מקבל גם רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. הפרמטר הזה הוא תלוי אותיות רישיות. ערך ברירת המחדל הוא Sent Items.
How long to wait for recipient reply (minutes)	חובה פרק זמן להמתנה לתשובת המשתמש לפני סימון הפעולה ככזו שחלף הזמן שהוקצב לה. ערך ברירת המחדל הוא 1,440 דקות.
Wait for All Recipients to Reply?	אופציונלי אם בוחרים באפשרות הזו, הפעולה תמתין לתשובות מכל הנמענים עד שתגיע לזמן קצוב לתפוגה או שתמשיך עם התשובה הראשונה. האפשרות הזו מסומנת כברירת מחדל.

פלט של פעולות

הפעולה Wait for Vote Mail Results מספקת את הפלט הבא:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט תוצאות JSON שמתקבל כשמשתמשים בפעולה Wait for Vote Mail Results:

{
    "Responses": [{
        "recipient": "[e-mail]",
        "content": "Approve"
    }]
}

הודעות פלט

הפעולה Wait for Vote Mail Results יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT	הפעולה הסתיימה בהצלחה.
Could not perform action on the following mailboxes: MAILBOX_LIST Could not perform action on any of the provided mailboxes. Please check the action parameters and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט תוצאות הסקריפט כשמשתמשים בפעולה Wait for Vote Mail Results:

שם התוצאה של הסקריפט	ערך
is_success	True או False

הפונקציות 'חסימת השולח' ו'חסימת דומיין'

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

ב-Google SecOps, השילוב עם Exchange מספק את הפונקציונליות Block Sender and Domain (חסימת השולח והדומיין), שכוללת את השלבים הבאים ברצף:

1. הגנה בתוך הארגון.

   השתמש בפעולה חסימת שולח לפי מזהה הודעה כדי להוסיף את השולח לרשימת החסימות באמצעות שירות EWS סמן כזבל.

2. הגנה מחוץ לארגון באמצעות כללים לתיבת הדואר הנכנס.

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

3. הגנה מחוץ לארגון באמצעות כללים לתיבת הדואר הנכנס בשרת.

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

מידע נוסף על השלבים האלה מופיע בקטע הבא.

תרחיש שימוש

תרחיש השימוש הבא מציג דוגמה לפרצת אבטחה שהיא אימייל חשוד ועלול להיות מזיק.

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

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

תיקון האיום

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

הפעולה חסימת השולח לפי מזהה ההודעה מפעילה את שירות Exchange EWS‏ Mark as Junk (סימון כדואר) כדי לבצע את הפעולות הבאות:

1. מעבירים את האימייל החשוד לתיקייה דואר.
2. להוסיף את שולח האימייל לרשימת השולחים החסומים של תיבת הדואר שנבדקת.

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

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

טיפול בתיבות דואר שנפרצו

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

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

1. הוספת דומיינים לכללים של תיבת הדואר הנכנס ב-Exchange-Siemplify
2. הוספת שולחים לכלל בתיבת הדואר הנכנס של Exchange-Siemplify
3. מחיקת כללים לתיבת הדואר הנכנס ב-Exchange-Siemplify
4. רשימת כללים לתיבת הדואר הנכנס של Exchange-Siemplify
5. הסרת דומיינים מכללי תיבת הדואר הנכנס של Exchange-Siemplify
6. הסרת שולחים מכללים לתיבת הדואר הנכנס ב-Exchange-Siemplify

במאמרי העזרה של מיקרוסופט אפשר לקרוא מידע נוסף על השירות שבו נעשה שימוש בפעולות.

השילוב עם Exchange מאפשר להשתמש בקבוצה של הכללים המוגדרים מראש הבאים עבור הפעולות הנפוצות ביותר:

• Siemplify – Senders List – Move To Junk
• Siemplify – Senders List – Delete
• Siemplify – Senders List – Permanently Delete
• Siemplify – Domains List – Move To Junk
• Siemplify – Domains List – Delete
• Siemplify – Domains List – Permanently Delete

מחיקה סופית של הודעות אימייל מהשולח הזדוני

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

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

1. ב-Google SecOps, מחשבון האדמין, מריצים את הפעולה Add Senders to Exchange-Siemplify Inbox Rule. מזינים את כתובת האימייל של השולח הזדוני.

2. בוחרים את הכלל המתאים מהרשימה כדי להגדיר איך לנהל אימייל חשוד. כדי למחוק סופית הודעות אימייל זדוניות, בוחרים את הכלל Siemplify – Senders List – Permanently Delete.

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

3. בוחרים את הפרמטר Perform action in all mailboxes כדי להחיל את הכלל על כל תיבות הדואר.

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

4. כדי להוסיף הגנה מפני הודעת אימייל חשודה שהתקבלה בתיבות דואר אחרות ולחסום את הדומיין הזדוני של השולח, בוחרים את הפרמטר Should add senders' domain to the corresponding Domains List rule as well?.

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

הפעולה Add Senders to Exchange-Siemplify Inbox Rule מעדכנת כמה כללים בו-זמנית בהתאם לפרמטר Mailboxes to process in one batch. הפעולה Add Senders to Exchange-Siemplify Inbox Rule פועלת על שולחים ועל דומיינים, חלה על כל תיבות הדואר בלי קשר לשאלה אם התקבל אימייל חשוד, ויכולה להיות אוטומטית.

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

הפעולות 'חסימת השולח' ו'חסימת הדומיין'

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

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

משתמשים בפעולה Add Domains to Exchange-Siemplify Inbox Rules כדי לקבל רשימה של דומיינים כפרמטר, או משתמשים בישות Domain של Google SecOps אם הפרמטרים ריקים. הפעולה הזו זמינה רק ב-Google SecOps מגרסה 5.6 ואילך.

לפני שמריצים את הפעולה הזו, צריך להגדיר את הרשאות הפעולה הנדרשות.

אפשר ליצור או לעדכן כלל על ידי סינון הדומיינים מתיבות הדואר. אפשר לשנות את הפעולה הזו באמצעות הפרמטר Rule to add Domains to.

הפעולה Add Domains to Exchange-Siemplify Inbox Rules משנה את כללי תיבת הדואר הנכנס הנוכחיים של המשתמשים עם EWS.

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

אם לא מגדירים פרמטרים והגרסה של Google SecOps היא 5.6 ואילך, הפעולה הזו מופעלת בישות Domain.

הוספת נתונים לפעולה

הפעולה Add Domains to Exchange-Siemplify Inbox Rules (הוספת דומיינים לכללי תיבת הדואר הנכנס של Exchange-Siemplify) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Domains	אופציונלי רשימה מופרדת בפסיקים של דומיינים להוספה לכלל.
Rule to add Domains to	חובה כלל שאליו רוצים להוסיף דומיינים. אם אין כלל, הפעולה יוצרת אותו. הערכים האפשריים הם: Siemplify - Domains List - Move To Junk Siemplify - Domains List - Delete Siemplify - Domains List - Permanently Delete ערך ברירת המחדל הוא Siemplify - Domains List - Move To Junk.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה Add Domains to Exchange-Siemplify Inbox Rules מספקת את הפלט הבא:

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

הודעות פלט

הפעולה Add Domains to Exchange-Siemplify Inbox Rules יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Added the following Domains to the corresponding rules: Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	הפעולה הסתיימה בהצלחה.
Error performing "Add Domains to Exchange-Siemplify Inbox Rules" action: ERROR_REASON No domains provided in "Domains" parameter, please check action parameters and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Add Domains to Exchange-Siemplify Inbox Rules:

שם התוצאה של הסקריפט	ערך
is_success	True או False

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

אם הפרמטרים ריקים, אפשר להשתמש בפעולה Add Senders to Exchange-Siemplify Inbox Rule כדי לקבל רשימה של כתובות אימייל או לעבוד עם הישות User של Google SecOps. אפשר להשתמש בביטויים רגולריים לפעולה הזו.

אפשר ליצור כלל חדש על ידי סינון השולחים מתיבות הדואר. אפשר לשנות את הפעולה הזו באמצעות הפרמטר Rule to add senders to.

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

הפעולה Add Senders to Exchange-Siemplify Inbox Rule משנה את כללי תיבת הדואר הנכנס הנוכחיים של המשתמשים באמצעות EWS.

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

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

הוספת נתונים לפעולה

הפעולה Add Senders to Exchange-Siemplify Inbox Rule דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Senders	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים, להוספה לכלל. אם לא מגדירים ערך, הפעולה פועלת עם הישות User.
Rule to add senders to	חובה כלל להוספת השולח. אם אין כלל, הפעולה יוצרת אותו. הערכים האפשריים הם: Siemplify - Senders List - Move To Junk Siemplify - Senders List - Delete Siemplify - Senders List - Permanently Delete ערך ברירת המחדל הוא Siemplify - Senders List - Move To Junk.
Should add senders' domain to the corresponding Domains List rule as well?	אופציונלי אם בוחרים באפשרות הזו, הפעולה מוסיפה באופן אוטומטי את הדומיינים של כתובות האימייל שצוינו לכללי הדומיין המתאימים. לא מסומן כברירת מחדל.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך ההגדרות הנוכחיות של הסרת ההתאמה האישית. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה Add Senders to Exchange-Siemplify Inbox Rule מספקת את הפלט הבא:

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

הודעות פלט

הפעולה Add Senders to Exchange-Siemplify Inbox Rule יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Added the following inputs to the corresponding rules: Email Addresses: EMAIL_ADDRESS_LIST Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	הפעולה הסתיימה בהצלחה.
Error performing "Add Senders to Siemplify Inbox Rule" action: ERROR_REASON No email addresses provided in "Senders" parameter and there are no email addresses in user entities, Please check action inputs and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Add Senders to Exchange-Siemplify Inbox Rule:

שם התוצאה של הסקריפט	ערך
is_success	True או False

חסימת שולח לפי מזהה ההודעה

משתמשים בפעולה Block Sender by Message ID (חסימת שולח לפי מזהה הודעה) כדי לקבל רשימה של מזהי הודעות כפרמטר ולסמן את הרשימה כדואר.

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

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

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

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

הפעולה Block Sender by Message ID לא פועלת על ישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה חסימת השולח לפי מזהה ההודעה דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Move item to Junk folder?	חובה אם בוחרים באפשרות הזו, הפעולה מעבירה את ההודעות שצוינו לתיקיית הספאם. האפשרות הזו מסומנת כברירת מחדל.
Message IDs	אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי הודעות כדי לסמן אותם כדואר. אם מספקים את מזהה ההודעה, הפעולה מתעלמת מהפרמטרים Subject Filter, Sender Filter ו-Recipient Filter.
Mailboxes list to perform on	אופציונלי תנאי סינון להפעלת הפעולה ברשימה ספציפית של תיבות דואר כדי לשפר את התזמון. כדי לסמן הודעות מכמה כתובות אימייל כדואר, צריך להזין רשימה של כתובות אימייל שמופרדות בפסיקים. אם מספקים רשימת תיבות דואר, הפעולה מתעלמת מהפרמטר Perform Action in all Mailboxes.
Folder Name	אופציונלי תיקיית תיבת דואר שבה רוצים לחפש אימייל. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. ערך ברירת המחדל הוא Inbox.
Subject Filter	אופציונלי תנאי סינון שמציין את נושא האימייל שרוצים לחפש.
Sender Filter	אופציונלי תנאי סינון שמציין את השולח של הודעות האימייל המבוקשות.
Recipient Filter	אופציונלי תנאי סינון שמציין את הנמען של האימיילים המבוקשים.
Mark All Matching Emails	אופציונלי אם הפעולה הזו נבחרה, היא תסמן את כל האימיילים מתיבת הדואר שתואמים לקריטריונים. אם היא לא נבחרה, היא תסמן רק את האימייל הראשון שתואם לקריטריונים. האפשרות הזו לא מסומנת כברירת מחדל.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה עוברת לספאם והאימיילים מהשולח נחסמים בכל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 25.
Time Frame (minutes)	אופציונלי התקופה בדקות שבה יתבצע החיפוש של הודעות אימייל.

פלט של פעולות

הפעולה חסימת השולח לפי מזהה ההודעה מספקת את הפלטים הבאים:

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

הודעות פלט

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

הודעת פלט	תיאור ההודעה
NUMBER_OF_EMAILS mails were successfully marked as junk. No mails were found matching the search criteria! NUMBER_OF_EMAILS email(s) were marked as junk from PROCESSED_MAILBOXES mailboxes (out of ALL_MAILBOXES). Continuing.	הפעולה הסתיימה בהצלחה.
Failed to execute action - Action is fully supported only from Exchange Server version 2013 and above, Please make sure you have the appropriate version configured in Chronicle SOAR.	הפעולה נכשלה. הגרסה של Exchange Server שבה אתם משתמשים לא נתמכת.
Error performing "Mark as junk and Block Sender" action: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

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

משתמשים בפעולה Delete Exchange-Siemplify Inbox Rules כדי לקבל שם של כלל כפרמטר ולמחוק אותו מכל תיבות הדואר שצוינו.

לפני שמריצים את הפעולה הזו, צריך להגדיר את הרשאות הפעולה הנדרשות.

הפעולה מחיקת כללי תיבת דואר נכנס של Exchange-Siemplify משנה את כללי תיבת הדואר הנכנס הנוכחיים של המשתמשים שלכם עם EWS.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Delete Exchange-Siemplify Inbox Rules דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Rule Name To Delete	חובה שם של כלל למחיקה מלאה מתיבות הדואר הרלוונטיות. הערכים האפשריים הם: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete All available Exchange-Siemplify Senders Rules All available Exchange-Siemplify Domains Rules All available Exchange-Siemplify Rules
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה מחיקת כללים של תיבת דואר נכנס ב-Exchange-Siemplify מספקת את הפלטים הבאים:

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

הודעות פלט

הפעולה Delete Exchange-Siemplify Inbox Rules יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Deleted the following rules from the specified mailboxes: MAILBOX_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	הפעולה הסתיימה בהצלחה.
Error performing "Delete Siemplify Inbox Rules" action: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

List Exchange-Siemplify Inbox Rules

משתמשים בפעולה List Exchange-Siemplify Inbox Rules כדי לקבל שם של כלל מכללי תיבת הדואר הנכנס של Exchange-Siemplify כפרמטר, ולרשום אותו. אם אין תיבות דואר לרשום, הפעולה רושמת את הכללים של המשתמש שמחובר לחשבון.

לפני שמריצים את הפעולה הזו, צריך להגדיר את הרשאות הפעולה הנדרשות.

הפעולה List Exchange-Siemplify Inbox Rules משנה את כללי תיבת הדואר הנכנס הנוכחיים של המשתמשים עם EWS.

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה List Exchange-Siemplify Inbox Rules דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Rule Name To List	חובה שם הכלל שרוצים להציג מתיבות הדואר הרלוונטיות. הערכים האפשריים הם: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete All available Exchange-Siemplify Senders Rules All available Exchange-Siemplify Domains Rules All available Exchange-Siemplify Rules
Mailboxes list to perform on	אופציונלי תנאי סינון שמציין את רשימת תיבות הדואר שבהן תתבצע הפעולה, כדי לשפר את התזמון. הפרמטר הזה מקבל רשימה של כתובות אימייל שמופרדות בפסיקים, כדי לבטל את הסימון של ההודעות כדואר. אם מספקים רשימת תיבות דואר, הפעולה מתעלמת מהפרמטר Perform action in all mailboxes.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה List Exchange-Siemplify Inbox Rules מספקת את הפלט הבא:

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

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט תוצאת ה-JSON שמתקבל כשמשתמשים בפעולה List Exchange-Siemplify Inbox Rules:

{
  {
    "id": "example_id",
    "name": "Siemplify - Domains List - Delete",
    "priority": 1,
    "is_enabled": True,
    "conditions": {
        "domains": ["EXAMPLE.COM", "EXAMPLE.CO"],
        "addresses": []
    },
    "actions": "move_to_folder"
  }
}

הודעות פלט

הפעולה List Exchange-Siemplify Inbox Rules יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Listed the following rules: LISTED_RULES for the specified mailboxes. Successfully listed NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST.	הפעולה הסתיימה בהצלחה.
Error performing "List Exchange-Siemplify Inbox Rules" action: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה List Exchange-Siemplify Inbox Rules:

שם התוצאה של הסקריפט	ערך
is_success	True או False

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

אפשר להשתמש בפעולה Remove Domains from Exchange-Siemplify Inbox Rules כדי לקבל רשימה של דומיינים כפרמטר, או לעבוד על הישות Domain אם הפרמטרים לא מסופקים. הפעולה הזו זמינה רק ב-Google SecOps בגרסה 5.6 ואילך. אפשר להסיר את הדומיינים שצוינו מהכללים הקיימים.

לפני שמריצים את הפעולה הזו, צריך להגדיר את הרשאות הפעולה הנדרשות.

הפעולה Remove Domains from Exchange-Siemplify Inbox Rules משנה את הכללים הנוכחיים בתיבת הדואר הנכנס של המשתמשים עם EWS.

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

אם לא מגדירים פרמטרים, הפעולה הזו מופעלת על הישות Domain ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Remove Domains from Exchange-Siemplify Inbox Rules (הסרת דומיינים מכללי תיבת הדואר הנכנס של Exchange-Siemplify) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Domains	אופציונלי רשימה של דומיינים להסרה מהכלל, מופרדים בפסיקים. אם לא מגדירים ערך, הפעולה פועלת עם ישויות.
Rule to remove Domains from	חובה כלל להסרת דומיינים. אם לא מגדירים כלל, הפעולה נכשלת. הערכים האפשריים הם: Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete ערך ברירת המחדל הוא Siemplify – Domains List – Move To Junk.
Remove Domains from all available Rules	אופציונלי אם בוחרים באפשרות הזו, הפעולה מחפשת את הדומיינים שצוינו בכל כללי תיבת הדואר הנכנס של Google SecOps. האפשרות הזו לא מסומנת כברירת מחדל.
Mailboxes list to perform on	אופציונלי תנאי סינון שמציין את רשימת תיבות הדואר שבהן תתבצע הפעולה, כדי לשפר את התזמון. הפרמטר הזה מקבל רשימה של כתובות אימייל שמופרדות בפסיקים, כדי לבטל את הסימון של ההודעות כדואר. אם מספקים רשימת תיבות דואר, הפעולה מתעלמת מהפרמטר Perform action in all mailboxes.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה Remove Domains from Exchange-Siemplify Inbox Rules מספקת את הפלט הבא:

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

הודעות פלט

הפעולה Remove Domains from Exchange-Siemplify Inbox Rules יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Removed the following inputs from the corresponding rules: Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	הפעולה הסתיימה בהצלחה.
Error performing "Remove Domains from Siemplify Inbox Rule" action: ERROR_REASON No domains provided in "Domains" parameter, please check action parameters and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Remove Domains from Exchange-Siemplify Inbox Rules:

שם התוצאה של הסקריפט	ערך
is_success	True או False

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

אפשר להשתמש בפונקציה Remove Senders from Exchange-Siemplify Inbox Rules כדי לקבל רשימה של שולחי אימייל כפרמטר, או לעבוד עם הישות User אם הפרמטרים לא מסופקים.

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

לפני שמריצים את הפעולה הזו, צריך להגדיר את הרשאות הפעולה הנדרשות.

הפעולה Remove Senders from Exchange-Siemplify Inbox Rules משנה את הכללים הנוכחיים של תיבת הדואר הנכנס של המשתמשים באמצעות EWS.

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

אם לא מספקים פרמטרים, הפעולה הזו מופעלת על ישות User של Google SecOps.

הוספת נתונים לפעולה

הפעולה Remove Senders from Exchange-Siemplify Inbox Rules (הסרת שולחים מכללי תיבת הדואר הנכנס של Exchange-Siemplify) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Senders	אופציונלי רשימה של כתובות אימייל שמופרדות בפסיקים ויוסרו מהכלל. אם לא מגדירים ערך, הפעולה פועלת עם הישות User.
Rule to remove senders from	חובה כלל להסרת השולחים. אם לא מגדירים כלל, הפעולה נכשלת. הערכים האפשריים הם: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete ערך ברירת המחדל הוא Siemplify – Senders List – Move To Junk.
Remove senders from all available rules	אופציונלי אם האפשרות הזו נבחרה, המערכת תחפש את השולחים שצוינו בכל כללי תיבת הדואר הנכנס ב-Google SecOps. האפשרות הזו לא מסומנת כברירת מחדל.
Should remove senders' domain from the corresponding Domains List rule as well?	אופציונלי אם בוחרים באפשרות הזו, הפעולה מסירה באופן אוטומטי את הדומיינים של כתובות האימייל שצוינו מכללי הדומיין המתאימים. לא מסומן כברירת מחדל.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך ההגדרות הנוכחיות של הסרת ההתאמה האישית. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה Remove Senders from Exchange-Siemplify Inbox Rules מספקת את הפלט הבא:

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

הודעות פלט

הפעולה Remove Senders from Exchange-Siemplify Inbox Rules יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Removed the following inputs from the corresponding rules: Senders: SENDERS_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	הפעולה הסתיימה בהצלחה.
Error performing "Remove Senders from Siemplify Inbox Rule" action: ERROR_REASON No email addresses provided in "Senders" parameter and there are no email addresses in user entities, Please check action inputs and try again.	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Remove Senders from Exchange-Siemplify Inbox Rules:

שם התוצאה של הסקריפט	ערך
is_success	True או False

ביטול החסימה של השולח לפי מזהה ההודעה

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

בפעולה הזו, ביטול הסימון של פריט כדואר מסיר את כתובת האימייל של השולח מרשימת השולחים החסומים. כדי להעביר פריט חזרה לתיקיית הדואר הנכנס, בוחרים את הפרמטר Move items back to Inbox? בפרמטרים של הפעולה.

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

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

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

הפעולה הזו לא מופעלת על ישויות ב-Google SecOps.

הוספת נתונים לפעולה

הפעולה Unblock Sender by Message ID (ביטול חסימת השולח לפי מזהה ההודעה) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Move items back to Inbox?	חובה אם בוחרים באפשרות הזו, הפעולה מעבירה את ההודעות שצוינו בחזרה לתיקייה של תיבת הדואר הנכנס. האפשרות הזו מסומנת כברירת מחדל.
Message IDs	אופציונלי תנאי סינון לביטול הסימון של אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל גם רשימה של מזהי הודעות שמופרדים בפסיקים כדי לבטל את הסימון של אימיילים כדואר. אם מספקים את מזהה ההודעה, הפעולה מתעלמת מהפרמטרים Subject Filter, Sender Filter ו-Recipient Filter
Mailboxes list to perform on	אופציונלי תנאי סינון להפעלת הפעולה ברשימה ספציפית של תיבות דואר כדי לשפר את התזמון. כדי לסמן הודעות מכמה כתובות אימייל כדואר, צריך להזין רשימה של כתובות אימייל שמופרדות בפסיקים. אם מספקים רשימת תיבות דואר, הפעולה מתעלמת מהפרמטר Perform action in all mailboxes.
Folder Name	אופציונלי תיקיית תיבת דואר שבה יתבצע החיפוש של האימייל. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות שממנה יועבר הפריט. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. ערך ברירת המחדל הוא Junk Email.
Subject Filter	אופציונלי תנאי סינון שמציין את נושא האימייל שרוצים לחפש.
Sender Filter	אופציונלי תנאי סינון שמציין את השולח של הודעות האימייל המבוקשות.
Recipient Filter	אופציונלי תנאי סינון שמציין את הנמען של האימיילים המבוקשים.
Unmark All Matching Emails	אופציונלי אם בוחרים באפשרות הזו, הפעולה מבטלת את הסימון של כל הודעות האימייל בתיבת הדואר שתואמות לקריטריונים. אם לא בוחרים באפשרות הזו, הפעולה מבטלת את הסימון רק של הודעת האימייל הראשונה שתואמת לקריטריונים. האפשרות הזו לא מסומנת כברירת מחדל.
Perform action in all mailboxes	אופציונלי אם בוחרים באפשרות הזו, הפעולה חלה על כל תיבות הדואר שאפשר לגשת אליהן דרך הגדרות ההתחזות הנוכחיות. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch	אופציונלי אם בוחרים את הפרמטר Perform action in all mailboxes, הפעולה מתבצעת בקבוצות. הפרמטר הזה מגדיר את מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא 25.
Time Frame (minutes)	אופציונלי תקופה בדקות לחיפוש הודעות אימייל.

פלט של פעולות

הפעולה ביטול חסימת השולח לפי מזהה ההודעה מספקת את הפלט הבא:

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

הודעות פלט

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

הודעת פלט	תיאור ההודעה
NUMBER_OF_EMAILS mails were successfully unmarked as junk. No mails were found matching the search criteria! NUMBER_OF_EMAILS email(s) were unmarked as junk from PROCESSED_MAILBOXES mailboxes (out of ALL_MAILBOXES). Continuing.	הפעולה הסתיימה בהצלחה.
Failed to execute action - Action is fully supported only from Exchange Server version 2013 and above, Please make sure you have the appropriate version configured in Chronicle SOAR.	הפעולה נכשלה. הגרסה של Exchange Server שבה אתם משתמשים לא נתמכת.
Error performing action: ERROR_REASON	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

שם התוצאה של הסקריפט	ערך
is_success	True או False

מחברים

הוראות מפורטות להגדרת מחבר ב-Google SecOps מופיעות במאמר העברת נתונים (מחברים).

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

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

• פרמטרים של הגדרת Exchange EML Connector
• פרמטרים של הגדרת Exchange Mail Connector
• פרמטרים של הגדרת Exchange Mail Connector V2
• פרמטרים של הגדרת אימות OAuth ב-Exchange Mail Connector v2

מחבר Exchange EML

אזהרה: המחבר הזה מיושן. מומלץ להשתמש במקום זאת במחברים Exchange Mail Connector v2 ו-Exchange Mail Connector v2 with OAuth.

המחבר Exchange EML Connector מאחזר אימיילים משרת Exchange ומנתח אותם. אם יש קובצי EML מצורפים, המחבר מצרף אותם לתיק כאירועים. אם יש כמה קבצים מצורפים בפורמט EML באימייל, המחבר יוצר כמה מקרים ומטמיע כל קובץ מצורף כאירוע אחד לכל מקרה.

הגבלות ידועות

1. ‫Microsoft 365 ואימות בסיסי.

   • מחבר ה-EML של Exchange לא תומך יותר באימות בסיסי, ואי אפשר להשתמש בו עם Microsoft 365. ב-Microsoft 365, משתמשים במחבר הדואר של Exchange בגרסה 2 עם OAuth.

2. אלה הפרטים הספציפיים של מחבר Exchange EML:

   • המחבר יוצר התראות ב-Google SecOps רק מאימיילים שמכילים קבצים מצורפים מסוג EML או MSG.

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

כניסות קלט של מחברים

מחבר Exchange EML דורש את הפרמטרים הבאים:

פרמטר	תיאור
Product Field Name	חובה שם השדה שבו מאוחסן שם המוצר. ערך ברירת המחדל הוא device_product.
EventClassId	חובה שם השדה שמשמש לקביעת שם האירוע (סוג משנה). ערך ברירת המחדל הוא event_name.
Server IP	חובה כתובת ה-IP של השרת שאליו רוצים להתחבר.
Domain	חובה ערך דומיין לשימוש באימות.
Username	חובה שם משתמש לתיבת הדואר שממנה יימשכו האימיילים, למשל [e-mail].
Password	חובה סיסמה לתיבת הדואר שאליה רוצים למשוך אימיילים.
Mail Address	חובה כתובת האימייל של תיבת הדואר שרוצים לעקוב אחריה. ערך ברירת המחדל הוא Inbox.
Verify SSL	אופציונלי אם האפשרות הזו נבחרה, האינטגרציה בודקת שאישור ה-SSL לחיבור לשרת Exchange תקף. האפשרות הזו לא מסומנת כברירת מחדל.
Use Domain for Authentication	אופציונלי אם בוחרים באפשרות הזו, השילוב משתמש בדומיין כחלק מפרטי האימות, כמו user@domain. האפשרות הזו מסומנת כברירת מחדל.
Unread Emails Only	אופציונלי אם בוחרים באפשרות הזו, בקשות תמיכה נוצרות רק מאימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Mark Emails as Read	אופציונלי אם בוחרים באפשרות הזו, האימיילים מסומנים כאימיילים שנקראו אחרי ההטמעה. האפשרות הזו לא מסומנת כברירת מחדל.
Max Days Backwards	אופציונלי מספר הימים לפני האיטרציה הראשונה של המחבר שממנה יאוחזרו האימיילים. הפרמטר הזה חל רק פעם אחת על האיטרציה הראשונית של המחבר אחרי שמפעילים אותו בפעם הראשונה.
PythonProcessTimeout	חובה מגבלת הזמן הקצוב בשניות לתהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא 30 שניות.
Folder Name	אופציונלי שם התיקייה שרוצים להריץ בה חיפוש. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. ערך ברירת המחדל הוא Inbox.
Environment Field Name	אופציונלי שם השדה שבו מאוחסן שם הסביבה. אם השדה environment לא נמצא, הסביבה מוגדרת ל-"".
Environment Regex Pattern	אופציונלי תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לכם לשנות את השדה environment באמצעות הלוגיקה של הביטוי הרגולרי. משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הנדרש Environment Field Name. אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא סביבת ברירת המחדל.
Encode Data as UTF-8	אופציונלי אם האפשרות הזו נבחרה, השילוב מקודד את נתוני האימייל באמצעות UTF-8. מומלץ לבחור את הפרמטר הזה. האפשרות הזו מסומנת כברירת מחדל.
Attach EML or MSG File to the Case Wall	אופציונלי אם בוחרים באפשרות הזו, השילוב מצרף את קובץ ה-EML או ה-MSG שהועבר לקיר של ה-Case ב-Google SecOps. לא מסומן כברירת מחדל.
Exclusion Body Regex	אופציונלי ביטוי רגולרי להחרגת אימיילים שהתוכן שלהם תואם לערך שצוין. לדוגמה, הביטוי הרגולרי '([N|n]ewsletter)|([O|o]ut of office)' מחריג את כל האימיילים שמכילים את מילות המפתח ניוזלטר או לא בעבודה.
Proxy Server Address	אופציונלי הכתובת של שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username	אופציונלי שם המשתמש ב-proxy לאימות.
Proxy Password	אופציונלי סיסמת ה-proxy לאימות.
Extract urls from HTML email part?	אופציונלי אם האפשרות הזו נבחרה, המחבר ינסה לחלץ כתובות URL מחלק ה-HTML של האימייל. הפרמטר הזה מאפשר גם למחבר לחלץ כתובות URL מורכבות, אבל לא את כתובות ה-URL מחלק הטקסט הפשוט של האימייל. כתובות ה-URL שחולצו זמינות בשדה האירוע urls_from_html_part. האפשרות הזו לא מסומנת כברירת מחדל.

כללים של Connectors

• מחבר ה-EML של Exchange לא תומך בכללים של רשימת חסימה ורשימה דינמית.

• מחבר Exchange EML תומך בשרתי proxy.

מחבר אימייל של Exchange

אזהרה: המחבר הזה מיושן. במקום זאת, מומלץ להשתמש בExchange Mail Connector v2 וב-Exchange Mail Connector v2 עם OAuth.

להשתמש במחבר האימייל של Exchange כדי לתקשר עם שרת Exchange ולחפש אימיילים כמעט בזמן אמת, ולהעביר אותם לתרגום ולמתן הקשר כהתראות בתיקי Google SecOps.

בקטע הזה מוסבר איך Google SecOps מתקשר עם ממשק הדואר של Exchange, עם תהליכי העבודה והפעילויות שמתבצעים בעזרת המערכת באפליקציה, ועם שרת Microsoft Exchange 2007-2019 או Microsoft 365 באמצעות Exchange Web Services ‏ (EWS).

המחבר של Exchange Mail מאפשר לאחזר אימיילים משרת Exchange שהוגדר, לסרוק כל שרת וליצור מקרים חדשים. לפחות מופע אחד של אימייל ראשוני נכלל בכל תרחיש. ההבדל העיקרי הוא שExchange Mail connector מסיר אימיילים ויוצר אירועים שמנתחים את נתוני ה-EML או ה-MSG באימיילים המקוריים של שרת Exchange.

הגבלות ידועות

1. ‫Microsoft 365 ואימות בסיסי.

   • מחבר הדואר של Exchange לא תומך יותר באימות בסיסי, ואי אפשר להשתמש בו עם Microsoft 365. ב-Microsoft 365, משתמשים במחבר הדואר של Exchange בגרסה 2 עם OAuth.

2. אלה הדרישות הספציפיות של מחבר האימייל של Exchange:

   • המחבר יוצר התראות ב-Google SecOps רק מהודעות אימייל מקוריות שהתקבלו ונמצאות בתיבת הדואר.

   • המחבר מתעלם מקובצי EML ו-MSG מצורפים.

כניסות קלט של מחברים

מחבר הדואר של Exchange דורש את הפרמטרים הבאים:

פרמטר	תיאור
Product Field Name	חובה שם השדה שבו מאוחסן שם המוצר. ערך ברירת המחדל הוא device_product.
Event Field Name	חובה שם השדה שמשמש לקביעת שם האירוע (סוג משנה). ערך ברירת המחדל הוא event_name.
Server IP	חובה כתובת ה-IP של השרת שאליו רוצים להתחבר.
Domain	חובה ערך דומיין לשימוש באימות.
Username	חובה שם משתמש לתיבת הדואר שממנה ייאחזרו האימיילים, למשל [e-mail].
Password	חובה סיסמה לתיבת הדואר שאליה רוצים למשוך אימיילים.
Mail Address	חובה כתובת האימייל של תיבת הדואר שרוצים לעקוב אחריה. ערך ברירת המחדל הוא Inbox.
Verify SSL	אופציונלי אם האפשרות הזו נבחרה, האינטגרציה בודקת שאישור ה-SSL לחיבור לשרת Exchange תקף. האפשרות הזו לא מסומנת כברירת מחדל.
Use Domain for Authentication	אופציונלי אם בוחרים באפשרות הזו, הדומיין משמש כחלק מפרטי האימות, כמו user@domain. האפשרות הזו מסומנת כברירת מחדל.
Unread Emails Only	אופציונלי אם האפשרות הזו נבחרה, השילוב יוצר בקשות תמיכה רק מאימיילים שלא נקראו. האפשרות הזו מסומנת כברירת מחדל.
Mark Emails as Read	אופציונלי אם האפשרות הזו נבחרה, האינטגרציה מסמנת את כל האימיילים שנקלטים כאימיילים שנקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Max Days Backwards	אופציונלי מספר הימים לפני האיטרציה הראשונה של המחבר שממנה יאוחזרו האימיילים. הפרמטר הזה חל רק פעם אחת על האיטרציה הראשונית של המחבר אחרי שמפעילים אותו בפעם הראשונה.
PythonProcessTimeout	חובה מגבלת הזמן הקצוב בשניות לתהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא 30 שניות.
Attach Original EML	אופציונלי אם האפשרות הזו נבחרה, האימייל המקורי מצורף לפנייה כקובץ EML. האפשרות הזו לא מסומנת כברירת מחדל.
Folder Name	אופציונלי שם התיקייה שרוצים להריץ בה חיפוש. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. ערך ברירת המחדל הוא Inbox.
Environment Field Name	אופציונלי שם השדה שבו מאוחסן שם הסביבה. אם השדה environment לא נמצא, הסביבה מוגדרת ל-"".
Environment Regex Pattern	אופציונלי תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לכם לשנות את השדה environment באמצעות הלוגיקה של הביטוי הרגולרי. משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הנדרש Environment Field Name. אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא סביבת ברירת המחדל.
Exclusion Subject Regex	אופציונלי ביטוי רגולרי להחרגת אימיילים עם נושא שתואם לערך שצוין. לדוגמה, הביטוי הרגולרי ([N|n]ewsletter)|([O|o]ut of office) מחריג את כל האימיילים שהנושא שלהם כולל את מילות המפתח ניוזלטר או לא בעבודה.
Exclusion Body Regex	אופציונלי ביטוי רגולרי להחרגת אימיילים שהתוכן שלהם תואם לערך שצוין. לדוגמה, הביטוי הרגולרי ([N|n]ewsletter)|([O|o]ut of office) מחריג את כל הודעות האימייל שמכילות את מילות המפתח ניוזלטר או לא בעבודה בתוכן האימייל.
Proxy Server Address	אופציונלי כתובת של שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username	אופציונלי שם משתמש לשרת proxy לצורך אימות.
Proxy Password	אופציונלי סיסמת proxy לאימות.
Extract urls from HTML email part?	אופציונלי אם בוחרים באפשרות הזו, המחבר מנסה לחלץ כתובות URL מחלק ה-HTML של האימייל. הפרמטר הזה מאפשר למחבר לחלץ כתובות URL מורכבות, אבל לא כתובות URL מחלק הטקסט הפשוט של האימייל. כתובות ה-URL שחולצו זמינות בשדה האירוע urls_from_html_part. האפשרות הזו לא מסומנת כברירת מחדל.

הגדרת כללים לרשימה דינמית

בקטע של הרשימה הדינמית, כדי לחלץ ערכים ספציפיים מאימיילים באמצעות ביטויים רגולריים, מוסיפים כלל בפורמט הבא:

'<var>FIELD_NAME</var>': '<var>REGULAR_EXPRESSION</var>'

לדוגמה, כדי לחלץ את מזהה ההודעה מאימייל, מזינים את הכלל הבא:

message-id: (?<=Message-ID: ).*

כללים של Connectors

• המחבר של Exchange Mail תומך בשרתי proxy.

• מחבר הדואר של Exchange לא תומך בכלל של רשימת חסימה.

• השילוב עם Exchange משתמש בקטע של הרשימה הדינמית כדי להגדיר ביטויים רגולריים ולאפשר את הפעולות הבאות:

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

מחבר אימייל של Exchange גרסה 2

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

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

אם אין אימיילים חדשים, Exchange Mail Connector v2 משלים את האיטרציה הנוכחית וממתין למשך תקופה מוגדרת לפני הפעלת האיטרציה הבאה.

רשימת השלבים של איטרציה של מחבר

אחרי כל הפעלה, Exchange Mail Connector v2 מעדכן את קובץ חותמת הזמן עם התאריך והשעה של ההפעלה האחרונה. ‫Exchange Mail Connector v2 מחולץ מהאימייל מידע שניתן לפעול לפיו לגבי מקרה, כתוצאה טכנית של אובייקט אימייל, כולל, בין היתר:

• השולח והנמען של האימייל.
• נושא האימייל.
• תוכן האימייל.
• כתובות URL באימייל.
• קבצים מצורפים, אם יש כאלה.

אחרי ש-Exchange Mail Connector v2 יוצר את ההתראות (האירועים) להעברה אל Google SecOps, האיטרציה של המחבר מסתיימת.

על סמך נתוני האירועים שסופקו על ידי Exchange Mail Connector v2, שרת Google SecOps מריץ נהלי ETL כדי להטמיע התראות חדשות וליצור או לעדכן אירועים. אם מוגדרים Playbook קשורים,‏ Google SecOps מפעיל Playbook כדי להוסיף מידע למקרה, ליצור תובנות ולבצע פעולות אוטומטיות.

עבודה עם תבנית שם ההתראה ותבנית שם האירוע

הפרמטרים Alert Name Template ו-Case Name Template מאפשרים לכם להחליף את האופן שבו נוצרים השם של ההתראה והשם של הכרטיס. רק ההתראה הראשונה קובעת את השם של הכרטיס או של ההתראה, וכל ההתראות הבאות לא משפיעות על השם.

דוגמה לאירוע ב-Google SecOps:

{
    "event": {
        "type": "Phishing"
        "name": "Example Event",
        "id": "1"
    }
}

כדי ליצור שם בהתאמה אישית להתראה ב-Google SecOps, משתמשים בתבנית הבאה:

[EVENT_TYPE] - [EVENT_NAME]

לדוגמה, כדי ליצור התראה ב-Google SecOps בשם Phishing – Example Event, התבנית תהיה כזו:

[Phishing] - [Example Event]

כניסות קלט של מחברים

ב-Exchange Mail Connector v2, הפרמטרים הבאים יכולים להשפיע על עיבוד האימייל:

• Original Received Mail Prefix
• Attached Mail File Prefixes
• Create a Separate Siemplify Alert per Attached Mail File?

כדי למפות את השדות to ו-from של האימיילים שעברו עיבוד, המחבר יוצר את קבוצות השדות הבאות:

1. שדות רגילים to ו-from שמכילים כתובות אימייל בפורמט הבא: email@example.

2. השדות to_raw ו-from_raw שמכילים רק כתובת אימייל כערך בפורמט הבא: email@example.

Exchange Mail Connector v2 דורש את הפרמטרים הבאים:

פרמטר	תיאור
Product Field Name	חובה שם השדה שבו מאוחסן שם המוצר. ערך ברירת המחדל הוא device_product.
Event Field Name	חובה שם השדה שמשמש לקביעת שם האירוע (סוג משנה). ערך ברירת המחדל הוא event_name.
Mail Server Address	חובה כתובת ה-IP של שרת הדואר שאליו רוצים להתחבר. כשמתחברים ל-Microsoft 365, צריך להגדיר את כתובת השרת ל-outlook.office365.com.
Verify SSL	אופציונלי אם האפשרות הזו נבחרה, האינטגרציה בודקת שאישור ה-SSL לחיבור לשרת Exchange תקף. האפשרות הזו לא מסומנת כברירת מחדל.
Mail Address	חובה כתובת האימייל של תיבת הדואר שרוצים לעקוב אחריה. ערך ברירת המחדל הוא Inbox.
Use Domain for Authentication	אופציונלי אם בוחרים באפשרות הזו, הדומיין משמש כחלק מפרטי האימות, כמו user@domain. האפשרות הזו מסומנת כברירת מחדל.
Domain	חובה ערך דומיין לשימוש באימות.
Username	חובה שם המשתמש של תיבת הדואר שממנה ייאספו האימיילים, למשל [e-mail].
Password	חובה הסיסמה של תיבת הדואר שאליה רוצים למשוך אימיילים.
Unread Emails Only	אופציונלי אם בוחרים באפשרות הזו, בקשות תמיכה נוצרות רק מאימיילים שלא נקראו. האפשרות הזו מסומנת כברירת מחדל.
Mark Emails as Read	אופציונלי אם בוחרים באפשרות הזו, האימיילים מסומנים כאימיילים שנקראו אחרי ההטמעה. האפשרות הזו לא מסומנת כברירת מחדל.
Offset Time In Days	חובה מספר הימים לפני האיטרציה הראשונה של המחבר שממנה יאוחזרו האימיילים. הפרמטר הזה חל רק פעם אחת על האיטרציה הראשונית של המחבר אחרי שמפעילים אותו בפעם הראשונה. ערך ברירת המחדל הוא 5.
Max Emails Per Cycle	חובה מספר האימיילים לאחזור באיטרציה אחת של המחבר. ערך ברירת המחדל הוא 10.
Environment Field Name	אופציונלי שם השדה שבו מאוחסן שם הסביבה. אם השדה environment לא נמצא, הסביבה מוגדרת ל-"".
Environment Regex Pattern	אופציונלי תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לכם לשנות את השדה environment באמצעות הלוגיקה של הביטוי הרגולרי. משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הנדרש Environment Field Name. אם תבנית הביטוי הרגיל היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא "".
Headers to add to events	אופציונלי מחרוזת מופרדת בפסיקים שמציינת אילו כותרות אימייל להוסיף לאירועים. אפשר לספק ערכים כהתאמות מדויקות או להגדיר אותם כביטוי רגולרי.
Email Exclude Pattern	אופציונלי ביטוי רגולרי להחרגה של אימיילים ספציפיים מהטמעה. הפרמטר הזה פועל גם עם הנושא וגם עם גוף האימייל. אפשר להשתמש בפרמטר הזה כדי להחריג הטמעה של אימיילים שנשלחים להרבה נמענים, כמו ניוזלטרים.
PythonProcessTimeout	חובה מגבלת הזמן הקצוב בשניות לתהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא 60 שניות.
Folder to check for emails	חובה תיקיית אימייל שבה יתבצע החיפוש של האימיילים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. הפרמטר הזה הוא תלוי אותיות רישיות. ערך ברירת המחדל הוא Inbox.
Attach Original EML	אופציונלי אם בוחרים באפשרות הזו, האינטגרציה מצרפת את האימייל המקורי לפנייה לתמיכה כקובץ EML. האפשרות הזו לא מסומנת כברירת מחדל.
Fetch Backwards Time Interval (minutes)	אופציונלי מרווח הזמן שבו המחבר משתמש כדי לאחזר אירועים מהתקופה שהוגדרה בדקות לפני עכשיו. הערך של הפרמטר הזה הוא חותמת זמן של האיטרציה האחרונה של המחבר. צריך לשנות את הערך בהתאם לסביבה, למשל 60 דקות או פחות. ערך ברירת המחדל הוא 0.
Proxy Server Address	אופציונלי כתובת של שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username	אופציונלי שם משתמש לשרת proxy לצורך אימות.
Proxy Password	אופציונלי סיסמת proxy לאימות.
Extract urls from HTML email part?	אופציונלי אם בוחרים באפשרות הזו, המחבר מנסה לחלץ כתובות URL מחלק ה-HTML של האימייל. הפרמטר הזה מאפשר למחבר לחלץ כתובות URL מורכבות, אבל לא כתובות URL מחלק הטקסט הפשוט של האימייל. כתובות ה-URL שחולצו זמינות בשדה האירוע urls_from_html_part. האפשרות הזו לא מסומנת כברירת מחדל.
Disable Overflow	אופציונלי אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון הגלישה. האפשרות הזו לא מסומנת כברירת מחדל.
Original Received Mail Prefix	אופציונלי קידומת להוספה למפתחות האירועים שחולצו, למשל to,‏ from או subject מהאימייל המקורי שהתקבל בתיבת הדואר הנכנס שבמעקב. ערך ברירת המחדל הוא orig.
Attached Mail File Prefix	אופציונלי קידומת להוספה למפתחות האירועים שחולצו, למשל to,‏ from או subject מקובץ האימייל המצורף שהתקבל בתיבת הדואר המפוקחת. ערך ברירת המחדל הוא attach.
Create a Separate Siemplify Alert per Attached Mail File?	אופציונלי אם בוחרים באפשרות הזו, המחבר יוצר כמה התראות, התראה אחת לכל קובץ אימייל מצורף. אם בוחרים את הפרמטר הזה, Google SecOps מעבד אימיילים עם כמה קבצים מצורפים ויוצר ישויות מהקבצים המצורפים. האפשרות הזו לא מסומנת כברירת מחדל.
Case Name Template	אופציונלי שם מותאם אישית של בקשת התמיכה. כשמגדירים את הפרמטר הזה, המחבר מוסיף מפתח חדש בשם custom_case_name לאירוע ב-Google SecOps. אפשר לספק את משתני המיקום בפורמט הבא: [name of the field]. דוגמה: Phishing - [event_mailbox] במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps. המחבר מעבד רק מפתחות שמכילים את ערך המחרוזת.
Alert Name Template	אופציונלי שם של התראה מותאמת אישית. אפשר לספק את משתני המיקום בפורמט הבא: [name of the field]. דוגמה: Phishing - [event_mailbox] במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps. מטפלים רק במפתחות שמכילים את המחרוזת value. אם לא תספקו ערך או תבנית לא תקינה, המחבר ישתמש בשם ברירת המחדל של ההתראה.
Email Padding Period (minutes)	אופציונלי תקופה שבה המחבר מאחזר אימיילים לפני חותמת הזמן האחרונה.
URL Regex	חובה מחבר הביטויים הרגולריים שמשמש לניתוח כתובות URL מתוך האימיילים שעברו עיבוד.
Event Fields to Exclude	אופציונלי רשימה מופרדת בפסיקים של שדות שצריך להחריג מאירועים.
Exclude Attachments	אופציונלי אם האפשרות הזו נבחרה, המחבר לא קולט קבצים מצורפים לאימייל ולא מוסיף אותם לתיקים.

כללים של Connectors

• ‫Exchange Mail Connector v2 תומך בשרת proxy.

• Exchange Mail Connector v2 לא תומך בכלל של רשימת חסימה.

• השילוב עם Exchange משתמש בקטע של הרשימה הדינמית כדי להגדיר ביטויים רגולריים שיאפשרו את הפעולות הבאות:

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

Exchange Mail Connector v2 באימות OAuth

משתמשים בExchange Mail Connector v2 עם OAuth כדי לעקוב אחרי תיבות דואר ספציפיות בשרתי דואר של Microsoft 365 שנדרש בהם אימות OAuth. אתם יכולים להשתמש בפעולות Get Authorization ו-Generate Token כדי לקבל את טוקן הרענון שנדרש להגדרת המחבר.

כדי להפעיל את Exchange Mail Connector v2 עם OAuth, צריך להגדיר את השילוב כך שיתמוך באימות OAuth.

עבודה עם תבנית שם ההתראה ותבנית שם האירוע

הפרמטרים Alert Name Template ו-Case Name Template מאפשרים לכם להחליף את האופן שבו נוצר השם של ההתראה ושל הכרטיס.

דוגמה לאירוע ב-Google SecOps:

{
    "event": {
        "type": "Phishing"
        "name": "Example Event",
        "id": "1"
    }
}

כדי ליצור שם בהתאמה אישית להתראה ב-Google SecOps, משתמשים בתבנית הבאה:

[EVENT_TYPE] - [EVENT_NAME]

לדוגמה, כדי ליצור התראה ב-Google SecOps בשם Phishing – Example Event, התבנית תהיה כזו:

[Phishing] - [Example Event]

כניסות קלט של מחברים

ב-Exchange Mail Connector v2 with OAuth, הפרמטרים הבאים יכולים להשפיע על עיבוד האימייל:

• Original Received Mail Prefix
• Attached Mail File Prefixes
• Create a Separate Siemplify Alert per Attached Mail File?

כדי למפות את השדות to ו-from של האימיילים שעברו עיבוד, המחבר יוצר את שני סטים השדות הבאים:

1. שדות רגילים to ו-from שמכילים כתובות אימייל, כמו email@example.

2. השדות to_raw ו-from_raw מכילים רק כתובת אימייל כערך, כמו email@example.

מחבר הדואר של Exchange v2 עם OAuth דורש את הפרמטרים הבאים:

פרמטר	תיאור
Product Field Name	חובה שם השדה שבו מאוחסן שם המוצר. ערך ברירת המחדל הוא device_product.
Event Field Name	חובה שם השדה שמשמש לקביעת שם האירוע (סוג משנה). ערך ברירת המחדל הוא event_name.
Mail Server Address	חובה כתובת ה-IP של שרת הדואר שאליו רוצים להתחבר. כשמתחברים ל-Microsoft 365, צריך להגדיר את כתובת השרת ל-outlook.office365.com.
Mail Address	חובה כתובת אימייל לשימוש במחבר.
Client ID	חובה לאימות OAuth ב-Microsoft 365, מזהה אפליקציה (לקוח) של אפליקציית Microsoft Entra שבה השתמשתם לשילוב.
Client Secret	חובה באימות OAuth ב-Microsoft 365, סוד הלקוח שסיפקתם לתהליך האימות.
Tenant (Directory) ID	חובה לצורך אימות OAuth ב-Microsoft 365, צריך להזין את מזהה הדייר (הספרייה) של אפליקציית Microsoft Entra שבה השתמשתם לשילוב.
Refresh Token	חובה באימות OAuth של Microsoft 365, טוקן הרענון מתקבל אחרי יצירת טוקן.
Verify SSL	אופציונלי אם האפשרות הזו נבחרה, האינטגרציה בודקת שאישור ה-SSL לחיבור לשרת Exchange תקף. לא מסומן כברירת מחדל.
Unread Emails Only	אופציונלי אם האפשרות הזו נבחרה, השילוב יוצר בקשות תמיכה רק מאימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Mark Emails as Read	אופציונלי אם בוחרים באפשרות הזו, המחבר מסמן את האימיילים שהועברו כאימיילים שנקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Offset Time In Days	חובה מספר הימים לפני האיטרציה הראשונה של המחבר שממנה יאוחזרו האימיילים. הפרמטר הזה חל רק פעם אחת על האיטרציה הראשונית של המחבר אחרי שמפעילים אותו בפעם הראשונה. ערך ברירת המחדל הוא 5 ימים.
Max Emails Per Cycle	חובה מספר האימיילים לאחזור באיטרציה אחת של המחבר. ערך ברירת המחדל הוא 10 אימיילים.
Environment Field Name	אופציונלי שם השדה שבו מאוחסן שם הסביבה. אם השדה environment לא נמצא, הסביבה מוגדרת ל-"".
Environment Regex Pattern	אופציונלי תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לכם לשנות את השדה environment באמצעות הלוגיקה של הביטוי הרגולרי. משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הנדרש Environment Field Name. אם תבנית הביטוי הרגיל היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא "".
Headers to add to events	אופציונלי מחרוזת מופרדת בפסיקים שמציינת אילו כותרות אימייל להוסיף לאירועים. אפשר לספק ערכים כהתאמות מדויקות או להגדיר אותם כביטוי רגולרי.
Email Exclude Pattern	אופציונלי ביטוי רגולרי להחרגה של אימיילים ספציפיים מהטמעה. הפרמטר הזה פועל גם עם הנושא וגם עם גוף האימייל. אפשר להשתמש בפרמטר הזה כדי להחריג הטמעה של אימיילים שנשלחים להרבה נמענים, כמו ניוזלטרים.
PythonProcessTimeout	חובה מגבלת הזמן הקצוב בשניות לתהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא 60.
Folder to check for emails	חובה תיקיית אימייל שבה יתבצע החיפוש של האימיילים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות. השילוב עם Exchange משתמש בלוכסנים הפוכים כמפרידים כדי לציין תיקיות משנה, כמו folder/subfolder1/subfolder2. כדי להימנע משגיאת הזמן הקצוב לתפוגה או משגיאה בפעולה, צריך להחליף את הקווים הנטויים ההפוכים בשמות של תיקיות או תיקיות משנה בתווים אחרים, כמו קו תחתון. הפרמטר הזה הוא תלוי אותיות רישיות. ערך ברירת המחדל הוא Inbox.
Attach Original EML	אופציונלי אם האפשרות הזו נבחרה, האימייל המקורי מצורף לפנייה כקובץ EML. האפשרות הזו לא מסומנת כברירת מחדל.
Fetch Backwards Time Interval (minutes)	אופציונלי מרווח הזמן שבו המחבר משתמש כדי לאחזר אירועים מהתקופה שהוגדרה בדקות לפני עכשיו. הערך של הפרמטר הזה הוא חותמת זמן של האיטרציה האחרונה של המחבר. צריך לשנות את הערך בהתאם לסביבה, למשל 60 דקות או פחות. ערך ברירת המחדל הוא 0.
Proxy Server Address	אופציונלי כתובת של שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username	אופציונלי שם משתמש לשרת proxy לצורך אימות.
Proxy Password	אופציונלי סיסמת proxy לאימות.
Extract urls from HTML email part?	אופציונלי אם בוחרים באפשרות הזו, המחבר מנסה לחלץ כתובות URL מחלק ה-HTML של האימייל. הפרמטר הזה מאפשר למחבר לחלץ כתובות URL מורכבות, אבל לא כתובות URL מחלק הטקסט הפשוט של האימייל. כתובות ה-URL שחולצו זמינות בשדה האירוע urls_from_html_part. האפשרות הזו לא מסומנת כברירת מחדל.
Disable Overflow	אופציונלי אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון הגלישה. האפשרות הזו לא מסומנת כברירת מחדל.
Original Received Mail Prefix	אופציונלי קידומת להוספה למפתחות האירועים שחולצו, למשל to,‏ from או subject מהאימייל המקורי שהתקבל בתיבת הדואר הנכנס שבמעקב. ערך ברירת המחדל הוא orig.
Attached Mail File Prefix	אופציונלי קידומת להוספה למפתחות האירועים שחולצו, למשל to,‏ from או subject מקובץ האימייל המצורף שהתקבל בתיבת הדואר המפוקחת. ערך ברירת המחדל הוא attach.
Create a Separate Siemplify Alert per Attached Mail File?	אופציונלי אם בוחרים באפשרות הזו, המחבר יוצר כמה התראות, התראה אחת לכל קובץ אימייל מצורף. אם בוחרים את הפרמטר הזה, Google SecOps מעבד אימיילים עם כמה קבצים מצורפים ויוצר ישויות מהקבצים המצורפים. האפשרות הזו לא מסומנת כברירת מחדל.
Case Name Template	אופציונלי שם מותאם אישית של בקשת התמיכה. כשמגדירים את הפרמטר הזה, המחבר מוסיף מפתח חדש בשם custom_case_name לאירוע ב-Google SecOps. אפשר לספק את משתני המיקום בפורמט הבא: [name of the field]. דוגמה: Phishing - [event_mailbox] במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps. המחבר מעבד רק מפתחות שמכילים את ערך המחרוזת.
Alert Name Template	אופציונלי פרמטר להגדרת שם התראה מותאמת אישית. שם של התראה מותאמת אישית. אפשר לספק את משתני המיקום בפורמט הבא: [name of the field]. דוגמה: Phishing - [event_mailbox] במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps. מטפלים רק במפתחות שמכילים את המחרוזת value. אם לא תספקו ערך או תבנית לא תקינה, המחבר ישתמש בשם ברירת המחדל של ההתראה.
Email Padding Period (minutes)	אופציונלי תקופה שבה המחבר מאחזר אימיילים לפני חותמת הזמן האחרונה.
Event Fields to Exclude	אופציונלי רשימה מופרדת בפסיקים של שדות שצריך להחריג מאירועים.
Exclude Attachments	אופציונלי אם האפשרות הזו נבחרה, המחבר לא קולט קבצים מצורפים לאימייל ולא מוסיף אותם לתיקים.

תעסוקה

לפני שמגדירים משימות לשילוב עם Exchange, צריך לוודא שהגרסה של פלטפורמת Google SecOps תומכת בהן.

משימת חידוש של טוקן רענון

אזהרה: העבודה הזו נתמכת רק בגרסה 6.2.35 ואילך של פלטפורמת Google SecOps. אם מריצים את העבודה הזו בגרסה קודמת של הפלטפורמה, העבודה נכשלת.

המטרה של Refresh Token Renewal Job היא לעדכן מעת לעת את טוקן הרענון שמשמש בשילוב.

כברירת מחדל, תוקף טוקן הרענון פג כל 90 יום. מומלץ להריץ את העבודה הזו כל 7 או 14 ימים כדי לוודא שהאסימון לרענון עדכני.

נתוני משרות

ל-Refresh Token Renewal Job נדרשים הפרמטרים הבאים:

פרמטר	תיאור
Integration Environments	אופציונלי סביבות השילוב שהמשימה מעדכנת את טוקני הרענון שלהן. הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת באמצעות פסיקים. תוחמים כל ערך במירכאות (" ").
Connector Names	אופציונלי שמות המחברים שעבורם העבודה מעדכנת את אסימוני הרענון. הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת באמצעות פסיקים. תוחמים כל ערך במירכאות (" ").

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