ทำให้เครื่องมือเชื่อมต่อ Microsoft SharePoint On-Prem ใช้งานได้

คุณสามารถตั้งค่า Google Cloud Search ให้แสดงผลการค้นหาจากเนื้อหา SharePoint ภายในองค์กรเพิ่มเติมจากเนื้อหา Google Workspace ได้ คุณใช้เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Google Cloud Search และกำหนดค่าให้เข้าถึงแหล่งข้อมูล SharePoint ที่ต้องการ

สิ่งสำคัญที่ควรพิจารณา

การตั้งค่า SharePoint ที่มีประสิทธิภาพ

เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Cloud Search จะยึดตามการตั้งค่า Search visibility ใน SharePoint เสมอ ซึ่งจะลบล้างไม่ได้ สำหรับเอกสารฉบับร่าง สิทธิ์ในบัญชีผู้ใช้ (ที่เครื่องมือเชื่อมต่อใช้ในการเข้าถึง SharePoint Online) จะควบคุมเอกสารฉบับร่างที่จะมีการจัดทำดัชนีและแสดงผล หากบัญชีมีสิทธิ์ "การอ่านแบบเต็ม" เท่านั้น เครื่องมือเชื่อมต่อจะยึดตามการตั้งค่า "ระดับการเข้าถึงรายการฉบับร่าง" ใน SharePoint

นอกจากนี้ คุณยังกำหนดค่าเครื่องมือเชื่อมต่อเพื่อจำกัดผลลัพธ์ตามการเข้าถึงบัญชีผู้ใช้ได้ด้วย คุณสามารถใช้ผู้ใช้หลัก Google และผู้ใช้หลักภายนอกเพื่อกำหนด ACL หากต้องการใช้การตัดการรักษาความปลอดภัยสำหรับเนื้อหา SharePoint ให้ซิงค์ข้อมูลข้อมูลประจำตัวภายนอกต่อไปนี้กับไดเรกทอรี Google

  • ผู้ใช้ Active Directory
  • กลุ่ม Active Directory
  • SharePoint Local Groups (โดยมีผู้ใช้และกลุ่ม Active Directory เป็นสมาชิก)

หากต้องการซิงค์ข้อมูลผู้ใช้และกลุ่ม AD ให้ใช้ Google Cloud Directory Sync เพื่อเปิดใช้กลุ่มการจับคู่ข้อมูลประจำตัว หากต้องการซิงค์ข้อมูลกลุ่มในเครื่องของ SharePoint ให้ใช้ SharePoint Identity Connector

เครื่องมือเชื่อมต่อยังต้องค้นหาโดยใช้ AD เพื่อดึงข้อมูลเพิ่มเติมและซิงค์ข้อมูลผู้ใช้หลักด้วย ตัวอย่างเช่น การค้นหาด้วย AD จะช่วยให้เครื่องมือเชื่อมต่อทำสิ่งต่อไปนี้ได้

  • แมป SID ของกลุ่มโดเมนกับ sAMAccountName ที่สอดคล้องกัน
  • แมป sAMAccountName ของผู้ใช้กับอีเมลสำหรับการเป็นสมาชิกกลุ่มภายในของ SharePoint

การเพิ่มประสิทธิภาพการค้นหา

คุณสามารถปรับปรุงประสบการณ์ของผู้ใช้ได้โดยกำหนดค่าเครื่องมือเชื่อมต่อให้แสดงผลการค้นหาที่เกี่ยวข้องมากขึ้น

หากต้องการใช้ API ให้กำหนดค่าสำหรับพารามิเตอร์การสร้าง HTML ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อ SharePoint Online พารามิเตอร์เหล่านี้ช่วยให้คุณกำหนดได้ว่าจะให้ช่องใดส่งผลต่อการจับคู่สูงกว่าหรือต่ำกว่า

หากต้องการตั้งค่าสคีมา ให้ทำตามวิธีการในหัวข้อสร้างและลงทะเบียนสคีมา เมื่อคุณตั้งค่าสคีมา ให้ทำดังนี้

  • ในการจับคู่ชื่อประเภทเนื้อหาของ SharePoint กับการกำหนดออบเจ็กต์ที่สัมพันธ์กัน เครื่องมือเชื่อมต่อจะปรับชื่อประเภทเนื้อหาให้เป็นมาตรฐานโดยไม่รวมอักขระที่ไม่รองรับ สำหรับการกำหนดออบเจ็กต์ Cloud Search API รองรับเฉพาะอักขระ A-Z, a-z และ 0-9 เท่านั้น ตัวอย่างเช่น ประเภทเนื้อหา "ประกาศ" จะแมปกับคำจำกัดความของออบเจ็กต์ "ประกาศ" เนื้อหาประเภท "บทความข่าว" จะแมปกับ "Newsบทความข่าว" (ไม่มีช่องว่าง)

  • เมื่อเครื่องมือเชื่อมต่อไม่สามารถจับคู่การกำหนดออบเจ็กต์กับการกำหนดออบเจ็กต์ เครื่องมือเชื่อมต่อจะใช้ประเภทออบเจ็กต์สำรอง (itemMetadata.objectType) ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การกำหนดค่าข้อมูลเมตา

  • ในการจับคู่ชื่อพร็อพเพอร์ตี้ของ SharePoint กับคำจำกัดความของพร็อพเพอร์ตี้ เครื่องมือเชื่อมต่อจะปรับชื่อพร็อพเพอร์ตี้ให้เป็นมาตรฐานโดยการถอดรหัสอักขระที่เข้ารหัสด้วยเลขฐาน 16 และนำคำนำหน้า "ows_" ออก จากนั้นจึงยกเว้นอักขระที่ไม่รองรับ (อักขระทั้งหมดยกเว้น A-Z, a-z และ 0-9 เป็นอักขระที่ถูกต้อง)

การจัดการข้อความใน Microsoft Outlook

เมื่อเครื่องมือเชื่อมต่อพบไฟล์ .msg ของ Microsoft Outlook ขณะทำดัชนีเนื้อหา เครื่องมือจะแทนที่ประเภทสื่อสำหรับไฟล์ และจัดทำดัชนีไฟล์เป็น application/vnd.ms-outlook.

การกำหนดค่ากลุ่มผู้ใช้หลายกลุ่ม

หาก SharePoint เป็นการใช้งานแบบ Multi-tenant ซึ่งเว็บไซต์ของลูกค้าหลายเว็บไซต์โฮสต์อยู่ในเว็บแอปพลิเคชันเดียวกัน คุณต้องกำหนดค่าโหมดคอลเล็กชันของเว็บไซต์ในไฟล์การกำหนดค่า ในการติดตั้งใช้งานแบบหลายผู้ใช้ คุณได้รับสิทธิ์เข้าถึงเฉพาะคอลเล็กชันเว็บไซต์ของคุณ และจะไม่ได้รับสิทธิ์อ่านแบบเต็มตามที่เครื่องมือเชื่อมต่อ SharePoint On-Prem กำหนด

วิธีเปิดใช้โหมดรวบรวมข้อมูลเว็บไซต์

  • มอบสิทธิ์ผู้ดูแลระบบคอลเล็กชันเว็บไซต์ให้แก่บัญชีผู้ใช้เครื่องมือเชื่อมต่อ
  • ตั้งค่า sharepoint.server ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อเป็น URL คอลเล็กชันของเว็บไซต์ เช่น http://sharepoint.example.com/sites/sitecollection โดยที่ URL ไม่จำเป็นต้องใช้ตัวพิมพ์แบบเดียวกับใน SharePoint
  • ตั้งค่า sharepoint.siteCollectionOnly ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อเป็น true

หากคุณมีคอลเล็กชันเว็บไซต์หลายรายการที่จะทำดัชนีในสภาพแวดล้อมแบบผู้ใช้หลายราย คุณจะต้องกำหนดค่าอินสแตนซ์ของเครื่องมือเชื่อมต่อ 1 อินสแตนซ์สำหรับแต่ละคอลเล็กชันของเว็บไซต์

ข้อจำกัดของเครื่องมือเชื่อมต่อที่ทราบ

  • เวลาที่เครื่องมือเชื่อมต่อใช้ในการตรวจสอบการเปลี่ยนแปลงของรายการในฐานข้อมูลจะเพิ่มขึ้นพร้อมกับจำนวนฐานข้อมูลที่เครื่องมือเชื่อมต่อตรวจสอบ
  • การใช้หน่วยความจำจะเพิ่มขึ้นตามจำนวนผู้ใช้และกลุ่มที่ไม่ซ้ำกันที่คุณใช้ใน ACL สำหรับคอลเล็กชันเว็บไซต์แต่ละรายการ
  • คุณสามารถกำหนดค่าเครื่องมือเชื่อมต่อด้วยข้อมูลประจำตัวจากโดเมน Active Directory เดียวเท่านั้น
  • ระบบไม่รองรับ Active Directory และผู้ใช้หลักของ Windows ทั่วไปบางรายการ เช่น Everyone, BUILTIN\Users และ All Authenticated Users
  • การแจ้งเตือนการลบจะไม่เกิดขึ้นทันที และอาจใช้เวลามากกว่า 4 ชั่วโมงเพื่อให้เครื่องมือเชื่อมต่อจดจำว่าผู้ใช้ลบเนื้อหาออกจากที่เก็บต้นทาง

ข้อกำหนดของระบบ

ข้อกำหนดของระบบ
ระบบปฏิบัติการ
  • Windows Server 2016
  • Ubuntu
  • Red Hat Enterprise Linux 5.0
  • SUSE Enterprise Linux 10 (64 บิต)
ซอฟต์แวร์
  • เซิร์ฟเวอร์ SharePoint
    • เซิร์ฟเวอร์ SharePoint 2016
    • เซิร์ฟเวอร์ SharePoint 2013
  • Java JRE 1.8 ที่ติดตั้งในคอมพิวเตอร์ที่จะเรียกใช้เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Google Cloud Search
การตรวจสอบสิทธิ์
  • NTLM
  • Kerberos
  • HTTP พื้นฐาน
  • ADFS

ทำให้เครื่องมือเชื่อมต่อใช้งานได้

ข้อกำหนดเบื้องต้น

  1. สร้างคีย์ส่วนตัว Google Workspace ที่มีรหัสบัญชีบริการ หากต้องการดูวิธีรับคีย์ส่วนตัว ให้ไปที่หัวข้อ กำหนดค่าการเข้าถึง Google Cloud Search API

  2. ผู้ดูแลระบบ Google Workspace ต้องเพิ่มแหล่งข้อมูลที่จะค้นหา บันทึกรหัสแหล่งข้อมูล

  3. หากเครื่องมือเชื่อมต่อแสดงผลลัพธ์ตาม ACL (ผลลัพธ์ไม่ใช่แบบสาธารณะ) ผู้ดูแลระบบ Google Workspace จะต้องสร้างแหล่งที่มาของข้อมูลประจำตัว 2 แหล่งและให้รหัสแก่คุณดังนี้

    • แหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์ผู้ใช้และกลุ่ม Active Directory
    • แหล่งที่มาของข้อมูลประจำตัวสำหรับกลุ่ม SharePoint Local

    นอกจากนี้ผู้ดูแลระบบยังต้องได้รับรหัสลูกค้า Google Workspace ขององค์กรและมอบรหัสนี้ให้คุณด้วย

    ดูวิธีรับค่าเหล่านี้ในจับคู่ข้อมูลประจำตัวของผู้ใช้ใน Cloud Search

  4. ตั้งค่าบัญชีผู้ใช้สำหรับเครื่องมือเชื่อมต่อที่มีสิทธิ์การอ่านแบบเต็มสำหรับเว็บแอปพลิเคชันของ SharePoint ในนโยบายผู้ใช้

  5. หากเว็บแอปพลิเคชัน SharePoint ไม่มีคอลเล็กชันของเว็บไซต์ราก ให้สร้างคอลเล็กชันขึ้นมา

  6. หากคอลเล็กชันของเว็บไซต์ถูกล็อกด้วยการเขียน ให้ลงชื่อเข้าใช้เซิร์ฟเวอร์ SharePoint ด้วยบัญชีที่มีสิทธิ์ของผู้ดูแลระบบและเรียกใช้สคริปต์ PrepareWriteLockedSites.ps1

  7. หากต้องการรับเมตริกแหล่งข้อมูลเพื่อใช้ประกอบการกำหนดค่าเครื่องมือเชื่อมต่อ ให้ลงชื่อเข้าใช้เซิร์ฟเวอร์ SharePoint ด้วยบัญชีที่มีสิทธิ์การดูแลระบบฟาร์มและเรียกใช้ diagnose_sp.ps1

    ผลลัพธ์จะรายงานจำนวนเว็บแอปพลิเคชัน เอกสาร และการเป็นสมาชิกของกลุ่มผู้ใช้ ใช้ข้อมูลนี้เพื่อประเมินจำนวนอินสแตนซ์ของเครื่องมือเชื่อมต่อที่คุณต้องการ ข้อกำหนดด้านหน่วยความจำ และจำนวนเอกสาร

ขั้นตอนที่ 1 ติดตั้งซอฟต์แวร์เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Google Cloud Search

  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 -DskipTests แทน mvn package

  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

ขั้นตอนที่ 2 สร้างไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อ 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 จัดหา

ขั้นตอนที่ 3 สำหรับ HTTPS ให้เพิ่ม SharePoint เป็นโฮสต์ที่เชื่อถือได้

หากมีการกำหนดค่า SharePoint ให้ใช้ HTTPS ให้รับใบรับรอง SharePoint เพื่อเพิ่มเป็นโฮสต์ที่เชื่อถือได้สำหรับเครื่องมือเชื่อมต่อ

  1. ในคอมพิวเตอร์ที่จะเรียกใช้เครื่องมือเชื่อมต่อ ให้เปิดเบราว์เซอร์และไปที่ SharePoint

  2. ในหน้าคำเตือนที่เปิดขึ้น ให้คลิกฉันเข้าใจความเสี่ยงและเพิ่มข้อยกเว้น หน้านี้จะแสดงข้อความว่า "การเชื่อมต่อนี้ไม่น่าเชื่อถือ" เนื่องจากใบรับรองเป็นแบบ Self-signed และไม่ได้ลงชื่อโดยผู้ออกใบรับรองที่เชื่อถือได้

  3. เมื่อปุ่มดูพร้อมให้ใช้งานแล้ว ให้คลิกปุ่มนี้

  4. ไปที่แท็บรายละเอียด แล้วคลิกส่งออก

  5. บันทึกใบรับรองในไดเรกทอรีเครื่องมือเชื่อมต่อโดยใช้ชื่อ sharepoint.crt

  6. คลิกปิด แล้วยกเลิกเพื่อปิดหน้าต่าง

  7. เปิด Command Prompt แล้วป้อนคำสั่งต่อไปนี้

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

    เมื่อได้รับข้อความแจ้ง "เชื่อถือใบรับรองนี้ไหม" ให้ตอบว่าใช่

ขั้นตอนที่ 4 ตั้งค่าการบันทึก

  1. สร้างโฟลเดอร์ชื่อ logs ในไดเรกทอรีที่มีไบนารีของเครื่องมือเชื่อมต่อ

  2. ในไดเรกทอรีเดียวกัน (ไม่ใช่ logs) ให้สร้างไฟล์ที่เข้ารหัส Latin1 ชื่อ logging.properties

  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

ขั้นตอนนี้จำเป็นสำหรับการใช้ ACL ที่อิงตามข้อมูลประจำตัวของ SharePoint On-Prem กับผลการค้นหา ถ้าคุณตั้งค่าเครื่องมือเชื่อมต่อด้วย ACL สาธารณะ คุณสามารถข้ามขั้นตอนนี้ได้

  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.customerId แทนที่จะเป็น api.sourceId ค่าของ api.customerId คือรหัสลูกค้าที่ได้รับจากผู้ดูแลระบบ Google Workspace

ขั้นตอนที่ 6 เปิดใช้เครื่องมือเชื่อมต่อ SharePoint On-Prem

ในขั้นตอนต่อไปนี้ คุณจะแมปผู้ใช้หลักทั้งใน Active Directory ภายในองค์กรและคอลเล็กชันของเว็บไซต์ SharePoint กับข้อมูลประจำตัวในบริการ Cloud Identity ซึ่งการซิงค์นี้จะทำได้ด้วย Google Cloud Directory Sync (GCDS) และเครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem

หลังจากที่ GCDS ซิงค์ผู้ใช้และกลุ่ม ให้เรียกใช้เครื่องมือเชื่อมต่อข้อมูลประจำตัวของ SharePoint On-Prem เพื่อซิงค์ข้อมูลกลุ่มคอลเล็กชันของเว็บไซต์ SharePoint สุดท้าย เรียกใช้เครื่องมือเชื่อมต่อ SharePoing On-Prem เพื่อจัดทำดัชนีและแสดงผลลัพธ์แก่ผู้ใช้ Cloud Search

  1. หากยังไม่ได้ดำเนินการ โปรด กำหนดค่าและเรียกใช้ GCDS ตรวจสอบว่าได้เปิดใช้กลุ่มการจับคู่ข้อมูลประจำตัวแล้ว

  2. เรียกใช้เครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem

    $ 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 ดังนี้

    • HTTP (ไม่ต้องใช้โฮสต์ที่เชื่อถือได้):

      $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
    • HTTPS (เพิ่ม 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 Cloud Search ที่ผู้ดูแลระบบ Google Workspace กำหนด

เส้นทางไปยังไฟล์คีย์ส่วนตัวของบัญชีบริการ api.serviceAccountPrivateKeyFile=PrivateKey.json

ต้องระบุ เส้นทางไปยังไฟล์คีย์บัญชีบริการ Google Cloud Search

การเข้าถึง SharePoint ภายในองค์กร

การเกริ่นนำ พารามิเตอร์
URL ของเซิร์ฟเวอร์ SharePoint sharepoint.server=http://yoursharepoint.example.com/

ต้องระบุ URL ของเซิร์ฟเวอร์ SharePoint เป็นชื่อโฮสต์แบบเต็ม เช่น http://yoursharepoint.example.com/ หากชื่อโฮสต์ไม่ตรงตามเกณฑ์ทั้งหมด คุณต้องตั้งค่าการลบล้าง DNS ในโฮสต์ของเครื่องมือเชื่อมต่อ

ชื่อผู้ใช้ 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

ใช้การตรวจสอบสิทธิ์ ADFS เพื่อเชื่อมต่อกับ SharePoint 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 แบบหลายกลุ่มผู้ใช้ (ดูข้อมูลเพิ่มเติม) ตั้งค่าเป็น "จริง" เพื่อให้ดัชนีเครื่องมือเชื่อมต่อ sharepoint.server เป็นคอลเล็กชันของเว็บไซต์แทนที่จะเป็นเซิร์ฟเวอร์เสมือน ค่าเริ่มต้นคือ Null (ตรวจพบอัตโนมัติ)

การจับคู่ข้อมูลประจำตัวของ SharePoint

การเกริ่นนำ พารามิเตอร์
รหัสแหล่งที่มาของข้อมูลประจำตัว api.identitySourceId=1234567890abcdef

ต้องระบุ รหัสแหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์กลุ่มภายในของ SharePoint รหัสแหล่งที่มาของ Google Cloud Search ที่ผู้ดูแลระบบ Google Workspace เป็นผู้ตั้งค่า ตามที่อธิบายไว้ในหัวข้อเพิ่มแหล่งข้อมูลที่จะค้นหา

แหล่งที่มาของข้อมูลประจำตัวอ้างอิง api.referenceIdentitySources=CONTOSO,contoso

รายการที่คั่นด้วยเครื่องหมายจุลภาคของแหล่งที่มาของข้อมูลประจำตัวอ้างอิงสำหรับผู้ใช้หลักของไดเรกทอรีที่ใช้งานอยู่ ค่านี้ตรงกับชื่อ NETBIOS ของ Active Directory ของรายการหลักของไดเรกทอรี Active อ้างอิง

รหัสแหล่งที่มาของข้อมูลประจำตัวอ้างอิง api.referenceIdentitySource.DOMAIN.id=identity-source-id

ต้องระบุ รหัสแหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์ผู้ใช้หลักของ Active Directory

การค้นหา Active Directory

การเกริ่นนำ พารามิเตอร์
โฮสต์ Active Directory adLookup.host=host

ต้องระบุ ชื่อโฮสต์ของไดเรกทอรีที่ใช้งานอยู่ เช่น dc.contoso.com หรือที่อยู่ IP

พอร์ตการค้นหา Active Directory adLookup.port=port

ไม่บังคับ ค่าเริ่มต้นคือ 389 ใช้ 686 สำหรับ SSL

วิธีการค้นหา Active Directory adLookup.method=value

ไม่บังคับ ค่าเริ่มต้นคือ "standard" สำหรับการเชื่อมต่อ HTTPS ให้ตั้งค่าเป็น "ssl"

ค้นหาผู้ใช้ Active Directory adLookup.username=CONTOSO\user1

ต้องระบุ ผู้ใช้ได้รับอนุญาตให้ค้นหาไดเรกทอรีที่ใช้งานอยู่

รหัสผ่านการค้นหา Active Directory adLookup.password=password123

ต้องระบุ รหัสผ่านสำหรับผู้ใช้ที่ระบุโดย adLookup.user

การสร้างเนื้อหา HTML

การเกริ่นนำ พารามิเตอร์
ช่องชื่อเทมเพลต HTML contentTemplate.sharePointItem.title=Title

ฟิลด์ SharePoint ที่จะใช้เป็นชื่อเทมเพลต HTML สำหรับ HTML ที่สร้างขึ้น

ฟิลด์เนื้อหา HTML ที่มีคุณภาพสูง contentTemplate.sharePointItem.quality.high=highField1[,highField2,...]

รายการช่องที่คั่นด้วยคอมมาที่จะใส่ไว้ใน HTML ที่สร้างขึ้นให้เป็นช่องคุณภาพสูง เมื่อข้อความค้นหาตรงกับช่องเหล่านี้ ผลการค้นหาจะอยู่ในอันดับที่สูงกว่า

ช่องคุณภาพการค้นหาปานกลางสำหรับเนื้อหา HTML contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...]

รายการช่องที่คั่นด้วยคอมมาที่จะใส่ไว้ใน HTML ที่สร้างขึ้นเป็นช่องคุณภาพปานกลาง

ฟิลด์เนื้อหา HTML คุณภาพต่ำในการค้นหา contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...]

รายการช่องที่คั่นด้วยคอมมาที่จะใส่ไว้ใน HTML ที่สร้างขึ้นให้เป็นช่องคุณภาพต่ำ

คอลัมน์ที่ไม่ได้จับคู่เนื้อหา HTML contentTemplate.sharepointItem.unmappedColumnsMode=APPEND

วิธีที่เครื่องมือเชื่อมต่อจัดการคอลัมน์ที่ไม่ได้แมป ค่าคือ APPEND (ค่าเริ่มต้น) หรือ IGNORE

  • ต่อท้าย - เครื่องมือเชื่อมต่อจะสร้างเนื้อหา HTML ที่มีทุกช่อง รวมถึงช่องที่ไม่ได้ตั้งค่าไว้ด้วยระดับคุณภาพ (สูง ปานกลาง หรือต่ำ)
  • IGNORE - เครื่องมือเชื่อมต่อจะสร้างเนื้อหา HTML ที่มีเฉพาะช่องที่แมปเท่านั้น