הגדרת 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.

      הגדרת אפליקציית 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. בתיבת הדו-שיח 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: אפשר למצוא אותו בכרטיסייה הגדרות כלליות.

    קבלת מזהה הארגון
    איך מקבלים את מזהה ה-Enterprise

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

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

  • ‫Private key (מפתח פרטי), Key ID (מזהה מפתח) ו-Passphrase (ביטוי סיסמה): הפרמטרים האלה נוצרו והורדו לקובץ מקומי מהכרטיסייה Configuration (הגדרה) בקטע Add and manage public keys (הוספה וניהול של מפתחות ציבוריים) במהלך הגדרת האפליקציה.

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