Microsoft SharePoint On-premises कनेक्टर डिप्लॉय करना

Google Cloud Search को इस तरह सेट अप किया जा सकता है कि वह Google Workspace के कॉन्टेंट के अलावा, आपके संगठन के SharePoint के कंपनी की इमारत में मौजूद कॉन्टेंट से भी नतीजे दिखाए. Cloud Search के SharePoint ऑन-प्रिमाइसेस कनेक्टर का इस्तेमाल करें और इसे SharePoint के किसी खास डेटा सोर्स को ऐक्सेस करने के लिए कॉन्फ़िगर करें.

विचार करने वाली ज़रूरी बातें

SharePoint ऑन-प्रिमाइसेस कनेक्टर को डिप्लॉय करने से पहले, इन बातों का ध्यान रखें.

SharePoint की सेटिंग

कनेक्टर, SharePoint पर खोज में दिखने की सेटिंग का हमेशा पालन करता है. ड्राफ़्ट किए गए दस्तावेज़ों के लिए, SharePoint को ऐक्सेस करने के लिए कनेक्टर जिस उपयोगकर्ता खाते का इस्तेमाल करता है उसकी अनुमतियों से यह तय होता है कि कनेक्टर किन दस्तावेज़ों को इंडेक्स करेगा और किन दस्तावेज़ों को नतीजे के तौर पर दिखाएगा. अगर खाते में "पूरी तरह पढ़ने" की अनुमतियां हैं, तो कनेक्टर "ड्राफ़्ट किए गए आइटम की दिखने की सेटिंग" का पालन करता है.

एसीएल तय करने के लिए, Google और बाहरी प्रिंसिपल का इस्तेमाल करके, उपयोगकर्ता खाते के ऐक्सेस के आधार पर नतीजों को सीमित भी किया जा सकता है. सुरक्षा के लिए, इन बाहरी आइडेंटिटी को Google Cloud Directory के साथ सिंक करें:

  • Active Directory के उपयोगकर्ता और ग्रुप.
  • SharePoint के लोकल ग्रुप (जिनमें Active Directory के उपयोगकर्ता और ग्रुप सदस्य के तौर पर शामिल हैं).

AD के उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए, Google Cloud Directory Sync का इस्तेमाल करें और आइडेंटिटी मैप किए गए ग्रुप की सुविधा चालू करें. SharePoint के लोकल ग्रुप के लिए, SharePoint आइडेंटिटी कनेक्टर का इस्तेमाल करें.

प्रिंसिपल को सिंक करने के लिए, कनेक्टर Active Directory में लुकअप भी करता है. जैसे, एसआईडी को sAMAccountNames पर मैप करना.

खोज के लिए ऑप्टिमाइज़ेशन

कनेक्टर को काम के नतीजे दिखाने के लिए कॉन्फ़िगर करके, खोज के अनुभव को बेहतर बनाएं. फ़ील्ड के असर के लेवल सेट करने के लिए, कॉन्फ़िगरेशन फ़ाइल में एचटीएमएल जनरेट करने वाले पैरामीटर का इस्तेमाल करें.

स्कीमा सेट अप करने के लिए, स्कीमा बनाना और रजिस्टर करना लेख पढ़ें. स्कीमा सेट अप करते समय:

  • कनेक्टर, SharePoint के कॉन्टेंट टाइप को मान्य ऑब्जेक्ट की परिभाषा के नामों (A-Z, a-z, 0-9) में बदलता है. उदाहरण के लिए, "News Article" को "NewsArticle" में बदल दिया जाता है.
  • अगर कनेक्टर, ऑब्जेक्ट की परिभाषा से मेल नहीं खा पाता है, तो वह फ़ॉलबैक ऑब्जेक्ट टाइप (itemMetadata.objectType) का इस्तेमाल करता है. मेटाडेटा कॉन्फ़िगरेशन पैरामीटर देखें.
  • कनेक्टर, हेक्स वर्णों को डिकोड करके और "ows_" प्रीफ़िक्स हटाकर, प्रॉपर्टी के नामों को सामान्य बनाता है.

Microsoft Outlook के मैसेज मैनेज करना

कनेक्टर, Microsoft Outlook की .msg फ़ाइलों के मीडिया टाइप को बदलता है और उन्हें application/vnd.ms-outlook के तौर पर इंडेक्स करता है.

मल्टी-टेनेंट कॉन्फ़िगरेशन

मल्टी-टेनेंट डिप्लॉयमेंट के लिए, साइट कलेक्शन मोड कॉन्फ़िगर करें:

  • कनेक्टर खाते को साइट कलेक्शन एडमिन की अनुमतियां दें.
  • sharepoint.server को साइट कलेक्शन यूआरएल पर सेट करें. जैसे, http://sharepoint.example.com/sites/collection.
  • sharepoint.siteCollectionOnly को true पर सेट करें.

हर साइट कलेक्शन के लिए, कनेक्टर का एक इंस्टेंस कॉन्फ़िगर करें.

सीमाएं

  • मॉनिटर किए जा रहे डेटाबेस की संख्या बढ़ने पर, बदलावों का पता लगाने में ज़्यादा समय लगता है.
  • एसीएल में शामिल खास उपयोगकर्ताओं और ग्रुप की संख्या बढ़ने पर, मेमोरी का इस्तेमाल भी बढ़ जाता है.
  • कनेक्टर, सिर्फ़ एक Active Directory डोमेन की आइडेंटिटी के साथ काम करता है.
  • मिटाने की सूचनाएं लागू होने में चार घंटे से ज़्यादा लग सकते हैं.

सिस्टम की ज़रूरतें

सिस्टम की ज़रूरतें
ऑपरेटिंग सिस्टम Windows Server 2016, Ubuntu, Red Hat Enterprise Linux 5.0 या SUSE Enterprise Linux 10 (64-बिट).
सॉफ़्टवेयर SharePoint Server 2013 या 2016; Java JRE 1.8.
प्रमाणीकरण NTLM, Kerberos, HTTP Basic या ADFS.

कनेक्टर डिप्लॉय करना

SharePoint ऑन-प्रिमाइसेस कनेक्टर को डिप्लॉय करने के लिए, यह तरीका अपनाएं.

ज़रूरी शर्तें

  1. Google Workspace की निजी कुंजी बनाएं. Cloud Search API को ऐक्सेस करने की सुविधा कॉन्फ़िगर करना लेख पढ़ें.
  2. खोज के लिए कोई डेटा सोर्स जोड़ें और उसका आईडी रिकॉर्ड करें. खोज के लिए डेटा सोर्स जोड़ना लेख पढ़ें .
  3. एसीएल के आधार पर नतीजे दिखाने के लिए, आपके एडमिन को दो आइडेंटिटी सोर्स बनाने होंगे. इनमें से एक Active Directory के लिए और दूसरा SharePoint के लोकल ग्रुप के लिए होगा. साथ ही, उन्हें Google Workspace का ग्राहक आईडी देना होगा. उपयोगकर्ता की आइडेंटिटी मैप करना लेख पढ़ें .
  4. कनेक्टर के लिए, पूरी तरह पढ़ने की अनुमतियों वाला उपयोगकर्ता खाता सेट अप करें.
  5. पक्का करें कि SharePoint वेब ऐप्लिकेशन में रूट साइट कलेक्शन हो.
  6. अगर साइट कलेक्शन, राइट-लॉक हैं, तो PrepareWriteLockedSites.ps1 स्क्रिप्ट चलाएं.

पहला चरण. कनेक्टर सॉफ़्टवेयर इंस्टॉल करना

  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. ZIP फ़ाइल को अपनी इंस्टॉलेशन डायरेक्ट्री में एक्सट्रैक्ट करें.

दूसरा चरण. कॉन्फ़िगरेशन फ़ाइल बनाना

इंस्टॉलेशन डायरेक्ट्री में 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

ज़्यादा जानकारी के लिए, रेफ़रंस या Google की ओर से दिए गए पैरामीटर देखें.

तीसरा चरण. SharePoint को भरोसेमंद होस्ट के तौर पर जोड़ना (एचटीटीपीएस)

अगर एचटीटीपीएस का इस्तेमाल किया जा रहा है, तो SharePoint का सर्टिफ़िकेट एक्सपोर्ट करें और इसे कनेक्टर के कीस्टोर में इंपोर्ट करें:

$ 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

पांचवां चरण. आइडेंटिटी कनेक्टर कॉन्फ़िगर करना

आइडेंटिटी के आधार पर एसीएल लागू करने के लिए, api.customerId और कनेक्शन के अन्य पैरामीटर के साथ sharepoint-onprem-identity-connector.config बनाएं.

छठा चरण. कनेक्टर लॉन्च करना

  1. Active Directory के उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए, GCDS चलाएं.
  2. साइट कलेक्शन ग्रुप को सिंक करने के लिए, SharePoint आइडेंटिटी कनेक्टर चलाएं.
  3. कॉन्टेंट को इंडेक्स करने के लिए, SharePoint कंपनी की इमारत में कनेक्टर चलाएं.

कॉन्फ़िगरेशन पैरामीटर का रेफ़रंस

यहां SharePoint ऑन-प्रिमाइसेस कनेक्टर को कॉन्फ़िगर करने के लिए इस्तेमाल किए जाने वाले कॉन्फ़िगरेशन पैरामीटर की सूची दी गई है.

डेटा स्रोत की ऐक्सेस

सेटिंग पैरामीटर
डेटा सोर्स का आईडी api.sourceId=ID
सेवा खाता api.serviceAccountPrivateKeyFile=path

SharePoint कंपनी की इमारत में ऐक्सेस

सेटिंग पैरामीटर
सर्वर यूआरएल sharepoint.server=URL
क्रेडेंशियल sharepoint.username और sharepoint.password

एचटीएमएल कॉन्टेंट जनरेट करना

सेटिंग पैरामीटर
टाइटल फ़ील्ड contentTemplate.sharePointItem.title=Title
क्वालिटी फ़ील्ड contentTemplate.sharePointItem.quality.high, medium या low