اتصال دهنده Microsoft SharePoint On-premises را مستقر کنید

شما می‌توانید Google Cloud Search را طوری تنظیم کنید که علاوه بر محتوای Google Workspace، نتایج محتوای SharePoint داخلی سازمان شما را نیز برگرداند. از رابط Cloud Search SharePoint داخلی استفاده کنید و آن را برای دسترسی به یک منبع داده SharePoint خاص پیکربندی کنید.

ملاحظات مهم

قبل از استقرار کانکتور SharePoint On-premises، به نکات زیر توجه داشته باشید.

تنظیمات SharePoint ارجمند

رابط همیشه تنظیمات قابلیت مشاهده جستجو در SharePoint را رعایت می‌کند. برای اسناد پیش‌نویس، مجوزهای حساب کاربری که رابط برای دسترسی به کنترل SharePoint که اسناد را فهرست‌بندی و برمی‌گرداند، استفاده می‌کند. اگر حساب دارای مجوزهای "خواندن کامل" باشد، رابط تنظیمات "قابلیت مشاهده آیتم پیش‌نویس" را رعایت می‌کند.

همچنین می‌توانید نتایج را بر اساس دسترسی حساب کاربری با استفاده از گوگل و مدیران خارجی برای تعریف ACLها محدود کنید. برای اعمال تنظیمات امنیتی، این هویت‌های خارجی را با Google Cloud Directory همگام‌سازی کنید:

  • کاربران و گروه‌های اکتیو دایرکتوری
  • گروه‌های محلی SharePoint (با کاربران و گروه‌های Active Directory به عنوان عضو).

برای همگام‌سازی کاربران و گروه‌های AD، از Google Cloud Directory Sync استفاده کنید و گروه‌های نگاشت‌شده با هویت را فعال کنید. برای گروه‌های محلی SharePoint، از کانکتور هویت SharePoint استفاده کنید.

این کانکتور همچنین جستجوهای Active Directory را برای دریافت اطلاعات جهت همگام‌سازی Principalها، مانند نگاشت SIDها به sAMAccountNames، انجام می‌دهد.

بهینه‌سازی جستجو

با پیکربندی رابط برای بازگرداندن نتایج مرتبط، تجربه جستجو را بهبود بخشید. از پارامترهای تولید HTML در فایل پیکربندی برای تنظیم سطوح تأثیر فیلد استفاده کنید.

برای تنظیم یک طرحواره، به بخش ایجاد و ثبت طرحواره مراجعه کنید. هنگام تنظیم یک طرحواره:

  • این رابط، انواع محتوای SharePoint را به نام‌های تعریف شیء معتبر (AZ، az، 0-9) نرمال‌سازی می‌کند. برای مثال، "News Article" به "NewsArticle" تبدیل می‌شود.
  • اگر کانکتور نتواند با تعریف یک شیء مطابقت داشته باشد، از نوع شیء جایگزین ( itemMetadata.objectType ) استفاده می‌کند. به پارامترهای پیکربندی Metadata مراجعه کنید.
  • این کانکتور با رمزگشایی کاراکترهای هگز و حذف پیشوندهای "ows_" نام ویژگی‌ها را نرمال‌سازی می‌کند.

مدیریت پیام‌های مایکروسافت اوت‌لوک

این رابط، نوع رسانه را برای فایل‌های .msg مایکروسافت اوت‌لوک نادیده می‌گیرد و آن‌ها را به صورت application/vnd.ms-outlook فهرست‌بندی می‌کند.

پیکربندی‌های چند مستاجری

برای استقرارهای چند مستاجری، حالت مجموعه سایت را پیکربندی کنید:

  • به حساب کاربری متصل‌کننده در مجموعه سایت، مجوزهای مدیریتی بدهید.
  • sharepoint.server روی آدرس مجموعه سایت (مثلاً http://sharepoint.example.com/sites/collection ) تنظیم کنید.
  • مقدار sharepoint.siteCollectionOnly را روی true تنظیم کنید.

برای هر مجموعه سایت، یک نمونه کانکتور پیکربندی کنید.

محدودیت‌های شناخته‌شده

  • زمان تشخیص تغییرات با افزایش تعداد پایگاه‌های داده تحت نظارت افزایش می‌یابد.
  • استفاده از حافظه با افزایش تعداد کاربران و گروه‌های منحصر به فرد در ACLها افزایش می‌یابد.
  • این کانکتور فقط از هویت‌های یک دامنه‌ی اکتیو دایرکتوری پشتیبانی می‌کند.
  • انتشار اعلان‌های حذف می‌تواند بیش از چهار ساعت طول بکشد.

الزامات سیستم

الزامات سیستم
سیستم عامل ویندوز سرور ۲۰۱۶، اوبونتو، رد هت انترپرایز لینوکس ۵.۰ یا سوزه انترپرایز لینوکس ۱۰ (۶۴ بیتی).
نرم‌افزار شیرپوینت سرور ۲۰۱۳ یا ۲۰۱۶؛ جاوا JRE 1.8.
احراز هویت NTLM، Kerberos، HTTP Basic یا ADFS.

کانکتور را مستقر کنید

برای استقرار کانکتور SharePoint On-premises، این مراحل را دنبال کنید.

پیش‌نیازها

  1. یک کلید خصوصی Google Workspace ایجاد کنید. به پیکربندی دسترسی به Cloud Search API مراجعه کنید.
  2. یک منبع داده برای جستجو اضافه کنید و شناسه آن را ثبت کنید. به بخش «افزودن یک منبع داده برای جستجو» مراجعه کنید.
  3. برای نتایج مبتنی بر ACL، مدیر سیستم شما باید دو منبع هویت (یکی برای Active Directory و یکی برای گروه‌های محلی SharePoint) ایجاد کند و شناسه مشتری Google Workspace را ارائه دهد. به Map user identity مراجعه کنید.
  4. یک حساب کاربری برای رابط با مجوزهای خواندن کامل تنظیم کنید.
  5. مطمئن شوید که برنامه وب SharePoint دارای یک مجموعه سایت ریشه (root site collection) است.
  6. اگر مجموعه‌های سایت قفل نوشتنی دارند، اسکریپت PrepareWriteLockedSites.ps1 را اجرا کنید.

مرحله 1. نرم‌افزار کانکتور را نصب کنید

  1. مخزن را کلون کنید: 
    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
$ cd sharepoint-connector
  2. نسخه انتخاب شده را بررسی کنید (مثلاً v1-0.0.5 ): 
    $ git checkout tags/v1-0.0.5
  3. کانکتور را بسازید:
    $ mvn package
     برای رد کردن تست‌ها، از mvn package -DskipTests استفاده کنید.
  4. فایل زیپ را در پوشه نصب خود استخراج کنید.

مرحله ۲. ایجاد فایل پیکربندی

connector-config.properties در پوشه نصب ایجاد کنید. پارامترها را به صورت جفت‌های کلید-مقدار اضافه کنید:

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
sharepoint.server=http://sp-2016:32967/sites/collection
sharepoint.siteCollectionOnly=true
sharepoint.username=contoso\\admin
sharepoint.password=password
adLookup.host=dc.contoso.com
adLookup.username=contoso\\admin
adLookup.password=password

برای جزئیات بیشتر به مرجع یا پارامترهای ارائه شده توسط گوگل مراجعه کنید.

مرحله ۳. اضافه کردن SharePoint به عنوان یک میزبان قابل اعتماد (HTTPS)

اگر از HTTPS استفاده می‌کنید، گواهی SharePoint را export کرده و آن را در keystore کانکتور import کنید:

$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

مرحله ۴. تنظیم گزارش‌گیری

یک پوشه‌ی logs و یک فایل logging.properties با این محتوا ایجاد کنید: properties handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler .level = INFO java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log

مرحله ۵. پیکربندی رابط هویت

برای اعمال ACL های مبتنی بر هویت، sharepoint-onprem-identity-connector.config را با api.customerId و سایر پارامترهای اتصال خود ایجاد کنید.

مرحله ۶. اتصال را راه‌اندازی کنید

  1. برای همگام‌سازی کاربران و گروه‌های Active Directory، GCDS را اجرا کنید.
  2. برای همگام‌سازی گروه‌های مجموعه سایت، رابط هویت SharePoint را اجرا کنید.
  3. برای فهرست‌بندی محتوا، رابط SharePoint On-premises را اجرا کنید.

مرجع پارامترهای پیکربندی

بخش‌های زیر پارامترهای پیکربندی مورد استفاده برای پیکربندی رابط SharePoint On-premises را فهرست می‌کنند.

دسترسی به منبع داده

تنظیم پارامتر
شناسه منبع داده api.sourceId= ID
حساب کاربری خدمات api.serviceAccountPrivateKeyFile= path

دسترسی در محل SharePoint

تنظیم پارامتر
آدرس سرور sharepoint.server= URL
مدارک تحصیلی sharepoint.username و sharepoint.password

تولید محتوای HTML

تنظیم پارامتر
فیلد عنوان contentTemplate.sharePointItem.title= Title
زمینه‌های کیفیت contentTemplate.sharePointItem.quality.high ، medium یا low