הגדרת Box

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

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

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

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

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

  6. בוחרים באפשרות Server Auth - JWT (אימות שרת – JWT) בתור Authentication method (שיטת האימות).

  7. לחצו על Create App.

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

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

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

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

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

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

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

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

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

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

כדי לאשר את אפליקציית Box מ-Developer Console, מבצעים את הפעולות הבאות:

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

  3. בתיבת הדו-שיח בדיקת הבקשה להרשאת האפליקציה, לוחצים על שליחה.

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

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

כדי לאשר את אפליקציית 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.

    משיגים את מזהה הארגון
    משיגים את מזהה הארגון.

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

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

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

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