שילוב של 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 Management (אם הוא עדיין לא מותקן):

      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. שומרים את הערך של סוד הלקוח (לא את מזהה הסוד) כדי להשתמש בו בתור ערך הפרמטר Secret ID כשמגדירים את השילוב. הערך של סוד הלקוח מוצג רק פעם אחת.

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

כדי לשלב את 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. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.

פעולות

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

חסימת דומיין

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

הפעולה הזו היא אסינכרונית. אם צריך, משנים את הזמן הקצוב לתפוגה של הפעולה בסביבת הפיתוח המשולבת (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.

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

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

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

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

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

ערכי פלט של פעולות

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

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
Mailboxes

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

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

חובה.

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

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

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

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

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

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

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

משתמשים בפעולה 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

חובה.

תיקייה בתיבת הדואר שבה רוצים להריץ את החיפוש. כדי לציין תיקיית משנה, משתמשים בלוכסן /, כמו 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.

ערכי פלט של פעולות

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

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

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

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, .msg ו-.ics.

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

קלט של הפעולה

הפעולה חילוץ נתונים מקובץ 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 מספקת את הפלט הבא:

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

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

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

בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה חילוץ נתונים מקובץ 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

אופציונלי

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

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

אופציונלי

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

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

אופציונלי

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

חובה.

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

ערכי פלט של פעולות

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

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

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

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

כללי הרשימה

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

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

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

פרמטר תיאור
Mailboxes

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

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

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

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

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

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

ערכי פלט של פעולות

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

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

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

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

השתמש בפעולה <simg class=" ... הפעולה הזו מוסיפה את השולח של האימייל לרשימת השולחים החסומים ומעבירה את ההודעה לתיקייה דואר.

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

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

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

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

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

חובה.

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

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

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

חובה.

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

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

חובה.

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

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

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

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

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

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

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

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

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

קלט של הפעולה

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

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

חובה.

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

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

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

חובה.

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

חובה.

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

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

ערכי פלט של פעולות

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

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

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

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

הפעולה הזו היא אסינכרונית. בסביבת הפיתוח המשולבת (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.

ערכי פלט של פעולות

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

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

הפעולה Move Email To Folder מספקת את הודעות הפלט הבאות:

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

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:

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

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

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

פרמטר תיאור
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 מספקת את הפלט הבא:

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

קלט של הפעולה

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

פרמטר תיאור
Senders

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

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

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

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

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

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

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

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

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

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

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

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

[
  {
    "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 כדי לשלוח אימיילים, הגדירו את ערך הפרמטר לפלייסהולדר {SendEmail.JSONResult|id} או {SendEmail.JSONResult|internetMessageId}.
Save Only Email Attachments

אופציונלי

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

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

אופציונלי

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

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

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

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

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

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

בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Save Email To The Case:

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

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

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

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

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

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

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

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

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

לחיפושים מורכבים במספר משמעותי של תיבות דואר, השתמשו בשילוב של Exchange Extension Pack.
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. האפשרות הזו לא מסומנת כברירת מחדל.

ערכי פלט של פעולות

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

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

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

שלח אימייל

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

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

חובה.

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

אופציונלי

רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" (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) של הנמען (פורמט של שורה אחת). משמש להצפנת אימיילים.

ערכי פלט של פעולות

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

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

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

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

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

שם תוצאת הסקריפט ערך
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

אופציונלי

רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" (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.

ערכי פלט של פעולות

הפעולה שליחת אימייל ב-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. הפעולה הושלמה בהצלחה.

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 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:

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

הפעולה 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

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

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

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

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

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

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

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

קלט של הפעולה

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

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

חובה.

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

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

חובה.

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

חובה.

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

אופציונלי

רשימה מופרדת בפסיקים של כתובות אימייל לשדה "עותק" (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.

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

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

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

ערכי פלט של פעולות

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

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

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

סוג: ישות

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

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

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

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

עמודות:

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

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

שם תוצאת הסקריפט ערך
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.

קלט של הפעולה

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

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

חובה.

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

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

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

חובה.

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

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

כדי להחזיר מזהי אימיילים, אפשר להשתמש בפעולה חיפוש אימיילים.
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.

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

ערכי פלט של פעולות

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

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

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

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

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

שם התוצאה של הסקריפט ערך
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]

בפלייסהולדרים, המחבר משתמש באירוע הראשון של 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.