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

# הגדרת האינטגרציה עם Adaptive Security

> חברו את Adaptive Security אל 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="Adaptive Security" />

## מה האינטגרציה הזו מספקת

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

* `phishing.simulation.clicked` — לחץ על הודעת דוא"ל מדומה מבלי לדווח עליה
* `phishing.simulation.credential.submitted` — הזין פרטי הזדהות בדף כניסה מדומה
* `phishing.simulation.attachment.opened` — פתח קובץ מצורף בהודעת דוא"ל מדומה
* `phishing.simulation.reported` — דיווח על הודעת דוא"ל מדומה
* `smishing.simulation.replied` — השיב להודעת טקסט מדומה
* `vishing.simulation.succeeded` — נענה לדרישות של מתקשר קולי מדומה
* `training.assigned` — הוקצתה לו הדרכת אבטחה
* `training.completed` — סיים הדרכת אבטחה
* `training.past.due` — החמיץ מועד אחרון להשלמת הדרכה

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

<Note>
  **Adaptive מדמה שלושה ערוצים, ו-Living Security מעריכה כל אחד מהם בנפרד.**
  תוצאות של דוא"ל נבחנות כפישינג, תוצאות של הודעות טקסט כסמישינג, ותוצאות של שיחות קוליות כוישינג. אדם שלוחץ על הודעת דוא"ל מדומה ואדם שמשיב להודעת טקסט מדומה אינם נמדדים כבעלי אותה התנהגות, משום ששיקול הדעת של כל אחד מהם שונה.
</Note>

## מה Living Security צריכה

| אישור גישה | תיאור |
| - | - |
| **אסימון API** | אסימון API של Adaptive Security. Living Security שולחת אותו כאסימון נושא (bearer token) בכל בקשה. |

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

**גישה:** קריאה בלבד. Living Security רק קוראת נתונים מ-Adaptive Security, ואינה יוצרת, משנה או מוחקת דבר בחשבון שלכם.

### אילו נתונים Living Security שולפת

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

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

<Note>
  **ציון הסיכון של Adaptive נרשם אך לעולם אינו משמש לחישוב ציונים.** Adaptive מחשבת `current_risk_score` לכל אדם. Living Security שומרת אותו כדי שתוכלו להשוות בין שתי המערכות זו לצד זו, אך מדד הסיכון האנושי מחושב תמיד על סמך התנהגות שנצפתה, באמצעות המודל שפורסם של Living Security — ולעולם לא על סמך ציון מרוכב של ספק אחר.
</Note>

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

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

***

## חלק א׳ — ב-Adaptive Security

*מנהל המערכת של Adaptive Security אצלכם משלים את השלבים הבאים.*

<Steps>
  <Step title="פתיחת הגדרות ה-API">
    1. היכנסו אל [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) כמנהל מערכת.
    2. עברו אל **הגדרות ← API של**.
  </Step>

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

    <Warning>
      העתיקו את האסימון לפני שתעזבו את הדף. אם חשבון Adaptive שלכם קובע תוקף לאסימון, רשמו לעצמכם את התאריך — Living Security אינה יכולה לשלוף נתונים לאחר שתוקפו פג, ויש לעדכן את החיבור באמצעות אסימון חדש.
    </Warning>
  </Step>
</Steps>

***

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

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

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

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

***

## תדירות שליפת הנתונים

| נתונים | לוח זמנים |
| - | - |
| אנשים | כל 6 שעות |
| תוצאות סימולציות (דוא"ל, הודעות טקסט, שיחות קוליות) | כל 6 שעות |
| תוצאות הדרכה | כל 6 שעות |

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

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

***

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

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

  <Accordion title="403 Forbidden">
    האסימון אומת, אך התפקיד שלו אינו יכול לקרוא את הנתונים המבוקשים. הדבקה חוזרת של אותו אסימון לא תעזור. ב-Adaptive, ודאו שלתפקיד של האסימון יש הרשאת קריאה למשתמשים, לפישינג ולהדרכות, או הנפיקו אסימון מתפקיד שיש לו הרשאה כזו.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive הגבילה את קצב הבקשות של החיבור. Living Security עוצרת את ההרצה הנוכחית וממשיכה מאותה נקודה בהרצה המתוזמנת הבאה, ולכן לא הולכים לאיבוד נתונים — הספירות פשוט לוקחות זמן רב יותר לעלות. אם הבעיה נמשכת כמה ימים, פנו לתמיכה של Adaptive Security כדי לברר מהי מגבלת הקצב החלה על החשבון שלכם.
  </Accordion>

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

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

<PublicIntegrationNextSteps />


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