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

# הגדרת אינטגרציה

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

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

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

| תפקיד | אחריות |
| - | - |
| [**בעל התוכנית**](/he/reference/glossary#%D7%91%D7%A2%D7%9C-%D7%94%D7%AA%D7%95%D7%9B%D7%A0%D7%99%D7%AA) | בוחר את המקור, מחבר אותו ב-Living Security, מפעיל זרמים ומאמת את התוצאה |
| [**מנהל מערכת**](/he/reference/glossary#%D7%9E%D7%A0%D7%94%D7%9C-%D7%9E%D7%A2%D7%A8%D7%9B%D7%AA) | יוצר או מאשר פרטי גישה והיקפי הרשאה במערכת המקור |

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

לפני שמתחילים:

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

## 1. הכנת פרטי הגישה של הספק

פתחו את **הגדרות → שילובי → קטלוג**, אתרו את הספק וקראו את מדריך ההגדרה שלו לפני יצירת פרטי גישה.

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

<Warning>
  אל תעתיקו הרשאות מספק אחר ואל תעניקו גישת כתיבה רחבה
  "ליתר ביטחון". הרשאות חסרות מפיקות בדרך כלל שגיאת 401 או 403 ברורה
  שניתן לתקן; הרשאות עודפות יוצרות סיכון שאפשר להימנע ממנו.
</Warning>

## 2. חיבור הספק

<Steps>
  <Step title="פתיחת הקטלוג">
    עברו אל **הגדרות → שילובי → קטלוג** ובחרו את הספק.
  </Step>

  <Step title="התחלת החיבור">
    בחרו **חבר**. השלימו את תהליך OAuth או הזינו את השדות המבוקשים
    בחלון החיבור. מדריך הספק מסביר מהיכן מגיע כל ערך.
  </Step>

  <Step title="השלמת האימות">
    אשרו את מסך ההסכמה של הספק כשהדבר רלוונטי. לאחר שהאימות מצליח, Living Security פותחת או מציגה את החיבור החדש תחת **מחובר**.
  </Step>
</Steps>

אם הספק דוחה את האימות, עצרו ותקנו את פרטי הגישה, הדייר (tenant), האזור, כתובת ה-redirect או ההרשאות במערכת המקור לפני שתמשיכו.

## 3. הפעלת זרמי נתונים

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

1. עברו על השם והמטרה של כל זרם.
2. הפעילו רק את הזרמים שהתוכנית שלכם זקוקה להם.
3. השאירו זרמים שאינם רלוונטיים במצב מושהה.
4. השתמשו ב-**סנכרון עכשיו** כשהאפשרות זמינה כדי לבקש את ההרצה הראשונה.

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

## 4. אימות ההרצה הראשונה

אימות החיבור בלבד אינו מוכיח שהנתונים זורמים.

<Steps>
  <Step title="בדיקת תקינות החיבור">
    ודאו שהחיבור תקין ושאינו מבקש הרשאה מחדש.
  </Step>

  <Step title="בדיקת מצב הזרם">
    ודאו שהזרם הנדרש מופעל ואינו מושהה.
  </Step>

  <Step title="בדיקת ההרצה האחרונה">
    פתחו את הזרם, את קישור הסנכרון של החיבור או את **הגדרות** → **שילובי** → **סינכרון**. המתינו לתוצאה סופית מוצלחת ועיינו בשגיאות הספק ובספירות הרשומות כשהן זמינות.
  </Step>

  <Step title="אימות הנתונים במורד הזרם">
    פתחו את אזור Living Security הרלוונטי. נתוני זהות אמורים ליצור ב-כוח העבודה את האנשים והזהויות הצפויים; נתונים ממקור אבטחה אמורים להופיע בתכונה המתועדת עבור אותו ספק.
  </Step>
</Steps>

במסגרת ההטמעה, המשימות **אימות זרימת נתוני זהות** ו-**אימות זרימת נתוני אינטגרציה** במפת המסע (Journey Map) מושלמות על בסיס נתונים שנקלטו. אל תחליפו את תוצאות האימות הללו בחיבור שנשמר.

## דף פרטי סנכרון

מתוך **הגדרות** → **שילובי** → **סינכרון**, פתחו סנכרון כלשהו כדי לצפות בתצורה ובהיסטוריית ההרצות שלו במקום אחד.

דף הפרטים מציג:

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

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

ניתן גם לפתוח סנכרון מדף פרטי החיבור שלו כשהאינטגרציה מציגה זרמים פעילים.

## פעולות על חיבור

דף פרטי החיבור חושף את הפעולות שהאינטגרציה הספציפית תומכת בהן:

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

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

## מקורות דחיפה מותאמים אישית

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

1. צרו את המקור מתחתית **הקטלוג**.
2. פתחו את דף הפרטים שלו באזור הדחיפה המותאמת אישית.
3. בחרו את זרם היעד.
4. השתמשו ב-**העלאת CSV** להעלאה ידנית של אצווה או ב-**דחיפה באמצעות API** עבור שולח אוטומטי.
5. הציגו תצוגה מקדימה של הקובץ או של המטען (payload) ועיינו בהיסטוריית ההרצות של המקור לאחר השליחה.

להסכם המלא של נקודת הקצה, האימות, המטען, הניסיונות החוזרים והאימות, ראו [API של מקור דחיפה מותאם אישית](/he/integrations/custom-push-source). אל תסיקו פרטים אלה ממדריך אינטגרציית Unify ישן יותר.

מעלה הקבצים בדף פרטי המקור מקבל קובץ CSV של מקור בגודל של עד 100 MB. לפני ההעלאה, לוח מחוונים מפצל אותו בצד הלקוח לבקשות של עד 10 MB ו-10,000 שורות כל אחת. מעלה הקבצים הייעודי למקור זה נפרד מדף **שילובי → העלאה** הכללי עבור תבניות זהות ופעילות.

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

| תסמין | מה לבדוק |
| - | - |
| `401 Unauthorized` | ערך פרטי הגישה, תפוגה, ביטול, דייר (tenant) של הספק ומצב ההרשאה מחדש |
| `403 Forbidden` | תפקיד הספק הנדרש, היקפי הרשאה, הסכמת מנהל ומדיניות הגישה של מערכת המקור |
| החיבור נכשל מיד | כתובת redirect, אזור, כתובת המקור, דרישות רשימת היתרים של רשת או IP |
| החיבור תקין אך אין הרצות | הזרם הנדרש מופעל והספק חושף את הזרם הזה |
| הרצה מוצלחת אינה מחזירה רשומות | חשבון המקור רואה את האוכלוסייה הצפויה ומסנני צד הספק נכונים |
| נתונים מופיעים אצל האדם הלא נכון | מאפייני הזהות והכינויים עקביים בכל המקורות המחוברים |
| הנתונים מפסיקים להתעדכן | הזרם או החיבור מושהים, פרטי הגישה פגו או שההרצה האחרונה נכשלה |

בפנייה אל [התמיכה של Living Security](mailto:support@livingsecurity.com), ציינו את הארגון, הספק, שם החיבור, הזרם, זמן ההרצה האחרונה והשגיאה הגלויה. אל תכללו סודות.

## נושאים קשורים

<CardGroup cols={2}>
  <Card title="סקירת אינטגרציות" icon="grid-2" href="/he/integrations/overview">
    מידע עזר על מחובר, קטלוג, סינכרון, פעולות והעלאה.
  </Card>

  <Card title="מיפוי נתונים" icon="arrows-left-right" href="/he/integrations/managing/data-mapping">
    הבנת המאפיינים והמיפויים הנתמכים, היכן שזמינים.
  </Card>

  <Card title="מחזור החיים של אינטגרציה" icon="route" href="/he/integrations/managing/lifecycle">
    תפעול אינטגרציה קיימת, כולל הרשאה מחדש או הסרה.
  </Card>

  <Card title="הטמעה למנהלים" icon="circle-check" href="/he/getting-started/onboarding">
    השלמת משימות האימות של נתוני הזהות ונתוני האבטחה.
  </Card>
</CardGroup>


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