דרישות מקדימות
לפני הגדרת 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
חברו את דייר Microsoft שלכם
הורידו את חבילת Teams האזורית
העלו והתקינו את החבילה ב-Teams admin center
- Teams app ID ו-bot app ID תואמים לערכים המוצגים ב-Living Security
- שם האפליקציה הוא השם האזורי של Living Security, או השם שהגדרתם אם התאמתם את מיתוג החבילה
- המפרסם הוא Living Security. התאמת המיתוג של החבילה אינה משנה את המפרסם
- האפליקציה אינה חסומה
- האפליקציה זמינה למשתמשים או לקבוצות המיועדים
- האפליקציה מותקנת באמצעות מדיניות הגדרת אפליקציות או התקנה ממוקדת עבור המשתמשים והצוותות/הערוצים שאמורים לקבל התראות
התקינו או פתחו את האפליקציה
הגדירו הודעות התקנה
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{installerName}}, שמוחלף בשם התצוגה של המשתמש שהתקין את האפליקציה. השאירו הודעה אישית או הודעת ערוץ ריקה כדי להשתמש בהודעת ברירת המחדל שהגדרתם. אם גם הודעת ברירת המחדל ריקה, Living Security משתמשת בהודעה המובנית עבור אותו היקף.אמתו את ההגדרה
שלחו התראות בדיקה
User.Read.All.אם לא זוהתה התקנה אישית, בקשו ממשתמש להתקין או לפתוח את
האפליקציה האישית של Living Security, בחרו שוב Validate install, ולאחר מכן
שלחו את הבדיקה מחדש. השתמשו בבדיקה המתקדמת הממוקדת לפי דוא”ל/UPN רק כאשר
החיפוש החלופי האופציונלי מופעל.התאמת המיתוג של החבילה האזורית
החבילה האזורית היא ארכיון ZIP של שלושה קבצים:manifest.json, color.png ו-outline.png. ניתן להגדיר בחבילה זו שם אפליקציה וסמלים משלכם לפני העלאתה. Living Security תומכת באפשרות זו בחבילות אזוריות שמנהל Teams מעלה ישירות.
בצעו זאת לאחר הורדת החבילה ואימותה, ולפני העלאתה ב-Teams admin center.
חלצו את החבילה
manifest.json, color.png ו-outline.png.החליפו את הסמלים
color.png ואת outline.png בסמלים שלכם. שמרו על אותם שני
שמות קבצים.הגדירו את שם האפליקציה
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 הייתה דוחה את ההעלאה.
השאירו את שדות הזהות ללא שינוי
-
id -
botIdב-bots -
webApplicationInfo -
validDomains -
contentUrlו-websiteUrlב-staticTabs
ארזו מחדש את שלושת הקבצים
manifest.json נמצא בתוך תיקייה.העלו ואמתו
מפרסם וסכום ביקורת
התאמת המיתוג מגדירה את שם האפליקציה והסמלים. היא אינה משנה שני דברים:- המפרסם נשאר 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 הבאה:
- Teams app ID מזהה את חבילת האפליקציה הניתנת להתקנה ב-Microsoft Teams admin center.
- Bot app ID מזהה את אפליקציית Microsoft Entra של הבוט האזורי והוא מזהה הלקוח (client ID) המשמש בתהליך הסכמת המנהל האופציונלי.
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 משתמש בצוות ובערוץ הנכונים.
- בדקו אם הערוץ הוסר, שונה שמו, הועבר לארכיון או הוגבל.
- התקינו מחדש את האפליקציה בצוות או בערוץ היעד ושלחו התראת בדיקה נוספת.
החיפוש האופציונלי לפי דוא"ל/UPN או ההסכמה נכשלים
החיפוש האופציונלי לפי דוא"ל/UPN או ההסכמה נכשלים
- ודאו שמנהל Microsoft Entra העניק הסכמה ברמת הדייר עבור
Microsoft Graph
User.Read.Allל-Bot app ID המוצג. - ודאו שמזהה הדייר שהוגדר הוא הדייר שבו נמצאים המשתמשים ו-Teams.
- ודאו שהמשתמש קיים ב-Microsoft Entra ID ואינו אורח מדייר אחר.
יומן התקשורת מציג שנדרשת הסכמת מנהל של Microsoft
יומן התקשורת מציג שנדרשת הסכמת מנהל של Microsoft
TEAMS_ADMIN_CONSENT_REQUIRED, או שגיאת Microsoft AADSTS7000229, פירושה שחיפוש נמען לפי דוא”ל/UPN ניסה להשתמש בחיפוש החלופי האופציונלי של Microsoft Graph, אך לאפליקציית Teams האזורית של Living Security אין service principal (אפליקציה ארגונית) בדייר Microsoft Entra המחובר. מסלולי ברירת המחדל של מזהה מהימן ושיחה שמורה אינם דורשים הסכמה זו. זו אינה בעיה של סוד (secret) שפג תוקפו ב-Living Security.- פתחו את הגדרות → תקשורת → ערוצים → Microsoft Teams. ניתן גם להשתמש ב-Open Microsoft Teams setup מתוך השגיאה ביומן התקשורת.
- ודאו שמזהה הדייר הנכון של Microsoft Entra מחובר.
- אם נדרש חיפוש חלופי לפי דוא”ל/UPN, בקשו ממנהל Microsoft Entra ללחוץ על Grant optional User.Read.All consent ולאשר את
User.Read.Allעבור Bot app ID המוצג. אחרת, ודאו שהנמען פתח את האפליקציה האישית ושיש ל-Living Security את מזהה האובייקט המהימן שלו ב-Entra. - לאחר ש-Microsoft מסיימת לעבד את ההסכמה, שלחו בדיקה מתקדמת ממוקדת לפי דוא”ל/UPN מתוך הגדרת Microsoft 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 שבו הארגון שלכם מתארח.

