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

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

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

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

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

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

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

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

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

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

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

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

एपीआई का इस्तेमाल करने के लिए, 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 On-Prem कनेक्टर के लिए ज़रूरी होती हैं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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-encoded फ़ाइल बनाएं.

  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
    

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

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

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

छठा चरण. SharePoint On-Prem कनेक्टर लॉन्च करना

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

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

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

  2. SharePoint On-Prem identity connector को चलाएं:

    $ 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 On-Prem कनेक्टर चलाएं. अपनी 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 on-premises का ऐक्सेस

सेटिंग पैरामीटर
SharePoint सर्वर का यूआरएल sharepoint.server=http://yoursharepoint.example.com/

ज़रूरी है. SharePoint सर्वर का यूआरएल, पूरी तरह से क्वालिफ़ाइड होस्ट नेम के तौर पर. जैसे, http://yoursharepoint.example.com/. अगर होस्ट नेम पूरी तरह से क्वालिफ़ाइड नहीं है, तो आपको कनेक्टर होस्ट पर डीएनएस ओवरराइड सेट करना होगा.

SharePoint का उपयोगकर्ता नाम sharepoint.username=YOURDOMAIN\\ConnectorUser

Linux या SharePoint Server AD डोमेन का हिस्सा न होने वाली Windows मशीन पर कनेक्टर चलाने के लिए, इसकी ज़रूरत होती है.

SharePoint का पासवर्ड sharepoint.password=user_password

Linux या SharePoint Server AD डोमेन का हिस्सा न होने वाली Windows मशीन पर कनेक्टर चलाने के लिए, इसकी ज़रूरत होती है.

SharePoint से कनेक्ट करने के लिए, लाइव पुष्टि करने की सुविधा का इस्तेमाल करना sharepoint.username=AdaptorUser Live Authentication Id

sharepoint.password uS3R_passWoRD

sharepoint.formsAuthenticationMode=LIVE

SharePoint से कनेक्ट करने के लिए, ADFS ऑथेंटिकेशन का इस्तेमाल करना sharepoint.username=AdaptorUser@yourdomain.com

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 डिप्लॉयमेंट के लिए यह विकल्प ज़रूरी है (ज़्यादा जानें). इस वैल्यू को true पर सेट करें, ताकि कनेक्टर इंडेक्स sharepoint.server को वर्चुअल सर्वर के बजाय साइट कलेक्शन के तौर पर इस्तेमाल किया जा सके. डिफ़ॉल्ट वैल्यू null (अपने-आप पता लगाया गया) होती है.

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

सेटिंग पैरामीटर
पहचान स्रोत आईडी api.identitySourceId=1234567890abcdef

ज़रूरी है. SharePoint लोकल ग्रुप को सिंक करने के लिए आइडेंटिटी सोर्स आईडी. Google Workspace एडमिन ने Google Cloud Search सोर्स आईडी सेट अप किया है. इसके बारे में खोज के लिए डेटा सोर्स जोड़ना लेख में बताया गया है.

पहचान स्रोतों को रेफ़रंस करना api.referenceIdentitySources=CONTOSO,contoso

ऐक्टिव डायरेक्ट्री प्रिंसिपल के लिए, कॉमा लगाकर अलग की गई रेफ़रंस आइडेंटिटी सोर्स की सूची. यह वैल्यू, रेफ़रंस Active Directory प्रिंसिपल के Active Directory NETBIOS नाम से मेल खाती है.

पहचान के सोर्स के आईडी का रेफ़रंस api.referenceIdentitySource.DOMAIN.id=identity-source-id

ज़रूरी है. Active Directory के प्रिंसिपल को सिंक करने के लिए, Identity Source ID.

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—कनेक्टर, सिर्फ़ मैप किए गए फ़ील्ड के साथ एचटीएमएल कॉन्टेंट जनरेट करता है.