ภาพรวม

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

คอลเลกชันไซต์ SharePoint หรือที่เรียกว่า SPSite สามารถมีหลายไซต์ได้ กฎคอลเลกชันมีผลกับทั้งคอลเลกชัน โดยยังขึ้นอยู่กับสิทธิ์ Microsoft ที่ผู้ใช้แต่ละคนมีอยู่ กฎนี้ไม่ได้ให้สิทธิ์ผู้ใช้เข้าถึงเนื้อหาที่ตนเข้าถึงไม่ได้ใน Microsoft 365

ข้อจำกัดไซต์มีผลกับการค้นหา การเรียกดู การดึงไฟล์ และการอ่าน/เขียนของ SharePoint ที่รองรับ การเข้าถึง OneDrive จัดการแยกต่างหาก

เลือกโหมดการเข้าถึงที่ตรงกับนโยบายของคุณ:

• ไซต์ที่อนุญาต: เมื่อรายการอนุญาตมีข้อมูล ผู้ใช้จะเข้าถึงผ่านแอปได้เฉพาะคอลเลกชันไซต์ที่อยู่ในรายการเท่านั้น

• ไซต์ที่บล็อก: ผู้ใช้เข้าถึงคอลเลกชันไซต์ที่ไม่อยู่ในรายการบล็อกได้ โดยขึ้นอยู่กับสิทธิ์ Microsoft ของตน

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

การเปิดให้ใช้งาน

ตัวควบคุมและ Admin API ของเวิร์กสเปซต้องได้รับการเปิดใช้งานสำหรับเวิร์กสเปซของคุณ ตัวควบคุมที่มีให้ใช้ ได้แก่ รายการอนุญาตคอลเลกชันไซต์ รายการบล็อกคอลเลกชันไซต์ การนำเข้าไซต์จาก CSV และการยกเว้นตามป้ายกำกับระดับความลับ

กฎมีผลกับทั้งคอลเลกชันไซต์ ตัวควบคุมคอลเลกชันไซต์เหล่านี้ไม่รวมการกำหนดขอบเขตแบบเจาะจงรายไซต์ โฟลเดอร์ หรือไฟล์ และการบังคับใช้ Microsoft Sites.Selected

ก่อนเริ่มต้น

• ระบุคอลเลกชันไซต์ที่องค์กรของคุณต้องการอนุญาตหรือบล็อก

• รับ GUID ของแต่ละคอลเลกชัน ID ไซต์แบบเต็มของ Microsoft Graph มี GUID ของคอลเลกชันเป็นค่าตรงกลาง Admin API ใช้ GUID ของคอลเลกชัน ส่วนตัวนำเข้า CSV ใน UI ยังสามารถดึงค่าเหล่านี้จาก ID ไซต์แบบสามส่วนของ Graph ได้ด้วย

• เปิดใช้สิทธิ์ Microsoft ที่แอป SharePoint ต้องการ ทั้งในการตั้งค่าสิทธิ์ของ ChatGPT และใน Microsoft Entra รวมถึง Sites.Read.All และ Files.Read.All ตัวควบคุมเหล่านี้กรองการเข้าถึงในฝั่ง OpenAI ไม่ได้ใช้แทนสิทธิ์แบบมอบหมายของ Microsoft

• สำหรับการยกเว้นตามป้ายกำกับระดับความลับ ให้ขอ GUID แบบเปลี่ยนแปลงไม่ได้ของป้ายกำกับแต่ละรายการที่ไม่มีการเข้ารหัสจากผู้ดูแลระบบ Microsoft 365 หรือ Purview

• สำหรับการดูแลระบบผ่าน API ให้เตรียม UUID ของเวิร์กสเปซ คีย์ผู้ดูแลระบบเวิร์กสเปซ ChatGPT และโทเค็น Microsoft Graph หากต้องค้นหาตัวระบุจาก URL ของ SharePoint ข้อมูลรับรองทั้งสองมีวัตถุประสงค์การใช้งานต่างกัน

เกี่ยวกับ OpenAI Cookbook

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

ตลอดบทความนี้ “Cookbook” หมายถึงคู่มือ SharePoint ดังกล่าว และ “เครื่องมือ Cookbook” หมายถึงสคริปต์ Python ที่ลิงก์ไว้ ใช้เอกสารอ้างอิงเหล่านี้เพื่อดูตัวอย่างคำสั่งและวิธีจัดการรายการอนุญาตผ่าน API

ตั้งค่าข้อมูลรับรองสำหรับการดูแลระบบผ่าน API

หมายเหตุ: คุณต้องเป็นผู้ดูแลระบบเวิร์กสเปซจึงจะสร้างคีย์ผู้ดูแลระบบได้ อ่านเพิ่มเติม

สร้างคีย์ผู้ดูแลระบบเวิร์กสเปซ ChatGPT

1. เปิดคอนโซลผู้ดูแลระบบ ChatGPT แล้วเลือกเวิร์กสเปซที่ต้องการ

2. ไปที่ ข้อมูลรับรอง แล้วเลือก คีย์ผู้ดูแลระบบ

3. สร้างคีย์ที่มีสิทธิ์แบบจำกัด แล้วตั้งค่า แอป เป็น เขียน

4. จัดเก็บคีย์อย่างปลอดภัย คีย์นี้ให้สิทธิ์อ่านและเปลี่ยนนโยบาย SharePoint ของเวิร์กสเปซของคุณ

สิทธิ์ที่ต้องใช้คือ chatgpt.enterprise.apps.write โปรดทราบว่าคีย์แพลตฟอร์ม API และโทเค็น Microsoft Graph ไม่สามารถใช้แทนคีย์ผู้ดูแลระบบเวิร์กสเปซ ChatGPT ได้

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

รับโทเค็น Microsoft Graph

ใช้กระบวนการตรวจสอบสิทธิ์ Microsoft ที่องค์กรของคุณอนุมัติ หากต้องการค้นหาแบบโต้ตอบ และองค์กรของคุณอนุญาตให้ใช้ Graph Explorer:

1. เปิด Microsoft Graph Explorer แล้วลงชื่อเข้าใช้ด้วยบัญชีที่ทำงานในเทนแนนต์ที่มีไซต์ SharePoint เหล่านั้น

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

3. เปิดแท็บ โทเค็นการเข้าถึง แล้วคัดลอกโทเค็นเพื่อใช้กับ Microsoft Graph

ดูคำแนะนำของ Microsoft ได้ที่ ใช้งาน Graph Explorer

โทเค็น Graph ใช้ค้นหาตัวระบุจาก URL ของ SharePoint คีย์ผู้ดูแลระบบ ChatGPT ใช้อ่านหรืออัปเดตนโยบาย ChatGPT เครื่องมือ Cookbook ต้องใช้โทเค็น Graph เฉพาะสำหรับคำสั่งที่ค้นหาตัวระบุจาก URL ส่วนการอ่านหรือล้างรายการอนุญาตที่มีอยู่ใช้เพียงคีย์ผู้ดูแลระบบ ChatGPT เท่านั้น

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

ค้นหา GUID ของคอลเลกชันไซต์

ใช้ URL ของไซต์ SharePoint

1. เปิดไซต์ SharePoint โดยลงชื่อเข้าใช้ Microsoft ด้วยบัญชีที่เข้าถึงไซต์นั้นได้

2. ต่อท้าย URL ของไซต์ด้วย /_api/site/id ตัวอย่างเช่น ใช้ https://contoso.sharepoint.com/sites/Finance/_api/site/id

3. คัดลอก GUID ที่ส่งกลับมาในผลลัพธ์

หมายเหตุ: โดเมนและตัวระบุที่ใช้เป็นตัวอย่างในบทความนี้เป็นค่าจำลอง

ใช้ Microsoft Graph

Microsoft Graph จะส่งกลับ ID ไซต์ที่มีองค์ประกอบสามส่วนคั่นด้วยจุลภาค ได้แก่ ชื่อโฮสต์, GUID ของคอลเลกชันไซต์ และ GUID ของไซต์ ใช้ค่าตรงกลางสำหรับกฎคอลเลกชันไซต์ URL ของไซต์ที่ต่างกันอาจอ้างถึง GUID ของคอลเลกชันเดียวกันได้

ดูตัวอย่างการค้นหาและตัวระบุได้ที่ ทำความเข้าใจตัวระบุไซต์ SharePoint หากต้องการค้นหาตัวระบุจาก URL หลายรายการโดยไม่เปลี่ยนนโยบาย ChatGPT ให้ใช้คำแนะนำการตรวจสอบใน Cookbook และสคริปต์ Python สำหรับการดูแลระบบ

ดูข้อกำหนดการค้นหาของ Microsoft ได้ที่ ดึงข้อมูลไซต์ SharePoint จากพาธ

จัดการคอลเลกชันไซต์ที่อนุญาตและที่บล็อก

ใช้ตัวควบคุมของเวิร์กสเปซ

1. เปิดการควบคุมความปลอดภัยและการรักษาความมั่นคงปลอดภัยของแอป SharePoint ในเวิร์กสเปซของคุณ

2. ในหัวข้อ โหมดการเข้าถึง ให้เลือก ไซต์ที่อนุญาต หรือ ไซต์ที่บล็อก

3. เพิ่มคอลเลกชันไซต์ลงในรายการที่เลือก คุณยังใช้การอัปโหลด CSV ตามที่อธิบายด้านล่างได้ด้วย

4. ตรวจสอบการเปลี่ยนแปลงแล้วเลือก บันทึก

5. ตรวจสอบนโยบายที่บันทึกไว้และทดสอบการตั้งค่า

ไซต์ที่เพิ่มผ่าน Admin API จะปรากฏในหน้าการควบคุมของเวิร์กสเปซ ไซต์ที่เพิ่มใน UI ก็เข้าถึงผ่าน API ได้เช่นกัน คุณเพิ่มหรือลบรายการผ่านช่องทางใดก็ได้ วิธีที่ใช้เพิ่มไซต์ไม่ได้บังคับว่าต้องจัดการไซต์นั้นด้วยวิธีเดิม

สลับระหว่างไซต์ที่อนุญาตและไซต์ที่บล็อก

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


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

อัปโหลดคอลเลกชันไซต์จาก CSV

การอัปโหลด CSV รองรับเฉพาะคอลเลกชันไซต์เท่านั้น หากต้องการยกเว้นไฟล์ตามป้ายกำกับระดับความลับ ให้เพิ่ม GUID ของป้ายกำกับในหัวข้อ ป้ายกำกับระดับความลับที่ยกเว้นโดยไม่มีการเข้ารหัส

1. เปิดการควบคุมความปลอดภัยและการรักษาความมั่นคงปลอดภัย แล้วเลือกโหมดการเข้าถึงที่ต้องการ

2. เตรียม CSV ที่มี GUID ของคอลเลกชันไซต์ หรือ ID ไซต์แบบสามส่วนของ Microsoft Graph ใช้รูปแบบตัวระบุเดียวกันตลอดทั้งไฟล์

3. เลือก อัปโหลดไฟล์ CSV แล้วเลือกไฟล์

4. ตรวจสอบผลการนำเข้าและรายการที่เลือก แก้ไขข้อผิดพลาดหรือคำเตือนของแถวต่างๆ ก่อนดำเนินการต่อ

5. เลือก บันทึก เพื่อใช้การเปลี่ยนแปลง แล้วตรวจสอบรายการที่บันทึกไว้

ข้อกำหนดและลักษณะการทำงานของ CSV:

• ขนาดไฟล์สูงสุด: 1 MB

• จะมีแถวหัวตารางหรือไม่ก็ได้

• ใช้ GUID ของคอลเลกชันหนึ่งค่าต่อแถว หรือใช้ ID ไซต์แบบสามส่วนของ Graph ค่าทั้งสามส่วนสามารถอยู่ในฟิลด์เดียวโดยครอบด้วยเครื่องหมายอัญประกาศ หรือแยกเป็นสามคอลัมน์ก็ได้

• ค่าทั้งสามส่วนของ Graph จะถูกแปลงเป็น GUID ของคอลเลกชัน การนำเข้าค่าแบบสามส่วนไม่ได้สร้างกฎที่เจาะจงเฉพาะไซต์

• การนำเข้าจะเพิ่มข้อมูลลงในรายการที่เลือกและคงข้อมูลเดิมไว้ คอลเลกชันที่ซ้ำกันจะถูกรวมเป็นรายการเดียว โดยจำนวนที่นำเข้าจะแสดงเฉพาะคอลเลกชันที่เพิ่มใหม่

• ระบบจะปฏิเสธรูปแบบที่ปะปนกันและแถวที่มีรูปแบบไม่ถูกต้อง หากอัปโหลดไฟล์ที่มีเพียง URL ของไซต์ ระบบจะแสดงคำเตือนและไม่เพิ่มไซต์ ค้นหา GUID ของคอลเลกชันจาก URL ก่อน

• การอัปโหลดจะเปลี่ยนเฉพาะรายการฉบับร่างเท่านั้น จะยังไม่อัปเดตการเข้าถึงของเวิร์กสเปซจนกว่าคุณจะเลือก บันทึก

• การอัปโหลด CSV ที่อธิบายไว้ที่นี่ใช้จัดการคอลเลกชันไซต์ ให้ตั้งค่าการยกเว้นตามป้ายกำกับระดับความลับแยกต่างหาก

หากคุณมี CSV ของ URL ของ SharePoint ขั้นตอนการใช้ CSV ของเครื่องมือ Cookbookสามารถค้นหาตัวระบุจาก URL เหล่านั้นและจัดการรายการอนุญาตผ่าน API ได้ ข้อมูลนำเข้า site_url หรือ url ของเครื่องมือนี้มีรูปแบบและขั้นตอนการใช้งานต่างจากการอัปโหลดตัวระบุใน UI

ทำความเข้าใจขีดจำกัดของนโยบายและคำขอ

ขีดจำกัดเริ่มต้นของนโยบายคือ 10,000 คอลเลกชันไซต์ ขีดจำกัดนโยบายของเวิร์กสเปซที่สูงขึ้น สูงสุด 120,000 คอลเลกชันไซต์ ต้องให้ OpenAI เปิดใช้งาน โปรดติดต่อทีม OpenAI ที่ดูแลคุณก่อนวางแผนใช้งานในขนาดที่ใหญ่ขึ้น

การเปลี่ยนแปลงผ่าน API แต่ละครั้งและสคริปต์ Cookbook เวอร์ชันปัจจุบันรองรับ GUID ของคอลเลกชันสูงสุด 10,000 ค่าต่อคำขอ การเพิ่มขีดจำกัดนโยบายของเวิร์กสเปซไม่ได้เพิ่มขีดจำกัดต่อคำขอนี้ ให้นับคอลเลกชันไซต์ที่ไม่ซ้ำกัน ไม่ใช่ URL ต้นทาง เพราะหลาย URL อาจอ้างถึงคอลเลกชันเดียวกัน

ใช้ Admin API ของเวิร์กสเปซ

ใช้ UUID ของเวิร์กสเปซและคีย์ผู้ดูแลระบบเวิร์กสเปซ ChatGPT กับ https://api.chatgpt.com

ดูคำสั่งจัดการรายการอนุญาตและตัวอย่างคำขอที่ได้รับการอัปเดตได้ใน Cookbook:

• อ่านรายการอนุญาตที่มีอยู่

• ดูตัวอย่างและเพิ่มคอลเลกชันไซต์ การเพิ่มจะคงคอลเลกชันที่อนุญาตอยู่แล้วไว้

• ลบคอลเลกชันไซต์

• ล้างรายการอนุญาต

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

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

ยกเว้นไฟล์ที่มีป้ายกำกับระดับความลับ

ค้นหา GUID ของป้ายกำกับ

ขอ GUID แบบเปลี่ยนแปลงไม่ได้ของป้ายกำกับที่ต้องการจากผู้ดูแลระบบ Microsoft 365 หรือ Purview ใช้ GUID ไม่ใช่ชื่อที่แสดงของป้ายกำกับ

ผู้ดูแลระบบสามารถเรียกดูรายการป้ายกำกับผ่าน Microsoft Graph ได้ โทเค็นต้องมีสิทธิ์ SensitivityLabel.Read หรือ SensitivityLabels.Read.All ตามกรณีที่ใช้งาน จับคู่ชื่อป้ายกำกับที่ต้องการกับ ID ของป้ายกำกับนั้น และตรวจสอบการตั้งค่าการป้องกัน

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

เพิ่มป้ายกำกับที่ต้องการยกเว้น

1. เปิดการควบคุมความปลอดภัยและการรักษาความมั่นคงปลอดภัยของแอป SharePoint

2. ป้อน GUID ของป้ายกำกับแต่ละรายการที่ไม่มีการเข้ารหัสในหัวข้อ ป้ายกำกับระดับความลับที่ยกเว้นโดยไม่มีการเข้ารหัส

3. บันทึกการตั้งค่าและทดสอบไฟล์ประเภทที่รองรับซึ่งมีป้ายกำกับที่ยกเว้น

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

ทดสอบการตั้งค่า

ใช้ไฟล์ทดสอบและบัญชีที่องค์กรของคุณอนุมัติ ก่อนทดสอบ ให้ยืนยันว่าบัญชี Microsoft เดียวกันนี้เข้าถึงไฟล์แต่ละไฟล์ใน SharePoint โดยตรงได้

1. ในโหมดไซต์ที่อนุญาตซึ่งมีรายการไม่ว่างเปล่า ให้ตรวจสอบไฟล์ในคอลเลกชันที่อนุญาตและไฟล์ในคอลเลกชันที่ไม่อยู่ในรายการ ควรเข้าถึงผ่านแอปได้เฉพาะคอลเลกชันที่อนุญาตเท่านั้น

2. ในโหมดไซต์ที่บล็อก ให้ตรวจสอบไฟล์ในคอลเลกชันที่บล็อกและไฟล์ในคอลเลกชันที่ไม่ถูกบล็อก คอลเลกชันที่บล็อกควรเข้าถึงไม่ได้ ส่วนคอลเลกชันที่ไม่ถูกบล็อกยังขึ้นอยู่กับสิทธิ์ของ Microsoft และการควบคุมอื่นๆ

3. ตรวจสอบไฟล์ทดสอบประเภทที่รองรับซึ่งมีป้ายกำกับระดับความลับที่ยกเว้น ไฟล์นั้นไม่ควรปรากฏในผลลัพธ์ของแอป

4. หลังจากเปลี่ยนแปลงผ่าน API ให้เปรียบเทียบรายการที่บันทึกใน UI กับนโยบายที่ API ส่งกลับมา

5. หลังอัปโหลด CSV ให้บันทึกการเปลี่ยนแปลงและเปิดหน้าการควบคุมอีกครั้ง เพื่อยืนยันว่าคอลเลกชันที่ต้องการยังอยู่ในรายการ

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

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

ทำความเข้าใจข้อจำกัด

• กฎคอลเลกชันครอบคลุมทั้งคอลเลกชันไซต์ ไม่สามารถจำกัดการเข้าถึงเฉพาะไซต์ย่อย โฟลเดอร์ หรือไฟล์ใดไฟล์หนึ่งได้

• ข้อจำกัดของไซต์ SharePoint ไม่ได้จำกัดการเข้าถึง OneDrive โดยอัตโนมัติ

• การกรองตามป้ายกำกับระดับความลับจะใช้ได้เฉพาะเมื่อ Microsoft Graph เปิดเผยเมทาดาทาของป้ายกำกับที่รองรับ ซึ่งรวมถึงเอกสาร Office, PDF และไฟล์ MP4 ที่รองรับ

• ประเภทไฟล์ที่ไม่รองรับป้ายกำกับระดับความลับ เช่น TXT และ CSV จะถือว่าไม่มีป้ายกำกับ ไฟล์เหล่านี้ยังเข้าถึงได้หากได้รับอนุญาตตามเงื่อนไขอื่น ข้อจำกัดด้านประเภทไฟล์นี้ไม่เกี่ยวกับการอัปโหลด CSV เพื่อตั้งค่าการเข้าถึงไซต์

• การอัปโหลด CSV และเครื่องมือตัวอย่างที่เผยแพร่สู่สาธารณะไม่สามารถตั้งค่าการยกเว้นตามป้ายกำกับระดับความลับได้ บทความนี้ไม่ได้อธิบาย API สำหรับจัดการป้ายกำกับจำนวนมาก

• แม้จะบันทึกนโยบายแล้วหรือได้รับผลลัพธ์สำเร็จจาก API ก็ยังต้องทดสอบการเข้าถึงด้วยบัญชีที่จะใช้งานจริง

ใช้เครื่องมือ Python สำหรับการดูแลระบบ

โค้ดและคำสั่งตัวอย่างฉบับเต็มได้รับการดูแลและอัปเดตใน OpenAI Cookbook:

• คู่มือการดูแลระบบ

• สคริปต์ Python สำหรับการดูแลระบบ

• ไฟล์ทดสอบแบบออฟไลน์

ใช้ Python 3.10 ขึ้นไป เครื่องมือนี้ใช้ไลบรารีมาตรฐานของ Python อ่านคู่มือก่อนเรียกใช้ และทดลองรันโดยไม่เปลี่ยนข้อมูลจริง (dry run) เพื่อตรวจสอบการเปลี่ยนแปลง

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

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

เครื่องมือนี้ไม่ได้เปิดใช้ฟีเจอร์ของเวิร์กสเปซหรือตรวจสอบว่ามีการบังคับใช้นโยบายจริง การทดสอบแบบออฟไลน์ของเครื่องมือนี้ใช้การเรียก Microsoft Graph และ ChatGPT Admin API แบบจำลอง

การเปลี่ยนแปลงที่ใช้หลายคำขอไม่ได้ทำงานแบบอะตอมมิก (สำเร็จทั้งหมดหรือไม่เปลี่ยนแปลงเลย) หากการลบหลายคอลเลกชันล้มเหลวระหว่างทาง การลบรายการก่อนหน้าอาจสำเร็จไปแล้ว อ่านนโยบายปัจจุบันก่อนลองอีกครั้ง

คำถามที่พบบ่อย

ตัวควบคุมไซต์ใช้แทนสิทธิ์ Microsoft หรือไม่

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

รายการอนุญาตที่ว่างเปล่าจะบล็อกทุกไซต์หรือไม่

ไม่ รายการอนุญาตที่ว่างเปล่าไม่ได้หมายถึง “บล็อกทั้งหมด” หากรายการบล็อกมีข้อมูล คอลเลกชันเหล่านั้นจะยังถูกบล็อกอยู่ เมื่อทั้งสองรายการไม่มีข้อมูล การเข้าถึงจะขึ้นอยู่กับสิทธิ์ Microsoft ของผู้ใช้และการควบคุมอื่นๆ ที่ตั้งค่าไว้

มีการบันทึกการเปลี่ยนแปลงผ่าน Admin API หรือไม่

การเปลี่ยนนโยบายผ่าน Admin API จะถูกบันทึกไว้ในบันทึกการตรวจสอบและการปฏิบัติตามข้อกำหนดของเวิร์กสเปซ