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

ספקי אימות של צד שלישי מאפשרים לכם לקשר בצורה מאובטחת בין משימות העשרה של Knowledge Studio לבין פלטפורמות חיצוניות כמו GitHub,‏ Microsoft SharePoint ו-Atlassian Confluence. כחלק מההגדרה של הדרישות המוקדמות, צריך להשלים את השלבים ליצירת פרטי כניסה ולהגדרת ספק האימות שמפורטים במסמך הזה.

לפני שמתחילים

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

  • במאמר הגדרת דרישות מוקדמות למשימות העשרה מוסבר איך מגדירים את תהליך העבודה הכולל של ההעשרה.
  • ודאו שיש לכם את הרשאות האדמין או המפתח הנדרשות בפלטפורמות היעד של הצד השלישי (GitHub,‏ Microsoft SharePoint או Atlassian Confluence) כדי ליצור אסימוני גישה או לרשום אפליקציות.
  • כדי לאחסן פרטי כניסה בצורה מאובטחת ולצרף אותם למשימות, צריך לוודא שהגדרתם נכון את שירות Agent Identity. מידע נוסף זמין במאמר הגדרת הרשאות IAM לספקי אימות.

כשמקשרים את סוכן ההעשרה למקורות ידע של צד שלישי, צריך להשתמש בשירות Google Cloud Agent Identity. התכונה Agent Identity פועלת כמנהל אימות שמאחסן באופן מאובטח את פרטי הכניסה שלכם לצד שלישי, ומספק לסוכן ההעשרה אסימוני גישה לטווח קצר, כדי שמפעילים אנושיים לא יצטרכו לנהל ישירות סודות לקוח גולמיים במהלך ביצוע המשימה.

הגדרת GitHub

כדי לקשר את Knowledge Studio למאגרים ב-GitHub, צריך ליצור טוקן גישה אישי (PAT) מפורט ב-GitHub ולשמור אותו בספק אימות של מפתח API.

  1. נכנסים ל-GitHub, לוחצים על תמונת הפרופיל ואז על Settings.
  2. עוברים אל Developer settings ‏ > Personal access tokens ‏ > Fine-grained tokens.
  3. לוחצים על יצירת טוקן חדש.
  4. מגדירים את מאפייני הטוקן:
    • שם הטוקן: מזינים שם תיאורי (לדוגמה, enrichment-agent).
    • תפוגה: מגדירים תאריך תפוגה מתאים.
    • בעלי המשאב: בוחרים את הארגון או את חשבון המשתמש שבבעלותו נמצאים מאגרי היעד.
    • ‫Repository access: בוחרים באפשרות Only select repositories ובוחרים את המאגרים שרוצים להעשיר.
    • ‫Permissions: מעניקים גישת Read או Read and Write ספציפית להיקפים הנדרשים (כמו Issues,‏ Pull Requests ו-Contents).
  5. לוחצים על יצירת טוקן ומעתיקים את הטוקן למקום בטוח.
  6. רושמים ספק אימות של מפתח API ב- Google Cloud ומספקים את ה-PAT כמפתח ה-API. איך מאמתים באמצעות מפתח API עם מנהל אימות

למידע נוסף על יצירת PAT, ראו ניהול טוקני הגישה האישיים במסמכי התיעוד של GitHub.

הגדרת Microsoft SharePoint

אם אתם מתחברים ל-Microsoft SharePoint, אתם צריכים לקבל פרטי כניסה ל-OAuth מ-Microsoft Entra ID (לשעבר Azure Active Directory) באמצעות תהליך OAuth עם 2 רגליים.

  1. רושמים אפליקציה חדשה במרכז הניהול של Microsoft Entra.
  2. נותנים הרשאות ל-Microsoft Graph API:
    1. עוברים אל API permissions (הרשאות API) > Add a permission (הוספת הרשאה) > Microsoft Graph > Application permissions (הרשאות לאפליקציה) (לא בוחרים באפשרות Delegated permissions (הרשאות שהוקצו)).
    2. מוסיפים את היקפי ההרשאות Sites.Read.All ו-Files.Read.All.
    3. לוחצים על Grant admin consent לדייר (tenant) כדי ששתי ההרשאות של האפליקציה יופיעו כ-Granted.

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

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

    • מזהה לקוח: מזהה האפליקציה (הלקוח) מסקירת האפליקציה.
    • כתובת ה-URL של הטוקן: בדף Overview, לוחצים על הכרטיסייה Endpoints. מעתיקים את כתובת ה-URL שנקראת OAuth 2.0 token endpoint (v2)‎.

  5. רושמים ספק אימות OAuth דו-רגלי ב- Google Cloud באמצעות הסודות האלה. כשיוצרים את הספק, צריך לספק את היקף ברירת המחדל לפרמטר --allowed-scopes:

    --allowed-scopes="https://graph.microsoft.com/.default"

    מידע נוסף זמין במאמר רישום אפליקציה בפלטפורמת הזהויות של מיקרוסופט במסמכי התיעוד של Microsoft Entra.

הגדרת Atlassian Confluence

מכיוון ש-Confluence לא תומך ב-OAuth דו-רגלי לסוכני שרת-אל-שרת, צריך ליצור חשבון שירות ייעודי (או חשבון משתמש דמה) ב-Atlassian, לתת לו את ההרשאות הנדרשות וליצור PAT.

  1. נכנסים לחשבון השירות הספציפי ב-Confluence.
  2. לוחצים על תמונת הפרופיל בפינה השמאלית העליונה של המסך.
  3. בתפריט, לוחצים על הגדרות (או הגדרות חשבון).
  4. בכרטיסייה "אבטחה", עוברים לקטע "אסימוני API".
  5. לוחצים על הכפתור Create API token with scopes (יצירת אסימון API עם היקפים). אל תשתמשו בטוקן ללא היקף, כי הוא לא יאחזר את כל הכלים הנדרשים.
  6. נותנים שם תיאורי (לדוגמה, enrichment-agent), מגדירים את תאריך התפוגה ולוחצים על Next.
  7. ברשימה בחירת האפליקציה, בוחרים באפשרות Atlassian MCP ולוחצים על הבא.
  8. בוחרים את כל היקפי ההרשאות הבאים לקריאה ולחיפוש ב-Confluence:
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. לוחצים על הבא ואז על יצירה.
  10. מעתיקים את הטוקן שנוצר.
  11. מעצבים את מחרוזת פרטי הכניסה של ספק האימות Google Cloud בתור <ATLASSIAN_EMAIL>:<API_TOKEN>. כדי להשתמש בטוקנים האישיים של ה-API באופן פרוגרמטי, ב-Atlassian נדרש קידוד אימות בסיסי של HTTP‏ (email:api_token).
  12. רושמים ספק אימות של מפתח API ב- Google Cloud ומספקים את המחרוזת <ATLASSIAN_EMAIL>:<API_TOKEN> כמפתח ה-API. איך מאמתים באמצעות מפתח API עם מנהל אימות

מידע נוסף על יצירת PAT זמין במאמר ניהול אסימוני API בחשבון Atlassian במסמכי התיעוד של Atlassian.

המאמרים הבאים