הגדרת Box

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

בדף הזה מוסבר איך להגדיר תצורה של צד שלישי לפני שיוצרים את מאגר הנתונים של Box.

יצירת אפליקציית Box

1. נכנסים למסוף המפתחים של Box באמצעות חשבון האדמין.
2. לוחצים על Create platform app (יצירת אפליקציה לפלטפורמה).
3. בוחרים באפשרות סוג האפליקציה בתור אפליקציה בהתאמה אישית.
4. מזינים את שם האפליקציה.

5. מגדירים את המאפיינים הבאים:

   • מטרה: שילוב.
   • קטגוריות: AI.
   • מערכת חיצונית: Google Cloud Gemini Enterprise.

6. בוחרים באפשרות שיטת אימות בתור אימות שרת – JWT.

7. לחצו על Create App.

הגדרת אפליקציית Box

1. ב-Box Developer Console, בוחרים באפשרות Platform app בדף My Platform Apps.

   

   הדף My Platform Apps (האפליקציות שלי לפלטפורמה) ב-Box Developer Console.

2. בכרטיסייה הגדרה, מבצעים את הפעולות הבאות:

   1. בקטע App access level, בוחרים באפשרות App + Enterprise access.

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

      

      מגדירים את אפליקציית Box.

   2. בקטע Application scopes, בוחרים את ההיקפים על סמך מצב הקישור מהטבלה הבאה:

      מצב החיבור	היקף	מטרה
      חיפוש מאוחד	Read all files and folders stored in Box	נדרשת כדי לאחזר תגובות ומשימות, וכדי להציג קבצים בתצוגה מקדימה לצורך חיפוש.
      חיפוש מאוחד ופעולות מאוחדות	Write all files and folders stored in Box	נדרשת כדי להעתיק קבצים, להעלות קבצים ולהוריד קבצים, לאחזר תגובות ומשימות ולצפות בתצוגה מקדימה של קבצים לצורך חיפוש.
      הטמעת נתונים	Read all files and folders stored in Box	נדרש להטמעת נתונים.
      	Manage users	נדרש כדי לאחזר את רשימת המשתמשים, וכך לאפשר אחזור של קבצים, תגובות ומשימות מחשבונות משתמשים ספציפיים לצורך הטמעה. לחשבון השירות של האדמין אין גישה לכל הקבצים שבבעלות המשתמשים. הכותרת as-user מאפשרת למערכת לשלוח בקשות API בשם המשתמש הספציפי כדי לגשת לנתונים שלו.
      	Manage enterprise properties	ההרשאה נדרשת לפונקציונליות של סנכרון מצטבר, כי היא מאפשרת להשתמש בזרם האירועים של Enterprise כדי לעקוב אחרי שינויים לצורך הטמעה.
      	Manage groups	נדרש כדי לאחזר את רשימת הקבוצות והחברים שלהן. זה חשוב במיוחד לבקרת גישה במהלך ההטמעה.

      הערה: אם אתם מתכוונים להשתמש במאגר הנתונים רק לחיפוש ולא לביצוע פעולות שמשנות את התוכן ב-Box, אתם יכולים להגביל את ההיקף לקריאת כל הקבצים והתיקיות שמאוחסנים ב-Box. היקף ההרשאה Write all files and folders stored in Box נדרש לפעולות שכוללות עדכון תוכן ב-Box. מידע נוסף זמין במאמר בנושא פעולות

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

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

4. לוחצים על שמירת השינויים.

מתן הרשאה לאפליקציית Box

כדי לתת הרשאה לאפליקציית Box דרך Developer Console:

1. ב-Box Developer Console, בוחרים את אפליקציית הפלטפורמה ועוברים לכרטיסייה Authorization (הרשאה).
2. לוחצים על בדיקה ושליחה.

3. בתיבת הדו-שיח Review app authorization submission (בדיקת בקשת הרשאה לאפליקציה), לוחצים על Submit (שליחה).

   אם בקשת ההרשאה נשלחת בהצלחה, מוצגת הודעת האישור הבאה:

   

   בקשת ההרשאה נשלחה בהצלחה.

כדי לאשר את אפליקציית Box ממרכז ניהול האפליקציות של Box:

1. נכנסים אל מנהל האפליקציות בפלטפורמת האדמין של Box באמצעות חשבון האדמין.
2. בוחרים את אפליקציית הפלטפורמה שהגדרתם.
3. לוחצים על סמל האפשרויות הנוספות (...) בשורה המתאימה.
4. בתפריט הנפתח, בוחרים באפשרות הרשאת האפליקציה.
5. בתיבת הדו-שיח Authorize app (אישור האפליקציה), לוחצים על Authorize (אישור) כדי להשלים את תהליך ההרשאה.

קבלת פרטי אימות של Box

כדי לקבל את פרטי האימות של Box:

1. ב-Box Developer Console, בוחרים באפשרות Platform app בדף My Platform Apps.

• ‫Enterprise ID: אפשר למצוא אותו בכרטיסייה General settings (הגדרות כלליות).

  

  איך מקבלים את מזהה ה-Enterprise

• מזהה לקוח וסוד לקוח: מקבלים אותם מהכרטיסייה Configuration (הגדרה) בקטע OAuth 2.0 credentials (פרטי כניסה של OAuth 2.0).

  

  משיגים את הגדרות הלקוח.

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

  

  הוספה וניהול של מפתחות ציבוריים.