Skip to main content
אינטגרציית Microsoft Teams שולחת התראות של Living Security אל משתמשים וערוצים באמצעות אפליקציית Teams של Living Security. ניתן להשתמש בה להקצאות הדרכה, להתראות על סיכון אנושי, להודעות פריסה ולהודעות של צוות האבטחה. אינטגרציה זו מיועדת להתראות בלבד. משתמשים אינם שולחים פקודות אל הבוט ב-Microsoft Teams. לאחר התקנת האפליקציה, הבוט שומר את הפניית השיחה (conversation reference) של Teams לצורך התראות יזומות עתידיות. הודעות ההתקנה הן חד-כיווניות וניתן להתאים אותן אישית או לבטל אותן בהתאם לדרישות הפריסה הארגונית.
מנהל Microsoft Teams עדיין נדרש להעלות, לאשר ולהפיץ את אפליקציית Teams של Living Security. הסכמת מנהל (admin consent) של Microsoft Entra User.Read.All היא אופציונלית ומאפשרת רק חיפוש חלופי לפי כתובת דוא”ל או שם עיקרי של משתמש (UPN).
להגדרת מסירה של דחיפות ופלייבוקים, התחילו ב-הגדרות → תקשורת → ערוצים ולחצו על הכרטיס Microsoft Teams. דף זה מתאר את תצורת אפליקציית Teams הבסיסית.

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

לפני הגדרת Microsoft Teams, ודאו שברשותכם:
  • מנהל Microsoft Teams שיכול להעלות ולאשר אפליקציות ארגוניות. אותו אדם יכול להחזיק בשני תפקידי הניהול.
  • מנהל Microsoft Entra, רק אם ברצונכם להפעיל את החיפוש החלופי האופציונלי לפי דוא”ל/UPN עם הסכמת אפליקציה ברמת הדייר (tenant) עבור User.Read.All
  • הרשאות מנהל ב-Living Security
  • ארגון פעיל ב-Living Security
  • שמות הצוות והערוץ שאליהם יש להעביר הודעות אבטחה, אם הודעות בערוצים מופעלות
  • מזהה הדייר (tenant ID) שלכם ב-Microsoft Entra, הזמין תחת Microsoft Entra admin center → זהות → סקירה כללית

חלוקת האחריות

אלה יכולים להיות אנשים שונים. שתפו עם מנהל Microsoft Teams את סכום הביקורת (checksum) של החבילה, את Teams app ID, את Bot app ID ואת אוכלוסיית הפריסה המיועדת. שתפו את כתובת ההסכמה שנוצרה עם מנהל Microsoft Entra רק בעת הפעלת החיפוש החלופי האופציונלי לפי דוא”ל/UPN. אין לשתף פרטי גישה אחרים של Living Security שאינם קשורים.

הגדרה

1

פתחו את לוח ההגדרה של Microsoft Teams

ב-Living Security, עברו אל הגדרות → תקשורת → ערוצים ובחרו Microsoft Teams.הלוח מציג את אזור הארגון שלכם, שם קובץ החבילה, Teams app ID, bot app ID, סכום ביקורת SHA256, סטטוס תצורת דייר Microsoft, הוראות התקנה, פקדי הודעות התקנה, אימות וכלים לשליחת התראות בדיקה.
האזור המוצג ב-Living Security תואם לאזור שבו הארגון שלכם מתארח.
2

חברו את דייר Microsoft שלכם

ב-Connect your tenant, הזינו את מזהה הדייר של Microsoft Entra שבבעלותו נמצאים המשתמשים וערוצי Teams שמקבלים התראות, ולאחר מכן לחצו על Save Microsoft tenant. דייר Microsoft אחד יכול להשתייך לארגון Living Security אחד בלבד.אם פקד הדייר אינו זמין, פנו לבעלי הטמעת Living Security או לאיש קשר בתמיכה כדי לחבר או לשנות את הדייר לפני התקנת האפליקציה.
Living Security מציגה Microsoft tenant connected לפני שתמשיכו.
מומלץ לחבר את הדייר לפני התקנת אפליקציית Teams. אם האפליקציה כבר מותקנת, שמרו את הדייר ובחרו תחילה Validate install. Living Security מנסה לשייך את ההתקנה הקיימת באופן אוטומטי; התקינו מחדש רק אם האימות אינו מצליח לאתר אותה.
3

הורידו את חבילת Teams האזורית

לחצו על Download Teams package. Living Security מספקת חבילת ZIP ייעודית לאזור של הארגון שלכם.לפני שאתם משנים משהו, אמתו את הקובץ שהורד מול סכום הביקורת SHA256 המוצג ב-Living Security. כדי לתת לאפליקציה שם וסמלים משלכם, פעלו לפי התאמת המיתוג של החבילה האזורית לאחר בדיקה זו ולפני העלאת החבילה.
סכום הביקורת של הקובץ שהורד תואם לסכום הביקורת SHA256 המוצג ב-Living Security.
4

העלו והתקינו את החבילה ב-Teams admin center

ב-Microsoft Teams admin center, עברו אל Teams apps → Manage apps → Actions → Upload new app, ולאחר מכן העלו את קובץ ה-ZIP שהורד מ-Living Security.אשרו את הפרטים הבאים:
  • Teams app ID ו-bot app ID תואמים לערכים המוצגים ב-Living Security
  • שם האפליקציה הוא השם האזורי של Living Security, או השם שהגדרתם אם התאמתם את מיתוג החבילה
  • המפרסם הוא Living Security. התאמת המיתוג של החבילה אינה משנה את המפרסם
  • האפליקציה אינה חסומה
  • האפליקציה זמינה למשתמשים או לקבוצות המיועדים
  • האפליקציה מותקנת באמצעות מדיניות הגדרת אפליקציות או התקנה ממוקדת עבור המשתמשים והצוותות/הערוצים שאמורים לקבל התראות
ייתכן ש-Microsoft תזדקק לזמן להפצת שינויים בזמינות האפליקציה ובמדיניות ההגדרה.
אם האימות או הבדיקה נכשלים מיד לאחר שינוי במדיניות האפליקציה, ודאו את הקצאת המדיניות ב-Microsoft Teams admin center ונסו שוב לאחר ש-Microsoft תסיים להפיץ אותה.
5

התקינו או פתחו את האפליקציה

הפיצו את האפליקציה האישית למשתמשים המיועדים. לפני ש-Living Security יכולה לשלוח בדיקה אישית להתקנה שזוהתה, לפחות משתמש אחד צריך להתקין או לפתוח את האפליקציה האישית של Living Security ב-Microsoft Teams. פעולה זו מאפשרת לבוט לקלוט את הזהות המהימנה של המשתמש ואת הפניית השיחה האישית שלו. התקנה בערוץ בלבד אינה מספיקה לבדיקה אישית של התקנה שזוהתה.למסירה לערוץ, התקינו את האפליקציה בצוות ובערוץ המיועדים כדי שהבוט יוכל לקלוט את הפניית השיחה של אותו ערוץ.
משתמש יעד התקין או פתח את האפליקציה האישית, או שהאפליקציה מותקנת בערוץ המיועד.
6

הגדירו הודעות התקנה

בקטע Install message controls, בחרו אם לשלוח הודעות התקנה ב-Teams והתאימו אישית את נוסח ההודעה החד-כיוונית עבור הארגון שלכם.הפקדים הזמינים:
  • Send install messages
  • Send personal install messages
  • Send channel install messages
  • Default message
  • Personal message
  • Channel message
שדות ההודעה תומכים ב-{{installerName}}, שמוחלף בשם התצוגה של המשתמש שהתקין את האפליקציה. השאירו הודעה אישית או הודעת ערוץ ריקה כדי להשתמש בהודעת ברירת המחדל שהגדרתם. אם גם הודעת ברירת המחדל ריקה, Living Security משתמשת בהודעה המובנית עבור אותו היקף.
7

אמתו את ההגדרה

לחצו על Validate install ב-Living Security. האימות בודק שהחבילה האזורית זמינה, שתצורת דייר Microsoft קיימת וייחודית לארגון Living Security זה, שפרטי הגישה של הבוט האזורי מוגדרים, ושזוהתה התקנה פעילה של האפליקציה עבור הדייר המחובר.
האימות מציג Validation passed לפני שליחת התראות חיות.
8

שלחו התראות בדיקה

לבדיקה האישית כברירת מחדל, לחצו על Send test to detected installation. Living Security בוחרת התקנה אישית פעילה שזוהתה ומשתמשת בזהות המהימנה ובהפניית השיחה ששמרה. בדיקה זו אינה קוראת ל-Microsoft Graph ואינה דורשת הסכמה של User.Read.All.אם לא זוהתה התקנה אישית, בקשו ממשתמש להתקין או לפתוח את האפליקציה האישית של Living Security, בחרו שוב Validate install, ולאחר מכן שלחו את הבדיקה מחדש. השתמשו בבדיקה המתקדמת הממוקדת לפי דוא”ל/UPN רק כאשר החיפוש החלופי האופציונלי מופעל.
התראת הבדיקה החד-כיוונית מופיעה ב-Microsoft Teams.
עיינו בניסיון המתאים ב-יומן התקשורת כאשר נדרשים נתוני אבחון של המסירה.

התאמת המיתוג של החבילה האזורית

החבילה האזורית היא ארכיון ZIP של שלושה קבצים: manifest.json, color.png ו-outline.png. ניתן להגדיר בחבילה זו שם אפליקציה וסמלים משלכם לפני העלאתה. Living Security תומכת באפשרות זו בחבילות אזוריות שמנהל Teams מעלה ישירות. בצעו זאת לאחר הורדת החבילה ואימותה, ולפני העלאתה ב-Teams admin center.
1

חלצו את החבילה

חלצו את קובץ ה-ZIP. הוא מכיל בדיוק שלושה קבצים בשורש הארכיון: manifest.json, color.png ו-outline.png.
2

החליפו את הסמלים

החליפו את color.png ואת outline.png בסמלים שלכם. שמרו על אותם שני שמות קבצים.
3

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

ב-manifest.json, ערכו את שני השדות הבאים:
  • name.short — השם המוצג בכותרת אפליקציית Teams ובאזורים אחרים עם מקום מוגבל. עד 30 תווים.
  • name.full — השם המוצג בקטלוג האפליקציות ובפרטי האפליקציה. עד 100 תווים.
    אם אפליקציית Living Security כבר הועלתה ב-Teams admin center, הגדירו את version לערך גבוה מהגרסה המותקנת שם. Microsoft Teams דוחה עדכון שאינו מגדיל את הגרסה, והורדה חדשה עשויה לכלול את אותה גרסה כמו החבילה שכבר התקנתם, או גרסה נמוכה ממנה.קראו את הגרסה המותקנת ב-Teams admin center תחת Teams apps → Manage apps, בדף פרטי האפליקציה. השוו אותה לערך version ב- manifest.json שהורדתם זה עתה, והגדירו ערך גבוה משניהם. שמרו על תבנית MAJOR.MINOR.PATCH בת שלושת המספרים.לדוגמה, אם האפליקציה המותקנת היא 1.1.1 וההורדה החדשה שלכם היא 1.1.0, הגדירו 1.1.2. העלאת 1.1.0 שהורד אל 1.1.1 הייתה חוזרת על הגרסה המותקנת, ו-Teams הייתה דוחה את ההעלאה.
4

השאירו את שדות הזהות ללא שינוי

אין לשנות שדות אלה. כל אחד מהם נושא את זהות האפליקציה, הבוט או הכניסה האחת (single sign-on):
  • id
  • botId ב-bots
  • webApplicationInfo
  • validDomains
  • contentUrl ו-websiteUrl ב-staticTabs
    שינוי בשדה זהות עלול להשאיר את האפליקציה ניתנת להתקנה, אך בלתי מסוגלת למסור התראות או להשלים כניסה אחת. Validate install בודק את הדייר, את פרטי הגישה של הבוט ואת ההתקנה שזוהתה. הוא אינו משווה את ה-manifest שלכם לחבילה ש-Living Security בנתה.
5

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

צרו ארכיון ZIP חדש משלושת הקבצים. הניחו אותם בשורש הארכיון, ללא תיקייה עוטפת. Microsoft Teams דוחה חבילה שבה manifest.json נמצא בתוך תיקייה.
6

העלו ואמתו

העלו את קובץ ה-ZIP עם המיתוג המותאם ב-Teams admin center, ולאחר מכן חזרו אל Living Security ולחצו על Validate install. שלחו התראת בדיקה.
האימות מציג Validation passed, והתראת הבדיקה מגיעה אל Microsoft Teams תחת שם האפליקציה והסמלים שלכם.

מפרסם וסכום ביקורת

התאמת המיתוג מגדירה את שם האפליקציה והסמלים. היא אינה משנה שני דברים:
  • המפרסם נשאר Living Security. שדות ה-manifest developer מציינים את Living Security ומקשרים לאתר Living Security, למדיניות הפרטיות ולתנאי השימוש. יחד הם מזהים את החברה שמפעילה את השירות, ולכן Teams ממשיכה להציג את Living Security כמפרסם בדף פרטי האפליקציה, בחלונות הסכמה להרשאות ובדוחות שימוש באפליקציה. השם והסמלים שלכם הם מה שהמשתמשים רואים בכותרת האפליקציה, בקטלוג האפליקציות ובהתראות.
  • סכום הביקורת SHA256 אינו תואם עוד. סכום הביקורת המוצג ב-Living Security מתאר את החבילה כפי שהורדה. אמתו אותו לפני עריכת הקבצים, ולאחר מכן תעדו את סכום הביקורת של החבילה שהתאמתם לרשומות הפריסה שלכם.

אופציונלי: הפעלת חיפוש חלופי לפי דוא”ל/UPN

מסירה אישית רגילה משתמשת במזהה אובייקט מהימן של Microsoft Entra שכבר ידוע ל-Living Security, יחד עם הפניית שיחת הבוט שנקלטה כאשר המשתמש מתקין או פותח את האפליקציה. מסירה לערוץ משתמשת בהפניית השיחה השמורה של הערוץ. אף אחד מהמסלולים אינו דורש Microsoft Graph. אם לנמען אין מזהה אובייקט מהימן של Entra, Living Security יכולה להשתמש באופן אופציונלי ב-Microsoft Graph כדי לזהות את הנמען לפי כתובת דוא”ל או UPN. כדי להפעיל חיפוש חלופי זה, בקשו ממנהל Microsoft Entra ללחוץ על Grant optional User.Read.All consent בלוח ההגדרה של Teams ולאשר את הרשאת האפליקציה User.Read.All של Microsoft Graph עבור אפליקציית Teams האזורית של Living Security. תהליך הסכמת המנהל עוקב אחר תבנית Microsoft Entra הבאה:
Living Security יוצרת כתובת זו ממזהה הדייר המחובר ומ-Bot app ID המוצג בלוח ההגדרה. המזהים משרתים מטרות שונות:
  • Teams app ID מזהה את חבילת האפליקציה הניתנת להתקנה ב-Microsoft Teams admin center.
  • Bot app ID מזהה את אפליקציית Microsoft Entra של הבוט האזורי והוא מזהה הלקוח (client ID) המשמש בתהליך הסכמת המנהל האופציונלי.
אין להחליף את Bot app ID ב-Teams app ID בכתובת ההסכמה. האינטגרציה Microsoft Entra ID (Client Credentials) תחת אינטגרציות מחוברות היא אינטגרציה נפרדת וכללית. בוט Teams האזורי אינו יכול להשתמש בפרטי הגישה או בהסכמה שלה, והסכמה שניתנה לאפליקציית Entra שאינה קשורה אינה מפעילה חיפוש חלופי זה.
הפיכת ההסכמה לאופציונלית אינה מסירה את User.Read.All מרישומי האפליקציה האזוריים הקיימים של Living Security. לקוחות שכבר העניקו הסכמה יכולים להמשיך להשתמש בחיפוש החלופי לפי דוא”ל/UPN ללא הגדרה מחדש.

סוגי התראות

בהתאם לזכאויות הארגון שלכם ולפלייבוקים שהוגדרו, Living Security יכולה לשלוח:

התאמה אישית

התראות Teams משתמשות בתצורת ארגון Living Security שלכם. השדות הנתמכים כוללים את שם התצוגה של הלקוח, שדות לוגו ומיתוג נתמכים, נוסח ההודעות, קריאות לפעולה, קישורי יעד, טקסט פריסה וטקסט תמיכה/יצירת קשר. ניתן להגדיר הודעות התקנה דרך הגדרות → תקשורת → ערוצים → Microsoft Teams → Install message controls. ניתן לבטל הודעות התקנה לחלוטין, לבטל רק הודעות התקנה אישיות או הודעות התקנה בערוצים, ולהגדיר נוסח ברירת מחדל, נוסח אישי או נוסח ייעודי לערוץ. שם אפליקציית Teams והסמלים שלה מגיעים מהחבילה האזורית. כדי להגדיר שם וסמלים משלכם, ראו התאמת המיתוג של החבילה האזורית.

עדכון או הסרה של האפליקציה

  • כאשר Living Security מספקת חבילה אזורית מעודכנת, הורידו אותה מלוח ערוץ Microsoft Teams והעלו אותה דרך Teams admin center. אמתו את מזהה האפליקציה, מזהה הבוט וסכום הביקורת המוצגים לפני הפריסה.
  • עריכות מיתוג אינן נשמרות בעדכון חבילה. כל חבילה אזורית חדשה נושאת שוב את שם האפליקציה והסמלים של Living Security. החילו מחדש את העריכות שלכם לפי התאמת המיתוג של החבילה האזורית לפני העלאת החבילה החדשה. שמרו במקום נגיש את הסמלים שלכם, את שני ערכי השם ואת הגרסה האחרונה שהעליתם, כך שכל שדרוג יהיה חזרה קצרה על אותם שלבים. חבילה חדשה אינה נושאת תמיד גרסה גבוהה מזו שהתקנתם, לכן הגדירו את הגרסה לפי מה ש-Teams מציג כמותקן.
  • הריצו שוב Validate install ושלחו התראת בדיקה נוספת לאחר עדכון אפליקציה או מדיניות.
  • הסרה או חסימה של האפליקציה מונעות התראות יזומות אל אותו משתמש או ערוץ. התקינו מחדש את האפליקציה ושלחו בדיקה חדשה כדי ש-Living Security תקבל אירוע התקנה עדכני של Teams.
  • אם אתם מפסיקים את המסירה דרך Teams, הסירו את Teams מהפלייבוקים הרלוונטיים לפני הסרת האפליקציה מ-Microsoft Teams.

פתרון בעיות

  • ודאו שהאפליקציה האישית של Living Security ב-Teams מותקנת ושהמשתמש פתח אותה, כך של-Living Security יש הפניית שיחה עדכנית
  • ודאו שמזהה הדייר של Microsoft שהוגדר הוא הדייר שבו נמצא המשתמש
  • אם נתוני האבחון מראים שבוצע ניסיון חיפוש חלופי לפי דוא”ל/UPN, ודאו שהסכמת מנהל ל-User.Read.All ניתנה ל-Bot app ID המוצג עבור הדייר הנכון
  • כאשר נעשה שימוש בחיפוש חלופי לפי דוא”ל/UPN, ודאו שהדוא”ל או ה-UPN של המשתמש ב-Living Security תואמים ל-Microsoft Entra ID
  • בקשו מהמשתמש לבטל את החסימה של האפליקציה או להתקין אותה מחדש אם הסיר או חסם אותה בעבר
  • ודאו שאפליקציית Teams של Living Security מותקנת בצוות או בערוץ היעד.
  • ודאו שמיפוי הערוץ ב-Living Security משתמש בצוות ובערוץ הנכונים.
  • בדקו אם הערוץ הוסר, שונה שמו, הועבר לארכיון או הוגבל.
  • התקינו מחדש את האפליקציה בצוות או בערוץ היעד ושלחו התראת בדיקה נוספת.
  • ודאו שמנהל Microsoft Entra העניק הסכמה ברמת הדייר עבור Microsoft Graph User.Read.All ל-Bot app ID המוצג.
  • ודאו שמזהה הדייר שהוגדר הוא הדייר שבו נמצאים המשתמשים ו-Teams.
  • ודאו שהמשתמש קיים ב-Microsoft Entra ID ואינו אורח מדייר אחר.
קטגוריית השגיאה TEAMS_ADMIN_CONSENT_REQUIRED, או שגיאת Microsoft AADSTS7000229, פירושה שחיפוש נמען לפי דוא”ל/UPN ניסה להשתמש בחיפוש החלופי האופציונלי של Microsoft Graph, אך לאפליקציית Teams האזורית של Living Security אין service principal (אפליקציה ארגונית) בדייר Microsoft Entra המחובר. מסלולי ברירת המחדל של מזהה מהימן ושיחה שמורה אינם דורשים הסכמה זו. זו אינה בעיה של סוד (secret) שפג תוקפו ב-Living Security.
  1. פתחו את הגדרות → תקשורת → ערוצים → Microsoft Teams. ניתן גם להשתמש ב-Open Microsoft Teams setup מתוך השגיאה ביומן התקשורת.
  2. ודאו שמזהה הדייר הנכון של Microsoft Entra מחובר.
  3. אם נדרש חיפוש חלופי לפי דוא”ל/UPN, בקשו ממנהל Microsoft Entra ללחוץ על Grant optional User.Read.All consent ולאשר את User.Read.All עבור Bot app ID המוצג. אחרת, ודאו שהנמען פתח את האפליקציה האישית ושיש ל-Living Security את מזהה האובייקט המהימן שלו ב-Entra.
  4. לאחר ש-Microsoft מסיימת לעבד את ההסכמה, שלחו בדיקה מתקדמת ממוקדת לפי דוא”ל/UPN מתוך הגדרת Microsoft Teams. יומן התקשורת מציג היסטוריית מסירה ונתוני אבחון; הוא אינו שולח מחדש את ההודעה שנכשלה.
הגדרה מחדש של Microsoft Entra ID (Client Credentials) אינה פותרת שגיאה זו מכיוון שאינטגרציה זו אינה משמשת למסירת התראות Teams.
  • בדקו אם הבוט נחסם, הוסר או הוסרה התקנתו
  • אם האפליקציה הותקנה לפני שהדייר חובר ב-Living Security, שמרו את הדייר ובחרו Validate install כדי ש-Living Security תוכל לשייך את ההתקנה הקיימת
  • התקינו מחדש רק אם האימות אינו מצליח לאתר את ההתקנה הקיימת
  • ודאו שמשתמש היעד או הערוץ קיבלו את אירוע התקנת האפליקציה האחרון
  • שלחו התראת בדיקה חדשה לאחר התקנה מחדש של האפליקציה
דוגמה לשדות אירוע התקנה המשמשים לפתרון בעיות:

אבטחה

Living Security משתמשת ב-User.Read.All של Microsoft Graph רק עבור החיפוש החלופי האופציונלי של נמענים לפי דוא”ל/UPN. כברירת מחדל, ניתוב התראות אישיות משתמש במזהה אובייקט מהימן של Entra מנתוני הישויות של Living Security ובהפניית שיחת הבוט שנקלטה מ-Microsoft Teams. מזהי אובייקט והפניות שיחה שמספק הקורא אינם נחשבים לנתוני ניתוב מהימנים. הודעות Microsoft Teams נמסרות באמצעות בוט Teams של Living Security המיועד להתראות בלבד, בשימוש בהודעות יזומות של Microsoft Teams. Living Security אינה דורשת מלקוחות ליצור רישום אפליקציה משלהם ב-Microsoft Entra או לשתף סוד לקוח (client secret) בבעלות הלקוח עבור הגדרת אפליקציית Teams הסטנדרטית. חבילות Teams ייעודיות לאזור שומרות על התאמה בין מזהה האפליקציה, מזהה הבוט ונקודת הקצה של ההודעות לבין אזור Living Security שבו הארגון שלכם מתארח.

קישורים קשורים

אינטגרציית דוא״ל

הגדירו דוא”ל כערוץ מסירה.

אינטגרציית Slack

הגדירו את Slack כערוץ מסירה.

יומן תקשורת

עקבו אחר סטטוס והיסטוריית מסירה ב-Teams.

אימות

הגדרת Microsoft Entra ID וכניסה אחת (SSO).