הגדרת מאגר נתונים של Confluence Data Center

בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Confluence Data Center ל-Gemini Enterprise.

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

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

  1. מקצים את התפקיד Discovery Engine Editor‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להקצות את התפקיד הזה:

    1. נכנסים לדף IAM במסוף Google Cloud .

      כניסה לדף IAM

    2. מוצאים את חשבון המשתמש ולוחצים על עריכה .
    3. מקצים למשתמש את התפקיד Discovery Engine Editor. מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.

  2. מבצעים את השלבים שמפורטים בקטע הגדרת אימות וקבלת פרטי כניסה של לקוח כדי לקבל את מזהה הלקוח וסוד הלקוח ולהגדיר היקפי הרשאות של OAuth.

  3. אם למכונה של Confluence Data Center יש כתובת IP פרטית, מפרסמים שירות מפיק של Private Service Connect. במאמר מבוא למקורות נתונים באירוח עצמי מוסבר איך משתמשים ב-Private Service Connect כדי לחבר את Gemini Enterprise למקורות נתונים באירוח עצמי..

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

  1. מוודאים שיש לכם הרשאת אדמין ב-Confluence כדי לאחזר את המידע של רשימה של בקרת גישה (ACL).

  2. מתקינים את הפלאגין Permission Accessor for Confluence מרכז נתונים. הפלאגין הזה מספק נקודות קצה (endpoints) של REST ל-Gemini Enterprise. נקודות הקצה האלה מאפשרות ל-Gemini Enterprise לאחזר את פרטי ההרשאות במרחב, את הגבלות התוכן ואת כתובות האימייל של משתמשים עם רישיון. המידע הזה משמש כדי לוודא שההרשאות הנכונות מופעלות בחוויית החיפוש פנים-ארגוני של Gemini Enterprise.

יצירת מאגר הנתונים של Confluence Data Center

כדי ליצור את מאגר הנתונים של Confluence Data Center, מבצעים את השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    Gemini Enterprise

  2. בוחרים פרויקט ב- Google Cloud או יוצרים פרויקט חדש.

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. ‫Create data store.

  5. בקטע מקור, מחפשים את Confluence מרכז נתונים ולוחצים על בחירה.

  6. בקטע נתונים:

    1. בקטע Connector mode, בוחרים באפשרות הטמעת נתונים או Federated search.

    2. לוחצים על Continue.

    3. בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר.

      1. מזינים את פרטי האימות:

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

          • ‫Instance URI: כתובת ה-URI הבסיסית של המכונה של Confluence מרכז נתונים, לדוגמה, https://your-confluence-instance.com.
          • מזהה לקוח: המזהה הייחודי של אפליקציית OAuth שרשומה ב-Confluence מרכז נתונים.
          • סוד לקוח: הסוד ב-Secret Manager שמכיל את סוד הלקוח לאימות בקשות.

          במאמר הגדרת אימות וקבלת פרטי כניסה של לקוח מוסבר איך לקבל את פרטי הכניסה האלה.

        • בקטע הטמעת נתונים, בוחרים בין פרטי כניסה של שם משתמש וסיסמה, טוקן גישה אישי או טוקן API, ומזינים את פרטי האימות בהתאם.

      2. לוחצים על Continue.

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

      • אם בחרתם בסוג היעד Public, בשדה Domain URL מזינים את כתובת ה-URL הציבורית.

      • אם בחרתם בסוג היעד פרטי, הזינו את הפרטים הבאים:

        1. Service attachment: מזינים את קובץ השירות המצורף של Private Service Connect. כדי לקבל את זה, צריך לפרסם שירות של ספק Private Service Connect למכונה של Confluence Data Center.
        2. אם האזור של קובץ השירות המצורף של Private Service Connect שונה מהאזור של מאגר הנתונים, מסמנים את התיבה Enable PSC Global Access.
        3. במקרה של מופע עם כתובת URL של דומיין:
          • אופציונלי: שם דומיין בסיסי: מזינים את הדומיין הבסיסי. ציינו שם דומיין בסיסי ייחודי ומפורט (לדוגמה, confluence.example.com) במקום דומיין בסיסי (root) משותף (לדוגמה, example.com). אם יש לכם כמה מחברי נתונים באותו פרויקט, כמו Jira Data Center ו-Confluence Data Center, ודאו שכל אחד מהם משתמש בדומיין המלא של המכונה שלו כדומיין הבסיסי כדי למנוע התנגשויות ברשת. אי אפשר ליצור באותו פרויקט שני מחברי נתונים שמשתמשים בקישוריות פרטית עם אותו שם דומיין בסיסי.
          • כתובת ה-URL של הדומיין: מזינים את כתובת ה-URL של הדומיין. הוא חייב להיות זהה ל-URI של המכונה.
          • אופציונלי: יציאת יעד: מזינים את יציאת היעד.
        4. למופע בלי כתובת URL של דומיין:
          • יציאת היעד: מזינים את יציאת היעד.

    5. לוחצים על Continue.

    6. אופציונלי: לוחצים על אפשרויות מתקדמות.

      • אם בחרתם באפשרות חיפוש מאוחד:

        • אם מסמנים את התיבה SSL settings, בוחרים Trust Model מבין האפשרויות Private,‏ Public או Insecure, ואז מגדירים את שדות החובה. מידע נוסף על מודלים של אמון זמין במאמר מודלים של אמון.

          • ציבורי: משתמשים באפשרות הזו אם מרכז הנתונים של Confluence Data Center משתמש בתעודות שהונפקו על ידי רשות אישורים (CA) שמהימנה באופן ציבורי.
          • פרטי: השתמשו באפשרות הזו אם מרכז הנתונים של Confluence משתמש באישורים שנחתמו על ידי רשות אישורים פרטית או פנימית.
          • לא מאובטח: האפשרות הזו עוקפת את אימות האישור. לא מומלץ להשתמש בה בסביבות ייצור כי היא עלולה לחשוף את החיבור לסיכוני אבטחה.

          השדות הבאים משותפים לכל מודלי האמון:

          • אישור לקוח של מאגר מפתחות: אישור הלקוח בפורמט PEM. לדוגמה, -----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----.
          • מפתח פרטי של לקוח במאגר מפתחות: המפתח הפרטי של אישור הלקוח בפורמט PEM.
          • ביטוי סיסמה למפתח פרטי של לקוח במאגר מפתחות: ביטוי הסיסמה למפתח הפרטי של הלקוח, אם רלוונטי.

          במודל האמון הפרטי נדרש המידע הנוסף הבא:

          • אישור פרטי: האישור הציבורי של ה-CA הפרטי בפורמט PEM.

      • אם בחרתם באפשרות הטמעת נתונים, בצעו את הפעולות הבאות:

        1. מסמנים את התיבה הפעלת כתובות IP סטטיות. אחרי שיוצרים את החיבור, צריך להוסיף לרשימת ההיתרים את כתובות ה-IP הסטטיות הרשומות כדי שהסנכרון יצליח. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.
        2. בשדה Max QPS, מציינים את המספר המקסימלי של שאילתות שנשלחות למאגר הנתונים של Confluence Data Center בשנייה.
        3. מסמנים את התיבה הפעלת שדות בהתאמה אישית. אם ההגדרה מופעלת, המחבר מאחזר שדות בהתאמה אישית מ-Confluence Data Center.
        4. אם צריך, מסמנים את התיבות הגדרות לשרת proxy והגדרות SSL כדי להפעיל אותן.

    7. לוחצים על Continue.

    8. בקטע ישויות לחיפוש (אם בחרתם באפשרות חיפוש מאוחד) או ישויות לסנכרון (אם בחרתם באפשרות הטמעת נתונים):

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

  7. לוחצים על Continue.

  8. אם בחרתם באפשרות חיפוש מאוחד, בקטע פעולות, באפשרות בחירת פעולות של Confluence Data Center להפעלה, בוחרים את הפעולות מהקטגוריה שרוצים להפעיל במאגר הנתונים.

    כדי לנהל את רשימת הפעולות, עיינו במאמר ניהול פעולות.

  9. לוחצים על Continue.

  10. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה השם של מחבר הנתונים, נותנים שם למחבר.
    3. אם בחרתם באפשרות us או eu בתור המיקום, מגדירים את הגדרות ההצפנה:
      • אופציונלי: אם לא הגדרתם מפתחות לאזור יחיד, לחצו על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר רישום מפתח לאזור יחיד למחברים של צד שלישי.
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות Cloud KMS key:
        • ברשימה Key management type, בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key, בוחרים את המפתח.
      מידע נוסף זמין במאמר מפתחות הצפנה בניהול הלקוח.

  11. לוחצים על Continue.

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

  13. לוחצים על Continue.

  14. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data stores.

  15. אם בחרתם את סוג היעד Private והגדרתם את שירות ה-producer של Private Service Connect ל-Accept connections for selected projects (אישור מפורש), בצעו את הפעולות הבאות:

    1. במסוף Google Cloud , מחפשים את Private Service Connect ונכנסים לדף Private Service Connect.

    2. לוחצים על הכרטיסייה שירותים שפורסמו.

    3. לוחצים על השם של שירות Private Service Connect שתואם למאגר הנתונים של Confluence Data Center.

    4. בקטע Connected projects, מסמנים את התיבה לצד הפרויקט של Gemini Enterprise שמשמש כדייר (tenant) של מאגר הנתונים, ולוחצים על Accept project.

    הסטטוס של מאגר הנתונים נשאר Creating בדף Data Stores עד שלוחצים על Accept project בדף פרטי השירות ב-Private Service Connect. אחרי שלוחצים על אישור הפרויקט, הסטטוס של מאגר הנתונים משתנה לפעיל.

כדי לאמת את המצב של מאגר הנתונים, מבצעים את הפעולות הבאות בדף Data stores:

  1. עוברים למאגר הנתונים החדש שנוצר ברשימת מאגרי הנתונים, ועוקבים אחרי הסטטוס שלו עד שהוא משתנה ל-Active.
  2. כשהסטטוס של מאגר הנתונים משתנה מ-Creating (בשלבי יצירה) ל-Active (פעיל), אפשר להשתמש במחבר של Confluence Data Center.

אחרי שיוצרים את מאגר הנתונים:

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

טיפול בנתונים והרצת שאילתות

בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות כשמשתמשים במאגר הנתונים המשותף.

הרצת שאילתות

אחרי שנותנים הרשאה ל-Confluence Data Center ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש ישירות ל-API של Confluence Data Center.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:

  • מחרוזת השאילתה נשלחת לקצה העורפי של החיפוש של הצד השלישי (Confluence מרכז נתונים API).
  • הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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