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

# הגדרת שילוב NINJIO

> חברו את NINJIO ל-Living Security Platform כדי לייבא תוצאות הדרכה בנושא מודעות לאבטחה ותוצאות של סימולציית פישינג עבור כוח העבודה בארגונכם.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>משאבים קשורים</h2>
    <ul>
      <li>
        <a href="/he/signals/data-sources">כך הופכים נתוני אינטגרציה לאותות של ניהול סיכוני גורם אנוש</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">גלו את האינטגרציות של Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">פתחו את Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">בקשו הדגמה של Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="הזינו את פרטי הגישה ב-Living Security Platform">
    <p>
      השלב מבוצע על ידי מי שיש לו גישה ל-Living Security — בעל התוכנית, או מנהל המערכת
      אם הוזמן (הגדרה מואצלת).
    </p>
    <ol>
      <li>
        עברו אל <strong>הגדרות → שילובי → קטלוג</strong>, אתרו את האריח{' '}
        <strong>{tile}</strong> ולחצו על <strong>חבר</strong>.
      </li>
      <li>
        מלאו את השדות שלהלן, ולאחר מכן לחצו על <strong>חבר</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>מדריך זה מיועד למנהל/ת {system} שלכם.</strong> הוא עוסק ביצירת אישורי API
      בתוך {system}, פעולה הדורשת הרשאות ניהול ב-{system} — ולא ב-Living Security Platform.
    </p>
    <p>
      אם אתם <strong>בעלי התוכנית</strong> של Living Security ואינכם מנהלים את {system},
      העבירו דף זה לאיש או אשת הקשר המנהלים אותה. הם ישלימו את חלק A ויעבירו אליכם את האישורים
      (או שיזינו אותם ישירות אם הוזמנו לפלטפורמה).
      {recommendDelegated && <>
          {' '}מאחר שהתקנה זו מפיקה חומרי מפתח רגישים, אנו ממליצים על מסלול{' '}
          <strong>ההתקנה המואצלת</strong>, כך שהסוד לעולם לא יישלח אליכם.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## מה השילוב תורם

NINJIO יכולה לספק תוצאות הנוגעות לכוח העבודה, להדרכה ולסימולציית פישינג. דוגמאות שנבדקו כוללות:

* `training.assigned` — הוקצתה לו הדרכת אבטחה
* `training.completed` — משלים הדרכת אבטחה
* `training.passed` — עובר הערכות בהדרכת אבטחה
* `phishing.simulation.clicked` — לחץ על סימולציה מבלי לדווח עליה
* `phishing.simulation.reported` — מדווח על סימולציות פישינג

דוגמאות אלה מציגות את סוגי הפעילות המנורמלת ש-Living Security יכולה להשתמש בהם. ראו [כיצד נתוני שילוב הופכים לאותות](/he/signals/data-sources).

## מה Living Security נדרשת לקבל

| פרטי גישה | תיאור |
| - | - |
| **מפתח API** | מפתח API של NINJIO עם הרשאת קריאה לנקודות הגישה של עובדים, הדרכה ופישינג. Living Security שולחת אותו בכל בקשה. |

**היקפי הרשאה:** NINJIO מגדירה היקפי הרשאה לכל מפתח API בנפרד לפי *נקודת גישה*, עם הרשאות קריאה וכתיבה נפרדות. Living Security נדרשת להרשאת **קריאה** בשלוש נקודות גישה: עובדים, הדרכה ופישינג. אין צורך בהרשאת כתיבה, ואין להעניק אותה.

**תפקיד נדרש:** **מנהל מערכת (Administrator)** בחשבון NINJIO שלכם. רק מנהלי מערכת יכולים להגיע לאזור השילוב (Integration) שבו נוצרים המפתחות.

<Warning>
  **NINJIO מציגה מפתח חדש פעם אחת בלבד, ברגע יצירתו.** העתיקו אותו ישירות אל Living Security Platform, או אל כספת סיסמאות, לפני שתנווטו למקום אחר. לא ניתן לשחזר מפתח שלא הועתק — יש ליצור מפתח חלופי.
</Warning>

### אילו נתונים Living Security מאחזרת

| נתונים | פירוט |
| - | - |
| **לומדים** | ספריית העובדים שלכם ב-NINJIO: שם, דוא"ל, מחלקה, תפקיד, מנהל, מדינה, סניף וסטטוס פעיל. |
| **הדרכה** | למי הוקצתה כל הדרכה ומי השלים אותה — כולל תאריך השלמה, ציון בחינה וציון מעורבות. |
| **פישינג** | מי הייתה לו אינטראקציה עם הודעת דוא"ל מדומה של פישינג ומי דיווח עליה, יחד עם מועד האירוע. |

<Note>
  **מספרי הטלפון של לומדים אינם נשמרים.** NINJIO מחזירה מספר טלפון ברשומת העובד. Living Security מוחקת אותו לפני שמירת כל נתון, מכיוון שאף תכונה של Living Security אינה משתמשת בו.
</Note>

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

* חשבון NINJIO עם גישת API.
* גישת מנהל מערכת אל [admin.goninjio.com](https://admin.goninjio.com/).
* כתובות דוא"ל של לומדים ב-NINJIO התואמות לכתובות שבהן משתמשות המערכות המחוברות האחרות שלכם. Living Security מתאימה לומד ב-NINJIO לאדם לפי כתובת הדוא"ל.

***

## חלק א׳ — ב-NINJIO

*מנהל NINJIO שלכם מבצע שלבים אלה.*

<Steps>
  <Step title="פתיחת אזור השילוב">
    1. היכנסו אל [admin.goninjio.com](https://admin.goninjio.com/) כמנהל מערכת.
    2. בחרו **Integration** בפינה הימנית העליונה של המסך.
  </Step>

  <Step title="יצירת מפתח API">
    1. בחרו **New API Key**.
    2. תנו למפתח שם שתזהו בהמשך — לדוגמה `Living Security`.
    3. העניקו הרשאת **קריאה** לנקודות הגישה **employee**, **training** ו-**phishing**.
    4. השאירו את הרשאת הכתיבה לא מסומנת. Living Security רק קוראת נתונים מ-NINJIO.
    5. בחרו **Generate Key**.

    <Warning>
      העתיקו את המפתח כעת. NINJIO מציגה אותו פעם אחת ולא תוכל להציג אותו שוב.
    </Warning>
  </Step>
</Steps>

***

## חלק ב׳ — ב-Living Security Platform

*בעל התוכנית מבצע שלב זה, או מנהל המערכת אם נעשה שימוש בהגדרה מואצלת.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | שדה | ערך |
    | - | - |
    | **מפתח API** | המפתח שיצרתם בחלק א׳ |
  </ConnectInPlatform>
</Steps>

כעת אתם מחוברים ל-NINJIO.

***

## תדירות אחזור הנתונים

| נתונים | לוח זמנים |
| - | - |
| לומדים | מדי יום |
| תוצאות הדרכה | כל 6 שעות |
| תוצאות פישינג | כל 6 שעות |

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

<Note>
  חיבור ראשוני בחשבון NINJIO גדול עשוי לדרוש מספר הרצות מתוזמנות עד לסיום קריאת כל הנתונים. כל הרצה קוראת כמה שאפשר, וההרצה הבאה ממשיכה מהנקודה שבה נעצרה, ולכן הספירות עולות במהלך היום או היומיים הראשונים ואינן מופיעות בבת אחת.
</Note>

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    מפתח ה-API שגוי או חלקי. הגורם הנפוץ ביותר הוא מפתח שהועתק באופן חלקי — NINJIO מציגה אותו פעם אחת, ולכן קל להדביק אותו קטוע, ואי אפשר לזהות זאת לאחר מכן. צרו מפתח חדש ב-NINJIO וחברו מחדש באמצעותו.
  </Accordion>

  <Accordion title="403 Forbidden">
    זו **אינה** בעיה של פרטי גישה. המפתח אומת, אך לאחת מנקודות הגישה הנדרשות לא הוענקה הרשאת קריאה.

    הדבקה חוזרת של אותו מפתח לא תעזור. ב-NINJIO, צרו מפתח עם הרשאת **קריאה** לכל שלוש נקודות הגישה — employee, training ו-phishing — וחברו מחדש באמצעותו.
  </Accordion>

  <Accordion title="החיבור הצליח אך אין נתוני הדרכה">
    בדקו ב-NINJIO שלפחות קמפיין הדרכה אחד **פעיל** ושמצורפת אליו סימולציה. קמפיין ללא סימולציה נשאר לא פעיל ואינו מספק דבר, ולכן אין תוצאות לאחזר.

    אם הקמפיינים פעילים, ודאו שלמשתתפים לומדים בהם יש כתובות דוא"ל ברשומות שלהם ב-NINJIO. לא ניתן להתאים לומד ללא כתובת דוא"ל לאדם, והוא מדולג.
  </Accordion>

  <Accordion title="הדרכה מוצגת כמוקצית אך לא הושלמה">
    זו התצוגה הצפויה להדרכה שלומד טרם סיים. Living Security רושמת את ההקצאה כאשר סימולציית NINJIO מתחילה, ורושמת את ההשלמה בנפרד כאשר NINJIO מדווחת על תאריך השלמה.
  </Accordion>

  <Accordion title="חלק מהלומדים חסרים">
    Living Security מתאימה לומד ב-NINJIO לאדם לפי **כתובת דוא"ל**. לומד שכתובת הדוא"ל שלו ב-NINJIO שונה מהכתובת המופיעה בספרייה שלכם — כתובת פרטית, דומיין ישן או שגיאת הקלדה — לא יותאם.

    תקנו את הכתובת ב-NINJIO, וההתאמה תתבצע באחזור המתוזמן הבא.
  </Accordion>

  <Accordion title="תוצאות פישינג חסרות עבור סימולציה ישנה">
    Living Security בודקת שוב סימולציית פישינג במשך שבועיים לאחר סיומה, ולאחר מכן מפסיקה. תוצאות ש-NINJIO רושמת לאחר חלון זמן זה אינן נקלטות. פנו לתמיכה אם יש צורך בקריאה חוזרת של סימולציה ישנה.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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