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

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

สิ่งสำคัญที่ต้องคำนึงถึง

การตั้งค่า SharePoint ที่ใช้

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

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

  • ผู้ใช้ Active Directory
  • กลุ่ม Active Directory
  • กลุ่มภายในของ SharePoint (มีผู้ใช้และกลุ่ม Active Directory เป็นสมาชิก)

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

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

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

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

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

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

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

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

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

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

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

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

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

หาก SharePoint เป็นการติดตั้งใช้งานแบบหลายผู้เช่าซึ่งโฮสต์เว็บไซต์ของลูกค้าหลายรายในเว็บแอปพลิเคชันเดียวกัน คุณต้องกำหนดค่าโหมดคอลเล็กชันเว็บไซต์ในไฟล์การกำหนดค่า ในการติดตั้งใช้งานแบบหลายผู้เช่า คุณจะได้รับสิทธิ์สำหรับคอลเล็กชันเว็บไซต์ของคุณเท่านั้น และไม่สามารถรับสิทธิ์อ่านแบบเต็มตามที่เครื่องมือเชื่อมต่อ 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 Server 2016
    • SharePoint Server 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 ภายในองค์กรของ 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 ภายในองค์กร

  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. สร้างไฟล์ที่เข้ารหัส Latin1 ชื่อ logging.properties ในไดเรกทอรีเดียวกัน (ไม่ใช่ logs)

  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 ภายในองค์กร

ขั้นตอนนี้จำเป็นต่อการใช้ 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 ภายในองค์กร

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

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

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

    • 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 ที่ไม่ได้เป็นส่วนหนึ่งของโดเมน AD ของ SharePoint Server
รหัสผ่าน SharePoint sharepoint.password=user_password

ต้องระบุเมื่อเรียกใช้เครื่องมือเชื่อมต่อใน Linux หรือในเครื่อง Windows ที่ไม่ได้เป็นส่วนหนึ่งของโดเมน AD ของ SharePoint Server
ใช้การตรวจสอบสิทธิ์แบบสดเพื่อเชื่อมต่อกับ 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

รายการแหล่งที่มาของข้อมูลประจำตัวอ้างอิงที่คั่นด้วยคอมมาสำหรับหลักการของ Active Directory ค่านี้ตรงกับชื่อ NETBIOS ของ Active Directory ของหลักการ Active Directory อ้างอิง
อ้างอิงรหัสแหล่งที่มาของข้อมูลประจำตัว api.referenceIdentitySource.DOMAIN.id=identity-source-id

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

การค้นหา Active Directory

การตั้งค่า พารามิเตอร์
โฮสต์ Active Directory adLookup.host=host

ต้องระบุ ชื่อโฮสต์ Active Directory เช่น 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
รหัสผ่านการค้นหา 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

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