הערה: חבילת המסמכים הזו מיועדת למהדורות Standard,‏ Plus,‏ תשלום לפי שימוש ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הגדרה של Microsoft SharePoint

כדי לקשר בין Gemini Enterprise ל-Microsoft SharePoint, צריך לבצע את השלבים הבאים.

הגדרת אימות והרשאות

אתם צריכים להגדיר אימות והרשאות במרכז הניהול של Microsoft Entra. זהו שלב חיוני כדי לאפשר למחבר לגשת לנתונים ולסנכרן אותם.

רישום אפליקציית Microsoft Entra למחבר של Microsoft SharePoint

לפני שיוצרים את המחבר של Microsoft SharePoint ב-Gemini Enterprise, צריך לרשום אפליקציית Microsoft Entra כדי לאפשר גישה מאובטחת.

כדי לרשום את Gemini Enterprise כאפליקציית OAuth 2.0 ב-Entra, מבצעים את הפעולות הבאות:

עוברים אל Microsoft Entra admin center (מרכז הניהול של Microsoft Entra).
בתפריט הניווט, מרחיבים את Entra ID ובוחרים באפשרות App registrations.
בדף App registrations, לוחצים על New registration.
בדף Register an application, מבצעים את הפעולות הבאות:
1. בשדה שם, מזינים שם לאפליקציה.
2. בקטע Supported account types, בוחרים באפשרות Accounts in this organizational directory only (יכול להיות שהיא תופיע גם בתור Single tenant only או Single tenant only - MSFT, בהתאם להגדרת הדייר). הפעולה הזו מגבילה את הגישה למשתמשים ולאורחים בתוך הדייר או הספרייה שלכם.
3. בקטע Redirect URI:
  1. ברשימת הפלטפורמות, בוחרים באפשרות Web.
  2. בשדה ה-URI של ההפניה האוטומטית, מזינים את הכתובת https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.
4. לוחצים על הרשמה. מערכת Microsoft Entra יוצרת את האפליקציה ומציגה את דף הסקירה הכללית שלה.
בתפריט הניווט של האפליקציה, לוחצים על Authentication (אימות).
לוחצים על Add redirect URI.
בחלונית לבחירת הפלטפורמה:
1. לוחצים על אתר.
2. בשדה Redirect URI, מזינים https://vertexaisearch.cloud.google.com/oauth-redirect.
3. לוחצים על הגדרה.

הוספת פרטי כניסה מאוחדים להטמעת נתונים

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

בתפריט הניווט של האפליקציה, לוחצים על Certificates & secrets.
לוחצים על הכרטיסייה Federated credentials.
‫לוחצים על Add credential.
ברשימה Federated credential scenario, בוחרים באפשרות Other issuer.
בשדה Issuer, מזינים https://accounts.google.com.
בשדה Subject identifier, מזינים את הערך שקיבלתם ממסוף Google Cloud . הערך הזה נוצר במהלך יצירת מאגר הנתונים של Microsoft SharePoint בקטע הנתונים.
בשדה Name, מזינים תווית ייחודית לפרטי הכניסה המאומתים.
לוחצים על הוספה כדי לתת גישה.

יצירת הגדרת OAuth 2.0

כדי ליצור חיבור באמצעות שיטת האימות OAuth 2.0, אתם צריכים לקבל מזהה לקוח, סוד לקוח ומזהה דייר (tenant) מדף הרישום של האפליקציה ב-Microsoft Entra.

קבלת מזהה לקוח וסוד לקוח

כדי לקבל את מזהה הלקוח:
1. בתפריט הניווט של האפליקציה, בוחרים באפשרות סקירה כללית.
2. מעתיקים את מה שכתוב בשדה Application (client) ID.
כדי לקבל את סוד הלקוח של האפליקציה:
1. בתפריט הניווט של האפליקציה, בוחרים באפשרות Certificates & secrets.
2. לוחצים על New client secret.
3. בחלונית של סוד הלקוח:
  1. בשדה Description, מזינים תיאור של הסוד.
  2. ברשימה תוקף, בוחרים את משך הזמן עד שהתוקף יפוג.
  3. לוחצים על הוספה.
4. מעתיקים את סוד הלקוח מהעמודה Value.

קבלת ה-URI של המכונה

ה-URI של המכונה הוא באחד מהפורמטים הבאים:

לכל האתרים ברמה הראשונה: https://DOMAIN_OR_SERVER.sharepoint.com —לדוגמה, mydomain.sharepoint.com.
לאתר אחד: https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE —לדוגמה, mydomain.sharepoint.com/sites/sample-site.

קבלת מזהה דייר (tenant)

מזהה הדייר מופיע בתיבה Tenant ID (מזהה הדייר) בדף הסקירה הכללית במרכז הניהול של Microsoft Entra.

הגדרת הרשאות ל-API של מיקרוסופט

כדי להגדיר את הרשאות ה-API הנדרשות לאפליקציה:

עוברים לדף האפליקציה.
בתפריט הניווט של האפליקציה, בוחרים באפשרות API permissions (הרשאות API).
לוחצים על הוספת הרשאות.
בחלונית Request API permissions, בוחרים באפשרות Microsoft Graph.

מחפשים ובוחרים את ההרשאות הבאות בהתאם למצב החיבור:

במצב החיבור חיפוש מאוחד, לא נדרשות הרשאות Graph API.

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

הרשאה	סוג	תיאור
`GroupMember.Read.All`	בקשת הצטרפות	ההרשאה מאפשרת למחבר לקרוא את החברויות בקבוצות ואת המאפיינים הבסיסיים של כל הקבוצות בלי משתמש שמחובר לחשבון.
`User.Read`	חשבון מואצל	מאפשרת למחבר לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. הוא גם מאפשר למחבר לקרוא מידע בסיסי על החברה של משתמשים שמחוברים לחשבון.
אפשרויות לבקרת האתר
אפשרות 1: `Sites.FullControl.All`	בקשת הצטרפות	מאפשר למחבר לקבל שליטה מלאה בכל אוספי האתרים.
אפשרות 2: `Sites.Selected`	בקשת הצטרפות	מאפשר למחבר לגשת לקבוצת משנה של אוספי אתרים. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
אפשרויות קריאה בפרופיל
אפשרות 1: `User.Read.All`	בקשת הצטרפות	מאפשרת למחבר לקרוא פרופילי משתמשים.
אפשרות 2: `User.ReadBasic.All`	בקשת הצטרפות	מאפשרת למחבר לקרוא קבוצה בסיסית של מאפייני פרופיל של משתמשים אחרים בארגון.

במצב החיבור הטמעת נתונים עם טוקן רענון של OAuth 2.0:

הרשאה	סוג	תיאור
`GroupMember.Read.All`	בקשת הצטרפות	ההרשאה מאפשרת למחבר לקרוא את החברויות בקבוצות ואת המאפיינים הבסיסיים של כל הקבוצות בלי משתמש שמחובר לחשבון.
`User.Read`	חשבון מואצל	מאפשר למחבר לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. הוא גם מאפשר למחבר לקרוא מידע בסיסי על החברה של משתמשים שמחוברים לחשבון.
`User.Read.All`	בקשת הצטרפות	מאפשרת למחבר לקרוא פרופילי משתמשים.
אפשרויות לבקרת האתר
אפשרות 1: `Sites.FullControl.All`	בקשת הצטרפות	מאפשר למחבר לקבל שליטה מלאה בכל אוספי האתרים.
אפשרות 2: `Sites.Selected`	בקשת הצטרפות	מאפשר למחבר לגשת לקבוצת משנה של אוספי אתרים. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.

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

הרשאה	סוג	תיאור
`Sites.ReadWrite.All`	חשבון מואצל	המחבר יכול לערוך או למחוק מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש שמחובר לחשבון.
`Files.ReadWrite`	חשבון מואצל	מאפשרת למחבר לקרוא (להוריד), ליצור (להעלות), לעדכן ולמחוק את הקבצים של המשתמש שמחובר לחשבון.
`Files.ReadWrite.All`	חשבון מואצל	מאפשרת למחבר לקרוא (להוריד), ליצור (להעלות), לעדכן ולמחוק את כל הקבצים שהמשתמש המחובר יכול לגשת אליהם.
`Sites.Manage.All`	חשבון מואצל	מאפשר למחבר ליצור או למחוק ספריות מסמכים ורשימות בכל אוספי האתרים בשם המשתמש.

לוחצים על Add Permissions.
בחלונית Request API permissions, בוחרים באפשרות Microsoft SharePoint.

מחפשים ובוחרים את ההרשאות הבאות בהתאם למצב החיבור:

במצב החיבור חיפוש מאוחד:

הרשאה	סוג	תיאור
`Sites.Search.All`	חשבון מואצל	מאפשרת למחבר להריץ שאילתות חיפוש ולקרוא מידע בסיסי על האתר בשם המשתמש שמחובר כרגע. תוצאות החיפוש מבוססות על ההרשאות של המשתמש ולא על ההרשאות של האפליקציה.
`AllSites.Read`	חשבון מואצל	מאפשר למחבר לקרוא מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש המחובר.

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

הרשאה	סוג	תיאור
אפשרויות לבקרת האתר
אפשרות 1: `Sites.FullControl.All`	בקשת הצטרפות	מאפשר למחבר לקבל שליטה מלאה בכל אוספי האתרים.
אפשרות 2: `Sites.Selected`	בקשת הצטרפות	מאפשר למחבר לגשת לקבוצת משנה של אוספי אתרים עם משתמש מחובר. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.

במצב החיבור הטמעת נתונים עם טוקן רענון של OAuth 2.0:

הרשאה	סוג	תיאור
אפשרויות לבקרת האתר
אפשרות 1: `AllSites.FullControl`	חשבון מואצל	מאפשר למחבר לקבל שליטה מלאה על כל אוספי האתרים בשם המשתמש המחובר.
אפשרות 2: `Sites.Selected`	חשבון מואצל	מאפשר למחבר לגשת לקבוצת משנה של אוספי אתרים עם משתמש מחובר. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.

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

הרשאה	סוג	תיאור
`AllSites.Write`	חשבון מואצל	ההרשאה הזו מאפשרת למחבר ליצור, לקרוא, לעדכן, למחוק, להעלות ולהוריד מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש שמחובר לחשבון.

לוחצים על Add Permissions.
הערה: כשמשתמשים ב-Sites.Selected, צריך לתת ל-fullcontrol הרשאה לאתרים שנבחרו. בנוסף, כדי שההרשאה הזו תיכנס לתוקף, צריך לבצע לפחות אחת מהפעולות הבאות כשיוצרים את מאגר הנתונים של SharePoint ב-Gemini Enterprise:
- משתמשים בכתובת URL ספציפית של אתר בתור כתובת ה-URL של המופע של מחבר SharePoint, לדוגמה, mydomain.sharepoint.com/sites/sample-site.
- כשמגדירים את מאגר הנתונים של Gemini Enterprise, צריך לספק מסננים מדויקים של siteName.
נותנים הסכמה של אדמין. במאמר Grant tenant-wide administrator consent to an application במסמכי התיעוד של Microsoft Entra מוסבר איך לתת הסכמה.
זהירות:
- הסכמת אדמין ברמת הדייר (קריטי): חובה לתת הסכמת אדמין ברמת הדייר ב-Microsoft Entra ID לאפליקציה הרשומה. חוסר הסכמה של האדמין הוא סיבה נפוצה לכך שהמחבר לא מצליח לבצע אימות.
- מזהי אפליקציות כפולים: שימו לב שב-Gemini Enterprise יש מזהי אפליקציות שונים ב-Microsoft Entra לתכונות שונות. צריך מזהה אפליקציה אחד לחיבור של "מאגר הנתונים" בקצה העורפי, ומזהה אפליקציה נפרד כדי להפעיל את הלחצן "העלאה מ-OneDrive או מ-SharePoint" בממשק הצ'אט. שתי האפליקציות דורשות הסכמה של האדמין.

מתן הרשאה ל-`fullcontrol` באתרים שנבחרו

אם בוחרים באפשרות Sites.Selected כדי לתת שליטה באתרים נבחרים ב-Microsoft Graph, צריך לתת את ההרשאה fullcontrol לאפליקציית Gemini Enterprise. אפשר לעשות את זה באחת מהדרכים הבאות:

PowerShell
Microsoft Graph

PowerShell

במאמר הענקת הרשאות באמצעות PnP PowerShell מוסבר איך להעניק הרשאות באמצעות PnP PowerShell.

כדי להעניק את ההרשאה FullControl, מריצים את הפקודה הבאה ב-PowerShell :
```
Grant-PnPAzureADAppSitePermission -AppId CLIENT_ID -DisplayName DISPLAY_NAME -Permissions FullControl -Site SITE_URL
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫CLIENT_ID: מזהה הלקוח של האפליקציה ב-Microsoft Entra.
- ‫SITE_URL: כתובת ה-URL של האתר ב-SharePoint, לדוגמה: https://example.sharepoint.com/sites/ExampleSite1.
- ‫DISPLAY_NAME: השם המוצג של האפליקציה ב-Microsoft Entra.

Microsoft Graph

במאמר מתן הרשאות באמצעות Microsoft Graph מוסבר איך נותנים הרשאות באמצעות Microsoft Graph.

משתמשים ב-Microsoft Graph Explorer כדי להפעיל את השיטות הבאות. רק בעלי האתר יכולים להפעיל את השיטות האלה.

מאתרים את מזהה האתר:
```
GET `https://graph.microsoft.com/v1.0/sites/HOSTNAME:SITE_PATH`
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫HOSTNAME: שם המארח של האתר ב-Sharepoint, לדוגמה example.sharepoint.com.
- ‫SITE_PATH: הנתיב של האתר ב-SharePoint. לדוגמה: /sites/ExampleSite1 או /teams/ExampleSite2.
נותנים ל-fullcontrol גישה לאתר שהמזהה שלו אוחזר בשלב הקודם.
- שולחים את בקשת ה-POST הבאה:
```
   POST `https://graph.microsoft.com/v1.0/sites/SITE_ID/permissions`
```
- משתמשים בגוף הבקשה הבא:
```
{
  "roles": ["fullControl"],
  "grantedToIdentities": [{
    "application": {
      "id": "CLIENT_ID",
      "displayName": "DISPLAY_NAME"
    }
  }]
}
```
  מחליפים את מה שכתוב בשדות הבאים:
  - ‫SITE_ID: מזהה האתר של SharePoint שקיבלתם בשלב הקודם. זהו הפורמט הרצוי: example.sharepoint.com,48332b69-85ab-0000-0000-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
  - ‫CLIENT_ID: מזהה הלקוח של האפליקציה ב-Microsoft Entra.
  - ‫DISPLAY_NAME: השם המוצג של האפליקציה ב-Microsoft Entra.

פתרון בעיות

בקטע הזה מוסבר איך לפתור בעיות נפוצות במחבר של Microsoft SharePoint.

המשתמשים רואים את ההודעה "נדרש אישור אדמין" כשהם מתחברים

בפעם הראשונה שהמשתמשים מתחברים ל-Microsoft SharePoint מאפליקציית האינטרנט של Gemini Enterprise, יכול להיות שתוצג ב-Microsoft ההודעה נדרש אישור אדמין. זה קורה אם Gemini Enterprise מבקש הרשאות ברמת האדמין, או אם הדייר (tenant) ב-Microsoft Entra אוסר על המשתמשים לאשר אפליקציות של צד שלישי בלי הסכמה מראש של האדמין ברמת הדייר.

כדי לפתור את הבעיה, אדמין צריך להשלים את האישור הראשון. אחרי שההרשאה תאושר, משתמשים אחרים בדייר שלכם יוכלו להתחבר בלי מסך האישור.

מבקשים מאדמין ב-Microsoft Entra ID שיש לו הרשאה לתת הסכמה ברמת הדייר להיכנס לאתר Gemini Enterprise ולקשר אותו ל-Microsoft SharePoint.
במסך ההרשאות, האדמין צריך לבחור באפשרות Consent on behalf of your organization ואז ללחוץ על Accept.
מבקשים מהמשתמשים להתחבר שוב.

מידע נוסף זמין במאמר Grant tenant-wide admin consent במסמכי התיעוד של Microsoft Entra.