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

चेतावनी: Cloud Search के रेफ़रंस कनेक्टर, सैंपल कोड के तौर पर "जैसे हैं वैसे ही" दिए जाते हैं. इनका इस्तेमाल, काम करने वाले कनेक्टर बनाने के लिए किया जाता है. इस सैंपल कोड को कॉन्सेप्ट की पुष्टि करने या प्रोडक्शन एनवायरमेंट में इस्तेमाल करने से पहले, ज़रूरत के मुताबिक बनाने और टेस्ट करने की ज़रूरत होती है. प्रोडक्शन में इस्तेमाल करने के लिए, हमारा सुझाव है कि आप Cloud Search के किसी पार्टनर से मदद लें. Cloud Search के लिए सही पार्टनर ढूंढने में और मदद पाने के लिए, अपने Google खाता मैनेजर से संपर्क करें.

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

ज़रूरी बातें

SharePoint की सेटिंग

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

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

• Active Directory उपयोगकर्ता
• Active Directory ग्रुप
• SharePoint के लोकल ग्रुप (सदस्यों के तौर पर Active Directory के उपयोगकर्ता और ग्रुप)

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

प्रिंसिपल को सिंक करने के लिए ज़्यादा जानकारी पाने के लिए, कनेक्टर को AD के साथ लुकअप भी करना होगा. उदाहरण के लिए, AD के साथ लुकअप की मदद से कनेक्टर ये काम कर सकता है:

• किसी डोमेन ग्रुप के एसआईडी को उससे जुड़े sAMAccountName से मैप करें.
• SharePoint के स्थानीय ग्रुप की सदस्यताओं के लिए, उपयोगकर्ता के sAMAccountName को ईमेल पते से मैप करें.

ध्यान दें: इस कनेक्टर से मिलने वाले सभी नतीजों को सार्वजनिक (आपके डोमेन में मौजूद किसी भी व्यक्ति के लिए उपलब्ध) किया जा सकता है. ऐसा करने के लिए, SharePoint के ऑन-प्रीम कनेक्टर की कॉन्फ़िगरेशन फ़ाइल में ये पैरामीटर डालें:

defaultAcl.mode=override
defaultAcl.public=true

सार्वजनिक नतीजे सेट अप करने पर, आपको आइडेंटिटी कनेक्टर सेट अप करने की ज़रूरत नहीं होती.

सर्च ऑप्टिमाइज़ेशन

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

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

स्कीमा सेट अप करने के लिए, स्कीमा बनाएं और रजिस्टर करें में दिए गए निर्देशों का पालन करें. स्कीमा सेट अप करने पर:

• SharePoint कॉन्टेंट टाइप के नामों को उनसे जुड़ी ऑब्जेक्ट परिभाषाओं से मैप करने के लिए, कनेक्टर कॉन्टेंट टाइप के नामों को सामान्य बनाता है. ऐसा करने के लिए, वह उन वर्णों को हटा देता है जो इस्तेमाल नहीं किए जा सकते. ऑब्जेक्ट की परिभाषाओं के लिए, Cloud Search API सिर्फ़ A-Z, a-z, और 0-9 को मान्य वर्ण के तौर पर इस्तेमाल करता है. उदाहरण के लिए, कॉन्टेंट टाइप "सूचनाएं", ऑब्जेक्ट की परिभाषा "सूचनाएं" से मैप होता है. कॉन्टेंट टाइप "News Article", "NewsArticle" (बिना स्पेस) पर मैप होता है.

• जब कनेक्टर किसी ऑब्जेक्ट की परिभाषा को किसी ऑब्जेक्ट की परिभाषा से मैच नहीं कर पाता, तो कनेक्टर फ़ॉलबैक ऑब्जेक्ट टाइप (itemMetadata.objectType) का इस्तेमाल करता है. मेटाडेटा कॉन्फ़िगरेशन पैरामीटर के बारे में ज़्यादा जानें.

• SharePoint प्रॉपर्टी के नामों को प्रॉपर्टी की परिभाषाओं से मैप करने के लिए, कनेक्टर हेक्स-कोड वाले वर्णों को डिकोड करके और "ows_" प्रीफ़िक्स हटाकर, प्रॉपर्टी के नामों को सामान्य बनाता है. इसके बाद, इस्तेमाल न किए जा सकने वाले वर्णों को हटा देता है. इन वर्णों में A से Z, a से z, और 0 से 9 तक के वर्ण शामिल हैं.

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

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

एक से ज़्यादा किरायेदारों के लिए कॉन्फ़िगरेशन

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

साइट कलेक्शन मोड चालू करने के लिए:

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

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

कनेक्टर की सीमाएं

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

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

सिस्टम की ज़रूरतें
ऑपरेटिंग सिस्टम	Windows Server 2016 Ubuntu Red Hat Enterprise Linux 5.0 SUSE Enterprise Linux 10 (64 बिट)
सॉफ़्टवेयर	SharePoint सर्वर SharePoint Server 2016 SharePoint Server 2013 उस कंप्यूटर पर Java JRE 1.8 इंस्टॉल होना चाहिए जिस पर Google Cloud Search SharePoint का ऑन-प्रीमिस कनेक्टर चलेगा
पुष्टि करना	NTLM Kerberos एचटीटीपी बुनियादी ADFS

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

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

1. Google Workspace की निजी कुंजी बनाएं, जिसमें आपका सेवा खाता आईडी शामिल हो. निजी कुंजी पाने का तरीका जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना पर जाएं.

2. आपके Google Workspace एडमिन को खोज के लिए डेटा सोर्स जोड़ना होगा. डेटा सोर्स का आईडी रिकॉर्ड करें.

3. अगर कनेक्टर, एसीएल के आधार पर नतीजे दिखाता है (नतीजे सार्वजनिक नहीं होते), तो आपके Google Workspace एडमिन को दो आइडेंटिटी सोर्स बनाने होंगे और आपको उनके आईडी देने होंगे:

   • Active Directory के उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए, पहचान का सोर्स.
   • SharePoint के लोकल ग्रुप के लिए आइडेंटिटी सोर्स

   एडमिन को आपके संगठन का Google Workspace ग्राहक आईडी भी लेना होगा और आपको देना होगा.

   Cloud Search में उपयोगकर्ता की पहचानों को मैप करना में, इन वैल्यू को पाने का तरीका जानें.

   ध्यान दें: आपको हर Active Directory डोमेन के लिए, एक आइडेंटिटी सोर्स सेट अप करना होगा. अगर Active Directory को SharePoint इंस्टेंस शेयर करते हैं, तो सभी SharePoint कनेक्टर इंस्टेंस के लिए उस आइडेंटिटी सोर्स का रेफ़रंस दिया जा सकता है.

4. कनेक्टर के लिए उपयोगकर्ता खाता सेट अप करें. यह खाता, उपयोगकर्ता नीति में SharePoint वेब ऐप्लिकेशन के लिए पूरी तरह से पढ़ने की अनुमतियां वाला होना चाहिए.

5. अगर SharePoint वेब ऐप्लिकेशन में कोई रूट साइट कलेक्शन नहीं है, तो एक बनाएं.

6. अगर किसी साइट कलेक्शन पर लिखने की अनुमति नहीं है, तो SharePoint सर्वर में उस खाते से साइन इन करें जिसके पास एडमिन की अनुमतियां हैं. इसके बाद, PrepareWriteLockedSites.ps1 स्क्रिप्ट चलाएं.

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

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

पहला चरण. Google Cloud Search SharePoint On-Prem कनेक्टर सॉफ़्टवेयर इंस्टॉल करें.

1. GitHub से कनेक्टर के डेटा स्टोर करने की जगह को क्लोन करें.

   $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
   $ cd sharepoint-connector

2. कनेक्टर का वह वर्शन देखें जिसका इस्तेमाल करना है:

   $ git checkout tags/latest_version

   जहां: latest_version = कोई वैल्यू, जैसे कि v1-0.0.5

3. कनेक्टर बनाएं.

   $ mvn package

   कनेक्टर बनाते समय जांच को छोड़ने के लिए, mvn package के बजाय mvn package -DskipTests चलाएं.

4. कनेक्टर की 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

दूसरा चरण. SharePoint On-Prem कनेक्टर की कॉन्फ़िगरेशन फ़ाइल बनाना

1. कनेक्टर इंस्टॉल करने वाली डायरेक्ट्री में ही एक फ़ाइल बनाएं. Google का सुझाव है कि आप फ़ाइल को connector-config.properties नाम दें, ताकि कनेक्टर को चलाने के लिए किसी अन्य कमांड-लाइन पैरामीटर की ज़रूरत न पड़े. अगर आपको कई कनेक्टर इंस्टेंस चलाने हैं, तो उन्हें अलग-अलग पहचानने के लिए नाम में जानकारी जोड़ें.

2. फ़ाइल के कॉन्टेंट में पैरामीटर को की/वैल्यू पेयर के तौर पर जोड़ें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

   ### 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
   

   हर पैरामीटर के बारे में ज़्यादा जानकारी के लिए, कॉन्फ़िगरेशन पैरामीटर रेफ़रंस पर जाएं.

3. (ज़रूरी नहीं) ज़रूरत के मुताबिक, कनेक्टर के अन्य पैरामीटर कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, Google के दिए गए कनेक्टर पैरामीटर पर जाएं.

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

अगर SharePoint को एचटीटीपीएस का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो SharePoint का सर्टिफ़िकेट पाएं, ताकि उसे कनेक्टर के लिए भरोसेमंद होस्ट के तौर पर जोड़ा जा सके.

1. जिस कंप्यूटर पर कनेक्टर चलाना है उस पर कोई ब्राउज़र खोलें और SharePoint पर जाएं.

2. चेतावनी वाले पेज पर, मुझे जोखिम समझ आ रहे हैं और अपवाद जोड़ें पर क्लिक करें. पेज पर "यह कनेक्शन भरोसेमंद नहीं है" जैसा मैसेज दिखता है. ऐसा इसलिए होता है, क्योंकि सर्टिफ़िकेट पर खुद का हस्ताक्षर होता है और किसी भरोसेमंद सर्टिफ़िकेट देने वाली संस्था का हस्ताक्षर नहीं होता.

3. देखें बटन उपलब्ध होने पर, उस पर क्लिक करें.

4. जानकारी टैब पर जाएं और एक्सपोर्ट करें पर क्लिक करें.

5. सर्टिफ़िकेट को sharepoint.crt नाम से कनेक्टर डायरेक्ट्री में सेव करें.

6. विंडो बंद करने के लिए, बंद करें पर क्लिक करें. इसके बाद, रद्द करें पर क्लिक करें.

7. कोई कमांड प्रॉम्प्ट खोलें और यह कमांड डालें:

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

   "क्या इस सर्टिफ़िकेट पर भरोसा करें?" के लिए कहा जाए, तो हां में जवाब दें.

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

1. कनेक्टर बाइनरी वाली डायरेक्ट्री में, logs नाम का फ़ोल्डर बनाएं.

2. उसी डायरेक्ट्री (logs नहीं) में, logging.properties नाम की Latin1-कोड वाली फ़ाइल बनाएं.

3. 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 के ऑन-प्रीम आइडेंटिटी कनेक्टर को कॉन्फ़िगर करना

खोज के नतीजों में, SharePoint के ऑन-प्रीमाइज़ वर्शन में पहचान पर आधारित एसीएल लागू करने के लिए, यह चरण ज़रूरी है. अगर आपने कनेक्टर को सार्वजनिक एसीएल के साथ सेट अप किया है, तो इस चरण को छोड़ा जा सकता है.

1. SharePoint Online कनेक्टर इंस्टॉलेशन की डायरेक्ट्री में, एक फ़ाइल बनाएं और उसका नाम sharepoint-onprem-identity-connector.config रखें.

2. फ़ाइल के कॉन्टेंट में पैरामीटर को की/वैल्यू पेयर के तौर पर जोड़ें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

   ### 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.sourceId के बजाय पैरामीटर api.customerId है. api.customerId की वैल्यू, वह ग्राहक आईडी है जो आपको Google Workspace एडमिन से मिला है.

छठा चरण. SharePoint का ऑन-प्रीमिस कनेक्टर लॉन्च करना

यहां दिए गए चरणों में, ऑन-प्राइमिस Active Directory और SharePoint साइट कलेक्शन, दोनों में मौजूद प्रिंसिपल को Cloud Identity सेवा में मौजूद पहचानों से मैप किया जाता है. यह सिंक, Google Cloud डायरेक्ट्री सिंक (GCDS) और SharePoint के ऑन-प्रीमाइज़ आइडेंटिटी कनेक्टर की मदद से किया जाता है.

GCDS के उपयोगकर्ताओं और ग्रुप को सिंक करने के बाद, SharePoint साइट कलेक्शन के ग्रुप को सिंक करने के लिए, SharePoint का ऑन-प्रॉपर्टी आइडेंटिटी कनेक्टर चलाएं. आखिर में, अपने Cloud Search उपयोगकर्ताओं को नतीजे दिखाने और उन्हें इंडेक्स करने के लिए, SharePoing का ऑन-प्रीम कनेक्टर चलाएं.

1. अगर आपने अब तक ऐसा नहीं किया है, तो GCDS को कॉन्फ़िगर और चलाएं. ऐसे ग्रुप जिनकी पहचान को मैप किया गया है उन्हें चालू करना न भूलें.

2. SharePoint के ऑन-प्रीम आइडेंटिटी कनेक्टर को चलाएं:

   $ 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

3. SharePoint का ऑन-प्रीम कनेक्टर चलाएं. अपनी SharePoint साइट की सुरक्षा के लिए, कमांड सिंटैक्स का इस्तेमाल करें:

   • एचटीटीपी (भरोसेमंद होस्ट की ज़रूरत नहीं है):

     $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar

   • एचटीटीपीएस (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 Workspace एडमिन ने Google Cloud Search का जो डेटा सोर्स आईडी सेट अप किया है.
सेवा खाते की निजी कुंजी फ़ाइल का पाथ	api.serviceAccountPrivateKeyFile=PrivateKey.json ज़रूरी है. Google Cloud Search के सेवा खाते की कुंजी फ़ाइल का पाथ.

SharePoint के ऑन-प्राइमिस वर्शन का ऐक्सेस

सेटिंग	पैरामीटर
SharePoint सर्वर का यूआरएल	sharepoint.server=http://yoursharepoint.example.com/ ज़रूरी है. SharePoint सर्वर का यूआरएल, पूरी तरह से सही होस्ट नेम के तौर पर. जैसे, http://yoursharepoint.example.com/. अगर होस्ट नेम पूरी तरह से सही नहीं है, तो आपको कनेक्टर होस्ट पर डीएनएस बदलाव सेट करना होगा.
SharePoint का उपयोगकर्ता नाम	sharepoint.username=YOURDOMAIN\\ConnectorUser यह तब ज़रूरी होता है, जब कनेक्टर को Linux या किसी ऐसे Windows मशीन पर चलाया जाता है जो SharePoint Server के AD डोमेन का हिस्सा नहीं है.
SharePoint का पासवर्ड	sharepoint.password=user_password यह तब ज़रूरी होता है, जब कनेक्टर को Linux या किसी ऐसे Windows मशीन पर चलाया जाता है जो SharePoint Server के AD डोमेन का हिस्सा नहीं है.
SharePoint से कनेक्ट करने के लिए, लाइव पुष्टि करने की सुविधा का इस्तेमाल करना	sharepoint.username=AdaptorUser Live Authentication Id sharepoint.password uS3R_passWoRD sharepoint.formsAuthenticationMode=LIVE
SharePoint से कनेक्ट करने के लिए, ADFS ऑथेंटिकेशन का इस्तेमाल करना	sharepoint.username=[e-mail] sharepoint.password=uS3R_passWoRD sharepoint.sts.endpoint=https://adfs.example.com/adfs/services/trust/2005/usernamemixed sharepoint.sts.realm=urn:myserver:sharepoint या https://yoursharepoint.example.com/_trust sharepoint.formsAuthenticationMode=ADFS

साइट कलेक्शन को इंडेक्स करना

सेटिंग	पैरामीटर
इंडेक्स टाइप	sharepoint.siteCollectionOnly=boolean मल्टी-टेंटेंट SharePoint डिप्लॉयमेंट के अलावा, यह विकल्प ज़रूरी नहीं है (ज़्यादा जानें). कनेक्टर इंडेक्स sharepoint.server को वर्चुअल सर्वर के बजाय साइट कलेक्शन के तौर पर सेट करने के लिए, इसे 'सही' पर सेट करें. डिफ़ॉल्ट रूप से, यह वैल्यू शून्य होती है. इसका पता अपने-आप चल जाता है.

SharePoint में पहचान की मैपिंग

सेटिंग	पैरामीटर
पहचान सोर्स आईडी	api.identitySourceId=1234567890abcdef ज़रूरी है. SharePoint के लोकल ग्रुप सिंक करने के लिए, आइडेंटिटी सोर्स आईडी. यह Google Cloud Search का सोर्स आईडी होता है, जिसे Google Workspace एडमिन सेट अप करता है. इस बारे में खोज के लिए डेटा सोर्स जोड़ना में बताया गया है.
पहचान के सोर्स के रेफ़रंस	api.referenceIdentitySources=CONTOSO,contoso Active Directory प्रिंसिपल के लिए, रेफ़रंस आइडेंटिटी सोर्स की कॉमा लगाकर अलग की गई सूची. यह वैल्यू, रेफ़रंस Active Directory प्रिंसिपल के Active Directory NETBIOS नाम से मेल खाती है.
पहचान के सोर्स के रेफ़रंस आईडी	api.referenceIdentitySource.DOMAIN.id=identity-source-id ज़रूरी है. Active Directory प्रिंसिपल को सिंक करने के लिए, आइडेंटिटी सोर्स आईडी.

Active Directory लुकअप

सेटिंग	पैरामीटर
Active Directory होस्ट	adLookup.host=host ज़रूरी है. Active Directory का होस्टनेम, जैसे कि dc.contoso.com या आईपी पता.
Active Directory लुकअप पोर्ट	adLookup.port=port ज़रूरी नहीं. डिफ़ॉल्ट रूप से 389 पर सेट होता है. एसएसएल के लिए 686 का इस्तेमाल करें.
Active Directory लुकअप का तरीका	adLookup.method=value ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह `standard` पर सेट होता है. एचटीटीपीएस कनेक्शन के लिए, इसे `ssl` पर सेट करें.
Active Directory लुकअप उपयोगकर्ता	adLookup.username=CONTOSO\user1 ज़रूरी है. उपयोगकर्ता के पास ऐक्टिव डायरेक्ट्री लुकअप करने की अनुमति है.
Active Directory लुकअप पासवर्ड	adLookup.password=password123 ज़रूरी है. adLookup.user के लिए उपयोगकर्ता का पासवर्ड.

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

सेटिंग	पैरामीटर
एचटीएमएल टेंप्लेट का टाइटल फ़ील्ड	contentTemplate.sharePointItem.title=Title जनरेट किए गए एचटीएमएल के लिए, एचटीएमएल टेंप्लेट के टाइटल के तौर पर इस्तेमाल किया जाने वाला SharePoint फ़ील्ड.
एचटीएमएल कॉन्टेंट के लिए, खोज के लिए अच्छी क्वालिटी वाले फ़ील्ड	contentTemplate.sharePointItem.quality.high=highField1[,highField2,...] जनरेट किए गए एचटीएमएल में अच्छी क्वालिटी वाले फ़ील्ड के तौर पर शामिल करने के लिए, फ़ील्ड की कॉमा से अलग की गई सूची. जब खोज क्वेरी के शब्द इन फ़ील्ड से मेल खाते हैं, तो नतीजों को ज़्यादा रैंक दी जाती है.
एचटीएमएल कॉन्टेंट के लिए, खोज की क्वालिटी के मीडियम फ़ील्ड	contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...] जनरेट किए गए एचटीएमएल में मीडियम क्वालिटी वाले फ़ील्ड के तौर पर शामिल करने के लिए, फ़ील्ड की कॉमा से अलग की गई सूची.
एचटीएमएल कॉन्टेंट के लिए, खोज के लिए कम क्वालिटी वाले फ़ील्ड	contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...] जनरेट किए गए एचटीएमएल में, खराब क्वालिटी वाले फ़ील्ड के तौर पर शामिल करने के लिए, फ़ील्ड की कॉमा से अलग की गई सूची.
एचटीएमएल कॉन्टेंट के ऐसे कॉलम जिन्हें मैप नहीं किया गया है	contentTemplate.sharepointItem.unmappedColumnsMode=APPEND कनेक्टर, मैप नहीं किए गए कॉलम को कैसे मैनेज करता है. वैल्यू, APPEND (डिफ़ॉल्ट) या IGNORE होनी चाहिए. APPEND—कनेक्टर सभी फ़ील्ड के साथ एचटीएमएल कॉन्टेंट जनरेट करता है. इनमें वे फ़ील्ड भी शामिल हैं जिन्हें क्वालिटी लेवल (ज़्यादा, मीडियम या कम) के साथ सेट नहीं किया गया है. IGNORE—कनेक्टर सिर्फ़ मैप किए गए फ़ील्ड के साथ एचटीएमएल कॉन्टेंट जनरेट करता है.