הגדרת Box

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

תוכנית Public Preview: התכונות של חיפוש מאוחד ופעולות מאוחדות זמינות בתוכנית Public Preview. השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות כלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאורים של שלבי ההשקה.

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

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

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

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

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

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

7. לוחצים על יצירת אפליקציה.

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

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

   

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

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

   1. בקטע רמת הגישה לאפליקציה, בוחרים באפשרות גישה לאפליקציה + גישה לארגון.

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

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

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

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

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

  

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

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

  

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

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

  

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