يمكنك إعداد Google Cloud Search لعرض نتائج من محتوى SharePoint المحلي الخاص بمؤسستك بالإضافة إلى محتوى Google Workspace. يمكنك استخدام موصّل Google Cloud Search SharePoint On-Prem وإعداده للوصول إلى مصدر بيانات SharePoint محدّد.
اعتبارات مهمة
إعدادات SharePoint التي يتم الالتزام بها
يُراعي موصّل Cloud Search SharePoint On-Prem دائمًا إعداد إذن الوصول إلى البحث في SharePoint، ولا يمكن تجاهله. بالنسبة إلى مستندات المسودات، تتحكّم الأذونات الممنوحة لحساب المستخدم (الذي يستخدمه الموصل للوصول إلى SharePoint Online) في مستندات المسودات التي يتم فهرستها وعرضها. إذا كان الحساب لديه أذونات "القراءة الكاملة" فقط، يلتزم الموصل بإعدادات "إمكانية رؤية مسودة العنصر" في SharePoint.
يمكنك أيضًا ضبط الموصّل لحصر النتائج استنادًا إلى أذونات الوصول إلى حساب المستخدم. يمكنك استخدام الجهات الرئيسية في Google والجهات الرئيسية الخارجية لتحديد قوائم التحكّم بالوصول. لتطبيق ميزة "اقتطاع الأمان" على محتوى SharePoint، عليك مزامنة الهويات الخارجية التالية مع "دليل Google":
- مستخدمو Active Directory
- مجموعات Active Directory
- مجموعات SharePoint المحلية (مع مستخدمي ومجموعات Active Directory كأعضاء)
لمزامنة مستخدمي ومجموعات Active Directory، يمكنك استخدام أداة مزامنة دليل Google Cloud، ما يتيح استخدام المجموعات التي تم ربطها بالهوية. لمزامنة مجموعات SharePoint المحلية، عليك استخدام أداة ربط الهوية في SharePoint.
يحتاج الموصِّل أيضًا إلى إجراء بحث باستخدام "Active Directory" لجلب معلومات إضافية لمزامنة الجهات الرئيسية. على سبيل المثال، يتيح البحث باستخدام "الدليل النشط" للموصل تنفيذ ما يلي:
- اربط معرّف SID لمجموعة نطاق بـ sAMAccountName المقابل.
- ربط sAMAccountName الخاص بالمستخدم بعنوان البريد الإلكتروني الخاص بعضويات مجموعة SharePoint المحلية
تحسين الأداء على "شبكة البحث"
يمكنك تحسين تجربة المستخدمين من خلال ضبط أداة الربط لعرض نتائج بحث أكثر صلة.
لاستخدام واجهة برمجة التطبيقات، اضبط قيم مَعلمات إنشاء HTML في ملف إعداد أداة ربط SharePoint Online. تتيح لك هذه المَعلمات تحديد الحقول التي لها تأثير أكبر أو أقل في عمليات المطابقة.
لإعداد مخطط، اتّبِع التعليمات الواردة في إنشاء مخطط وتسجيله. عند إعداد مخطط:
لربط أسماء أنواع محتوى SharePoint بتعريفات العناصر المقابلة، يعمل الموصل على تسوية أسماء أنواع المحتوى من خلال استبعاد الأحرف غير المسموح بها. بالنسبة إلى تعريفات العناصر، لا تتيح Cloud Search API استخدام سوى الأحرف من A إلى Z ومن a إلى z والأرقام من 0 إلى 9 كأحرف صالحة. على سبيل المثال، يرتبط نوع المحتوى "الإشعارات" بتعريف العنصر "الإشعارات". يتوافق نوع المحتوى "مقالة إخبارية" مع "NewsArticle" (بدون مسافة).
عندما يتعذّر على أداة الربط مطابقة تعريف عنصر مع تعريف عنصر آخر، تستخدم أداة الربط نوع العنصر الاحتياطي (
itemMetadata.objectType
). مزيد من المعلومات عن مَعلمات إعداد البيانات الوصفيةلربط أسماء خصائص SharePoint بتعريفات الخصائص، يعمل الموصل على تسوية أسماء الخصائص من خلال فك ترميز الأحرف المرمّزة بنظام الستة عشر وإزالة البادئات "ows_"، ثم استبعاد الأحرف غير المسموح بها (جميع الأحرف باستثناء A-Z وa-z و0-9 كأحرف صالحة).
التعامل مع رسائل Microsoft Outlook
عندما يصادف الموصل ملفات .msg من Microsoft Outlook أثناء فهرسة المحتوى، يتجاهل نوع الوسائط للملفات ويفهرسها على أنّها application/vnd.ms-outlook.
إعدادات الوحدات المشترَكة
إذا كان SharePoint عبارة عن عملية نشر متعددة المستأجرين، حيث تتم استضافة مواقع إلكترونية متعددة للعملاء على تطبيق الويب نفسه، عليك ضبط وضع مجموعة المواقع في ملف الإعداد. في عمليات النشر المتعددة المستأجرين، لا يمكنك الحصول على أذونات إلا لمجموعة المواقع المشتركة، ولا يمكنك الحصول على أذونات القراءة الكاملة، كما هو مطلوب من موصل SharePoint On-Prem.
لتفعيل وضع "مجموعة المواقع"، اتّبِع الخطوات التالية:
- امنح حساب مستخدم الموصل أذونات مشرف مجموعة المواقع.
- اضبط
sharepoint.server
في ملف إعداد الموصل على عنوان URL لمجموعة المواقع الإلكترونية، مثلhttp://sharepoint.example.com/sites/sitecollection
. ليس مطلوبًا أن يستخدم عنوان URL حالة الأحرف نفسها تمامًا كما في SharePoint. - اضبط
sharepoint.siteCollectionOnly
في ملف إعداد الموصل علىtrue
.
إذا كان لديك مجموعات مواقع إلكترونية متعددة لفهرستها في بيئة متعددة المستأجرين، عليك ضبط مثيل موصّل واحد لكل مجموعة من مجموعات المواقع الإلكترونية.
القيود المعروفة للموصلات
- يزداد الوقت الذي يستغرقه الموصّل لرصد التغييرات في العناصر في قواعد البيانات مع زيادة عدد قواعد البيانات التي يراقبها الموصّل.
- يزداد استهلاك الذاكرة مع عدد المستخدمين والمجموعات الفريدة التي تستخدمها في قوائم التحكم بالوصول لكل مجموعة مواقع إلكترونية.
- يمكنك ضبط أداة الربط باستخدام هويات من نطاق Active Directory واحد فقط.
- لا تتوافق بعض عناصر Active Directory وWindows الأساسية الشائعة، مثل
Everyone
وBUILTIN\Users
وAll Authenticated Users
. - لا تتم عمليات حذف الإشعارات على الفور، وقد يستغرق الموصّل أكثر من 4 ساعات للتعرّف على أنّ أحد المستخدمين حذف محتوًى من مستودع المصدر.
متطلبات النظام
متطلبات النظام | |
---|---|
نظام التشغيل |
|
البرامج |
|
المصادقة |
|
نشر الموصّل
المتطلبات الأساسية
أنشئ مفتاحًا خاصًا على Google Workspace يحتوي على رقم تعريف حساب الخدمة. لمعرفة كيفية الحصول على مفتاح خاص، انتقِل إلى ضبط أذونات الوصول إلى Google Cloud Search API.
على مشرف Google Workspace إضافة مصدر بيانات للبحث. سجِّل رقم تعريف مصدر البيانات.
إذا كان الموصل يعرض نتائج استنادًا إلى قوائم التحكّم بالوصول (أي أنّ النتائج ليست متاحة للجميع)، على مشرف Google Workspace إنشاء مصدرَي هوية ومنحك أرقام التعريف الخاصة بهما:
- مصدر هوية لمزامنة مستخدمي ومجموعات Active Directory
- مصدر هوية لمجموعات SharePoint المحلية
على المشرف أيضًا الحصول على رقم تعريف عميل Google Workspace لمؤسستك وإرساله إليك.
تعرَّف على كيفية الحصول على هذه القيم في مقالة ربط هويات المستخدمين في Cloud Search.
إعداد حساب مستخدم للموصل لديه أذونات القراءة الكاملة لتطبيق SharePoint على الويب في سياسة المستخدم
إذا لم يكن لدى تطبيق الويب في SharePoint مجموعة مواقع جذر، أنشئ مجموعة مواقع جذر.
إذا كانت أي مجموعات مواقع إلكترونية محمية من الكتابة، سجِّل الدخول إلى خادم SharePoint باستخدام حساب لديه امتيازات المشرف وشغِّل النص البرمجي
PrepareWriteLockedSites.ps1
.للحصول على مقاييس مصدر البيانات التي تساعدك في ضبط إعدادات الموصل، سجِّل الدخول إلى خادم SharePoint باستخدام حساب لديه امتيازات إدارة المزرعة وشغِّل
diagnose_sp.ps1
.تعرض النتائج أعداد تطبيقات الويب والمستندات وعضويات مجموعات المستخدمين. استخدِم هذه المعلومات لتقدير عدد مثيلات الموصل التي تحتاج إليها ومتطلبات الذاكرة وعدد المستندات.
الخطوة 1: ثبِّت برنامج موصّل Google Cloud Search SharePoint On-Prem.
استنسِخ مستودع الموصل من GitHub.
$ git clone https://github.com/google-cloudsearch/sharepoint-connector.git $ cd sharepoint-connector
اطّلِع على الإصدار المطلوب من الموصل:
$ git checkout tags/latest_version
المكان:
latest_version
= قيمة مثلv1-0.0.5
أنشئ الموصّل.
$ mvn package
لتخطّي الاختبارات عند إنشاء الموصل، شغِّل
mvn package -DskipTests
بدلاً منmvn package
.انسخ ملف zip الخاص بالموصل إلى دليل التثبيت المحلي:
$ cp target/google-cloudsearch-sharepoint-connector-latest_version.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-sharepoint-connector-latest_version.zip $ cd google-cloudsearch-sharepoint-connector-latest_version
الخطوة 2: إنشاء ملف إعداد موصّل SharePoint On-Prem
في الدليل نفسه الذي تم فيه تثبيت الموصّل، أنشِئ ملفًا. تنصح Google بتسمية الملف
connector-config.properties
حتى لا تكون هناك حاجة إلى معلَمات إضافية في سطر الأوامر لتشغيل الموصّل. إذا كنت تخطّط لتشغيل العديد من مثيلات الموصل، أضِف تفاصيل إلى الاسم لتمييزه.أضِف المَعلمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:
### Sharepoint On-Prem Connector configuration ### # Required parameters for data source access api.sourceId=08ef8becd116faa4546b8ca2c84b2879 api.serviceAccountPrivateKeyFile=service_account.json api.identitySourceId=08ef8becd116faa475de26d9b291fed9 # Required parameters for SharePoint on-premises access sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection sharepoint.siteCollectionOnly=true sharepoint.username=contoso\\admin sharepoint.password=pa$sw0rd sharepoint.stripDomainInUserPrincipals=true # Required parameters for AD lookup adLookup.host=dc.contoso.com adLookup.username=contoso\\admin adLookup.password=pa$sw0rd api.referenceIdentitySources=CONTOSO,contoso api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa # Optional parameters for schema mapping contentTemplate.sharepointItem.title=Title contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
للحصول على أوصاف تفصيلية لكل مَعلمة، انتقِل إلى مرجع مَعلمات الإعداد.
(اختياري) اضبط مَعلمات إضافية للموصل حسب الحاجة. لمعرفة التفاصيل، انتقِل إلى مَعلمات الموصل التي توفّرها Google.
الخطوة 3: بالنسبة إلى HTTPS، أضِف SharePoint كمضيف موثوق به
إذا تم إعداد SharePoint لاستخدام HTTPS، احصل على شهادة SharePoint لإضافتها كمضيف موثوق به للموصل.
على الكمبيوتر الذي سيتم تشغيل أداة الربط عليه، افتح متصفّحًا وانتقِل إلى SharePoint.
في صفحة التحذير التي تفتح، انقر على أتفهّم المخاطر وإضافة استثناء. تعرض الصفحة رسالة مثل "هذا الاتصال غير موثوق به" لأنّ الشهادة موقّعة ذاتيًا وليست موقّعة من مرجع تصديق موثوق به.
بعد أن يصبح الزر عرض متاحًا، انقر عليه.
انتقِل إلى علامة التبويب التفاصيل وانقر على تصدير.
احفظ الشهادة في دليل الموصل بالاسم
sharepoint.crt
.انقر على إغلاق ثم على إلغاء لإغلاق النوافذ.
افتح موجّه الأوامر وأدخِل الأمر التالي:
$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint
عندما يُطلب منك "هل تثق في هذه الشهادة؟"، أجِب نعم.
الخطوة 4: إعداد التسجيل
في الدليل الذي يحتوي على الملف الثنائي للموصل، أنشئ مجلدًا باسم
logs
.في الدليل نفسه (وليس
logs
)، أنشئ ملفًا بترميز Latin1 باسمlogging.properties
.أضِف النص التالي إلى
logging.properties
:handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler # Default log level .level = INFO # uncomment line below to increase logging level for SharePoint APIsa #com.google.enterprise.cloudsearch.sharepoint.level=FINE # uncomment line below to increase logging level to enable API trace #com.google.api.client.http.level = FINE java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log java.util.logging.FileHandler.limit=10485760 java.util.logging.FileHandler.count=10 java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
الخطوة 5: ضبط موصّل الهوية في SharePoint On-Prem
هذه الخطوة مطلوبة لتطبيق قوائم التحكّم بالوصول المستندة إلى الهوية في SharePoint On-Prem على نتائج البحث. إذا أعددت أداة الربط باستخدام قوائم التحكّم بالوصول (ACL) العامة، يمكنك تخطّي هذه الخطوة.
في الدليل نفسه الذي تم فيه تثبيت أداة ربط SharePoint Online، أنشئ ملفًا وسمِّه
sharepoint-onprem-identity-connector.config
.أضِف المَعلمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:
### SharePoint On-prem identity connector configuration ### # Required parameters for data source access api.customerId=C05d3djk8 api.serviceAccountPrivateKeyFile=service_account.json api.identitySourceId=08ef8becd116faa475de26d9b291fed9 # Required parameters for SharePoint access sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection sharepoint.siteCollectionOnly=true sharepoint.username=contoso\\admin sharepoint.password=pa$sw0rd sharepoint.stripDomainInUserPrincipals=true # Required parameters for AD lookup adLookup.host=dc.contoso.com adLookup.username=contoso\\admin adLookup.password=pa$sw0rd api.referenceIdentitySources=CONTOSO,contoso api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
تتشابه القيم مع تلك الخاصة بموصل SharePoint On-Prem، باستثناء أنّه بدلاً من
api.sourceId
، تكون المَعلمةapi.customerId
. قيمةapi.customerId
هي رقم تعريف العميل الذي حصلت عليه من مشرف Google Workspace.
الخطوة السادسة. تشغيل موصّل SharePoint On-Prem
في الخطوات التالية، يمكنك ربط الجهات الرئيسية في كل من Active Directory المحلي ومجموعة المواقع الإلكترونية على SharePoint بالهويات في خدمة Cloud Identity. تتم هذه المزامنة باستخدام أداة Google Cloud Directory Sync (GCDS) وSharePoint On-Prem identity connector.
بعد أن تعمل "أداة مزامنة دليل Google Cloud" على مزامنة المستخدمين والمجموعات، شغِّل أداة ربط الهوية في SharePoint On-Prem لمزامنة مجموعات مجموعات المواقع الإلكترونية في SharePoint. أخيرًا، شغِّل موصل SharePoing On-Prem لفهرسة النتائج وعرضها لمستخدمي Cloud Search.
إذا لم يسبق لك إجراء ذلك، اضبط أداة GCDS وشغِّلها. احرص على تفعيل المجموعات التي تم تحديد هويتها.
شغِّل موصّل الهوية في SharePoint On-Prem:
$ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.config
شغِّل موصِّل SharePoint On-Prem. استخدِم بنية الأوامر الخاصة بأمان موقع SharePoint الإلكتروني:
HTTP (لا يلزم توفّر مضيف موثوق به):
$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
HTTPS (إضافة SharePoint كمضيف موثوق به):
$ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
مرجع مَعلمات الإعداد
الوصول إلى مصدر البيانات
الإعداد | المَعلمة |
رقم تعريف مصدر البيانات | api.sourceId=1234567890abcdef
مطلوب. معرّف مصدر بيانات Google Cloud Search الذي أعدّه مشرف Google Workspace |
مسار ملف المفتاح الخاص لحساب الخدمة | api.serviceAccountPrivateKeyFile=PrivateKey.json
مطلوب. مسار ملف مفتاح حساب الخدمة في Google Cloud Search. |
الوصول إلى SharePoint المحلي
الإعداد | المَعلمة |
عنوان URL لخادم SharePoint | sharepoint.server=http://yoursharepoint.example.com/
مطلوب. عنوان URL لخادم SharePoint كاسم مضيف مؤهَّل بالكامل، مثل http://yoursharepoint.example.com/. إذا لم يكن اسم المضيف مؤهَّلاً بالكامل، يجب ضبط خيار تجاهل نظام أسماء النطاقات على مضيف الموصل. |
اسم مستخدم SharePoint | sharepoint.username=YOURDOMAIN\\ConnectorUser
يجب توفير هذه المعلومات عند تشغيل الموصل على نظام التشغيل Linux أو على جهاز Windows غير تابع لنطاق Active Directory الخاص بخادم SharePoint. |
كلمة مرور SharePoint | sharepoint.password=user_password
يجب توفير هذه المعلومات عند تشغيل الموصل على نظام التشغيل Linux أو على جهاز Windows غير تابع لنطاق Active Directory الخاص بخادم SharePoint. |
استخدام ميزة "المصادقة المباشرة" للربط بـ SharePoint | sharepoint.username=AdaptorUser Live Authentication Id
|
استخدام مصادقة ADFS للربط بـ SharePoint | sharepoint.username=AdaptorUser@yourdomain.com
|
فهرسة مجموعة المواقع الإلكترونية
الإعداد | المَعلمة |
نوع الفهرس | sharepoint.siteCollectionOnly=boolean
اختياري، باستثناء عمليات نشر SharePoint المتعددة المستأجرين (مزيد من المعلومات) اضبط القيمة على "صحيح" ليكون فهرس الموصل |
تحديد الهوية في SharePoint
الإعداد | المَعلمة |
رقم تعريف مصدر الهوية | api.identitySourceId=1234567890abcdef
مطلوب. معرّف مصدر الهوية لمزامنة "مجموعات SharePoint المحلية"، وهو معرّف مصدر Google Cloud Search الذي أعدّه مشرف Google Workspace، كما هو موضّح في مقالة إضافة مصدر بيانات للبحث |
مصادر الهوية المرجعية | api.referenceIdentitySources=CONTOSO,contoso
قائمة مفصولة بفواصل لمصادر هوية المرجع الخاصة بكيانات Active Directory تتطابق القيمة مع اسم NETBIOS في Active Directory لكيانات Active Directory المرجعية. |
أرقام تعريف مصادر الهوية المرجعية | api.referenceIdentitySource.DOMAIN.id=identity-source-id
مطلوب. معرّف مصدر الهوية لمزامنة عناصر Active Directory الأساسية. |
البحث في Active Directory
الإعداد | المَعلمة |
مضيف Active Directory | adLookup.host=host
مطلوب. اسم مضيف Active Directory، مثل dc.contoso.com، أو عنوان IP |
منفذ البحث في Active Directory | adLookup.port=port
اختياريّ. القيمة التلقائية هي 389. استخدِم الرقم 686 لبروتوكول SSL. |
طريقة البحث في Active Directory | adLookup.method=value
اختياريّ. القيمة التلقائية هي `standard`. بالنسبة إلى اتصالات HTTPS، اضبط القيمة على `ssl`. |
مستخدم البحث في Active Directory | adLookup.username=CONTOSO\user1
مطلوب. المستخدم لديه الإذن بإجراء عمليات بحث في Active Directory. |
كلمة مرور البحث في Active Directory | adLookup.password=password123
مطلوب. كلمة المرور الخاصة بالمستخدم المحدّد من خلال |
إنشاء محتوى HTML
الإعداد | المَعلمة |
حقل عنوان نموذج HTML | contentTemplate.sharePointItem.title=Title
حقل SharePoint الذي سيتم استخدامه كعنوان لنموذج HTML لرمز HTML الذي تم إنشاؤه. |
حقول الجودة العالية للبحث في محتوى HTML | contentTemplate.sharePointItem.quality.high=highField1[,highField2,...]
قائمة مفصولة بفواصل للحقول المطلوب تضمينها في رمز HTML الذي تم إنشاؤه كحقول عالية الجودة عندما تتطابق عبارات طلب البحث مع هذه الحقول، يتم ترتيب النتائج في صفوف أعلى. |
حقول جودة البحث المتوسطة لمحتوى HTML | contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...]
قائمة مفصولة بفواصل للحقول المطلوب تضمينها في رمز HTML الذي تم إنشاؤه كحقول بجودة متوسطة |
حقول جودة البحث المنخفضة في محتوى HTML | contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...]
قائمة مفصولة بفواصل للحقول التي سيتم تضمينها في رمز HTML الذي تم إنشاؤه كحقول منخفضة الجودة |
أعمدة محتوى HTML غير مرتبطة | contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
كيفية تعامل الموصّل مع الأعمدة غير المطابَقة القيمة هي APPEND (تلقائية) أو IGNORE.
|