הגדרת Box

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

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

  1. נכנסים למסוף המפתחים של Box באמצעות חשבון האדמין.
  2. לוחצים על יצירת אפליקציה לפלטפורמה.
  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. בכרטיסייה 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, בוחרים את האפליקציה Platform ועוברים לכרטיסייה Authorization.
  2. לוחצים על בדיקה ושליחה.

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

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

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

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

  1. נכנסים למנהל האפליקציות בפלטפורמת האדמין של Box באמצעות חשבון האדמין.
  2. בוחרים את האפליקציה בפלטפורמה שהגדרתם.
  3. לוחצים על סמל האפשרויות הנוספות (...) בשורה המתאימה.
  4. בוחרים באפשרות Authorize app (אישור האפליקציה) מהרשימה הנפתחת.
  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.

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

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

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