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

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

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

การตั้งค่า SharePoint ที่ยอมรับ

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

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

  • ผู้ใช้ Active Directory
  • กลุ่ม Active Directory
  • กลุ่มภายในของ SharePoint (มีผู้ใช้และกลุ่ม 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 เท่านั้น เช่น ประเภทเนื้อหา "ประกาศ" จะแมปกับคําจํากัดความออบเจ็กต์ "ประกาศ" ประเภทเนื้อหา "บทความข่าว" จะแมปกับ "NewsArticle" (ไม่มีเว้นวรรค)

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

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

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

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

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

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

วิธีเปิดใช้โหมดคอลเล็กชันเว็บไซต์

  • ให้สิทธิ์ผู้ดูแลระบบคอลเล็กชันเว็บไซต์แก่บัญชีผู้ใช้ของเครื่องมือเชื่อมต่อ
  • ตั้งค่า 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 ในคอมพิวเตอร์ที่จะเรียกใช้โปรแกรมเชื่อมต่อ Google Cloud Search SharePoint ในองค์กร
การตรวจสอบสิทธิ์
  • NTLM
  • Kerberos
  • HTTP Basic
  • ADFS

ติดตั้งใช้งานเครื่องมือเชื่อมต่อ

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

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 1 ติดตั้งซอฟต์แวร์เครื่องมือเชื่อมต่อ Google Cloud Search สำหรับ SharePoint ในองค์กร

  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. ในไดเรกทอรีเดียวกัน (ไม่ใช่ 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 ภายในองค์กร

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

  1. สร้างไฟล์และตั้งชื่อว่า sharepoint-onprem-identity-connector.config ในไดเรกทอรีเดียวกับการติดตั้งตัวเชื่อมต่อ SharePoint Online

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

ขั้นตอนที่ 6 เปิดเครื่องมือเชื่อมต่อ SharePoint ภายในองค์กร

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

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