שילוב של Microsoft Graph Mail עם Google SecOps

במאמר הזה מוסבר איך לשלב את Microsoft Graph Mail עם Google Security Operations ‏ (Google SecOps).

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

לפני שמגדירים את השילוב של Microsoft Graph Mail:

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

  2. הגדרת הרשאות API לאפליקציה

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

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

כדי ליצור את אפליקציית Microsoft Entra:

  1. נכנסים לפורטל Azure כאדמין משתמשים או כאדמין סיסמאות.

  2. בוחרים באפשרות Microsoft Entra ID.

  3. עוברים אל App registrations > New registration.

  4. מזינים את שם האפליקציה.

  5. לוחצים על הרשמה.

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

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

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

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

  1. ב-Azure Portal, עוברים אל API Permissions > Add a permission.

  2. בוחרים באפשרות Microsoft Graph > הרשאות לאפליקציה.

  3. בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:

    • Mail.Read
    • Mail.ReadWrite
    • Mail.Send
    • User.Read
    • Directory.Read.All

  4. לוחצים על הוספת הרשאות.

  5. לוחצים על Grant admin consent for ORGANIZATION_NAME (מתן הסכמת אדמין ל-).

    כשמופיעה תיבת הדו-שיח Grant admin consent confirmation, לוחצים על Yes.

הגבלת הגישה של האפליקציה לתיבות דואר ספציפיות

כברירת מחדל, לאפליקציות עם הרשאות Mail.ReadWrite או Mail.Send יש גישה לכל תיבות הדואר בארגון. כדי להגביל את הגישה של האפליקציה רק לתיבות דואר ספציפיות, צריך להגדיר מדיניות גישה לאפליקציות ב-Microsoft Exchange Online.

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

  1. התחברות ל-Exchange Online PowerShell:

    1. פותחים את PowerShell כאדמין.

    2. מתקינים את מודול הניהול של Exchange Online (אם הוא עדיין לא מותקן):

      Install-Module -Name ExchangeOnlineManagement

    3. התחברות ל-Exchange Online:

      Connect-ExchangeOnline

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

    1. מקבלים את מזהה הלקוח (מזהה האפליקציה) של אפליקציית Microsoft Graph Mail מ-Azure AD.

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

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

    1. משתמשים ב-cmdlet‏ New-ApplicationAccessPolicy כדי ליצור מדיניות שמגבילה את הגישה לתיבות דואר נבחרות.

    2. אופציונלי: הגבלת הגישה לקבוצת אבטחה ספציפית של תיבות דואר:

      1. מחליפים את <Your_Application_ID> במזהה הלקוח של האפליקציה.

      2. מחליפים את <Security_Group_Email_Address> בכתובת האימייל של קבוצת האבטחה שמכילה את תיבות הדואר המותרות.

      New-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -PolicyScopeGroupId "<Security_Group_Email_Address>" -AccessRight RestrictAccess -Description "SOAR Graph Mail Access Policy"

  4. כדי לוודא שהמדיניות אפקטיבית, משתמשים ב-cmdlet‏ Test-ApplicationAccessPolicy:

       Test-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -Identity "user_email_to_test@yourdomain.com"

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

שימו לב:

  • כדי ליצור את כללי המדיניות האלה, צריך הרשאות OrganizationManagement או Security Administrator ב-Exchange Online.

  • בדרך כלל, השינויים במדיניות מתעדכנים תוך 30 דקות.

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

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

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

  1. עוברים אל Certificates and secrets > New client secret.

  2. צריך לספק תיאור לסוד הלקוח ולהגדיר את תאריך היעד לתפוגה שלו.

  3. לוחצים על הוספה.

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

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

השילוב של Microsoft Graph Mail דורש את הפרמטרים הבאים:
פרמטר תיאור
Azure AD Endpoint

חובה.

נקודת הקצה של Microsoft Entra ID שבה יש להשתמש בשילוב.

הערך יכול להיות שונה עבור סוגים שונים של דיירים.

ערך ברירת המחדל הוא https://login.microsoftonline.com.
Microsoft Graph Endpoint

חובה.

נקודת הקצה של Microsoft Graph שבה יש להשתמש בשילוב.

הערך יכול להיות שונה עבור סוגים שונים של דיירים.

ערך ברירת המחדל הוא https://graph.microsoft.com.
Client ID

חובה.

מזהה הלקוח (האפליקציה) של אפליקציית Microsoft Entra שבה רוצים להשתמש בשילוב.
Secret ID

חובה.

ערך סוד הלקוח של אפליקציית Microsoft Entra לשימוש בשילוב.
Tenant

חובה.

הערך של Microsoft Entra ID (מזהה הדייר).
Default Mailbox

חובה.

תיבת הדואר לשימוש בשילוב.
Mail Field Source

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, השילוב מאחזר את כתובת תיבת הדואר מהמאפיין mail של פרטי המשתמש. אם לא נבחרה תיבת סימון, השילוב מאחזר את כתובת תיבת הדואר מהשדה userPrincipalName.

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

חובה.

אם האפשרות הזו נבחרה, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Microsoft Graph.

מופעל כברירת מחדל.
Base64 Encoded Private Key

זה שינוי אופציונלי.

המפתח הפרטי בקידוד Base64 שמשמש לפענוח אימיילים מוצפנים ב-S/MIME.

אם מציינים ערך, צריך לציין גם את המאפיין Base64 Encoded Certificate.
Base64 Encoded Certificate

זה שינוי אופציונלי.

האישור בקידוד Base64 שמשמש לפענוח אימיילים שהוצפנו באמצעות S/MIME.

אם מציינים ערך, צריך לציין גם את המאפיין Base64 Encoded Private Key.
Base64 Encoded CA certificate

זה שינוי אופציונלי.

אישור CA המהימן בקידוד Base64 לאימות החתימה.

אם לא מסופק ערך, אימות החתימה של הודעות אימייל חתומות נכשל, אלא אם מופעל הערך Bypass S/MIME Signature Verification.

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

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

פעולות

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

חסימת דומיין

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

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

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

הפעולה Block Domain (חסימת דומיין) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Domains

זה שינוי אופציונלי.

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

חובה. ברירת המחדל היא Default Mailbox.

תיבות דואר שיוסף להן כלל ההודעות. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים.
Rule Name

חובה. ברירת המחדל היא Google SecOps - Blocked Domains.

השם של כלל ההודעות שאליו רוצים להוסיף את הדומיינים האלה. אם הכלל קיים, הוא יעודכן.
Action

חובה. ברירת המחדל היא Select One.

הפעולה שצריך לבצע לגבי הדומיינים האלה. ערכים אפשריים: Select One, ‏ Move To Junk, ‏ Delete. ‫Move To Junk יעביר אותן לתיקיית דואר הזבל, ו-Delete ינתב אותן לתיקייה 'פריטים שנמחקו'. ‫Select One שומרת את הפעולה הקיימת אם הכלל קיים.
How many mailboxes to process in a single batch

זה שינוי אופציונלי. ברירת המחדל היא 20.

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

פלטים של פעולות

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

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

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

{
    "status": "Success",
    "mailbox": "user@domain.com",
    "blocked_domain": "malicious-domain.com"
}
הודעות פלט

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

הודעת פלט תיאור ההודעה

Successfully blocked domain DOMAIN for mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to block domain DOMAIN for mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

חסום את השולח

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

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

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

הפעולה Block Sender (חסימת השולח) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Senders

זה שינוי אופציונלי.

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

חובה. ברירת המחדל היא Default Mailbox.

תיבות דואר שיוסף להן כלל ההודעות. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים.
Rule Name

חובה. ברירת המחדל היא Google SecOps - Blocked Senders.

השם של כלל ההודעות שאליו רוצים להוסיף את השולחים האלה. אם הכלל קיים, הוא יעודכן.
Action

חובה. ברירת המחדל היא Select One.

הפעולה שצריך לבצע לגבי השולחים האלה. ערכים אפשריים: Select One, ‏ Move To Junk, ‏ Delete. ‫Move To Junk יעביר אותן לתיקיית דואר הזבל, ו-Delete ינתב אותן לתיקייה 'פריטים שנמחקו'. Select One שומרת את הפעולה הקיימת אם הכלל קיים.
How many mailboxes to process in a single batch

זה שינוי אופציונלי. ברירת המחדל היא 20.

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

פלטים של פעולות

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

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

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

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
הודעות פלט

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

הודעת פלט תיאור ההודעה

Successfully blocked sender SENDER for mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to block sender SENDER for mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

מחיקת אימייל

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

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

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

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

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

פרמטר תיאור
Delete In Mailbox

חובה.

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

חובה.

תיקיית תיבת דואר לחיפוש אימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Mail IDs

אופציונלי

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

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

אם הפרמטר הזה מצוין, החיפוש מתעלם מהפרמטרים Subject Filter ו-Sender Filter.
Subject Filter

אופציונלי

תנאי סינון שמציין את נושא האימייל לחיפוש.
Sender Filter

אופציונלי

תנאי סינון שמציין את השולח של האימיילים המבוקשים.
Timeframe (Minutes)

אופציונלי

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

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch

אופציונלי

מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר).

ערך ברירת המחדל הוא 25.

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה

Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

 הפעולה הושלמה בהצלחה.

Action was not able to find any emails based on the specified search criteria.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

מחיקת כללים בתיבת הדואר הנכנס

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

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

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

פרמטר תיאור
Mailboxes

חובה. ברירת המחדל היא Default Mailbox.

תיבות דואר שמהן יימחק כלל ההודעות. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים (UPN).
Rule Name

חובה.

השם המדויק של כלל ההודעות בתיבת הדואר הנכנס שרוצים למחוק.
How many mailboxes to process in a single batch

זה שינוי אופציונלי. ברירת המחדל היא 25.

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

פלטים של פעולות

הפעולה Delete Inbox Rules מספקת את הפלט הבא:

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

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

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "labops1@siemplifycyarx.onmicrosoft.com"
    ],
    "failed_mailboxes": [
        "user2@example.com",
        "user3@example.com"
    ]
}
הודעות פלט

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

הודעת פלט תיאור ההודעה

Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

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

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

הפעולה מחליפה את התו של הקו התחתון \` forward slash or/backslash characters in the names of the downloaded attachments with the_`.

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

הפעולה Download Attachments From Email (הורדת קבצים מצורפים מאימייל) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Search In Mailbox

חובה.

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

חובה.

תיקיית תיבת הדואר שבה יתבצע החיפוש. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Download Destination

חובה.

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

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

הערכים האפשריים הם GCP Bucket ו-Local File System. ערך ברירת המחדל הוא GCP Bucket.
Download Path

חובה.

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

כששומרים קבצים מצורפים בקטגוריה של Cloud Storage או במערכת קבצים מקומית, צריך לציין את נתיב ההורדה בפורמט דמוי Unix, כמו /tmp/test.
Mail IDs

אופציונלי

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

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

אם הפרמטר הזה מצוין, החיפוש מתעלם מהפרמטרים Subject Filter ו-Sender Filter.
Subject Filter

אופציונלי

תנאי סינון שמציין את נושא האימייל לחיפוש.

המסנן הזה מבוסס על לוגיקת contains.
Sender Filter

אופציונלי

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

המסנן הזה מבוסס על לוגיקת equals.
Download Attachments From EML

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
Download attachments to unique path?

אופציונלי

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

לא מסומן כברירת מחדל.
How many mailboxes to process in a single batch

אופציונלי

מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר).

ערך ברירת המחדל הוא 25.

פלטים של פעולות

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

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

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

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]
הודעות פלט

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

הודעת פלט תיאור ההודעה

Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS.

Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS.

In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.

 הפעולה הושלמה בהצלחה.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOXES

Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX.

Error executing action. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

חילוץ נתונים מקובץ EML מצורף

משתמשים בפעולה Extract Data From Attached EML (חילוץ נתונים מקובץ EML מצורף) כדי לאחזר נתונים מקבצים מצורפים של EML באימייל ולהחזיר אותם בתוצאות הפעולה. הפעולה הזו תומכת בפורמטים של הקבצים .eml, .msg ו-.ics.

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

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

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

פרמטר תיאור
Search In Mailbox

חובה.

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

אופציונלי

תיקיית תיבת הדואר שבה יתבצע החיפוש. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Mail IDs

חובה.

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

הפרמטר הזה מקבל רשימה של מזהי אימייל שמופרדים בפסיקים, כדי לחפש אותם.
Regex Map JSON

אופציונלי

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

{ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}

פלטים של פעולות

הפעולה Extract Data From Attached EML מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר של בקשות תמיכה לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט 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 מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS

Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST

 הפעולה הושלמה בהצלחה.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOX_LIST

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

העברת אימייל

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

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

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

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

פרמטר תיאור
Send From

חובה.

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

כברירת מחדל, האימייל נשלח מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב.
Folder Name

אופציונלי

תיקיית תיבת דואר לחיפוש אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Mail ID

חובה.

המזהה של האימייל שרוצים להעביר.
Subject

חובה.

נושא האימייל.
Send to

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל של נמעני האימייל, כמו user1@example.com, user2@example.com.
CC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
BCC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
Attachments Paths

אופציונלי

רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים להודעה ומאוחסנים בשרת, כמו /FILE_DIRECTORY/file.pdf או /FILE_DIRECTORY/image.jpg.
Mail content

חובה.

תוכן האימייל.

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה
Email with message ID MAIL_ID was forwarded successfully. הפעולה הושלמה בהצלחה.

Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

הפעולה Get Mailbox Account Out Of Facility Settings משתמשת בגרסת הבטא של Microsoft Graph API.

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

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

אין.

פלטים של פעולות

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

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר של בקשות תמיכה לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully returned OOF settings for ENTITY_ID.

Failed to find the following usernames in Office 365 service: USERNAME_LIST.

 הפעולה הושלמה בהצלחה.

Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON

Action wasn't able to find OOF settings for ENTITY_ID.

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Get Mailbox Account Out Of Facility Settings:

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

כללים לגבי רשימות

משתמשים בפעולה List Rules כדי להציג רשימה של כל כללי ההודעות לתיבת דואר ספציפית באמצעות Microsoft Graph API.

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

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

פרמטר תיאור
Mailboxes

חובה. ברירת המחדל היא Default Mailbox.

תיבות הדואר שרוצים להציג את הכללים שלהן. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים.
Rule Name

זה שינוי אופציונלי.

סינון לפי השם המוצג של הכלל.
Limit

זה שינוי אופציונלי. ברירת המחדל היא 20.

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

פלטים של פעולות

הפעולה List Rules מספקת את הפלט הבא:

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

הפעולה List Rules מספקת פרטי ביצוע בטבלה של קיר התיק.

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

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

[
  {
    "mailbox": "user@example.com",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]
הודעות פלט

הפעולה List Rules מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to fetch rules for mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

סימון אימייל כדואר

משתמשים בפעולה Mark Email as Junk (סימון אימייל כדואר) כדי לסמן אימיילים כדואר בתיבת דואר ספציפית. הפעולה הזו מוסיפה את השולח של האימייל לרשימת השולחים החסומים ומעבירה את ההודעה לתיקייה דואר.

הפעולה סימון אימייל כדואר משתמשת בגרסת הבטא של Microsoft Graph API.

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

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

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

פרמטר תיאור
Search In Mailbox

חובה.

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

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

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

חובה.

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

ערך ברירת המחדל הוא Inbox.
Mail IDs

חובה.

המזהים או internetMessageId הערכים של האימיילים שיש לסמן כספאם.

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

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה

Successfully marked the email as junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

 הפעולה הושלמה בהצלחה.

Error executing action "Mark Email as Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

הפעולה נכשלה.

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

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

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

סימון אימייל כ'לא דואר'

משתמשים בפעולה Mark Email as Not Junk כדי לסמן אימיילים כלא בתיבת דואר ספציפית. הפעולה הזו מסירה את השולח מרשימת השולחים החסומים ומעבירה את ההודעה לתיקייה תיבת הדואר הנכנס.

הפעולה סימון אימייל כלא משתמשת בגרסת הבטא של Microsoft Graph API.

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

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

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

פרמטר תיאור
Search In Mailbox

חובה.

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

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

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

חובה.

תיקיית תיבת דואר שבה יתבצע חיפוש של אימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Mail IDs

חובה.

המזהים או internetMessageId הערכים של האימיילים שיש לסמן כספאם.

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

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה

Successfully marked the email as not junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

 הפעולה הושלמה בהצלחה.

Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

הפעולה נכשלה.

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

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

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

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

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

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

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

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

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

פרמטר תיאור
Move In Mailbox

חובה.

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

Source Folder Name

חובה.

תיקיית מקור שממנה רוצים להעביר את האימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Destination Folder Name

חובה.

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

מציינים את ערך הפרמטר בפורמט הבא: Inbox/folder_name/subfolder_name. הפרמטר הזה לא תלוי באותיות רישיות.
Mail IDs

אופציונלי

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

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

אם הפרמטר הזה מצוין, החיפוש מתעלם מהפרמטרים Subject Filter ו-Sender Filter.
Subject Filter

אופציונלי

תנאי סינון שמציין את נושא האימייל לחיפוש.

המסנן הזה מבוסס על לוגיקת contains.
Sender Filter

אופציונלי

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

המסנן הזה מבוסס על לוגיקת equals.
Timeframe (Minutes)

אופציונלי

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

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch

אופציונלי

מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר).

ערך ברירת המחדל הוא 25.

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה

Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

 הפעולה הושלמה בהצלחה.

Action was not able to find any emails based on the specified search criteria.

Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

פינג

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

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

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

אין.

פלטים של פעולות

בטבלה הבאה מפורטים סוגי הפלט שמשויכים לפעולה Ping:

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

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

הודעת פלט תיאור ההודעה
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

הסרת חסימה של דומיין

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

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

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

הפעולה Remove Block Domain (הסרת חסימה של דומיין) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Domains

זה שינוי אופציונלי.

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

חובה. ברירת המחדל היא Default Mailbox.

תיבות דואר שבהן קיים כלל ההודעות. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים.
Rule Name

חובה. ברירת המחדל היא Google SecOps - Blocked Domains.

השם של כלל ההודעות שממנו רוצים להסיר את הדומיינים האלה.
How many mailboxes to process in a single batch

זה שינוי אופציונלי. ברירת המחדל היא 20.

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

פלטים של פעולות

הפעולה Remove Block Domain מספקת את הפלט הבא:

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

בדוגמה הבאה מתואר פלט של תוצאת JSON שמתקבלת כשמשתמשים בפעולה Remove Block Domain:

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "user@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
הודעות פלט

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

הודעת פלט תיאור ההודעה

Successfully removed domain DOMAIN from the blocked senders list for mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to remove domain DOMAIN from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

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

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

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

פרמטר תיאור
Senders

זה שינוי אופציונלי.

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

חובה. ברירת המחדל היא Default Mailbox.

תיבות דואר שבהן קיים כלל ההודעות. יכול להיות רשימה מופרדת בפסיקים של שמות משתמשים ראשיים.
Rule Name

חובה. ברירת המחדל היא Google SecOps - Blocked Senders.

השם של כלל ההודעות שממנו רוצים להסיר את השולחים האלה.
How many mailboxes to process in a single batch

זה שינוי אופציונלי. ברירת המחדל היא 20.

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

פלטים של פעולות

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

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

בדוגמה הבאה מתואר פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Remove Block Sender:

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
הודעות פלט

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

הודעת פלט תיאור ההודעה

Successfully removed sender SENDER from the blocked senders list for mailbox MAILBOX.

 הפעולה הושלמה בהצלחה.

Failed to remove sender SENDER from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

שמירת האימייל בפנייה

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

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

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

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

פרמטר תיאור
Search In Mailbox

חובה.

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

אופציונלי

תיקיית תיבת דואר שבה יתבצע חיפוש של אימייל. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.
Mail ID

חובה.

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

אם השתמשתם בפעולה Send Email כדי לשלוח אימיילים, צריך להגדיר את ערך הפרמטר ל-placeholder {SendEmail.JSONResult|id} או {SendEmail.JSONResult|internetMessageId}.
Save Only Email Attachments

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
Attachment To Save

אופציונלי

אם הפרמטר Save Only Email Attachments נבחר, הפעולה שומרת רק את הקבצים המצורפים שצוינו בפרמטר הזה.

הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.
Base64 Encode

אופציונלי

אם בוחרים באפשרות הזו, הפעולה מקודדת את קובץ האימייל לפורמט base64.

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

פלטים של פעולות

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

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

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

  • ‫EMAIL_SUBJECT.eml, אם הפעולה שומרת את האימייל.

  • אם הפעולה שומרת את הקובץ המצורף, שם הקובץ המצורף מכיל סיומת קובץ, אם יש כזו.

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

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

{
    "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 מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Email successfully saved!

Successfully saved the following attachments: ATTACHMENTS_LIST

The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST

 הפעולה הושלמה בהצלחה.

Mailbox MAILBOX_NAME was not found.

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

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

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

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

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

פרמטר תיאור
Search In Mailbox חובה

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

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

תיקיית תיבת דואר שבה יתבצע חיפוש של אימיילים. כדי לציין תיקיית משנה, משתמשים בלוכסן / (לדוגמה, Inbox/Subfolder). ברירת המחדל היא Inbox.
Subject Filter אופציונלי

תנאי סינון שמציין את נושא האימייל לחיפוש. המסנן הזה מבוסס על לוגיקת contains.
Sender Filter אופציונלי

תנאי סינון שמציין את השולח של האימיילים המבוקשים. המסנן הזה מבוסס על לוגיקת equals.
Recipient Filter אופציונלי

תנאי סינון שמציין את הנמען של האימיילים המבוקשים.
Timeframe (minutes) אופציונלי

תנאי סינון שמציין את התקופה בדקות שבה יתבצע חיפוש של הודעות אימייל.
Start Time אופציונלי

מציינים את שעת ההתחלה של חיפוש האימייל בפורמט ISO 8601. הפרמטר הזה מקבל עדיפות על פני Timeframe (minutes).
End Time אופציונלי

מציינים את שעת הסיום של חיפוש האימייל בפורמט ISO 8601. אם לא מספקים ערך והפרמטר Start Time תקף, המערכת משתמשת בשעה הנוכחית.
Body Regex Filter אופציונלי

מציינים תבנית של ביטוי רגולרי לחיפוש בגוף האימייל.
Message IDs אופציונלי

רשימה מופרדת בפסיקים של מזהי הודעות לחיפוש. הערה: למסנן הזה יש עדיפות על פני מסננים אחרים.
Max Emails To Return אופציונלי

מספר האימיילים שיוחזרו עבור הפעולה. אם לא מגדירים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. ברירת המחדל היא 10.
Only Unread אופציונלי

אם בוחרים באפשרות הזו, הפעולה מחפשת רק אימיילים שלא נקראו. האפשרות הזו לא מסומנת כברירת מחדל.
Select All Fields For Return אופציונלי

אם בוחרים באפשרות הזו, הפעולה מחזירה את כל השדות הזמינים של האימייל שהתקבל. האפשרות הזו לא מסומנת כברירת מחדל.
How many mailboxes to process in a single batch אופציונלי

מספר תיבות הדואר לעיבוד באצווה אחת (חיבור יחיד לשרת הדואר). ברירת המחדל היא 25.
Search in all mailboxes אופציונלי

אם בוחרים באפשרות הזו, הפעולה מחפשת בכל תיבות הדואר שאפשר לגשת אליהן. האפשרות הזו לא מסומנת כברירת מחדל.
Limit the Amount of Information Returned in the JSON Result אופציונלי

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

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

פלטים של פעולות

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

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

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

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

עמודות:

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

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

שם התוצאה של הסקריפט ערך
is_success true או false
הודעות פלט של פעולות

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

הודעת פלט תיאור ההודעה

Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER

Mailbox MAILBOX was not found.

Action was not able to find any emails based on the specified search criteria.

 הפעולה הושלמה בהצלחה.

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

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

שלח אימייל

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

הפעולה הזו יכולה לשלוח אימיילים בטקסט פשוט או בפורמט 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 Email (שליחת אימייל) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Send From

חובה.

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

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

חובה.

נושא האימייל.
Send to

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל של נמעני האימייל, כמו user1@example.com, user2@example.com.
CC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
BCC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
Attachments Paths

אופציונלי

רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים להודעה ומאוחסנים בשרת, כמו /FILE_DIRECTORY/file.pdf או /FILE_DIRECTORY/image.jpg.
Attachments Location

חובה.

מיקום שבו הקבצים המצורפים מאוחסנים.

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

הערכים האפשריים הם GCP Bucket או Local File System. ערך ברירת המחדל הוא GCP Bucket.
Mail Content Type

אופציונלי

סוג התוכן של האימייל.

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

  • Text
  • HTML

ערך ברירת המחדל הוא Text.
Mail Content

חובה.

תוכן האימייל.
Reply-To Recipients

אופציונלי

רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To.

משתמשים בכותרת Reply-To כדי להפנות מחדש אימיילים של תשובות לכתובת האימייל שצוינה במקום לכתובת של השולח בשדה From.
Base64 Encoded Certificate

אופציונלי

אישור X.509 ציבורי בקידוד Base64 ‏ (.cer,‏ .crt, ‏ .pem) של השולח (פורמט של שורה אחת). משמש לחתימה דיגיטלית של S/MIME.

אם מספקים את Base64 Encoded Private Key, צריך לספק גם את.
Base64 Encoded Private Key

אופציונלי

המפתח הפרטי בקידוד Base64 ‏ (.key, .pem) של השולח (פורמט של שורה אחת). משמש לחתימה דיגיטלית של S/MIME.

חובה אם צוין הערך Base64 Encoded Certificate.
Base64 Encoded Recipient Certificate

אופציונלי

האישור הציבורי בקידוד Base64 (.cer,‏ .crt, ‏ .pem) של הנמען (פורמט של שורה אחת). משמש להצפנת אימייל.

פלטים של פעולות

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

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

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

הודעת פלט תיאור ההודעה

Email was sent successfully.

 הפעולה הושלמה בהצלחה.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

שליחת HTML של אימייל

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

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

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

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

פרמטר תיאור
Send From

חובה.

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

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

חובה.

נושא האימייל.
Send to

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל של נמעני האימייל, כמו user1@example.com, user2@example.com.
CC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
BCC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
Attachments Paths

אופציונלי

נתיב מלא של הקובץ המצורף שרוצים לספק, כמו /FILE_DIRECTORY/file.pdf או /FILE_DIRECTORY/image.jpg.

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

חובה.

סוג תבנית ה-HTML שבה רוצים להשתמש.

הערכים האפשריים הם Email HTML Template ו-Dynamically generated list of available templates.

ערך ברירת המחדל הוא Email HTML Template.
Mail Content

חובה.

תוכן האימייל.
Reply-To Recipients

אופציונלי

רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To.

משתמשים בכותרת Reply-To כדי להפנות מחדש את התשובות לאימייל לכתובת אימייל ספציפית במקום לכתובת של השולח שמופיעה בשדה From.
Attachment Location

חובה.

מיקום שבו הקבצים המצורפים מאוחסנים.

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

הערכים האפשריים הם GCP Bucket או Local File System. ערך ברירת המחדל הוא GCP Bucket.

פלטים של פעולות

הפעולה Send Email HTML מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר של בקשות תמיכה לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט 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. הפעולה הושלמה בהצלחה.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

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

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

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

פרמטר תיאור
Send From

חובה.

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

כברירת מחדל, הפעולה שולחת אימיילים מתיבת הדואר שמוגדרת כברירת מחדל בהגדרות השילוב.
Mail ID

חובה.

מזהה האימייל לחיפוש.
Folder Name

אופציונלי

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

ערך ברירת המחדל הוא Inbox.
Attachments Paths

אופציונלי

רשימה מופרדת בפסיקים של נתיבים לקבצים שמצורפים להודעה ומאוחסנים בשרת, כמו /FILE_DIRECTORY/file.pdf או /FILE_DIRECTORY/image.jpg.
Mail Content

חובה.

תוכן האימייל.
Reply All

אופציונלי

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

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

הפרמטר הזה מקבל עדיפות על פני הפרמטר Reply To.
Reply To

אופציונלי

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

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

אם תיבת הסימון Reply All מסומנת, הפעולה מתעלמת מהפרמטר הזה.
Attachments Location

חובה.

מיקום שבו הקבצים המצורפים מאוחסנים.

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

הערכים האפשריים הם GCP Bucket או Local File System. ערך ברירת המחדל הוא GCP Bucket.
Message Timezone

זה שינוי אופציונלי.

אזור הזמן שבו נעשה שימוש בתאריך השליחה של האימייל המקורי בכותרת של התשובה (למשל UTC, America/New_York או Europe/London). אם הערך שצוין לא תקין, נעשה שימוש בערך ברירת המחדל.

ערך ברירת המחדל הוא UTC.

פלטים של פעולות

בטבלה הבאה מפורטים סוגי הפלט שמשויכים לפעולה Send Thread Reply:

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

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

  {
    "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"
    }
  }
הודעות פלט

הפעולה Send Thread Reply מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
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.

הפעולה נכשלה.

בודקים את ערך הפרמטר Reply To.

Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

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

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

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

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

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

פרמטר תיאור
Send From

חובה.

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

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

חובה.

נושא האימייל.
Send to

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל של נמעני האימייל, כמו user1@example.com, user2@example.com.
CC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
BCC

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר Send to.
Attachments Paths

אופציונלי

נתיב מלא של הקובץ המצורף שרוצים לספק, כמו /FILE_DIRECTORY/file.pdf או /FILE_DIRECTORY/image.jpg.

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

חובה.

סוג תבנית ה-HTML שבה רוצים להשתמש.

הערכים האפשריים הם Email HTML Template ו-Dynamically generated list of available templates.

ערך ברירת המחדל הוא Email HTML Template.
Reply-To Recipients

אופציונלי

רשימה מופרדת בפסיקים של נמענים לשימוש בכותרת Reply-To.

משתמשים בכותרת Reply-To כדי להפנות מחדש אימיילים של תשובות לכתובת האימייל שצוינה במקום לכתובת האימייל של השולח שצוינה בשדה From.
Structure of voting options

חובה.

המבנה של ההצבעה שיישלח לנמענים.

הערכים האפשריים הם Yes/No או Approve/Reject. ערך ברירת המחדל הוא Yes/No.

Attachment Location

חובה.

מיקום שבו הקבצים המצורפים מאוחסנים.

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

הערכים האפשריים הם GCP Bucket או Local File System. ערך ברירת המחדל הוא GCP Bucket.

פלטים של פעולות

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

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר של בקשות תמיכה לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט 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. הפעולה הושלמה בהצלחה.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

המתנה לאימייל ממשתמש

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

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

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

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

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

פרמטר תיאור
Mail ID חובה

המזהה או internetMessageId של האימייל שהפעולה תחכה לו. אם השתמשתם בפעולה שליחת אימייל כדי לשלוח אימיילים, צריך להגדיר את ערך הפרמטר ל-placeholder ‏{SendEmail.JSONResult|id} או {SendEmail.JSONResult|internetMessageId}.
Mail Date אופציונלי

שליחת חותמת הזמן של האימייל שהפעולה ממתינה לו. אם ההודעה נשלחה באמצעות הפעולה שליחת אימייל, בוחרים בשדה {SendEmail.JSONResult|sentDateTime} או {SendEmail.JSONResult|createdDateTime} כמחזיק מקום.
Mail Recipients אופציונלי

רשימה מופרדת בפסיקים של כתובות אימייל של נמענים שהפעולה ממתינה לתשובה שלהם. אם ההודעה נשלחה באמצעות הפעולה שליחת אימייל, בוחרים בשדה {SendEmail.JSONResult|toRecipients} כמחזיק מקום.
How long to wait for recipient reply (minutes) אופציונלי

כמה דקות לחכות לתשובת המשתמש לפני שמסמנים שהזמן לתשובה חלף. ברירת המחדל היא 10080.
Wait for All Recipients to Reply? אופציונלי

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

ביטוי רגולרי להחרגת תשובות ספציפיות משלב ההמתנה. הפרמטר הזה פועל גם עם נושא האימייל וגם עם גוף האימייל. לדוגמה, אם מגדירים את הביטוי הרגולרי Out of Office.*, הפעולה לא מתייחסת להודעות אוטומטיות של 'מחוץ למשרד' כתשובות של נמענים, ומחכה לתשובה ממשתמש.
Folder to Check for Reply אופציונלי

תיקיית אימייל בתיבת הדואר לחיפוש תשובות נכנסות של נמענים. החיפוש מתבצע בתיבת הדואר שממנה נשלח האימייל עם השאלה. תומך בתיקיות משנה מקוננות באמצעות לוכסן / (לדוגמה, Inbox/Subfolder). הפרמטר הזה הוא תלוי אותיות רישיות. ברירת המחדל היא Inbox.
Fetch Response Attachments אופציונלי

אם האפשרות הזו נבחרה והתשובה של הנמען מכילה קבצים מצורפים, הפעולה מאחזרת את התשובה ומוסיפה אותה כקובץ מצורף לתוצאת הפעולה. האפשרות הזו לא מסומנת כברירת מחדל.
Limit the Amount of Information Returned in the JSON Result אופציונלי

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

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

פלטים של פעולות

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

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

הקובץ המצורף הבא ב-Case Wall משויך לפעולה המתנה לאימייל ממשתמש:

סוג: ישות

תוכן הקובץ המצורף: כותרת, שם הקובץ (כולל סיומות, אם יש), fileContent.

  • שם: RECIPIENT_EMAIL קובץ מצורף לתשובה.
  • שם הקובץ: ATTACHMENT_FILENAME + FILE_EXTENSION
  • fileContent: CONTENT_OF_THE_ATTACHED_FILE
טבלת קיר של בקשות תמיכה

הפעולה Wait For Email From User יכולה ליצור את הטבלה הבאה:

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

עמודות:

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

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

שם התוצאה של הסקריפט ערך
is_success true או false
הודעות פלט של פעולות

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

הודעת פלט תיאור ההודעה

Found the user EMAIL_RECIPIENT reply: USER_REPLY

Timeout getting reply from user: EMAIL_RECIPIENT.

 הפעולה הושלמה בהצלחה.

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

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

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

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

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

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

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

הפעולה Wait For Vote Email Results דורשת את הפרמטרים הבאים:

פרמטר תיאור
Vote Mail Sent From

חובה.

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

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

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

חובה.

המזהה של האימייל.

אם האימייל נשלח באמצעות הפעולה Send Vote Email, צריך להגדיר את ערך הפרמטר ל-placeholder SendVoteEmail.JSONResult|id או SendEmail.JSONResult|internetMessageId.

כדי להחזיר מזהי אימייל, אפשר להשתמש בפעולה Search Emails.
Wait for All Recipients To Reply?

אופציונלי

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

מופעל כברירת מחדל.
Wait Stage Exclude Pattern

אופציונלי

ביטוי רגולרי להחרגת תשובות ספציפיות משלב ההמתנה.

הפרמטר הזה פועל עם תוכן האימייל.

דוגמה: הפעולה לא מתייחסת להודעות אוטומטיות של "לא בעבודה" כתשובות של הנמען, אלא מחכה לתשובה ממשתמש.
Folder To Check For Reply

אופציונלי

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

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

הפרמטר הזה הוא תלוי אותיות רישיות.

ערך ברירת המחדל הוא Inbox.
Folder To Check For Sent Mail

אופציונלי

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

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

הפרמטר הזה הוא תלוי אותיות רישיות. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו Inbox/Subfolder.

ערך ברירת המחדל הוא Sent Items.
Fetch Response Attachments

אופציונלי

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

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

פלטים של פעולות

הפעולה Wait For Vote Email Results מספקת את הפלטים הבאים:

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

הקובץ המצורף הבא ב-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 שמתקבל כשמשתמשים בפעולה Wait For Vote Email Results:

{
    "Responses": [
        {
            "recipient": "user@example.com",
            "vote": "Approve"
        }
    ]
}
הודעות פלט

הפעולה Wait For Vote Email Results מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Found the user EMAIL_RECIPIENT reply: USER_REPLY.

Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.

 הפעולה הושלמה בהצלחה.

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

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

מחברים

מידע נוסף על הגדרת מחברים ב-Google SecOps זמין במאמר העברת נתונים (מחברים).

מחבר הדואר של Microsoft Graph

אפשר להשתמש ב-Microsoft Graph Mail Connector כדי לאחזר אימיילים משירות האימייל של Microsoft Graph.

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

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

מחבר Microsoft Graph Mail Delegated דורש את הפרמטרים הבאים:
פרמטר תיאור
Product Field Name

חובה.

שם השדה שבו מאוחסן שם המוצר.

ערך ברירת המחדל הוא device_product.

שם המוצר משפיע בעיקר על המיפוי. כדי לייעל ולשפר את תהליך המיפוי של כלי החיבור, ערך ברירת המחדל device_product מומר לערך חלופי שמופיע בקוד. כל קלט לא תקין לפרמטר הזה יומר כברירת מחדל לערך חלופי.
Event Field Name

חובה.

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

ערך ברירת המחדל הוא event_name.
Environment Field Name

אופציונלי

שם השדה שבו מאוחסן שם הסביבה.

אם השדה environment לא נמצא, הסביבה מוגדרת ל-"".

Environment Regex Pattern

אופציונלי

תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לכם לשנות את השדה environment באמצעות לוגיקה של ביטוי רגולרי.

משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הנדרש Environment Field Name.

אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא "".
Email Exclude Pattern

אופציונלי

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

הפרמטר הזה פועל גם עם הנושא וגם עם גוף האימייל.
PythonProcessTimeout

חובה.

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

ערך ברירת המחדל הוא 300.
Azure AD Endpoint

חובה.

נקודת הקצה של Microsoft Entra שבה צריך להשתמש בשילוב.

ערך ברירת המחדל הוא https://login.microsoftonline.com.
Microsoft Graph Endpoint

חובה.

נקודת הקצה של Microsoft Graph שבה יש להשתמש בשילוב.

ערך ברירת המחדל הוא https://graph.microsoft.com.
Mail Address

חובה.

כתובת אימייל לשימוש המחבר.
Client ID

חובה.

מזהה האפליקציה (הלקוח) של אפליקציית Microsoft Entra.
Secret ID

חובה.

ערך סוד הלקוח של אפליקציית Microsoft Entra.
Tenant (Directory) ID

חובה.

הערך של Microsoft Entra ID (מזהה הדייר).
Folder to check for emails

חובה.

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

הפרמטר הזה הוא תלוי אותיות רישיות.

ערך ברירת המחדל הוא Inbox.
Offset Time In Hours

חובה.

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

ערך ברירת המחדל הוא 24.
Max Emails Per Cycle

חובה.

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

ערך ברירת המחדל הוא 10.
Unread Emails Only

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
Mark Emails as Read

אופציונלי

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

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

אופציונלי

אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון הגלישה של Google SecOps.

לא מסומן כברירת מחדל.
Verify SSL

חובה.

אם האפשרות הזו נבחרה, השילוב מאמת את אישור ה-SSL כשמתחברים ל-Microsoft Graph.

מופעל כברירת מחדל.
Original Received Mail Prefix

אופציונלי

קידומת להוספה למפתחות האירועים שחולצו (לדוגמה, to,‏ from או subject) מהאימייל המקורי שהתקבל בתיבת הדואר הנכנס שבמעקב.

ערך ברירת המחדל הוא orig.
Attached Mail File Prefix

אופציונלי

קידומת להוספה למפתחות האירועים שחולצו (לדוגמה, to, from או subject) מקובץ האימייל המצורף שהתקבל בתיבת הדואר הנכנס שבמעקב.

ערך ברירת המחדל הוא attach.
Create a Separate Google Secops Alert per Attached Mail File

אופציונלי

אם בוחרים באפשרות הזו, המחבר יוצר כמה התראות, אחת לכל קובץ אימייל מצורף.

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

האפשרות הזו לא מסומנת כברירת מחדל.
Attach Original EML

אופציונלי

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

האפשרות הזו לא מסומנת כברירת מחדל.
Headers to add to events

אופציונלי

מחרוזת של כותרות אימייל מופרדות בפסיקים שרוצים להוסיף לאירועים ב-Google SecOps, כמו DKIM-Siganture,‏ Received או From.

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

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

כדי למנוע מהמחבר להוסיף כותרות לאירוע, מגדירים את ערך הפרמטר באופן הבא: None.

כברירת מחדל, המחבר מוסיף את כל הכותרות הזמינות.
Case Name Template

אופציונלי

שם מותאם אישית של בקשת התמיכה.

כשמגדירים את הפרמטר הזה, המחבר מוסיף מפתח חדש בשם custom_case_name לאירוע Google SecOps SOAR.

אפשר לספק את משתני המיקום בפורמט הבא: [name of the field].

דוגמה: Phishing - [event_mailbox]

במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps SOAR. המחבר מטפל רק במפתחות שמכילים את ערך המחרוזת.
Alert Name Template

אופציונלי

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

אפשר לספק את משתני המיקום בפורמט הבא: [name of the field].

דוגמה: Phishing - [event_mailbox]

במקרה של placeholders, המחבר משתמש באירוע הראשון של Google SecOps SOAR. המחבר מטפל רק במפתחות שמכילים את ערך המחרוזת. אם לא תספקו ערך או תספקו תבנית לא תקינה, המחבר ישתמש בשם ברירת המחדל של ההתראה.
Proxy Server Address

אופציונלי

הכתובת של שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username

אופציונלי

שם המשתמש ב-proxy לאימות.
Proxy Password

אופציונלי

סיסמת ה-proxy לאימות.
Mail Field Source

אופציונלי

אם בוחרים באפשרות הזו, השילוב מאחזר את כתובת תיבת הדואר מהמאפיין mail של פרטי המשתמש. אם לא נבחרה תיבת סימון, השילוב מאחזר את כתובת תיבת הדואר מהשדה userPrincipalName.

האפשרות הזו לא מסומנת כברירת מחדל.
Extract URLs from HTML Email Part

אופציונלי

אם בוחרים באפשרות הזו, המחבר מחלץ כתובות URL מגוף ה-HTML של האימייל. כך המחבר יכול לחלץ כתובות URL מורכבות, אבל הוא לא יכול לחלץ כתובות URL מחלק הטקסט הפשוט של האימייל.

כתובות ה-URL שחולצו זמינות בשדה האירוע urls_from_html_part.

מופעל כברירת מחדל.
Event Fields to Exclude

אופציונלי

רשימה מופרדת בפסיקים של שדות אירועים שיוחרגו מיצירת האירוע (למשל field1,field2).
Exclude Attachments

אופציונלי

אם האפשרות הזו נבחרה, המחבר לא קולט קבצים מצורפים לאימייל ולא מוסיף אותם לתיקים.
Bypass S/MIME Signature Verification

אופציונלי

אם בוחרים באפשרות הזו, המחבר קולט אימיילים שחתומים באמצעות S/MIME בלי לדרוש אישור CA בקידוד Base64 לאימות החתימה. גוף ההודעה, הכותרות והקבצים המצורפים מחולצים ישירות.
Base64 Encoded Private Key

אופציונלי

המפתח הפרטי בקידוד Base64 שמשמש לפענוח אימיילים מוצפנים ב-S/MIME שמגיעים.

אם מספקים את Base64 Encoded Certificate, צריך לספק גם את.
Base64 Encoded Certificate

אופציונלי

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

אם מספקים את Base64 Encoded Private Key, צריך לספק גם את.
Base64 Encoded CA certificate

אופציונלי

אישור CA מהימן בקידוד Base64 לאימות החתימות הדיגיטליות של אימיילים נכנסים ב-S/MIME.

אם לא מסופק אישור CA, אימות החתימה של אימיילים חתומים נכנסים נכשל, אלא אם המדיניות Bypass S/MIME Signature Verification מופעלת.

כללים של מחברים

המחבר תומך בשרתי proxy.

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