האצלת הגישה לאימייל ב-Microsoft Graph

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

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

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

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

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

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

  4. יוצרים טוקן רענון.

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

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

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

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

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

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

  5. בוחרים את סוגי החשבונות הנתמכים המתאימים.

  6. מגדירים את Redirect URI עם הערכים הבאים:

    1. פלטפורמה: Web

    2. כתובת URL להפניה אוטומטית: http://localhost

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

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

  8. שומרים את הערכים של Application (client) ID ו-Directory (tenant) ID כדי להגדיר את Integration Parameters.

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

כדי להגדיר את הרשאות ה-API לשילוב:

  1. בפורטל Azure, עוברים אל API Permissions ‏> Add a permission.

  2. בוחרים באפשרות Microsoft Graph > Delegated permissions (הרשאות שהוקצו).

  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.

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

כדי ליצור סוד לקוח:

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

  2. מזינים תיאור של סוד הלקוח ומגדירים את תאריך התפוגה שלו.

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

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

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

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

  1. מגדירים את Integration Parameters (פרמטרים של שילוב) (חוץ מהפרמטר Refresh Token) ושומרים אותם.

  2. אופציונלי: מדמים בקשה ב-Google SecOps.

  3. מפעילים את הפעולה Get Authorization.

  4. מריצים את הפעולה Generate Token.

  5. מגדירים את הפרמטר Refresh Token.

אופציונלי: סימולציה של פנייה לתמיכה

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

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

  1. בחלונית הניווט שמימין, לוחצים על Cases.

  2. בדף Cases, לוחצים על add Add a Case > Simulate Cases.

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

  4. לוחצים על Simulate.

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

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

מפעילים את הפעולה "קבלת הרשאה"

כדי להפעיל ידנית את הפעולה Get Authorization:

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

  2. ב-Case View, לוחצים על Manual Action.

  3. בשדה חיפוש של הפעולה הידנית, מזינים Microsoft Graph Mail Delegated.

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

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

  6. אחרי שהפעולה בוצעה, עוברים אל Case Wall (קיר הבקשה) של הבקשה. ברשומת הפעולה Microsoft Graph Mail Delegated_Get Authorization, לוחצים על View More. מעתיקים את הקישור להרשאה.

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

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

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

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

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

כדי להריץ ידנית את הפעולה Generate Token:

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

  2. בכרטיסייה Case View, לוחצים על Manual Action.

  3. בשדה חיפוש של הפעולה הידנית, מזינים Microsoft Graph Mail Delegated.

  4. בתוצאות שמתחת לשילוב Microsoft Graph Mail Delegated, לוחצים על Generate Token.

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

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

  7. אחרי שהפעולה בוצעה, עוברים אל Case Wall של הבקשה. ברשומת הפעולה Microsoft Graph Mail Delegated_Generate Token, לוחצים על View More.

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

הגדרת הפרמטר Refresh Token (טוקן רענון)

  1. עוברים לתיבת הדו-שיח של ההגדרות בשילוב Microsoft Graph Mail Delegated.

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

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

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

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

כדי לשלב את Microsoft Graph Mail Delegated, צריך להגדיר את הפרמטרים הבאים:
פרמטר תיאור
Microsoft Entra ID Endpoint

חובה.

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

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

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

Microsoft Graph Endpoint

חובה.

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

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

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

Client ID

חובה.

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

Client Secret Value

חובה.

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

Microsoft Entra ID Directory ID

חובה.

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

User Mailbox

חובה.

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

Refresh Token

חובה.

טוקן הרענון שמשמש לאימות.

Redirect URL

חובה.

כתובת ה-URL להפניה אוטומטית שהגדרתם כשיצרתם את האפליקציה ב-Microsoft Entra ID.

ערך ברירת המחדל הוא http://localhost.

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

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

פעולות

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

חסימת הדומיין

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

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

קלט של הפעולה

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

פרמטר תיאור
Domains

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

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

Mailboxes

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

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

Rule Name

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

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

Action

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

הפעולה שצריך לבצע בדומיינים האלה. ערכים אפשריים: Select One, ‏ moveToJunk, ‏ delete. ‫Move To Junk יעביר אותן לתיקיית דואר הזבל, ו-Delete ינתב אותן לפריטים שנמחקו. הפעולה Select One שומרת על הפעולה הקיימת אם הכלל קיים.

How many mailboxes to process in a single batch

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

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

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

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

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

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

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

תוצאת הסקריפט

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

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

חסימת השולח

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

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

קלט של הפעולה

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

פרמטר תיאור
Senders

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

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

Mailboxes

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

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

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

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

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

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

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

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

מחיקת האימייל

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

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

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

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

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

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

Rule Name

חובה.

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

How many mailboxes to process in a single batch

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

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

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

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

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

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

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

תוצאת הסקריפט

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

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

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

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

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

קלט של הפעולה

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

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

חובה.

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

Folder Name

אופציונלי

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

Mail IDs

חובה.

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

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

Regex Map JSON

אופציונלי

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

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

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

הפעולה חילוץ נתונים מקובץ EML מצורף מספקת את הפלטים הבאים:

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

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

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "user@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]
הודעות פלט

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

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

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

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר 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

יצירת טוקן

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

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

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

קלט של הפעולה

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

פרמטר תיאור
Authorization URL

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

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

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

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

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

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

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. We recommend you to configure a Refresh Token Renewal Job after you generate the initial refresh token so the job automatically renews and keeps the token valid.

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

Failed to generate a token because the authorization URL that you provided is incorrect. The "code" parameter is missing. Make sure to copy the whole URL properly.

Failed to get the refresh token! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

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

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

תוצאת הסקריפט

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

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

קבלת הרשאה

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

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

קלט של הפעולה

אין.

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

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

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

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

הודעת פלט תיאור ההודעה
Authorization URL generated successfully. To obtain a URL with access code, go to the link below as the user that you configured for the integration. Provide the URL with the access code in the Generate Token action. הפעולה בוצעה בהצלחה.

Failed to generate the authorization URL! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

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

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

תוצאת הסקריפט

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

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

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

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

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

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

קלט של הפעולה

אין.

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

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

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

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

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}
הודעות פלט

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

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

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.

תיבת הדואר שאליה יועברו כללי ההודעות. הערה: אפשר להציג כללי הודעות רק בתיבת הדואר של המשתמש המאומת. כדי לנהל כללים בתיבות דואר אחרות, צריך להשתמש בשילוב של Microsoft Graph Mail.

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

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

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

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

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

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

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

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

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

תוצאת הסקריפט

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

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

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
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

פינג

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

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

קלט של הפעולה

אין.

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

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

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

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

הודעת פלט תיאור ההודעה
Successfully connected to the Microsoft Graph mail service with the provided connection parameters! הפעולה בוצעה בהצלחה.
Failed to connect to the Microsoft Graph mail service! Error is ERROR_REASON

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

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

תוצאת הסקריפט

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

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

הרצת שאילתת חיפוש ב-Microsoft

משתמשים בפעולה Run Microsoft Search Query כדי לבצע שאילתת חיפוש באמצעות מנוע החיפוש של Microsoft. החיפוש מתבצע באמצעות השאילתה הבסיסית או המתקדמת שציינתם. מידע נוסף על Microsoft Search זמין במאמר סקירה כללית של Microsoft Search API ב-Microsoft Graph.

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

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

קלט של הפעולה

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

פרמטר תיאור
Entity Types To Search

אופציונלי

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

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

  • acronym
  • bookmark
  • chatMessage
  • drive
  • driveItem
  • event
  • externalItem
  • list
  • listItem
  • message
  • person
  • site
Fields To Return

אופציונלי

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

Search Query

אופציונלי

השאילתה להרצת החיפוש. למידע נוסף על הדוגמאות לשאילתות חיפוש, קראו את המאמר שימוש ב-Microsoft Search API כדי לחפש הודעות ב-Outlook.

Max Rows To Return

אופציונלי

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

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

Advanced Query

אופציונלי

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

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

הפעולה Run Microsoft Search Query מספקת את הפלטים הבאים:

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

הפעולה Run Microsoft Search Query יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully retrieved results for the provided search query.

No results found for the provided query.

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

Failed to construct a search query based on the provided parameters. Please check, if you specified all parameters properly.

Failed to run the search because the API doesn't support the provided combination of entities. See Microsoft documentation for supported entity combinations - URL. The error is ERROR_REASON

Failed to run the search as the provided advanced search query is invalid! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

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

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

תוצאת הסקריפט

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

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
Domains

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

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

Mailboxes

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

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

Rule Name

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

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

How many mailboxes to process in a single batch

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

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

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

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

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

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

תוצאת הסקריפט

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

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
Senders

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

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

Mailboxes

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

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

Rule Name

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

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

How many mailboxes to process in a single batch

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

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

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

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

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

הפעולה הזו לא פועלת על ישויות של 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.

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

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר 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.

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

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.

קלט של הפעולה

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

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

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

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

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

תוצאת הסקריפט

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

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

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

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

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

  {
    "id": "yyyy",
    "createdDateTime": "2024-02-02T10:57:18Z",
    "lastModifiedDateTime": "2024-02-02T10:57:23Z",
    "changeKey": "dsf+oAAQLaPjk",
    "categories": [],
    "receivedDateTime": "2024-02-02T10:57:20Z",
    "sentDateTime": "2024-02-02T10:57:19Z",
    "hasAttachments": true,
    "internetMessageId": "sdfhsjdfhjsdjfd",
    "subject": "RE: reply checking",
    "bodyPreview": "Reply check kr",
    "importance": "normal",
    "parentFolderId": "id",
    "conversationId": "id",
    "conversationIndex": "sdghfjfke",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "Reply check kr"
    },
    "sender": {
      "emailAddress": {
        "name": "aff",
        "address": "ddxsm@a.com"
      }
    },
    "from": {
      "emailAddress": {
        "name": "fasf",
        "address": "ddxsm@a.com"
      }
    },
    "toRecipients": [
      {
        "emailAddress": {
          "name": "wf",
          "address": "ddxsm@a.com"
        }
      }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
      "contentType": "html",
      "content": "Reply check"
    },
    "flag": {
      "flagStatus": "notFlagged"
    }
  }
הודעות פלט

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

הודעת פלט תיאור ההודעה
Successfully sent reply to the mail with ID: EMAIL_ID הפעולה בוצעה בהצלחה.
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.

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

צריך לבדוק את הערך של הפרמטר 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

אופציונלי

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

הפורמט זהה לפורמט של הפרמטר 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

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

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

תוצאת הסקריפט

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

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

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

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

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

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

קלט של הפעולה

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

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

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

סוג: ישות

תוכן הקובץ המצורף: כותרת, שם הקובץ (כולל סיומות, אם יש), 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, מגדירים את ערך הפרמטר לפלייסהולדר 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 שמתקבל כשמשתמשים בפעולה המתנה לתוצאות ההצבעה באימייל:

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

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

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

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 Mail

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

המחבר המורשה של Microsoft Graph Mail משתמש באימות מורשה ב-Microsoft 365, ודורש התחברות אינטראקטיבית של המשתמש כדי להתחבר ל-Microsoft 365.

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

דרישות מוקדמות לשימוש במחבר

כדי להשתמש ב-Microsoft Graph Mail Delegated Connector, צריך להגדיר את פרמטרי השילוב וליצור טוקן רענון.

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

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

חובה.

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

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

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

Event Field Name

חובה.

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

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

Environment Field Name

אופציונלי

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

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

Environment Regex Pattern

אופציונלי

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

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

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

Email Exclude Pattern

אופציונלי

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

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

Script Timeout (Seconds)

חובה.

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

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

Microsoft Entra ID Endpoint

חובה.

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

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

Microsoft Graph Endpoint

חובה.

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

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

Mail Address

חובה.

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

Refresh Token

חובה.

טוקן הרענון שמשמש לאימות.

Client ID

חובה.

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

Client Secret Value

חובה.

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

Microsoft Entra ID Directory ID

חובה.

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

Folder to check for emails

חובה.

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

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

  1. בתפריט הניווט הימני, לוחצים על Response(תגובה) > Job Scheduler (תזמון משימות).
  2. בכרטיסייה Jobs, לוחצים על add Create New Job.
  3. בוחרים את המשרה הרצויה מהרשימה ולוחצים על שמירה.
  4. עוברים להגדרת המשימה.

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

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

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

קלט של המשימה

ב-Refresh Token Renewal Job צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Integration Environments

אופציונלי

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

כדי להגדיר את הפרמטר הזה, צריך להקיף כל שם סביבה במירכאות כפולות "", למשל "Default environment", "Environment 1" או "Environment 5".

Connector Names

אופציונלי

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

כדי להגדיר את הפרמטר הזה, צריך להקיף כל שם של מחבר במירכאות כפולות "", למשל "Microsoft Graph Mail Delegated Connector", "Connector 2" או "Connector 5".

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