يمكنك إعداد Google Cloud Search لعرض نتائج من محتوى SharePoint على موقع مؤسستك الإلكتروني بالإضافة إلى محتوى Google Workspace. يمكنك استخدام موصِّل Google Cloud Search لإصدار SharePoint على الأجهزة الداخلية وضبطه للوصول إلى مصدر بيانات معيّن في SharePoint.
اعتبارات مهمة
إعدادات SharePoint المُحترمة
يراعي موصّل Cloud Search لإصدار SharePoint على الموقع دائمًا إعداد Search Visibility في SharePoint، ولا يمكن إلغاء هذا الإعداد. بالنسبة إلى مسودات المستندات، تتحكّم الأذونات في حساب المستخدم (التي يستخدمها الموصّل للوصول إلى SharePoint Online) في مسودات المستندات التي يتم فهرستها وإعادتها. إذا كان الحساب يتضمّن أذونات "القراءة الكاملة" فقط، سيلتزم الموصّل بإعدادات "Draft visibility of item" (مستوى رؤية العنصر) على SharePoint.
يمكنك أيضًا ضبط الموصّل للحدّ من النتائج استنادًا إلى إذن الوصول إلى حساب المستخدم. يمكنك استخدام عناصر Google الأساسية وعناصر خارجية أساسية لتحديد قوائم أذونات الوصول. لتطبيق ميزة "القطع وفقًا لمستوى الأمان" على محتوى SharePoint، يجب مزامنة الهويات الخارجية التالية مع "دليل Google":
- مستخدمو Active Directory
- مجموعات Active Directory
- المجموعات المحلية في SharePoint (التي تتضمّن مستخدمي ومجموعات Active Directory كأعضاء)
لمزامنة مستخدمي ومجموعات Active Directory، يمكنك استخدام أداة مزامنة دليل Google Cloud، ما يتيح المجموعات المرتبطة بهوية. لمزامنة المجموعات المحلية في SharePoint، يمكنك استخدام "موصِّل هوية SharePoint".
يجب أن يُجري الموصِّل أيضًا عملية بحث باستخدام Active Directory للحصول على معلومات إضافية لمزامنة العناصر الرئيسية. على سبيل المثال، تتيح عملية البحث باستخدام 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: ثبِّت برنامج موصل SharePoint On-Prem في Google Cloud Search.
استنسِخ مستودع الموصِّل من 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 على الموقع
في الدليل نفسه الذي تم فيه تثبيت الموصِّل، أنشِئ ملفًا. تنصح 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
الخطوة الخامسة. ضبط موصّل الهوية في 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 على الموقع، باستثناء أنّ المَعلمة هي
api.customerId
بدلاً منapi.sourceId
. قيمةapi.customerId
هي رقم تعريف العميل الذي حصلت عليه من مشرف Google Workspace.
الخطوة السادسة. تشغيل موصّل SharePoint داخل المؤسسة
في الخطوات التالية، يمكنك ربط المستخدمين الأساسيين في كلّ من Active Directory على الموقع الإلكتروني ومجموعة مواقع SharePoint بـ هويات في خدمة Cloud Identity. تتم هذه المزامنة باستخدام أداة "مزامنة دليل Google Cloud" (GCDS) ورابط الهوية في SharePoint On-Prem.
بعد أن تُجري أداة "مزامنة دليل 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 داخل المؤسسة. استخدِم بنية الأمر لأمان موقع 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 متعددة المستأجرين (مزيد من المعلومات). اضبط هذا الخيار على true ليكون فهرس الموصّل |
تحديد الهوية في 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.
|