> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# אינטגרציית Microsoft Teams

> חברו את Living Security אל Microsoft Teams כדי לשלוח התראות הדרכה, התראות אבטחה והודעות בערוצים.

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

אינטגרציה זו מיועדת להתראות בלבד. משתמשים אינם שולחים פקודות אל הבוט ב-Microsoft Teams. לאחר התקנת האפליקציה, הבוט שומר את הפניית השיחה (conversation reference) של Teams לצורך התראות יזומות עתידיות. הודעות ההתקנה הן חד-כיווניות וניתן להתאים אותן אישית או לבטל אותן בהתאם לדרישות הפריסה הארגונית.

<Warning>
  מנהל Microsoft Teams עדיין נדרש להעלות, לאשר ולהפיץ את אפליקציית Teams של
  Living Security. הסכמת מנהל (admin consent) של Microsoft Entra `User.Read.All` היא
  אופציונלית ומאפשרת רק חיפוש חלופי לפי כתובת דוא"ל או שם עיקרי של משתמש (UPN).
</Warning>

<Note>
  להגדרת מסירה של דחיפות ופלייבוקים, התחילו ב-**הגדרות → תקשורת →
  ערוצים** ולחצו על הכרטיס **Microsoft Teams**. דף זה מתאר את
  תצורת אפליקציית Teams הבסיסית.
</Note>

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

לפני הגדרת Microsoft Teams, ודאו שברשותכם:

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

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

| תפקיד | אחריות |
| - | - |
| **מנהל Living Security** | מחבר את דייר Microsoft, מוריד את החבילה האזורית, מגדיר את הודעות ההתקנה, מאמת את ההגדרה ושולח בדיקות |
| **מנהל Microsoft Teams** | מעלה ומתיר את האפליקציה, מפיץ אותה למשתמשים או לקבוצות המיועדים ומקצה מדיניות הגדרת אפליקציות |
| **מנהל Microsoft Entra**, אופציונלי | מעניק הסכמת אפליקציה ל-`User.Read.All` עבור מזהה אפליקציית הבוט האזורי כאשר נדרש חיפוש חלופי לפי דוא"ל/UPN |
| **בעלי Teams**, כאשר נעשה שימוש במסירה לערוץ | מתקין או מאשר את האפליקציה עבור הצוות והערוץ המיועדים |

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

## הגדרה

<Steps>
  <Step title="פתחו את לוח ההגדרה של Microsoft Teams">
    ב-Living Security, עברו אל **הגדרות → תקשורת → ערוצים** ובחרו **Microsoft Teams**.

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

    <Check>
      האזור המוצג ב-Living Security תואם לאזור שבו הארגון שלכם מתארח.
    </Check>
  </Step>

  <Step title="חברו את דייר Microsoft שלכם">
    ב-**Connect your tenant**, הזינו את מזהה הדייר של Microsoft Entra שבבעלותו נמצאים המשתמשים וערוצי Teams שמקבלים התראות, ולאחר מכן לחצו על **Save Microsoft tenant**. דייר Microsoft אחד יכול להשתייך לארגון Living Security אחד בלבד.

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

    <Check>
      Living Security מציגה **Microsoft tenant connected** לפני שתמשיכו.
    </Check>

    <Note>
      מומלץ לחבר את הדייר לפני התקנת אפליקציית Teams. אם האפליקציה כבר מותקנת, שמרו את הדייר ובחרו תחילה **Validate install**. Living Security מנסה לשייך את ההתקנה הקיימת באופן אוטומטי; התקינו מחדש רק אם האימות אינו מצליח לאתר אותה.
    </Note>
  </Step>

  <Step title="הורידו את חבילת Teams האזורית">
    לחצו על **Download Teams package**. Living Security מספקת חבילת ZIP ייעודית לאזור של הארגון שלכם.

    לפני שאתם משנים משהו, אמתו את הקובץ שהורד מול סכום הביקורת SHA256 המוצג ב-Living Security. כדי לתת לאפליקציה שם וסמלים משלכם, פעלו לפי [התאמת המיתוג של החבילה האזורית](#%D7%94%D7%AA%D7%90%D7%9E%D7%AA-%D7%94%D7%9E%D7%99%D7%AA%D7%95%D7%92-%D7%A9%D7%9C-%D7%94%D7%97%D7%91%D7%99%D7%9C%D7%94-%D7%94%D7%90%D7%96%D7%95%D7%A8%D7%99%D7%AA) לאחר בדיקה זו ולפני העלאת החבילה.

    <Check>
      סכום הביקורת של הקובץ שהורד תואם לסכום הביקורת SHA256 המוצג ב-Living Security.
    </Check>
  </Step>

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

    <Note>
      אם האימות או הבדיקה נכשלים מיד לאחר שינוי במדיניות האפליקציה, ודאו את הקצאת המדיניות ב-Microsoft Teams admin center ונסו שוב לאחר ש-Microsoft תסיים להפיץ אותה.
    </Note>
  </Step>

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

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

    <Check>
      משתמש יעד התקין או פתח את האפליקציה האישית, או שהאפליקציה
      מותקנת בערוץ המיועד.
    </Check>
  </Step>

  <Step title="הגדירו הודעות התקנה">
    בקטע **Install message controls**, בחרו אם לשלוח הודעות התקנה ב-Teams והתאימו אישית את נוסח ההודעה החד-כיוונית עבור הארגון שלכם.

    הפקדים הזמינים:

    * Send install messages
    * Send personal install messages
    * Send channel install messages
    * Default message
    * Personal message
    * Channel message

    שדות ההודעה תומכים ב-`{{installerName}}`, שמוחלף בשם התצוגה של המשתמש שהתקין את האפליקציה. השאירו הודעה אישית או הודעת ערוץ ריקה כדי להשתמש בהודעת ברירת המחדל שהגדרתם. אם גם הודעת ברירת המחדל ריקה, Living Security משתמשת בהודעה המובנית עבור אותו היקף.
  </Step>

  <Step title="אמתו את ההגדרה">
    לחצו על **Validate install** ב-Living Security. האימות בודק שהחבילה האזורית זמינה, שתצורת דייר Microsoft קיימת וייחודית לארגון Living Security זה, שפרטי הגישה של הבוט האזורי מוגדרים, ושזוהתה התקנה פעילה של האפליקציה עבור הדייר המחובר.

    <Check>
      האימות מציג **Validation passed** לפני שליחת התראות חיות.
    </Check>
  </Step>

  <Step title="שלחו התראות בדיקה">
    לבדיקה האישית כברירת מחדל, לחצו על **Send test to detected installation**.
    Living Security בוחרת התקנה אישית פעילה שזוהתה ומשתמשת בזהות המהימנה
    ובהפניית השיחה ששמרה. בדיקה זו אינה קוראת ל-Microsoft Graph
    ואינה דורשת הסכמה של `User.Read.All`.

    אם לא זוהתה התקנה אישית, בקשו ממשתמש להתקין או לפתוח את
    האפליקציה האישית של Living Security, בחרו שוב **Validate install**, ולאחר מכן
    שלחו את הבדיקה מחדש. השתמשו בבדיקה המתקדמת הממוקדת לפי דוא"ל/UPN רק כאשר
    החיפוש החלופי האופציונלי מופעל.

    <Check>התראת הבדיקה החד-כיוונית מופיעה ב-Microsoft Teams.</Check>

    עיינו בניסיון המתאים ב-[יומן התקשורת](/he/features/communications/log) כאשר נדרשים נתוני אבחון של המסירה.
  </Step>
</Steps>

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

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

בצעו זאת לאחר הורדת החבילה ואימותה, ולפני העלאתה ב-Teams admin center.

<Steps>
  <Step title="חלצו את החבילה">
    חלצו את קובץ ה-ZIP. הוא מכיל בדיוק שלושה קבצים בשורש
    הארכיון: `manifest.json`, `color.png` ו-`outline.png`.
  </Step>

  <Step title="החליפו את הסמלים">
    החליפו את `color.png` ואת `outline.png` בסמלים שלכם. שמרו על אותם שני
    שמות קבצים.

    | קובץ | דרישה |
    | - | - |
    | `color.png` | PNG צבעוני מלא, 192 × 192 פיקסלים, ללא שקיפות |
    | `outline.png` | PNG שקוף, 32 × 32 פיקסלים |
  </Step>

  <Step title="הגדירו את שם האפליקציה">
    ב-`manifest.json`, ערכו את שני השדות הבאים:

    * `name.short` — השם המוצג בכותרת אפליקציית Teams ובאזורים אחרים עם מקום מוגבל. עד 30 תווים.
    * `name.full` — השם המוצג בקטלוג האפליקציות ובפרטי האפליקציה. עד 100 תווים.

          <Note>
            אם אפליקציית 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 הייתה דוחה את ההעלאה.
          </Note>
  </Step>

  <Step title="השאירו את שדות הזהות ללא שינוי">
    אין לשנות שדות אלה. כל אחד מהם נושא את זהות האפליקציה, הבוט
    או הכניסה האחת (single sign-on):

    * `id`
    * `botId` ב-`bots`
    * `webApplicationInfo`
    * `validDomains`
    * `contentUrl` ו-`websiteUrl` ב-`staticTabs`

          <Warning>
            שינוי בשדה זהות עלול להשאיר את האפליקציה ניתנת להתקנה, אך בלתי מסוגלת
            למסור התראות או להשלים כניסה אחת. **Validate install** בודק
            את הדייר, את פרטי הגישה של הבוט ואת ההתקנה שזוהתה. הוא אינו משווה את ה-manifest שלכם
            לחבילה ש-Living Security בנתה.
          </Warning>
  </Step>

  <Step title="ארזו מחדש את שלושת הקבצים">
    צרו ארכיון ZIP חדש משלושת הקבצים. הניחו אותם בשורש
    הארכיון, ללא תיקייה עוטפת. Microsoft Teams דוחה חבילה שבה
    `manifest.json` נמצא בתוך תיקייה.
  </Step>

  <Step title="העלו ואמתו">
    העלו את קובץ ה-ZIP עם המיתוג המותאם ב-Teams admin center, ולאחר מכן חזרו אל Living
    Security ולחצו על **Validate install**. שלחו התראת בדיקה.

    <Check>
      האימות מציג **Validation passed**, והתראת הבדיקה מגיעה אל
      Microsoft Teams תחת שם האפליקציה והסמלים שלכם.
    </Check>
  </Step>
</Steps>

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

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

* **המפרסם נשאר 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 הבאה:

```text theme={null}
https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}
```

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 שאינה קשורה אינה מפעילה
חיפוש חלופי זה.

<Note>
  הפיכת ההסכמה לאופציונלית אינה מסירה את `User.Read.All` מרישומי האפליקציה האזוריים
  הקיימים של Living Security. לקוחות שכבר העניקו
  הסכמה יכולים להמשיך להשתמש בחיפוש החלופי לפי דוא"ל/UPN ללא הגדרה מחדש.
</Note>

## סוגי התראות

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

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

## התאמה אישית

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

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

שם אפליקציית Teams והסמלים שלה מגיעים מהחבילה האזורית. כדי להגדיר שם וסמלים משלכם, ראו [התאמת המיתוג של החבילה האזורית](#%D7%94%D7%AA%D7%90%D7%9E%D7%AA-%D7%94%D7%9E%D7%99%D7%AA%D7%95%D7%92-%D7%A9%D7%9C-%D7%94%D7%97%D7%91%D7%99%D7%9C%D7%94-%D7%94%D7%90%D7%96%D7%95%D7%A8%D7%99%D7%AA).

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

* כאשר Living Security מספקת חבילה אזורית מעודכנת, הורידו אותה מלוח ערוץ Microsoft Teams והעלו אותה דרך Teams admin center. אמתו את מזהה האפליקציה, מזהה הבוט וסכום הביקורת המוצגים לפני הפריסה.
* עריכות מיתוג אינן נשמרות בעדכון חבילה. כל חבילה אזורית חדשה נושאת שוב את שם האפליקציה והסמלים של Living Security. החילו מחדש את העריכות שלכם לפי [התאמת המיתוג של החבילה האזורית](#%D7%94%D7%AA%D7%90%D7%9E%D7%AA-%D7%94%D7%9E%D7%99%D7%AA%D7%95%D7%92-%D7%A9%D7%9C-%D7%94%D7%97%D7%91%D7%99%D7%9C%D7%94-%D7%94%D7%90%D7%96%D7%95%D7%A8%D7%99%D7%AA) לפני העלאת החבילה החדשה. שמרו במקום נגיש את הסמלים שלכם, את שני ערכי השם ואת הגרסה האחרונה שהעליתם, כך שכל שדרוג יהיה חזרה קצרה על אותם שלבים. חבילה חדשה אינה נושאת תמיד גרסה גבוהה מזו שהתקנתם, לכן הגדירו את הגרסה לפי מה ש-Teams מציג כמותקן.
* הריצו שוב **Validate install** ושלחו התראת בדיקה נוספת לאחר עדכון אפליקציה או מדיניות.
* הסרה או חסימה של האפליקציה מונעות התראות יזומות אל אותו משתמש או ערוץ. התקינו מחדש את האפליקציה ושלחו בדיקה חדשה כדי ש-Living Security תקבל אירוע התקנה עדכני של Teams.
* אם אתם מפסיקים את המסירה דרך Teams, הסירו את Teams מהפלייבוקים הרלוונטיים לפני הסרת האפליקציה מ-Microsoft Teams.

## פתרון בעיות

<AccordionGroup>
  <Accordion title="משתמש אינו מקבל התראה אישית">
    * ודאו שהאפליקציה האישית של Living Security ב-Teams מותקנת ושהמשתמש פתח אותה, כך של-Living Security יש הפניית שיחה עדכנית
    * ודאו שמזהה הדייר של Microsoft שהוגדר הוא הדייר שבו נמצא המשתמש
    * אם נתוני האבחון מראים שבוצע ניסיון חיפוש חלופי לפי דוא"ל/UPN, ודאו שהסכמת מנהל ל-`User.Read.All` ניתנה ל-Bot app ID המוצג עבור הדייר הנכון
    * כאשר נעשה שימוש בחיפוש חלופי לפי דוא"ל/UPN, ודאו שהדוא"ל או ה-UPN של המשתמש ב-Living Security תואמים ל-Microsoft Entra ID
    * בקשו מהמשתמש לבטל את החסימה של האפליקציה או להתקין אותה מחדש אם הסיר או חסם אותה בעבר
  </Accordion>

  <Accordion title="הודעה בערוץ אינה מופיעה">
    <ul>
      <li>
        ודאו שאפליקציית Teams של Living Security מותקנת בצוות או בערוץ
        היעד.
      </li>

      <li>
        ודאו שמיפוי הערוץ ב-Living Security משתמש בצוות ובערוץ
        הנכונים.
      </li>

      <li>
        בדקו אם הערוץ הוסר, שונה שמו, הועבר לארכיון או הוגבל.
      </li>

      <li>
        התקינו מחדש את האפליקציה בצוות או בערוץ היעד ושלחו התראת בדיקה
        נוספת.
      </li>
    </ul>
  </Accordion>

  <Accordion title="החיפוש האופציונלי לפי דוא&#x22;ל/UPN או ההסכמה נכשלים">
    <ul>
      <li>
        ודאו שמנהל Microsoft Entra העניק הסכמה ברמת הדייר עבור
        Microsoft Graph `User.Read.All` ל-Bot app ID המוצג.
      </li>

      <li>
        ודאו שמזהה הדייר שהוגדר הוא הדייר שבו נמצאים המשתמשים
        ו-Teams.
      </li>

      <li>
        ודאו שהמשתמש קיים ב-Microsoft Entra ID ואינו אורח
        מדייר אחר.
      </li>
    </ul>
  </Accordion>

  <Accordion title="יומן התקשורת מציג שנדרשת הסכמת מנהל של Microsoft">
    קטגוריית השגיאה `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.
  </Accordion>

  <Accordion title="האפליקציה מותקנת אך ההתראות נכשלות">
    * בדקו אם הבוט נחסם, הוסר או הוסרה התקנתו
    * אם האפליקציה הותקנה לפני שהדייר חובר ב-Living Security, שמרו את הדייר ובחרו **Validate install** כדי ש-Living Security תוכל לשייך את ההתקנה הקיימת
    * התקינו מחדש רק אם האימות אינו מצליח לאתר את ההתקנה הקיימת
    * ודאו שמשתמש היעד או הערוץ קיבלו את אירוע התקנת האפליקציה האחרון
    * שלחו התראת בדיקה חדשה לאחר התקנה מחדש של האפליקציה

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

    ```json theme={null}
    {
      "type": "installationUpdate",
      "action": "add",
      "channelData": {
        "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
        "team": { "id": "19:team-id@thread.tacv2" },
        "channel": { "id": "19:channel-id@thread.tacv2" }
      },
      "conversation": {
        "id": "19:channel-id@thread.tacv2",
        "conversationType": "channel",
        "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## אבטחה

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 שבו הארגון שלכם מתארח.

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

<CardGroup cols={2}>
  <Card title="אינטגרציית דוא״ל" icon="envelope" href="/he/integrations/outbound/email">
    הגדירו דוא"ל כערוץ מסירה.
  </Card>

  <Card title="אינטגרציית Slack" icon="slack" href="/he/integrations/outbound/slack">
    הגדירו את Slack כערוץ מסירה.
  </Card>

  <Card title="יומן תקשורת" icon="clock-rotate-left" href="/he/features/communications/log">
    עקבו אחר סטטוס והיסטוריית מסירה ב-Teams.
  </Card>

  <Card title="אימות" icon="shield-halved" href="/he/features/settings/sso">
    הגדרת Microsoft Entra ID וכניסה אחת (SSO).
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.