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

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

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

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

SharePoint की सेटिंग का पालन किया जाता है

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

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

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

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

कनेक्टर, Active Directory लुकअप भी करता है. इससे प्रिंसिपल को सिंक करने के लिए जानकारी मिलती है. जैसे, SID को sAMAccountName से मैप करना.

खोज को ऑप्टिमाइज़ करना

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

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

• कनेक्टर, 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 डोमेन की पहचानों के साथ काम करता है.
• सूचनाएं मिटाने में चार घंटे से ज़्यादा समय लग सकता है.

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

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

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

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

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

चरण 4. लॉगिंग की सुविधा सेट अप करना

इस कॉन्टेंट के साथ 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

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

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

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

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

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

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

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

SharePoint on-premises का ऐक्सेस

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