אימייל

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

דרישות מוקדמות

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

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

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

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

    כניסה באמצעות סיסמאות לאפליקציות

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

    אפליקציות ברמת אבטחה נמוכה וחשבון Google

גישה לרשת ל-IMAP/SMTP

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

תפקיד יציאת ברירת מחדל כיוון פרוטוקול
API ערכים מרובים להעברת נתונים IMAP/SMTP

שילוב אימייל עם Google Security Operations

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

פעולות

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

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

פרמטרים

פרמטר סוג ערך ברירת המחדל חובה תיאור
נתיב ההורדה String לא רלוונטי כן שמירת קובץ מצורף להודעה בנתיב ההורדה שצוין.
מזהה הודעה String לא רלוונטי לא הורדת קבצים מצורפים מאימייל ספציפי באמצעות המזהה שלו. לדוגמה, example@mail.gmail.com.
מסנן נושאים String לא רלוונטי לא סינון התנאי כדי לחפש אימיילים לפי נושא ספציפי.
מזהה ייחודי (UID) של אימייל String לא רלוונטי לא מזהה ייחודי אוניברסלי (UUID) לסינון.
רק הודעות שלא נקראו תיבת סימון לא רלוונטי לא אם התיבה מסומנת, רק אימיילים שלא נקראו יאוחזרו מתיבת הדואר.

הפעלה ב-

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

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

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

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

שליפת פרטי EML של הודעת אימייל.

פרמטרים

פרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה הודעה String לא רלוונטי לא הורדת קבצים מצורפים מאימייל ספציפי באמצעות המזהה שלו. לדוגמה, example@mail.gmail.com.
קידוד ב-Base64 String TRUE לא סינון התנאי כדי לחפש אימיילים לפי נושא ספציפי.

ריצה

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

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

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

פינג

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

פרמטרים

לא רלוונטי

הפעלה ב-

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

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

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_succeed נכון/לא נכון is_succeed:False

שלח אימייל

יכול להיות שתשלחו אימיילים מתיבת דואר אחת למספר נמענים אקראיים באמצעות הפעולה הזו. יכול להיות שהמשתמשים יקבלו התראה על התוצאה של התראות כאלה מההתראות הרלוונטיות שנוצרו על ידי Google SecOps או על ידי משתמשים. הפעולה יכולה להחזיר את מזהה הודעת האימייל, כדי שתוכלו להשתמש במזהה ההודעה כדי לעקוב אחרי התגובה של שם המשתמש לאימייל הזה בפעולה Wait for User E-mail (המתנה לאימייל מהמשתמש). הוא משמש לשאילת שאלה את המשתמש לגבי מדריך ההפעלה ולפעולה במדריך ההפעלה בהתאם לתשובת המשתמש.

פרמטרים

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

ריצה

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

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

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

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

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

פרמטרים

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

הפעלה ב-

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

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

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאה בפורמט JSON
{
    "body": "Mail Body",
    "receivers": "set(['user1@example.com'])",
    "cc": [],
    "timestamp": 1565012780,
    "raw": "Raw Content",
    "names": {
        "user1@example.com": null,
        "user2@example.com": "Tester Testor"
    },
    "content_type": "multipart/alternative",
    "date": "2019-08-05 16:46:20",
    "subject": "Re: Subject",
    "answer": " ",
    "sender": "user2@example.com",
    "received_timestamp": null,
    "charset": null,
    "bcc": [],
    "to": ["user1@example.com"],
    "email_uid": "173180",
    "received_date": null,
    "reply_to": null,
    "html_body": "HTML Body",
    "message_id": "<id@example-domain>",
    "plaintext_body": "Plain Text Body",
    "in_replay_to": "<id@example-domain>"
}

מחברים

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

Email Connector

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

בנושא הזה מוסבר על המנגנון וההגדרה שבאמצעותם Google SecOps מתחבר ומשתלב עם אימייל IMAP/SMTP, וגם על תהליכי עבודה נתמכים ופעולות שמתבצעות בפלטפורמה. הנושא הזה מתייחס לתקשורת עם שרתים שתומכים ב-IMAP, כמו Gmail,‏ Outlook.com ו-Yahoo!‎. דואר.

העברת אימייל של פנייה ל-Google SecOps

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

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

פרמטר סוג ערך ברירת המחדל תיאור
שם שדה המוצר String device_product פרמטר של מסגרת, צריך להגדיר אותו לכל מחבר. מתאר את השם של השדה שבו מאוחסן שם המוצר.
שם השדה של האירוע String event_name שם השדה שמשמש לקביעת שם האירוע (סוג משנה).
זמן קצוב לסקריפט (בשניות) מספר שלם 60 מגבלת הזמן הקצוב (בשניות) לתהליך Python שבו מופעל התסריט הנוכחי.
אימייל אימייל לא רלוונטי כתובת האימייל של תיבת הדואר שרוצים לעקוב אחריה.
כתובת שרת IMAP IP_OR_HOST לא רלוונטי כתובת שרת ה-IMAP להתחברות.
יציאת IMAP מספר שלם לא רלוונטי יציאת IMAP להתחברות.
שם משתמש String לא רלוונטי שם המשתמש של תיבת הדואר שממנה יתבצע שליפת האימיילים, לדוגמה, user@example.com.
סיסמה סיסמה לא רלוונטי הסיסמה של תיבת הדואר שרוצים לשלוף ממנה אימיילים.
תיקייה לבדיקת אימיילים String תיבת דואר נכנס אפשר להשתמש בפרמטר כדי לציין את תיקיית האימייל בתיבת הדואר לחיפוש האימיילים. הפרמטר צריך גם לקבל רשימה של תיקיות להוספה, מופרדת בפסיקים, כדי לבדוק את תגובת המשתמש בכמה תיקיות. הפרמטר תלוי אותיות רישיות.
אזור הזמן של השרת String UTC אזור הזמן שהוגדר בשרת, דוגמאות (1. ‫UTC, ‏ 2. ‫Asia/Jerusalem).
תבנית ביטוי רגולרי (regex) של סביבה String לא רלוונטי אם מוגדר, המחבר מחלץ את הסביבה משדה האירוע שצוין. אפשר לשנות את נתוני השדה באמצעות תבנית הביטוי הרגולרי field כדי לחלץ מחרוזת ספציפית.
שימוש ב-SSL ב-IMAP תיבת סימון סימן אישור מציין אם להשתמש ב-SSL בחיבור או לא.
אימיילים שעוד לא קראתי בלבד תיבת סימון סימן אישור אם האפשרות הזו מסומנת, רק הודעות שלא נקראו יועברו.
סימון אימיילים כפריטים שנקראו תיבת סימון סימן אישור אם תיבת הסימון הזו מסומנת, האימיילים מסומנים כפריטים שכבר קראתם אחרי שהם נמשכים.
צירוף קובץ EML מקורי תיבת סימון התיבה לא מסומנת אם תיבת הסימון הזו מסומנת, ההודעה המקורית מצורפת כקובץ eml.
ביטויי Regex לטיפול בהודעות אימייל מועברות String N אפשר להשתמש בפרמטר כדי לציין מחרוזת JSON בשורה אחת לטיפול באימיילים מועברים – כדי לחפש את השדות 'נושא', 'מאת' ו'אל' של האימייל המקורי באימייל המועבר.
הפרש הזמן בימים מספר שלם 5 מספר הימים המקסימלי שחלפו מאז שניתן לאחזר הודעות אימייל. דוגמה: 3.
מספר האימיילים המקסימלי בכל מחזור מספר שלם 10 המספר המקסימלי של הודעות אימייל שאפשר לשלוף במחזור אחד.
כתובת שרת ה-Proxy IP_OR_HOST לא רלוונטי הכתובת של שרת ה-Proxy שבו רוצים להשתמש.
שם משתמש של שרת proxy String לא רלוונטי שם המשתמש ב-proxy לאימות.
סיסמת שרת Proxy סיסמה לא רלוונטי סיסמת ה-proxy לאימות.

באזור של הרשימה הדינמית, מוסיפים את הכלל הבא כדי לחלץ ערכים ספציפיים מהאימייל באמצעות הביטוי הרגולרי בפורמט הבא: Display name: matching regular expression.

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

urls: http[s]?://(?:[a-zA-Z]|[0-9]|[$-_@.&+]|[!*(),]|(?:%0-9a-fA-F))+

תרחישים לדוגמה

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

כללים של Connectors

  • המחבר תומך בתקשורת מוצפנת עבור תקשורת עם שרת אימייל (SSL/TLS).

  • המחבר תומך בחיבור לשרת הדואר באמצעות proxy לתנועת נתונים של IMAP ו-IMAPS.

  • למחבר יש פרמטר שמאפשר לציין את תיקיית האימייל בתיבת הדואר לחיפוש האימיילים. הפרמטר מקבל רשימה מופרדת בפסיקים של תיקיות, כדי לבדוק את תגובת המשתמש בכמה תיקיות. הפרמטר הוא תלוי אותיות רישיות (case-sensitive).

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

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