> ## 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.

# אינטגרציית Slack

> חברו את Living Security ל-Slack כדי לשלוח הודעות הדרכה, התראות אבטחה ועדכוני פלייבוק אל סביבת העבודה שלכם.

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

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

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

לפני הגדרת אינטגרציית Slack, ודאו שברשותכם:

* הרשאות מנהל מערכת בסביבת העבודה של Slack או הרשאות להתקנת אפליקציות
* גישה לפורטל ה-API של Slack בכתובת [api.slack.com](https://api.slack.com)
* הרשאות מנהל מערכת ב-Living Security

## יצירת אפליקציית Slack

<Steps>
  <Step title="יצירת אפליקציית Slack חדשה">
    1. עברו אל [api.slack.com/apps](https://api.slack.com/apps)
    2. לחצו על **Create New App**
    3. בחרו **From scratch**
    4. הזינו שם לאפליקציה (לדוגמה: "Living Security")
    5. בחרו את סביבת העבודה שלכם
    6. לחצו על **Create App**

    <Check>
      האפליקציה שלכם מופיעה בלוח המחוונים של Slack API.
    </Check>
  </Step>

  <Step title="הגדרת היקפי הרשאה של OAuth">
    1. בסרגל הצד השמאלי, לחצו על **OAuth & Permissions**
    2. גללו אל **Bot Token Scopes**
    3. הוסיפו את היקפי ההרשאה הבאים:

    | היקף הרשאה | מטרה |
    | - | - |
    | `chat:write` | שליחת הודעות לערוצים |
    | `chat:write.public` | שליחת הודעות לערוצים ללא הצטרפות אליהם |
    | `users:read` | חיפוש מידע על משתמשים |
    | `users:read.email` | התאמת משתמשים לפי כתובת דוא״ל |

    <Tip>
      הוסיפו רק את היקפי ההרשאה הנחוצים לארגון שלכם. פחות היקפי הרשאה משמעם אבטחה טובה יותר.
    </Tip>
  </Step>

  <Step title="התקנת האפליקציה בסביבת העבודה שלכם">
    1. גללו לראש הדף **OAuth & Permissions**
    2. לחצו על **Install to Workspace**
    3. עיינו בהרשאות ולחצו על **Allow**

    <Check>
      יופיע **Bot User OAuth Token** המתחיל ב-`xoxb-`.
    </Check>
  </Step>

  <Step title="קבלת ה-Signing Secret">
    1. בסרגל הצד השמאלי, לחצו על **מידע בסיסי**
    2. גללו אל **App Credentials**
    3. העתיקו את ה-**Signing Secret**

    <Warning>
      שמרו על סודיות ה-Signing Secret. לעולם אין לשתף אותו במאגרי קוד ציבוריים או ביומני רישום.
    </Warning>
  </Step>
</Steps>

## הוספת פרטי הגישה ל-Living Security

<Steps>
  <Step title="מעבר אל אינטגרציות יוצאות">
    עברו אל **הגדרות → שילובי → יוצא** ולחצו על הכרטיס **Slack**.
  </Step>

  <Step title="הוספת פרטי הגישה">
    לחצו על **Add Credential** והזינו:

    <ParamField body="botToken" type="string" required>
      ה-Bot User OAuth Token שלכם, המתחיל ב-`xoxb-`. ניתן למצוא אותו תחת **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      ה-Signing Secret של האפליקציה שלכם. ניתן למצוא אותו תחת **מידע בסיסי → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      אופציונלי. נדרש רק לחיבורי Socket Mode. מתחיל ב-`xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      אופציונלי. שם ידידותי לפרטי גישה אלה (לדוגמה: "Production Slack").
    </ParamField>
  </Step>

  <Step title="שמירה ואימות">
    לחצו על **שמור**. פרטי הגישה יופיעו ברשימה שלכם בסטטוס **פעיל**.

    <Check>
      אינטגרציית Slack שלכם מחוברת ומוכנה לשליחת הודעות.
    </Check>
  </Step>
</Steps>

## סוגי הודעות

לאחר החיבור, Living Security יכולה לשלוח ל-Slack את סוגי ההודעות הבאים:

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

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

<AccordionGroup>
  <Accordion title="הודעות אינן מופיעות בערוצים">
    * ודאו שהבוט הוזמן לערוץ (`/invite @YourBotName`)
    * בדקו שהיקף ההרשאה `chat:write.public` נוסף, לצורך פרסום בערוצים ציבוריים ללא הצטרפות
    * ודאו שמזהה הערוץ נכון (יש להשתמש במזהה הערוץ, ולא בשמו)
  </Accordion>

  <Accordion title="שגיאת אסימון לא תקין">
    * ודאו שהעתקתם את האסימון המלא, המתחיל ב-`xoxb-`
    * ודאו שהאפליקציה עדיין מותקנת בסביבת העבודה שלכם
    * בדקו אם האסימון הופק מחדש (נדרש עדכון ב-Living Security)
  </Accordion>

  <Accordion title="הגבלת קצב">
    Slack מגבילה את מספר בקשות ה-API. אם מופיעות שגיאות הגבלת קצב:

    * הפחיתו את תדירות ההודעות
    * אחדו מספר הודעות להודעות סיכום
    * פנו לתמיכה במקרי שימוש בנפח גבוה
  </Accordion>
</AccordionGroup>

## שיטות עבודה מומלצות

<Tip>
  צרו ערוץ Slack ייעודי להודעות של Living Security (לדוגמה: `#security-training`) כדי לשמור על סדר בהתראות ולהפחית רעש בערוצים הכלליים.
</Tip>

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

## קישורים נוספים

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

  <Card title="אינטגרציית Teams" icon="microsoft" href="/he/integrations/outbound/teams">
    הגדרת Microsoft Teams כערוץ שליחה.
  </Card>

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

  <Card title="כיצד להגדיר אינטגרציה חדשה" icon="plug" href="/he/integrations/managing/setup">
    מדריך כללי להגדרת אינטגרציה.
  </Card>
</CardGroup>


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