האצלת הגישה לאימייל ב-Microsoft Graph
לפני שמתחילים
לפני שמגדירים את השילוב של Microsoft Graph Mail Delegated:
יצירת האפליקציה ב-Microsoft Entra
כדי ליצור את אפליקציית Microsoft Entra:
נכנסים לפורטל Azure כאדמין של משתמשים או כאדמין של סיסמאות.
בוחרים באפשרות Microsoft Entra ID.
עוברים אל App registrations > New registration.
מזינים את שם האפליקציה.
בוחרים את סוגי החשבונות הנתמכים המתאימים.
מגדירים את
Redirect URIעם הערכים הבאים:פלטפורמה:
Webכתובת URL להפניה אוטומטית:
http://localhost
לוחצים על הרשמה.
במסמך הזה מובאת דוגמה לשימוש בהגדרה של דייר יחיד. השילוב הזה משתמש בהרשאה באמצעות קוד של OAuth 2.0, ולכן מתרחש תהליך אינטראקטיבי של כניסת משתמשים. לכן, צריך
Redirect URIבמהלך תהליך ההגדרה.שומרים את הערכים של Application (client) ID ו-Directory (tenant) ID כדי להגדיר את Integration Parameters.
הגדרת הרשאות API
כדי להגדיר את הרשאות ה-API לשילוב:
בפורטל Azure, עוברים אל API Permissions > Add a permission.
בוחרים באפשרות Microsoft Graph > Delegated permissions (הרשאות שהוקצו).
בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:
Mail.ReadMail.ReadWriteMail.SendUser.ReadDirectory.Read.All
לוחצים על הוספת הרשאות.
לוחצים על Grant admin consent for
ORGANIZATION_NAME(מתן הסכמה של אדמין עבור ).כשמופיעה תיבת הדו-שיח Grant admin consent confirmation, לוחצים על Yes.
יצירת סוד לקוח
כדי ליצור סוד לקוח:
עוברים אל Certificates and secrets > New client secret.
מזינים תיאור של סוד הלקוח ומגדירים את תאריך התפוגה שלו.
לוחצים על הוספה.
שומרים את הערך של סוד הלקוח (לא את מזהה הסוד) כדי להשתמש בו בתור ערך הפרמטר Client Secret Value כשמגדירים את השילוב. הערך של סוד הלקוח מוצג רק פעם אחת.
יצירת טוקן רענון
כדי ליצור טוקן רענון, מבצעים את השלבים הבאים:
מגדירים את Integration Parameters (פרמטרים של שילוב) (חוץ מהפרמטר
Refresh Token) ושומרים אותם.אופציונלי: מדמים בקשה ב-Google SecOps.
מפעילים את הפעולה Get Authorization.
מריצים את הפעולה Generate Token.
מגדירים את הפרמטר
Refresh Token.
אופציונלי: סימולציה של פנייה לתמיכה
כדי ליצור טוקן רענון, צריך להריץ פעולות ידניות בכל בקשה. אם מכונת Google SecOps חדשה ואין בה אירועים קיימים, צריך לדמות אירוע.
כדי לדמות פנייה ב-Google SecOps, מבצעים את השלבים הבאים:
בחלונית הניווט שמימין, לוחצים על Cases.
בדף Cases, לוחצים על add Add a Case > Simulate Cases.
בוחרים באחד מהמקרים שמוגדרים כברירת מחדל ולוחצים על יצירה. לא משנה איזה מקרה תבחרו לדמות.
לוחצים על Simulate.
אם יש לכם סביבה אחרת שאינה ברירת המחדל ואתם רוצים להשתמש בה, בחרו את הסביבה הנכונה ולחצו על Simulate.
בכרטיסייה Cases, לוחצים על Refresh. בקשת התמיכה שדימיתם מופיעה ברשימת בקשות התמיכה.
מפעילים את הפעולה "קבלת הרשאה"
כדי להפעיל ידנית את הפעולה Get Authorization:
בכרטיסייה Cases, בוחרים בקשת תמיכה כלשהי או משתמשים בבקשת התמיכה המדומה כדי לפתוח את Case View.
ב-Case View, לוחצים על
Manual Action.
בשדה חיפוש של הפעולה הידנית, מזינים
Microsoft Graph Mail Delegated.בתוצאות שמתחת לשילוב Microsoft Graph Mail Delegated, לוחצים על Get Authorization. הפעולה הזו מחזירה קישור הרשאה שמשמש לכניסה אינטראקטיבית לאפליקציית Microsoft Entra.
לוחצים על Execute.
אחרי שהפעולה בוצעה, עוברים אל Case Wall (קיר הבקשה) של הבקשה. ברשומת הפעולה Microsoft Graph Mail Delegated_Get Authorization, לוחצים על View More. מעתיקים את הקישור להרשאה.
פותחים חלון דפדפן חדש במצב פרטי ומדביקים את כתובת ה-URL שנוצרה להרשאה. דף הכניסה של Azure נפתח.
נכנסים באמצעות פרטי הכניסה של המשתמש שבהם השתמשתם לשילוב. אחרי הכניסה, הדפדפן יפנה אתכם לכתובת עם קוד בסרגל הכתובות.
הדפדפן אמור להציג שגיאה כי האפליקציה מפנה אתכם אל
http://localhost.מעתיקים את כתובת ה-URL המלאה עם קוד הגישה מסרגל הכתובות.
מריצים את הפעולה Generate Token (יצירת טוקן)
כדי להריץ ידנית את הפעולה Generate Token:
בכרטיסייה Cases, בוחרים בקשת תמיכה כלשהי או משתמשים בבקשת התמיכה המדומה כדי לפתוח את Case View.
בכרטיסייה Case View, לוחצים על
Manual Action.
בשדה חיפוש של הפעולה הידנית, מזינים
Microsoft Graph Mail Delegated.בתוצאות שמתחת לשילוב Microsoft Graph Mail Delegated, לוחצים על Generate Token.
בשדה
Authorization URL, מדביקים את כתובת ה-URL המלאה עם קוד הגישה שהעתקתם אחרי שהפעלתם את הפעולה Get Authentication.לוחצים על Execute.
אחרי שהפעולה בוצעה, עוברים אל Case Wall של הבקשה. ברשומת הפעולה Microsoft Graph Mail Delegated_Generate Token, לוחצים על View More.
מעתיקים את הערך המלא של טוקן הרענון שנוצר.
הגדרת הפרמטר Refresh Token (טוקן רענון)
עוברים לתיבת הדו-שיח של ההגדרות בשילוב Microsoft Graph Mail Delegated.
מזינים את הערך של טוקן הרענון שקיבלתם בפעולה Generate Token בשדה Refresh Token.
לוחצים על Save.
לוחצים על Test כדי לבדוק אם ההגדרה נכונה והשילוב פועל כמו שצריך.
פרמטרים של שילוב
כדי לשלב את Microsoft Graph Mail Delegated, צריך להגדיר את הפרמטרים הבאים:| פרמטר | תיאור |
|---|---|
Microsoft Entra ID Endpoint
|
חובה. נקודת הקצה של Microsoft Entra ID שבה משתמשים בשילוב. הערך יכול להיות שונה בסוגים שונים של דיירים. ערך ברירת המחדל הוא |
Microsoft Graph Endpoint |
חובה. נקודת הקצה של Microsoft Graph שבה משתמשים בשילוב. הערך יכול להיות שונה בסוגים שונים של דיירים. ערך ברירת המחדל הוא |
Client ID |
חובה. מזהה הלקוח (האפליקציה) של אפליקציית Microsoft Entra שרוצים להשתמש בה בשילוב. |
Client Secret Value |
חובה. ערך סוד הלקוח של אפליקציית Microsoft Entra שרוצים להשתמש בה בשילוב. |
Microsoft Entra ID Directory ID
|
חובה. הערך של Microsoft Entra ID (מזהה הדייר). |
User Mailbox
|
חובה. תיבת הדואר שבה רוצים להשתמש בשילוב. |
Refresh Token
|
חובה. טוקן הרענון שמשמש לאימות. |
Redirect URL |
חובה. כתובת ה-URL להפניה אוטומטית שהגדרתם כשיצרתם את האפליקציה ב-Microsoft Entra ID. ערך ברירת המחדל הוא
|
Mail Field Source |
חובה. אם בוחרים באפשרות הזו, השילוב מאחזר את כתובת תיבת הדואר מהמאפיין מופעלת כברירת מחדל. |
Verify SSL |
חובה. אם בוחרים באפשרות הזו, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של Microsoft Graph. מופעלת כברירת מחדל. |
Base64 Encoded Private Key |
זה שינוי אופציונלי. המפתח הפרטי בקידוד Base64 שמשמש לפענוח אימיילים מוצפנים ב-S/MIME. אם מציינים ערך, צריך לציין גם את המאפיין |
Base64 Encoded Certificate |
זה שינוי אופציונלי. האישור בקידוד Base64 שמשמש לפענוח אימיילים שהוצפנו באמצעות S/MIME. אם מציינים ערך, צריך לציין גם את המאפיין |
Base64 Encoded CA certificate |
זה שינוי אופציונלי. אישור ה-CA המהימן בקידוד Base64 לאימות החתימה. אם לא מציינים ערך, אימות החתימה של אימיילים חתומים נכנסים נכשל, אלא אם מפעילים את |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
חסימת הדומיין
אתם יכולים להשתמש בפעולה חסימת דומיין כדי לחסום דומיינים ספציפיים של אימייל על ידי הוספה שלהם לכלל הודעות בתיבת הדואר המטורגטת. אם הכלל לא קיים, הוא נוצר.
הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.קלט של הפעולה
הפעולה חסימת דומיין דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Domains |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של דומיינים של שולחים שרוצים לחסום (לדוגמה, |
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר שאליה יתווסף כלל ההודעה. הערה: אפשר ליצור כללי הודעות רק לתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
חובה. ברירת המחדל היא השם של כלל ההודעות שאליו צריך להוסיף את הדומיינים האלה. אם הכלל קיים, הוא יעודכן. |
Action |
חובה. ברירת המחדל היא הפעולה שצריך לבצע בדומיינים האלה. ערכים אפשריים: |
How many mailboxes to process in a single batch |
זה שינוי אופציונלי. ברירת המחדל היא מציינים כמה תיבות דואר הפעולה צריכה לעבד באצווה אחת. |
ערכי פלט של פעולות
הפעולה חסימת דומיין מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Block Domain:
{
"status": "Success",
"mailbox": "user@domain.com",
"blocked_domain": "malicious-domain.com"
}
הודעות פלט
הפעולה חסימת דומיין מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט התוצאה של הסקריפט כשמשתמשים בפעולה חסימת דומיין:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
חסימת השולח
אפשר להשתמש בפעולה חסימת השולח כדי לחסום שולחי אימייל ספציפיים על ידי הוספה שלהם לכלל הודעות בתיבת הדואר של היעד. אם הכלל לא קיים, הוא ייווצר.
הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.קלט של הפעולה
הפעולה חסימת השולח דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Senders |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של כתובות אימייל של שולחים שרוצים לחסום. שולחים שהוזנו ידנית בשדה הזה ושולחים שחולצו באופן דינמי מישויות פועלים יחד, ושניהם יתווספו לתנאי הכלל. |
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר שאליה יתווסף כלל ההודעה. הערה: אפשר ליצור כללי הודעות רק לתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
חובה. ברירת המחדל היא שם הכלל להודעות שאליו רוצים להוסיף את השולחים האלה. אם הכלל קיים, הוא יעודכן. |
Action |
חובה. ברירת המחדל היא הפעולה שצריך לבצע לגבי השולחים האלה. ערכים אפשריים: |
How many mailboxes to process in a single batch |
זה שינוי אופציונלי. ברירת המחדל היא מציינים כמה תיבות דואר הפעולה צריכה לעבד באצווה אחת. |
ערכי פלט של פעולות
הפעולה חסימת השולח מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה חסימת השולח:
[
{
"Entity": "user@example.com",
"EntityResult": {
"successful_mailboxes": [
"target@example.com"
],
"failed_mailboxes": []
}
}
]
הודעות פלט
הפעולה חסימת השולח מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט הסקריפט כשמשתמשים בפעולה חסימת השולח:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
מחיקת האימייל
אתם יכולים להשתמש בפעולה Delete Email כדי למחוק אימייל אחד או יותר מתיבת דואר. הפעולה הזו מוחקת אימיילים על סמך קריטריוני החיפוש שהזנתם. אם יש לכם את ההרשאות המתאימות, אתם יכולים להשתמש בפעולה מחיקת אימייל כדי להעביר אימיילים לתיבות דואר אחרות.
הפעולה הזו היא אסינכרונית. במידת הצורך, משנים את הזמן הקצוב לתפוגה של הפעולה בסביבת הפיתוח המשולבת (IDE) של Google SecOps.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה מחיקת אימייל דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Delete In Mailbox |
חובה. תיבת הדואר שמוגדרת כברירת מחדל שבה תתבצע פעולת המחיקה. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
Folder Name |
חובה. תיקייה בתיבת הדואר שבה רוצים לחפש אימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Mail IDs |
אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי אימיילים לחיפוש. אם הפרמטר הזה מסופק, החיפוש מתעלם מהפרמטרים |
Subject Filter |
אופציונלי תנאי סינון שמציין את נושא האימייל שצריך לחפש. |
Sender Filter |
אופציונלי תנאי סינון שמציין את השולח של האימיילים המבוקשים. |
Timeframe (Minutes) |
אופציונלי תנאי סינון שמציין את מסגרת הזמן בדקות לחיפוש אימיילים. |
Only Unread |
אופציונלי אם האפשרות הזו נבחרת, הפעולה מחפשת רק אימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל. |
How many mailboxes to process in a single batch |
אופציונלי מספר תיבות הדואר שצריך לעבד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה Delete Email:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה מחיקת אימייל מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה מחיקת אימייל:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
מחיקת כללים בתיבת הדואר הנכנס
משתמשים בפעולה מחיקת כללים של תיבת הדואר הנכנס כדי למחוק כלל ספציפי של הודעות בתיבת הדואר הנכנס בתיבות הדואר שצוינו. הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.
קלט של הפעולה
כדי להשתמש בפעולה מחיקת כללים בתיבת הדואר הנכנס, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר המטורגטת שממנה יימחק כלל ההודעה. הערה: אפשר למחוק כללי הודעות רק מתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
חובה. השם המדויק של הכלל למחיקת הודעות בתיבת הדואר הנכנס. |
How many mailboxes to process in a single batch |
זה שינוי אופציונלי. ברירת המחדל היא מציינים כמה תיבות דואר הפעולה צריכה לעבד באצווה אחת. ברירת המחדל היא 1, כי הפעולות מוגבלות לתיבת הדואר של המשתמש המאומת. |
ערכי פלט של פעולות
הפעולה מחיקת כללים של תיבת הדואר הנכנס מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה מחיקת כללים של תיבת הדואר הנכנס:
{
"deleted_rule": [
"New test cases"
],
"successful_mailboxes": [
"labops1@siemplifycyarx.onmicrosoft.com"
],
"failed_mailboxes": [
"user2@example.com",
"user3@example.com"
]
}
הודעות פלט
הפעולה מחיקת כללים של תיבת הדואר הנכנס מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה מחיקת כללים של תיבת הדואר הנכנס:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הורדת קבצים מצורפים מאימייל
משתמשים בפעולה Download Attachments From Email כדי להוריד קבצים מצורפים מאימיילים על סמך הקריטריונים שצוינו.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
הפעולה הזו היא אסינכרונית. אם צריך, משנים את ערך הזמן הקצוב לתפוגה של הסקריפט ב-Google SecOps IDE.
הפעולה מחליפה את התו של הקו התחתון \` forward slash or/backslash characters in
the names of the downloaded attachments with the_`.
קלט של הפעולה
הפעולה Download Attachments From Email דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה. תיבת הדואר שמוגדרת כברירת מחדל שבה פועלת פעולת החיפוש. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
Folder Name |
חובה. תיקייה בתיבת הדואר שבה רוצים להריץ את החיפוש. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Download Destination |
חובה. סוג האחסון שבו יישמרו הקבצים המצורפים שהורדתם. כברירת מחדל, הפעולה מנסה לשמור את הקובץ המצורף בקטגוריה של Cloud Storage. שמירת קובץ מצורף במערכת הקבצים המקומית היא אפשרות חלופית. הערכים האפשריים הם |
Download Path |
חובה. נתיב להורדת קבצים מצורפים. כששומרים קבצים מצורפים בקטגוריה של Cloud Storage או במערכת קבצים מקומית, צריך לציין את נתיב ההורדה בפורמט דמוי Unix, כמו |
Mail IDs |
אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי אימיילים לחיפוש. אם הפרמטר הזה מסופק, החיפוש מתעלם מהפרמטרים |
Subject Filter |
אופציונלי תנאי סינון שמציין את נושא האימייל שצריך לחפש. המסנן הזה משתמש בלוגיקה של |
Sender Filter |
אופציונלי תנאי סינון שמציין את השולח של האימיילים המבוקשים. המסנן הזה משתמש בלוגיקה של |
Download Attachments From EML |
אופציונלי אם בוחרים באפשרות הזו, הפעולה מורידה קבצים מצורפים מקובצי EML. האפשרות הזו לא מסומנת כברירת מחדל. |
Download attachments to unique path? |
אופציונלי אם בוחרים באפשרות הזו, הפעולה מורידה קבצים מצורפים לנתיב הייחודי שצוין בשדה הפרמטר האפשרות הזו לא מסומנת כברירת מחדל. |
How many mailboxes to process in a single batch |
אופציונלי מספר תיבות הדואר שצריך לעבד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה הורדת קבצים מצורפים מאימייל מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Download Attachments From Email:
[
{
"attachment_name": "name1.png",
"downloaded_path": "file_path/name1.png"
},
{
"attachment_name": "name2.png",
"downloaded_path": "file_path/name2.png"
}
]
הודעות פלט
הפעולה Download Attachments From Email מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Download Attachments From Email:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
חילוץ נתונים מקובץ EML מצורף
משתמשים בפעולה Extract Data From Attached EML כדי לאחזר נתונים מקובצי EML שמצורפים לאימייל ולהחזיר אותם בתוצאות הפעולה. הפעולה הזו תומכת בפורמטים של הקבצים .eml, .msg ו-.ics.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Extract Data From Attached EML דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה. תיבת הדואר שמוגדרת כברירת מחדל שבה פועלת פעולת החיפוש. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
Folder Name |
אופציונלי תיקייה בתיבת הדואר שבה רוצים להריץ את החיפוש. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Mail IDs |
חובה. תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי אימיילים לחיפוש. |
Regex Map JSON |
אופציונלי הגדרה של JSON שמכילה ביטויים רגולריים שצריך להחיל על קובץ האימייל המצורף וליצור ערכי מפתח נוספים בתוצאת הפעולה של ה-JSON. דוגמה לערך פרמטר זה: {ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}
|
ערכי פלט של פעולות
הפעולה חילוץ נתונים מקובץ EML מצורף מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Extract Data From Attached EML:
[
{
"type": "EML",
"subject": "examplesubject",
"from": "sender@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>example-html</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.eml"
},
{
"type": "MSG",
"subject": "examplesubject",
"from": "user@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>examplehtml</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.msg"
},
{
"type": "ICS",
"subject": "examplesubject",
"from": "sender@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>example-html</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.ics"
}
]
הודעות פלט
הפעולה Extract Data From Attached EML מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה חילוץ נתונים מקובץ EML מצורף:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
העברת אימייל
משתמשים בפעולה העברת אימייל כדי להעביר אימיילים שכוללים שרשורים קודמים. עם ההרשאות המתאימות, הפעולה הזו יכולה לשלוח אימיילים מתיבת דואר שונה מזו שצוינה בהגדרות השילוב.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה העברת אימייל דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Send From |
חובה. כתובת אימייל אופציונלית שממנה אפשר לשלוח אימייל, אם ההרשאות מאפשרות זאת. כברירת מחדל, האימייל נשלח מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות האינטגרציה. |
Folder Name |
אופציונלי תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Mail ID |
חובה. המזהה של האימייל שרוצים להעביר. |
Subject |
חובה. נושא האימייל. |
Send to |
חובה. רשימה מופרדת בפסיקים של כתובות האימייל של הנמענים, למשל |
CC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" באימייל. הפורמט זהה לפורמט של הפרמטר |
BCC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק מוסתר" באימייל. הפורמט זהה לפורמט של הפרמטר |
Attachments Paths |
אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים מצורפים שמאוחסנים בשרת,
למשל |
Mail content |
חובה. תוכן האימייל. |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה העברת אימייל:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה העברת אימייל מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Email with message ID
MAIL_ID was forwarded successfully. |
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה העברת אימייל:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
יצירת טוקן
משתמשים בפעולה Generate Token כדי לקבל טוקן רענון להגדרת השילוב עם אימות מואצל. משתמשים בכתובת ה-URL להרשאה שקיבלתם בפעולה Get Authorization.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
אחרי שיוצרים את טוקן הרענון בפעם הראשונה, מומלץ להגדיר ולהפעיל את משימת חידוש טוקן הרענון כדי שהמשימה תחדש באופן אוטומטי את טוקן הרענון ותשמור על התוקף שלו.
קלט של הפעולה
כדי להשתמש בפעולה Generate Token, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Authorization URL |
חובה. כתובת URL להרשאה שקיבלתם בפעולה Get Authorization. כתובת ה-URL נדרשת כדי לבקש טוקן רענון. |
ערכי פלט של פעולות
הפעולה Generate Token מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה Generate Token יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה יצירת טוקן:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
קבלת הרשאה
משתמשים בפעולה Get Authorization כדי לקבל קישור עם קוד הגישה לאימות שהוקצה. מעתיקים את הקישור כולו ומשתמשים בו בפעולה Generate Token כדי לקבל את טוקן הרענון.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
הפעולה Get Authorization מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה קבלת הרשאה יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Authorization URL generated successfully. To obtain a URL with
access code, go to the link below as the user that you configured for the
integration. Provide the URL with the access code in the Generate Token
action. |
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Get Authorization:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הגדרות של חשבון תיבת דואר מחוץ למתקן
משתמשים בפעולה Get Mailbox Account Out Of Facility Settings כדי לאחזר את ההגדרות של חשבון תיבת הדואר מחוץ למשרד (OOF) של הישות User שצוינה ב-Google SecOps.
הפעולה Get Mailbox Account Out Of Facility Settings משתמשת בגרסת הבטא של Microsoft Graph API.
הפעולה הזו פועלת בישות User של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
הפעולה Get Mailbox Account Out Of Facility Settings מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Get Mailbox Account Out Of Facility Settings:
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
"id": "ID",
"availability": "Offline",
"activity": "Offline",
"statusMessage": null,
"outOfOfficeSettings": {
"message": "\n\nOut Of Facility111\n",
"isOutOfOffice": true
}
}
הודעות פלט
הפעולה Get Mailbox Account Out Of Facility Settings יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הפלט של תוצאת הסקריפט כשמשתמשים בפעולה Get Mailbox Account Out Of Facility Settings:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
כללי הרשימה
משתמשים בפעולה List Rules כדי להציג את כל הכללים של ההודעות בתיבת דואר ספציפית באמצעות Microsoft Graph API.
קלט של הפעולה
הפעולה List Rules דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר שאליה יועברו כללי ההודעות. הערה: אפשר להציג כללי הודעות רק בתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
זה שינוי אופציונלי. סינון לפי השם המוצג של הכלל. |
Limit |
זה שינוי אופציונלי. ברירת המחדל היא הגבלת מספר הכללים שיוחזרו לכל תיבת דואר. |
ערכי פלט של פעולות
הפעולה List Rules מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קונסולה צמוד לקיר
הפעולה הצגת רשימת הכללים מספקת פרטי ביצוע בטבלת קיר הבקשות.
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Rules:
[
{
"mailbox": "user@example.com",
"rules": [
{
"id": "AAMkAD...",
"displayName": "Google SecOps - Blocked Senders",
"sequence": 1,
"isEnabled": true
}
]
}
]
הודעות פלט
הפעולה הצגת רשימת הכללים מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה List Rules:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
סימון אימייל כדואר
משתמשים בפעולה סימון אימייל כדואר כדי לסמן אימיילים כדואר בתיבת דואר ספציפית. הפעולה הזו מוסיפה את שולח האימייל לרשימת השולחים החסומים ומעבירה את ההודעה לתיקייה דואר.
הפעולה סימון אימייל כדואר משתמשת בגרסת הבטא של Microsoft Graph API.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה סימון אימייל כדואר דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה. תיבת דואר שבה רוצים לחפש אימייל. כברירת מחדל, הפעולה מנסה לחפש את האימייל בתיבת הדואר הנכנס שציינתם בהגדרות האינטגרציה. כדי לבצע חיפוש בתיבות דואר אחרות, צריך להגדיר הרשאות מתאימות לפעולה. הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת בפסיקים. |
Folder Name |
חובה. תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן ערך ברירת המחדל הוא |
Mail IDs |
חובה. המזהים או הערכים של הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
ערכי פלט של פעולות
הפעולה סימון אימייל כדואר מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה סימון אימייל כדואר יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה סימון אימייל כדואר:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
סימון אימייל כ"לא דואר"
משתמשים בפעולה סימון אימייל כלא דואר כדי לסמן אימיילים כלא דואר בתיבת דואר ספציפית. הפעולה הזו מסירה את השולח מרשימת השולחים החסומים ומעבירה את ההודעה לתיקיית דואר נכנס.
הפעולה סימון אימייל כלא דואר משתמשת בגרסת הבטא של Microsoft Graph API.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה סימון אימייל כלא ספאם דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה. תיבת דואר שבה רוצים לחפש אימייל. כברירת מחדל, הפעולה מנסה לחפש את האימייל בתיבת הדואר הנכנס שציינתם בהגדרות האינטגרציה. כדי לבצע חיפוש בתיבות דואר אחרות, צריך להגדיר הרשאות מתאימות לפעולה. הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת בפסיקים. |
Folder Name |
חובה. תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Mail IDs |
חובה. המזהים או הערכים של הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת בפסיקים. |
ערכי פלט של פעולות
הפעולה סימון אימייל כלא דואר מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה סימון אימייל כהודעה שהיא לא דואר יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה סימון אימייל כלא דואר:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
העברת אימייל לתיקייה
משתמשים בפעולה Move Email To Folder כדי להעביר אימייל אחד או יותר מתיקיית המקור לתיקייה אחרת בתיבת הדואר. אם יש לפעולה הזו את ההרשאות המתאימות, היא יכולה להעביר אימיילים לתיבות דואר אחרות, שונות מזו שצוינה בהגדרות השילוב.
הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
כדי להגדיר את הפעולה Move Email To Folder, משתמשים בפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Move In Mailbox |
חובה. תיבת הדואר שמוגדרת כברירת מחדל שבה פועלת פעולת ההעברה. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
Source Folder Name |
חובה. תיקיית מקור שממנה רוצים להעביר את האימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Destination Folder Name |
חובה. תיקיית יעד שאליה רוצים להעביר את האימייל. מציינים את ערך הפרמטר בפורמט הבא:
|
Mail IDs |
אופציונלי תנאי סינון לחיפוש אימיילים עם מזהי אימייל ספציפיים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של מזהי אימיילים לחיפוש. אם הפרמטר הזה מסופק, החיפוש מתעלם מהפרמטרים |
Subject Filter |
אופציונלי תנאי סינון שמציין את נושא האימייל שצריך לחפש. המסנן הזה משתמש בלוגיקה של |
Sender Filter |
אופציונלי תנאי סינון שמציין את השולח של האימיילים המבוקשים. המסנן הזה משתמש בלוגיקה של |
Timeframe (Minutes) |
אופציונלי תנאי סינון שמציין את מסגרת הזמן, בדקות, לחיפוש אימיילים. |
Only Unread |
אופציונלי אם האפשרות הזו נבחרת, הפעולה מחפשת רק אימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל. |
How many mailboxes to process in a single batch |
אופציונלי מספר תיבות הדואר שצריך לעבד באצווה אחת (חיבור יחיד לשרת הדואר). ערך ברירת המחדל הוא |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה Move Email To Folder:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה Move Email To Folder מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה העברת אימייל לתיקייה:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
פינג
משתמשים בפעולה פינג כדי לבדוק את הקישוריות לשירות הדואר של Microsoft Graph.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה Ping:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה פינג מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully connected to the Microsoft Graph mail service with
the provided connection parameters! |
הפעולה בוצעה בהצלחה. |
Failed to connect to the Microsoft Graph mail service! Error is
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Ping:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הרצת שאילתת חיפוש ב-Microsoft
משתמשים בפעולה Run Microsoft Search Query כדי לבצע שאילתת חיפוש באמצעות מנוע החיפוש של Microsoft. החיפוש מתבצע באמצעות השאילתה הבסיסית או המתקדמת שציינתם. מידע נוסף על Microsoft Search זמין במאמר סקירה כללית של Microsoft Search API ב-Microsoft Graph.
בהתאם להיקף הישות, יכול להיות שתצטרכו להגדיר הרשאות נוספות לפעולה Run Microsoft Search Query. למידע נוסף על ההרשאות הנדרשות לסוגי ישויות ספציפיים, קראו את המאמר שימוש ב-Microsoft Search API כדי לשלוח שאילתות על נתונים. מידע נוסף על הגדרת הרשאות לשילוב זמין במאמר הגדרת הרשאות API.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הפעלת שאילתת חיפוש של מיקרוסופט דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Entity Types To Search |
אופציונלי רשימה מופרדת בפסיקים של סוגי המשאבים הצפויים בתגובה לחיפוש. הערכים האפשריים הם:
|
Fields To Return |
אופציונלי השדות שיופיעו בתגובה לחיפוש. אם לא מגדירים את הפרמטר הזה, הפעולה מחזירה את כל השדות הזמינים. |
Search Query |
אופציונלי השאילתה להרצת החיפוש. למידע נוסף על הדוגמאות לשאילתות חיפוש, קראו את המאמר שימוש ב-Microsoft Search API כדי לחפש הודעות ב-Outlook. |
Max Rows To Return |
אופציונלי מספר השורות המקסימלי שהפעולה תחזיר. אם לא מגדירים את הפרמטר הזה, הפעולה משתמשת בערך ברירת המחדל. ערך ברירת המחדל הוא |
Advanced Query |
אופציונלי המטען הייעודי (payload) המלא של החיפוש שבו צריך להשתמש במקום ליצור את שאילתת החיפוש עם פרמטרים אחרים של פעולות. מגדירים את הפורמט של המטען הייעודי (payload) של החיפוש כמחרוזת JSON. אם מגדירים את הפרמטר הזה, הפעולה מתעלמת מכל הפרמטרים האחרים. |
ערכי פלט של פעולות
הפעולה Run Microsoft Search Query מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה Run Microsoft Search Query יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה הפעלת שאילתת חיפוש של Microsoft:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הסרת החסימה של הדומיין
משתמשים בפעולה הסרת חסימה של דומיין כדי להסיר דומיינים ספציפיים של אימייל מכלל של הודעות בתיבת הדואר של היעד. אם הכלל יהיה ריק, הוא יימחק.
הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.קלט של הפעולה
הפעולה הסרת חסימה של דומיין דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Domains |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של דומיינים של שולחים שרוצים להסיר (לדוגמה, |
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר המטורגטת שבה קיים כלל ההודעה. הערה: אפשר לעדכן את כללי ההודעות רק בתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
חובה. ברירת המחדל היא השם של כלל ההודעות שממנו רוצים להסיר את הדומיינים האלה. |
How many mailboxes to process in a single batch |
זה שינוי אופציונלי. ברירת המחדל היא מציינים כמה תיבות דואר הפעולה צריכה לעבד באצווה אחת. |
ערכי פלט של פעולות
הפעולה Remove Block Domain מספקת את הפלט הבא:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Remove Block Domain:
[
{
"Entity": "example.com",
"EntityResult": {
"successful_mailboxes": [
"user@example.com"
],
"failed_mailboxes": []
}
}
]
הודעות פלט
הפעולה הסרת חסימה של דומיין מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הסרת חסימת דומיין:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הסרת החסימה של השולח
משתמשים בפעולה הסרת חסימה של שולח כדי להסיר שולחי אימייל ספציפיים מכלל של הודעות בתיבת הדואר של היעד. אם הכלל יהיה ריק, הוא יימחק.
הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (IDE) של Google SecOps, משנים את הזמן הקצוב לתפוגה של הפעולה לפי הצורך.קלט של הפעולה
הפעולה הסרת חסימה של שולח דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Senders |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של כתובות אימייל של שולחים שרוצים להסיר. שולחים שהוזנו ידנית בשדה הזה ושולחים שחולצו באופן דינמי מישויות פועלים יחד, ושניהם יוסרו מתנאי הכלל. |
Mailboxes |
חובה. ברירת המחדל היא תיבת הדואר המטורגטת שבה קיים כלל ההודעה. הערה: אפשר לעדכן את כללי ההודעות רק בתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail. |
Rule Name |
חובה. ברירת המחדל היא השם של כלל ההודעות שממנו רוצים להסיר את השולחים האלה. |
How many mailboxes to process in a single batch |
זה שינוי אופציונלי. ברירת המחדל היא מציינים כמה תיבות דואר הפעולה צריכה לעבד באצווה אחת. |
ערכי פלט של פעולות
הפעולה הסרת החסימה של השולח מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה הסרת חסימה של שולח:
[
{
"Entity": "user@example.com",
"EntityResult": {
"successful_mailboxes": [
"target@example.com"
],
"failed_mailboxes": []
}
}
]
הודעות פלט
הפעולה הסרת החסימה של השולח מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט הסקריפט כשמשתמשים בפעולה הסרת חסימה של שולח:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
שמירת האימייל בפנייה
כדי לשמור אימיילים או קבצים מצורפים לאימיילים ב-Google SecOps Case Wall, משתמשים בפעולה Save Email To The Case. אם יש לכם את ההרשאות המתאימות, אתם יכולים לשמור אימיילים מתיבות דואר אחרות, ולא רק מזו שצוינה בהגדרות האינטגרציה.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה שמירת האימייל בפנייה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה. תיבת הדואר שמוגדרת כברירת מחדל שבה פועלת פעולת החיפוש. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. |
Folder Name |
אופציונלי תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן |
Mail ID |
חובה. רשימה מופרדת בפסיקים של מזהי אימייל לחיפוש. אם השתמשתם בפעולה Send Email כדי לשלוח אימיילים, הגדירו את ערך הפרמטר לפלייסהולדר |
Save Only Email Attachments |
אופציונלי אם האפשרות הזו נבחרת, הפעולה שומרת רק קבצים מצורפים מהאימייל שצוין. האפשרות הזו לא מסומנת כברירת מחדל. |
Attachment To Save |
אופציונלי אם הפרמטר הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. |
Base64 Encode |
אופציונלי אם בוחרים באפשרות הזו, הפעולה מקודדת את קובץ האימייל בפורמט base64. האפשרות הזו לא מסומנת כברירת מחדל. |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה Save Email To The Case:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | יש גישה |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
חיבור לקיר של המארז
הקבצים המצורפים הבאים משויכים לפעולה שמירת האימייל בבקשת התמיכה:
EMAIL_SUBJECT.eml, אם הפעולה שומרת את האימייל.אם הפעולה שומרת את הקובץ המצורף, שם הקובץ המצורף מכיל סיומת קובץ, אם יש כזו.
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Save Email To The Case:
{
"id": "ID",
"createdDateTime": "2024-02-16T14:10:34Z",
"eml_info": "example_info",
"lastModifiedDateTime": "2024-02-16T14:10:41Z",
"changeKey": "cxsdjjh",
"categories": [],
"receivedDateTime": "2024-02-16T14:10:35Z",
"sentDateTime": "2024-02-16T14:09:36Z",
"hasAttachments": true,
"internetMessageId": "INTERNET_MESSAGE_ID",
"subject": "all attachments",
"bodyPreview": "all the attachments",
"importance": "normal",
"parentFolderId": "PARENT_FOLDER_ID",
"conversationId": "CONVERSATION_ID",
"conversationIndex": "example-index",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://example.com/",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "<html><head>example-html</head></html>"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"flag": {
"flagStatus": "notFlagged"
}
}
הודעות פלט
ב-Case Wall, הפעולה Save Email To The Case מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Save Email To The Case:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
חיפוש אימיילים
משתמשים בפעולה חיפוש אימיילים כדי לבצע חיפוש אימיילים בתיבת הדואר המוגדרת כברירת מחדל, על סמך הקריטריונים לחיפוש שצוינו. עם ההרשאות המתאימות, הפעולה הזו יכולה להריץ חיפוש בתיבות דואר אחרות.
הפעולה הזו היא אסינכרונית. משנים את זמן הקצוב לתפוגה של הפעולה ב-Google SecOps IDE לפי הצורך.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה חיפוש אימיילים דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Search In Mailbox |
חובה תיבת הדואר שמוגדרת כברירת מחדל שבה פועלת פעולת החיפוש. אם ההרשאות מאפשרות זאת, הפעולה יכולה גם לחפש בתיבות דואר אחרות. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. לחיפושים מורכבים במספר משמעותי של תיבות דואר, השתמשו בשילוב של Exchange Extension Pack. |
Folder Name |
אופציונלי
תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן ברירת המחדל היא |
Subject Filter |
אופציונלי תנאי סינון שמציין את נושא האימייל שצריך לחפש. המסנן הזה משתמש בלוגיקה של |
Sender Filter |
אופציונלי תנאי סינון שמציין את השולח של האימיילים המבוקשים. המסנן הזה משתמש בלוגיקה של |
Recipient Filter |
אופציונלי תנאי סינון שמציין את הנמען של האימיילים המבוקשים. |
Timeframe (minutes) |
אופציונלי תנאי סינון שמציין את התקופה בדקות לחיפוש אימיילים. |
Start Time |
אופציונלי ציינו את שעת ההתחלה של החיפוש באימייל בפורמט ISO 8601. לפרמטר הזה יש עדיפות על פני |
End Time |
אופציונלי מציינים את שעת הסיום של החיפוש באימייל בפורמט ISO 8601. אם לא צוין ערך והפרמטר |
Body Regex Filter |
אופציונלי מציינים תבנית של ביטוי רגולרי לחיפוש בגוף האימייל. |
Message IDs |
אופציונלי רשימה מופרדת בפסיקים של מזהי הודעות לחיפוש. הערה: למסנן הזה יש עדיפות על פני מסננים אחרים. |
Max Emails To Return |
אופציונלי מספר האימיילים שהפעולה צריכה להחזיר. אם לא מגדירים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. ברירת המחדל היא |
Only Unread |
אופציונלי אם האפשרות הזו נבחרת, הפעולה מחפשת רק אימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל. |
Select All Fields For Return |
אופציונלי אם בוחרים באפשרות הזו, הפעולה מחזירה את כל השדות הזמינים של האימייל שהתקבל. האפשרות הזו לא מסומנת כברירת מחדל. |
How many mailboxes to process in a single batch |
אופציונלי מספר תיבות הדואר שצריך לעבד באצווה אחת (חיבור יחיד לשרת הדואר). ברירת המחדל היא |
Limit the Amount of Information Returned in the JSON Result |
אופציונלי אם בוחרים באפשרות הזו, כמות המידע שהפעולה מחזירה מוגבלת רק לשדות אימייל מרכזיים. האפשרות הזו לא מסומנת כברירת מחדל. |
Disable the Action JSON Result |
אופציונלי אם בוחרים באפשרות הזו, הפעולה לא מחזירה תוצאת JSON. האפשרות הזו לא מסומנת כברירת מחדל. |
ערכי פלט של פעולות
הפעולה חיפוש אימיילים מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קונסולה צמוד לקיר
הפעולה חיפוש אימיילים יכולה ליצור את הטבלה הבאה:
שם הטבלה: אימיילים תואמים
עמודות:
- מזהה אימייל
- נושא
- השולח
- מקלטים
- תאריך קבלה
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה חיפוש אימיילים:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הודעות פלט של פעולות
הפעולה חיפוש אימיילים מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
שלח אימייל
משתמשים בפעולה שליחת אימייל כדי לשלוח אימיילים מתיבת דואר ספציפית לרשימה שרירותית של נמענים.
הפעולה הזו יכולה לשלוח אימיילים בטקסט פשוט או בפורמט HTML. אם יש הרשאות מתאימות, הפעולה יכולה לשלוח אימיילים מתיבת דואר שונה מזו שצוינה בהגדרות האינטגרציה.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
מדריך מקוצר להגדרת S/MIME
אתם יכולים להשתמש בטבלה הבאה כדי לקבוע אילו פרמטרים של S/MIME להגדיר, בהתאם לרמת האבטחה של האימייל היוצא:
| סוג האימייל הרצוי | Base64 Encoded Certificate |
Base64 Encoded Private Key |
Base64 Encoded Recipient Certificate |
|---|---|---|---|
| אימייל רגיל (ללא S/MIME) | להשאיר ריק | להשאיר ריק | להשאיר ריק |
| חתימה דיגיטלית | חובה | חובה | להשאיר ריק |
| מוצפן | להשאיר ריק | להשאיר ריק | חובה |
| חתימה והצפנה | חובה | חובה | חובה |
המרת קובצי אישורים ל-Base64
כדי לקודד את קובצי האישור והמפתח הפרטי למחרוזות Base64 בשורה אחת בשביל הפרמטרים של הפעולה, מריצים את הפקודות הבאות:
ב-Linux וב-macOS:
base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key
Windows PowerShell:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))
קלט של הפעולה
הפעולה שליחת אימייל דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Send From |
חובה. כתובת אימייל אופציונלית שממנה אפשר לשלוח אימיילים, אם ההרשאות מאפשרות זאת. כברירת מחדל, הפעולה שולחת אימיילים מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב. |
Subject |
חובה. נושא האימייל. |
Send to |
חובה. רשימה מופרדת בפסיקים של כתובות האימייל של הנמענים, למשל |
CC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" באימייל. הפורמט זהה לפורמט של הפרמטר |
BCC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק מוסתר" באימייל. הפורמט זהה לפורמט של הפרמטר |
Attachments Paths |
אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים מצורפים שמאוחסנים בשרת,
למשל |
Attachments Location |
חובה. מיקום שבו הקבצים המצורפים מאוחסנים. כברירת מחדל, הפעולה מנסה להעלות קבצים מצורפים מהקטגוריה של Cloud Storage. הערכים האפשריים הם |
Mail Content Type |
אופציונלי סוג התוכן של האימייל. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Mail Content |
חובה. תוכן האימייל. |
Reply-To Recipients |
אופציונלי רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To. משתמשים בכותרת תשובה אל כדי להפנות את הודעות התשובה לכתובת האימייל שצוינה, במקום לכתובת של השולח בשדה מאת. |
Base64 Encoded Certificate |
אופציונלי האישור הציבורי X.509 בקידוד Base64 ( אם ציינתם את השדה הזה, אתם צריכים לציין גם את השדה |
Base64 Encoded Private Key |
אופציונלי המפתח הפרטי בקידוד Base64 ( חובה אם צוין |
Base64 Encoded Recipient Certificate |
אופציונלי האישור הציבורי בקידוד Base64 ( |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה שליחת אימייל:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה שליחת אימייל מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Send Email:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
שליחת אימייל ב-HTML
משתמשים בפעולה Send Email HTML כדי לשלוח אימיילים באמצעות תבנית ה-HTML של Google SecOps מתיבת דואר ספציפית לרשימה שרירותית של נמענים. אם יש לכם את ההרשאות המתאימות, אתם יכולים לשלוח אימיילים מתיבת דואר אחרת, ולא רק מתיבת הדואר שמוגדרת כברירת מחדל.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה שליחת אימייל ב-HTML דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Send From |
חובה. כתובת אימייל אופציונלית שממנה אפשר לשלוח אימיילים, אם ההרשאות מאפשרות זאת. כברירת מחדל, הפעולה שולחת אימיילים מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב. |
Subject |
חובה. נושא האימייל. |
Send to |
חובה. רשימה מופרדת בפסיקים של כתובות האימייל של הנמענים, למשל |
CC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" באימייל. הפורמט זהה לפורמט של הפרמטר |
BCC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק מוסתר" באימייל. הפורמט זהה לפורמט של הפרמטר |
Attachments Paths |
אופציונלי הנתיב המלא של הקובץ המצורף שרוצים לצרף, למשל אפשר לציין כמה ערכים במחרוזת מופרדת בפסיקים. |
Email HTML Template |
חובה. סוג תבנית ה-HTML שבה רוצים להשתמש. הערכים האפשריים הם ערך ברירת המחדל הוא |
Mail Content |
חובה. תוכן האימייל. |
Reply-To Recipients |
אופציונלי רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To. משתמשים בכותרת Reply-To כדי להפנות את התשובות לאימיילים לכתובת האימייל הספציפית, במקום לכתובת של השולח שצוינה בשדה From. |
Attachment Location |
חובה. מיקום שבו הקבצים המצורפים מאוחסנים. כברירת מחדל, הפעולה מנסה להעלות קבצים מצורפים מהקטגוריה של Cloud Storage. הערכים האפשריים הם |
ערכי פלט של פעולות
הפעולה שליחת אימייל ב-HTML מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Send Email HTML:
{
"createdDateTime": "2024-01-30T16:50:27Z",
"lastModifiedDateTime": "2024-01-30T16:50:27Z",
"changeKey": "example-key",
"categories": [],
"receivedDateTime": "2024-01-30T16:50:27Z",
"sentDateTime": "2024-01-30T16:50:27Z",
"hasAttachments": false,
"internetMessageId": "outlook.com",
"subject": "Testing",
"bodyPreview": "example",
"importance": "normal",
"parentFolderId": "ID",
"conversationId": "ID",
"conversationIndex": "INDEX",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://example.com",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "content"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "content"
},
"flag": {
"flagStatus": "notFlagged"
},
"id": "ID"
}
הודעות פלט
ב-Case Wall, הפעולה Send Email HTML מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Email was sent successfully. |
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה שליחת אימייל ב-HTML:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
שליחת תשובה לשרשור
משתמשים בפעולה Send Thread Reply כדי לשלוח הודעה כתשובה לשרשור האימיילים. אם יש הרשאות מתאימות, הפעולה יכולה לשלוח אימיילים מתיבת דואר אחרת מזו שצוינה בהגדרות השילוב.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה שליחת תשובה לשרשור דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Send From |
חובה. כתובת אימייל אופציונלית שממנה אפשר לשלוח אימיילים, אם ההרשאות מאפשרות זאת. כברירת מחדל, הפעולה שולחת אימיילים מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב. |
Mail ID |
חובה. מזהה האימייל שרוצים לחפש. |
Folder Name |
אופציונלי תיקייה בתיבת הדואר שבה רוצים לחפש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן ערך ברירת המחדל הוא |
Attachments Paths |
אופציונלי רשימה מופרדת בפסיקים של נתיבים לקבצים מצורפים שמאוחסנים בשרת,
למשל |
Mail Content |
חובה. תוכן האימייל. |
Reply All |
אופציונלי אם בוחרים באפשרות הזו, הפעולה שולחת תשובה לכל הנמענים שקשורים לאימייל המקורי. האפשרות הזו לא מסומנת כברירת מחדל.
לפרמטר הזה יש עדיפות על פני הפרמטר |
Reply To |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל שאליהן תישלח התשובה. אם לא תזינו ערך ותיבת הסימון אם תיבת הסימון |
Attachments Location |
חובה. מיקום שבו הקבצים המצורפים מאוחסנים. כברירת מחדל, הפעולה מנסה להעלות קבצים מצורפים מהקטגוריה של Cloud Storage. הערכים האפשריים הם |
Message Timezone |
זה שינוי אופציונלי. אזור הזמן שמשמש לתאריך השליחה של האימייל המקורי בכותרת התשובה (למשל ערך ברירת המחדל הוא |
ערכי פלט של פעולות
בטבלה הבאה מתוארים סוגי הפלט שמשויכים לפעולה שליחת תשובה לשרשור:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה שליחת תשובה לשרשור:
{
"id": "yyyy",
"createdDateTime": "2024-02-02T10:57:18Z",
"lastModifiedDateTime": "2024-02-02T10:57:23Z",
"changeKey": "dsf+oAAQLaPjk",
"categories": [],
"receivedDateTime": "2024-02-02T10:57:20Z",
"sentDateTime": "2024-02-02T10:57:19Z",
"hasAttachments": true,
"internetMessageId": "sdfhsjdfhjsdjfd",
"subject": "RE: reply checking",
"bodyPreview": "Reply check kr",
"importance": "normal",
"parentFolderId": "id",
"conversationId": "id",
"conversationIndex": "sdghfjfke",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://www.example.com/about",
"inferenceClassification": "focused",
"body": {
"contentType": "text",
"content": "Reply check kr"
},
"sender": {
"emailAddress": {
"name": "aff",
"address": "ddxsm@a.com"
}
},
"from": {
"emailAddress": {
"name": "fasf",
"address": "ddxsm@a.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "wf",
"address": "ddxsm@a.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "Reply check"
},
"flag": {
"flagStatus": "notFlagged"
}
}
הודעות פלט
הפעולה שליחת תשובה לשרשור מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully sent reply to the mail with ID:
EMAIL_ID |
הפעולה בוצעה בהצלחה. |
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. |
הפעולה נכשלה. צריך לבדוק את הערך של הפרמטר |
Failed to execute action, the error is:
ERROR_REASON |
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט התוצאות של הסקריפט כשמשתמשים בפעולה שליחת תשובה לשרשור:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
שליחת אימייל להצבעה
משתמשים בפעולה שליחת אימייל להצבעה כדי לשלוח אימיילים עם אפשרויות התשובה שהוגדרו מראש. הפעולה הזו משתמשת בתבניות HTML של Google SecOps כדי לעצב את האימייל. אם יש לכם את ההרשאות המתאימות, אתם יכולים להשתמש בפעולה Send Vote Email כדי לשלוח אימיילים מתיבת דואר שהיא לא ברירת המחדל.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה שליחת אימייל להצבעה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Send From |
חובה. כתובת אימייל אופציונלית שממנה אפשר לשלוח אימיילים, אם ההרשאות מאפשרות זאת. כברירת מחדל, הפעולה שולחת אימיילים מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב. |
Subject |
חובה. נושא האימייל. |
Send to |
חובה. רשימה מופרדת בפסיקים של כתובות האימייל של הנמענים, למשל |
CC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" באימייל. הפורמט זהה לפורמט של הפרמטר |
BCC |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק מוסתר" באימייל. הפורמט זהה לפורמט של הפרמטר |
Attachments Paths |
אופציונלי הנתיב המלא של הקובץ המצורף שרוצים לצרף, למשל אפשר לציין כמה ערכים במחרוזת מופרדת בפסיקים. |
Email HTML Template |
חובה. סוג תבנית ה-HTML שבה רוצים להשתמש. הערכים האפשריים הם ערך ברירת המחדל הוא |
Reply-To Recipients |
אופציונלי רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To. משתמשים בכותרת Reply-To כדי להפנות את התשובות לאימיילים לכתובת האימייל שצוינה, במקום לכתובת של השולח שצוינה בשדה From. |
Structure of voting options |
חובה. מבנה ההצבעה שתישלח לנמענים. הערכים האפשריים הם |
Attachment Location |
חובה. מיקום שבו הקבצים המצורפים מאוחסנים. כברירת מחדל, הפעולה מנסה להעלות את הקובץ המצורף מהקטגוריה של Cloud Storage. הערכים האפשריים הם |
ערכי פלט של פעולות
הפעולה שליחת אימייל להצבעה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Send Vote Email:
{
"createdDateTime": "2024-01-30T16:50:27Z",
"lastModifiedDateTime": "2024-01-30T16:50:27Z",
"changeKey": "KEY",
"categories": [],
"receivedDateTime": "2024-01-30T16:50:27Z",
"sentDateTime": "2024-01-30T16:50:27Z",
"hasAttachments": false,
"internetMessageId": "<example-message-ID>",
"subject": "Testing",
"bodyPreview": "example",
"importance": "normal",
"parentFolderId": "FOLDER_ID",
"conversationId": "CONVERSATION_ID",
"conversationIndex": "CONVERSATION_INDEX",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://www.example.com/about",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "content"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "content"
},
"flag": {
"flagStatus": "notFlagged"
},
"id": "ID"
}
הודעות פלט
ב-Case Wall, הפעולה Send Vote Email מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Email was sent successfully. |
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה שליחת אימייל להצבעה:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
המתנה לאימייל מהמשתמש
משתמשים בפעולה המתנה לאימייל מהמשתמש כדי להמתין לתשובה של המשתמש על סמך אימייל שנשלח באמצעות הפעולה שליחת אימייל.
הפעולה הזו היא אסינכרונית. משנים את זמן הקצוב לתפוגה של הפעולה ב-Google SecOps IDE לפי הצורך. אם מגדירים את הזמן הקצוב לתפוגה כ-0 או משאירים אותו ריק, המערכת משתמשת בזמן הקצוב לתפוגה שמוגדר כברירת מחדל בהגדרות הסביבה.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה המתנה לאימייל מהמשתמש דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Mail ID |
חובה המזהה או |
Mail Date |
אופציונלי שליחת חותמת הזמן של האימייל שהפעולה ממתינה לו. אם ההודעה נשלחה באמצעות הפעולה שליחת אימייל, בוחרים בשדה |
Mail Recipients |
אופציונלי רשימה מופרדת בפסיקים של כתובות אימייל של נמענים שהפעולה ממתינה לתגובה שלהם. אם ההודעה נשלחה באמצעות הפעולה שליחת אימייל, בוחרים בשדה |
How long to wait for recipient reply (minutes) |
אופציונלי כמה זמן (בדקות) לחכות לתשובה מהמשתמש לפני שמוגדר שהזמן הקצוב לתפוגה חלף. ברירת המחדל היא |
Wait for All Recipients to Reply? |
אופציונלי אם האפשרות הזו נבחרת, הפעולה ממתינה לתגובות מכל הנמענים עד שהזמן הקצוב לתפוגה מסתיים או עד שהתגובה הראשונה מתקבלת. האפשרות הזו לא מסומנת כברירת מחדל. |
Wait Stage Exclude pattern |
אופציונלי ביטוי רגולרי להחרגת תשובות ספציפיות משלב ההמתנה. הפרמטר הזה פועל גם עם הנושא וגם עם גוף האימייל. לדוגמה, אם מגדירים את הביטוי הרגולרי |
Folder to Check for Reply |
אופציונלי תיקיית אימייל בתיבת הדואר שבה מחפשים תשובות נכנסות מנמענים. החיפוש מתבצע בתיבת הדואר שממנה נשלח האימייל עם השאלה. תומך בתיקיות משנה בתצוגת עץ באמצעות |
Fetch Response Attachments |
אופציונלי אם בוחרים באפשרות הזו והתשובה של הנמען מכילה קבצים מצורפים, הפעולה מאחזרת את התשובה ומוסיפה אותה כקובץ מצורף לתוצאת הפעולה. האפשרות הזו לא מסומנת כברירת מחדל. |
Limit the Amount of Information Returned in the JSON Result |
אופציונלי אם בוחרים באפשרות הזו, כמות המידע שהפעולה מחזירה מוגבלת רק לשדות אימייל מרכזיים. האפשרות הזו מסומנת כברירת מחדל. |
Disable the Action JSON Result |
אופציונלי אם בוחרים באפשרות הזו, הפעולה לא מחזירה תוצאת JSON. האפשרות הזו לא מסומנת כברירת מחדל. |
ערכי פלט של פעולות
הפעולה המתנה לאימייל מהמשתמש מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | יש גישה |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| תוצאת הסקריפט | יש גישה |
חיבור לקיר של המארז
הקובץ המצורף הבא ב-Case Wall משויך לפעולה המתנה לאימייל מהמשתמש:
סוג: ישות
תוכן הקובץ המצורף: כותרת, שם הקובץ (כולל סיומות, אם יש), fileContent.
- כותרת: קובץ מצורף לתשובה של
RECIPIENT_EMAIL. - שם הקובץ:
ATTACHMENT_FILENAME+FILE_EXTENSION - fileContent:
CONTENT_OF_THE_ATTACHED_FILE
שולחן קונסולה צמוד לקיר
הפעולה המתנה לאימייל מהמשתמש יכולה ליצור את הטבלה הבאה:
שם הטבלה: אימיילים תואמים
עמודות:
- מזהה אימייל
- תאריך קבלה
- השולח
- נמענים
- נושא
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה המתנה לאימייל מהמשתמש:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הודעות פלט של פעולות
הפעולה המתנה לאימייל מהמשתמש מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
המתנה לתוצאות ההצבעה באימייל
משתמשים בפעולה המתנה לתוצאות של אימייל הצבעה כדי להמתין לתגובת המשתמש על סמך אימייל ההצבעה שנשלח באמצעות הפעולה שליחת אימייל הצבעה.
הפעולה הזו היא אסינכרונית. משנים את הזמן הקצוב לתפוגה של הפעולה ב-Google SecOps IDE לפי הצורך.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה המתנה לתוצאות של הצבעה באימייל דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Vote Mail Sent From |
חובה. תיבת הדואר שממנה הפעולה שליחת אימייל להצבעה שלחה אימייל. ערך ברירת המחדל הוא תיבת הדואר שציינתם בהגדרות השילוב. אם האימייל עם ההצבעה נשלח מתיבת דואר אחרת, אפשר להגדיר ערך אחר לפרמטר הזה. |
Mail ID |
חובה. המזהה של האימייל. אם האימייל נשלח באמצעות הפעולה כדי להחזיר מזהי אימיילים, אפשר להשתמש בפעולה חיפוש אימיילים. |
Wait for All Recipients To Reply? |
אופציונלי אם האפשרות הזו נבחרת, הפעולה ממתינה לתגובות מכל הנמענים עד לסיום הזמן הקצוב או עד להמשך עם התשובה הראשונה. מופעלת כברירת מחדל. |
Wait Stage Exclude Pattern |
אופציונלי ביטוי רגולרי להחרגת תשובות ספציפיות משלב ההמתנה. הפרמטר הזה פועל עם תוכן האימייל. דוגמה: הפעולה לא מתייחסת להודעות אוטומטיות של "לא בעבודה" כתשובות של הנמען, אלא ממתינה לתשובה ממשתמש אמיתי. |
Folder To Check For Reply |
אופציונלי תיקיית אימייל בתיבת הדואר שבה מחפשים את התשובה של המשתמש. החיפוש מתבצע בתיבת הדואר שממנה נשלח האימייל עם השאלה. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות כדי לבדוק את תגובת המשתמש בכמה תיקיות. הפרמטר הזה תלוי אותיות רישיות. ערך ברירת המחדל הוא |
Folder To Check For Sent Mail |
אופציונלי תיקייה בתיבת הדואר שבה יתבצע החיפוש של הדואר שנשלח. זו תיבת דואר ששלחתם ממנה את האימייל עם השאלה. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות כדי לבדוק את תגובת המשתמש בכמה תיקיות. הפרמטר הזה תלוי אותיות רישיות.
כדי לציין תיקיית משנה, משתמשים בלוכסן ערך ברירת המחדל הוא |
Fetch Response Attachments |
אופציונלי אם בוחרים באפשרות הזו והתשובה של הנמען מכילה קבצים מצורפים, הפעולה מאחזרת את התשובה ומוסיפה אותה כקובץ מצורף ל-Case Wall. האפשרות הזו לא מסומנת כברירת מחדל. |
ערכי פלט של פעולות
הפעולה המתנה לתוצאות של הצבעה באימייל מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | יש גישה |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
חיבור לקיר של המארז
הקובץ המצורף הבא ב-Case Wall משויך לפעולה Wait For Vote Email Results:
סוג: ישות
תוכן הקובץ המצורף: כותרת, שם הקובץ (כולל סיומות, אם יש), fileContent.
- כותרת:
RECIPIENT_EMAILקובץ מצורף לתשובה. - שם הקובץ:
ATTACHMENT_FILENAME+FILE_EXTENSION - fileContent:
CONTENT_OF_THE_ATTACHED_FILE
שולחן קונסולה צמוד לקיר
ב-Case Wall, הפעולה Wait For Email Results יוצרת את הטבלה הבאה:
שם הטבלה: אימיילים תואמים
עמודות:
- מזהה אימייל
- תאריך קבלה
- השולח
- נמענים
- נושא
תוצאת JSON
הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה המתנה לתוצאות ההצבעה באימייל:
{
"Responses": [
{
"recipient": "user@example.com",
"vote": "Approve"
}
]
}
הודעות פלט
הפעולה המתנה לתוצאות של הצבעה באימייל מספקת את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מתוארים הערכים של פלט התוצאות של הסקריפט כשמשתמשים בפעולה Wait For Vote Email Results:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
מחברים
איך מגדירים מחברים ב-Google SecOps?
מחבר מורשה של Microsoft Graph Mail
משתמשים ב-Microsoft Graph Mail Delegated Connector כדי לאחזר אימיילים משירות האימייל של Microsoft Graph.
המחבר המורשה של Microsoft Graph Mail משתמש באימות מורשה ב-Microsoft 365, ודורש התחברות אינטראקטיבית של המשתמש כדי להתחבר ל-Microsoft 365.
אפשר להשתמש ברשימה הדינמית כדי לסנן את הערכים שצוינו מחלקי תוכן האימייל והנושא באמצעות ביטויים רגולריים. כברירת מחדל, המחבר משתמש בביטוי רגולרי כדי לסנן את כתובות ה-URL מהאימייל.
דרישות מוקדמות לשימוש במחבר
כדי להשתמש ב-Microsoft Graph Mail Delegated Connector, צריך להגדיר את פרמטרי השילוב וליצור טוקן רענון.
כניסות קלט של מחברים
ל-Microsoft Graph Mail Delegated Connector נדרשים הפרמטרים הבאים:| פרמטר | תיאור |
|---|---|
Product Field Name |
חובה. שם השדה שבו מאוחסן שם המוצר. ערך ברירת המחדל הוא שם המוצר משפיע בעיקר על המיפוי. כדי לייעל ולשפר את תהליך המיפוי של המחבר, ערך ברירת המחדל |
Event Field Name |
חובה. שם השדה שמשמש לקביעת שם האירוע (סוג המשנה). ערך ברירת המחדל הוא |
Environment Field Name |
אופציונלי שם השדה שבו מאוחסן שם הסביבה. אם השדה environment לא נמצא, הסביבה מוגדרת כ- |
Environment Regex Pattern |
אופציונלי תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה משתמשים בערך ברירת המחדל אם התבנית של הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא |
Email Exclude Pattern |
אופציונלי ביטוי רגולרי להחרגת אימיילים ספציפיים מהטמעה, כמו ספאם או חדשות. הפרמטר הזה פועל גם עם הנושא וגם עם גוף האימייל. |
Script Timeout (Seconds)
|
חובה. מגבלת הזמן הקצוב לתפוגה, בשניות, של תהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא
|
Microsoft Entra ID Endpoint
|
חובה. נקודת הקצה של Microsoft Entra שבה משתמשים בשילוב. ערך ברירת המחדל הוא |
Microsoft Graph Endpoint |
חובה. נקודת הקצה של Microsoft Graph שבה משתמשים בשילוב. ערך ברירת המחדל הוא |
Mail Address |
חובה. כתובת אימייל שהמחבר ישתמש בה. |
Refresh Token
|
חובה. טוקן הרענון שמשמש לאימות. |
Client ID |
חובה. מזהה האפליקציה (הלקוח) של אפליקציית Microsoft Entra. |
Client Secret Value |
חובה. ערך סוד הלקוח של האפליקציה ב-Microsoft Entra. |
Microsoft Entra ID Directory ID
|
חובה. הערך של Microsoft Entra ID (מזהה הדייר). |
Folder to check for emails |
חובה. תיקיית אימייל שבה רוצים לחפש את האימיילים. הפרמטר הזה מקבל רשימה מופרדת בפסיקים של תיקיות כדי לחפש את התגובה של המשתמש בכמה תיקיות. כדי לציין תיקיית משנה, משתמשים בלוכסן הפרמטר הזה תלוי אותיות רישיות. ערך ברירת המחדל הוא |
Offset Time In Hours |
חובה. מספר השעות לפני האיטרציה הראשונה של המחבר לאחזור אימיילים. הפרמטר הזה חל על האיטרציה הראשונית של המחבר אחרי שמפעילים את המחבר בפעם הראשונה. המחבר יכול להשתמש בפרמטר הזה כערך חלופי כשתוקף חותמת הזמן מהאיטרציה האחרונה של המחבר פג. ערך ברירת המחדל הוא |
Max Emails Per Cycle |
חובה. מספר האימיילים שצריך לאחזר בכל איטרציה של המחבר. ערך ברירת המחדל הוא |
Unread Emails Only |
אופציונלי אם בוחרים באפשרות הזו, המחבר יוצר פניות רק מאימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל. |
Mark Emails as Read |
אופציונלי אם בוחרים באפשרות הזו, המחבר מסמן את האימיילים כ"כבר קראתי" אחרי ההטמעה. האפשרות הזו לא מסומנת כברירת מחדל. |
Disable Overflow |
אופציונלי אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון ההצפה של Google SecOps. האפשרות הזו לא מסומנת כברירת מחדל. |
Verify SSL |
חובה. אם בוחרים באפשרות הזו, השילוב מאמת את אישור ה-SSL כשמתחברים ל-Microsoft Graph. מופעלת כברירת מחדל. |
Original Received Mail Prefix |
אופציונלי קידומת שצריך להוסיף למפתחות האירועים שחולצו (לדוגמה, ערך ברירת המחדל הוא |
Attached Mail File Prefix |
אופציונלי קידומת שצריך להוסיף למפתחות האירועים שחולצו (לדוגמה, ערך ברירת המחדל הוא |
Create a Separate Google Secops Alert per Attached Mail File
|
אופציונלי אם האפשרות הזו נבחרת, המחבר יוצר כמה התראות, התראה אחת לכל קובץ אימייל מצורף. ההתנהגות הזו שימושית כשמעבדים אימיילים עם כמה קובצי אימייל מצורפים, ומגדירים את מיפוי האירועים של Google SecOps כך שייצור ישויות מקובצי האימייל המצורפים. האפשרות הזו לא מסומנת כברירת מחדל. |
Attach Original EML |
אופציונלי אם בוחרים באפשרות הזו, המחבר מצרף את האימייל המקורי לפרטי הבקשה כקובץ EML. האפשרות הזו לא מסומנת כברירת מחדל. |
Headers to add to events |
אופציונלי מחרוזת מופרדת בפסיקים של כותרות אימיילים שצריך להוסיף לאירועים ב-Google SecOps, כמו אפשר להגדיר התאמה מדויקת לכותרות או להגדיר את ערך הפרמטר הזה כביטוי רגולרי. המחבר מסנן את הערכים שהוגדרו מהרשימה כדי למנוע מהמחבר להוסיף כותרות לאירוע, מגדירים את ערך הפרמטר באופן הבא: כברירת מחדל, המחבר מוסיף את כל הכותרות הזמינות. |
Case Name Template |
אופציונלי שם מותאם אישית לבקשת התמיכה. כשמגדירים את הפרמטר הזה, המחבר מוסיף מפתח חדש בשם אפשר להוסיף פלייסהולדרים בפורמט הבא:
דוגמה: בפלייסהולדרים, המחבר משתמש באירוע הראשון של Google SecOps SOAR. המחבר מטפל רק במפתחות שמכילים את ערך המחרוזת. |
Alert Name Template |
אופציונלי שם להתראה המותאמת אישית. אפשר להוסיף פלייסהולדרים בפורמט הבא:
דוגמה: בפלייסהולדרים, המחבר משתמש באירוע הראשון של Google SecOps SOAR. המחבר מטפל רק במפתחות שמכילים את ערך המחרוזת. אם לא תזינו ערך או שתזינו תבנית לא חוקית, המחבר ישתמש בשם ברירת המחדל של ההתראה. |
Proxy Server Address |
אופציונלי כתובת שרת ה-Proxy שבו רוצים להשתמש. |
Proxy Username |
אופציונלי שם המשתמש של שרת ה-proxy לאימות. |
Proxy Password |
אופציונלי הסיסמה לאימות מול שרת ה-proxy. |
Mail Field Source |
אופציונלי אם בוחרים באפשרות הזו, השילוב מאחזר את כתובת תיבת הדואר מהמאפיין מופעלת כברירת מחדל. |
Extract URLs from HTML Email Part |
אופציונלי אם בוחרים באפשרות הזו, המחבר מחלץ כתובות URL מגוף ה-HTML של האימייל. כך המחבר יכול לחלץ כתובות URL מורכבות, אבל הוא לא מחלץ כתובות URL מהחלק של הטקסט הפשוט באימייל. כתובות ה-URL שחולצו זמינות בשדה האירוע מופעלת כברירת מחדל. |
Event Fields to Exclude |
אופציונלי רשימה מופרדת בפסיקים של שדות אירועים שרוצים להחריג מיצירת האירוע (למשל |
Exclude Attachments |
אופציונלי אם בוחרים באפשרות הזו, המחבר לא מטמיע קבצים שמצורפים לאימיילים ולא מוסיף אותם לפניות. |
Bypass S/MIME Signature Verification |
אופציונלי אם בוחרים באפשרות הזו, המחבר מטמיע אימיילים שחתומים באמצעות S/MIME בלי לדרוש אישור CA בקידוד Base64 לאימות החתימה. גוף ההודעה, הכותרות והקבצים המצורפים נשלפים ישירות. |
Base64 Encoded Private Key |
אופציונלי המפתח הפרטי בקידוד Base64 שמשמש לפענוח אימיילים נכנסים שמוצפנים ב-S/MIME. אם ציינתם את השדה הזה, אתם צריכים לציין גם את השדה |
Base64 Encoded Certificate |
אופציונלי האישור בקידוד Base64 שמשמש לפענוח אימיילים נכנסים שמוצפנים באמצעות S/MIME. אם ציינתם את השדה הזה, אתם צריכים לציין גם את השדה |
Base64 Encoded CA certificate |
אופציונלי אישור ה-CA המהימן בקידוד Base64 לאימות החתימות הדיגיטליות של אימיילים נכנסים מסוג S/MIME. אם לא מספקים אישור CA, אימות החתימה של אימיילים חתומים נכנסים נכשל, אלא אם המדיניות |
כללי מחברים
המחבר תומך בשרתי proxy.
תעסוקה
כדי להגדיר משימות ב-Google SecOps:
- בתפריט הניווט הימני, לוחצים על Response(תגובה) > Job Scheduler (תזמון משימות).
- בכרטיסייה Jobs, לוחצים על add Create New Job.
- בוחרים את המשרה הרצויה מהרשימה ולוחצים על שמירה.
- עוברים להגדרת המשימה.
משימת חידוש של טוקן רענון
משתמשים ב-Refresh Token Renewal Job כדי לעדכן מדי פעם את טוקן הרענון של השילוב.
כברירת מחדל, התוקף של טוקן הרענון פג כל 90 יום. מומלץ להגדיר שהמשימה הזו תפעל באופן אוטומטי כל 7 או 14 ימים כדי לשמור על עדכניות של טוקן הרענון.
קלט של המשימה
ב-Refresh Token Renewal Job צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Integration Environments |
אופציונלי סביבות השילוב שבהן רוצים לעדכן את טוקני הרענון. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. כדי להגדיר את הפרמטר הזה, צריך להקיף כל שם סביבה במירכאות כפולות |
Connector Names |
אופציונלי שמות המחברים שצריך לעדכן את טוקני הרענון שלהם. הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. כדי להגדיר את הפרמטר הזה, צריך להקיף כל שם של מחבר במירכאות כפולות |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.