Ringkasan
Administrator workspace dapat menggunakan kontrol SharePoint untuk mengizinkan kumpulan situs yang disetujui, memblokir kumpulan situs tertentu, dan mengecualikan file yang didukung dengan label sensitivitas Microsoft Purview tertentu.
Kumpulan situs SharePoint, yang juga disebut SPSite, dapat berisi beberapa situs. Aturan kumpulan berlaku untuk seluruh kumpulan, dengan tetap tunduk pada izin Microsoft yang dimiliki setiap pengguna. Aturan ini tidak memberi pengguna akses ke konten yang tidak dapat mereka akses di Microsoft 365.
Pembatasan situs berlaku untuk pencarian, penelusuran, pengambilan file, serta tindakan baca/tulis SharePoint yang didukung. Akses OneDrive dikelola secara terpisah.
Pilih mode akses yang sesuai dengan kebijakan Anda:
Situs yang diizinkan: Jika daftar izin tidak kosong, pengguna hanya dapat mengakses kumpulan situs yang tercantum melalui aplikasi.
Situs yang diblokir: Pengguna dapat mengakses kumpulan situs selain yang tercantum dalam daftar blokir, dengan tetap tunduk pada izin Microsoft mereka.
Hanya satu daftar yang boleh berisi entri pada satu waktu. Daftar izin yang kosong tidak memblokir semua situs. Jika kedua daftar kosong, pembatasan situs SharePoint dihapus; izin Microsoft dan kontrol lain yang dikonfigurasi tetap berlaku.
Ketersediaan
Kontrol dan API Admin workspace harus diaktifkan untuk workspace Anda. Kontrol yang tersedia meliputi daftar izin kumpulan situs, daftar blokir kumpulan situs, impor situs melalui CSV, dan pengecualian berdasarkan label sensitivitas.
Aturan berlaku untuk seluruh kumpulan situs. Pembatasan khusus untuk satu situs, folder, atau file tertentu serta penerapan Microsoft Sites.Selected tidak termasuk dalam kontrol kumpulan situs ini.
Sebelum memulai
Identifikasi kumpulan situs yang ingin diizinkan atau diblokir oleh organisasi Anda.
Dapatkan GUID setiap kumpulan. ID situs Microsoft Graph lengkap memuat GUID kumpulan sebagai nilai di tengahnya. API Admin menggunakan GUID kumpulan; pengimpor CSV di UI juga dapat mengekstraknya dari tripel ID situs Graph.
Aktifkan izin Microsoft yang diperlukan aplikasi SharePoint di pengaturan izin ChatGPT maupun Microsoft Entra, termasuk
Sites.Read.AlldanFiles.Read.All. Kontrol ini memfilter akses di sisi OpenAI; kontrol ini tidak menggantikan izin yang didelegasikan Microsoft.Untuk pengecualian berdasarkan label sensitivitas, mintalah GUID tetap dari setiap label tanpa enkripsi kepada administrator Microsoft 365 atau Purview Anda.
Untuk administrasi melalui API, dapatkan UUID workspace Anda, kunci Admin workspace ChatGPT, dan token Microsoft Graph jika Anda perlu mencari pengenal dari URL SharePoint. Kedua kredensial tersebut memiliki fungsi yang berbeda.
Tentang OpenAI Cookbook
OpenAI Cookbook adalah kumpulan contoh kode dan panduan OpenAI yang tersedia untuk umum. Artikel ini menggunakan panduan akses situs SharePoint dan skrip administrasi Python dari Cookbook, yang keduanya tersedia di GitHub. Anda dapat membuka tautan ini di browser untuk membaca file tersebut. Untuk menjalankan skrip, unduh skrip tersebut dan ikuti petunjuk penyiapan dan perintah dalam panduan.
Di seluruh artikel ini, “Cookbook” merujuk pada panduan SharePoint tersebut, dan “utilitas Cookbook” merujuk pada skrip Python yang ditautkan. Gunakan referensi ini untuk contoh perintah dan pengelolaan daftar izin berbasis API.
Siapkan kredensial untuk administrasi melalui API
Catatan: Anda harus menjadi administrator workspace agar dapat membuat kunci admin. Baca selengkapnya.
Buat kunci admin workspace ChatGPT
Buka konsol admin ChatGPT dan pilih workspace yang dituju.
Buka Kredensial dan pilih Kunci admin.
Buat kunci dengan izin Terbatas dan atur Aplikasi ke Tulis.
Simpan kunci dengan aman. Kunci ini memberikan izin untuk membaca dan mengubah kebijakan SharePoint untuk workspace Anda.
Izin yang diperlukan adalah chatgpt.enterprise.apps.write. Perlu diketahui bahwa kunci Platform API dan token Microsoft Graph tidak dapat menggantikan kunci Admin workspace ChatGPT.
Untuk informasi selengkapnya, lihat: Mengelola kunci Admin di tab Kredensial. Untuk variabel lingkungan kredensial skrip dan contoh cara memasukkannya dengan aman, lihat petunjuk kredensial di Cookbook.
Dapatkan token Microsoft Graph
Gunakan proses autentikasi Microsoft yang disetujui organisasi Anda. Untuk pencarian interaktif, jika organisasi Anda mengizinkan Graph Explorer:
Buka Microsoft Graph Explorer dan masuk dengan akun kerja di tenant yang berisi situs SharePoint tersebut.
Pilih izin yang diperlukan untuk membaca situs, biasanya
Sites.Read.All, menggunakan Ubah izin atau Setujui izin. Minta administrator Microsoft Anda menyetujui akses jika organisasi Anda mewajibkannya.Buka tab Token akses dan salin token untuk digunakan dengan Microsoft Graph.
Untuk petunjuk Microsoft, lihat Menggunakan Graph Explorer.
Token Graph digunakan untuk mendapatkan pengenal dari URL SharePoint. Kunci Admin ChatGPT digunakan untuk membaca atau memperbarui kebijakan ChatGPT. Utilitas Cookbook hanya memerlukan token Graph untuk perintah yang mencari pengenal dari URL; membaca atau mengosongkan daftar izin yang ada hanya memerlukan kunci Admin ChatGPT.
Jangan simpan kedua kredensial tersebut dalam sistem kontrol versi, dokumen bersama, tangkapan layar, atau log.
Temukan GUID kumpulan situs
Gunakan URL situs SharePoint
Buka situs SharePoint setelah masuk ke Microsoft dengan akun yang dapat mengaksesnya.
Tambahkan
/_api/site/iddi akhir URL situs. Misalnya, gunakanhttps://contoso.sharepoint.com/sites/Finance/_api/site/id.Salin GUID yang dikembalikan dalam respons.
Catatan: Contoh domain dan pengenal dalam artikel ini hanyalah placeholder.
Gunakan Microsoft Graph
Microsoft Graph mengembalikan ID situs dengan tiga komponen yang dipisahkan koma: nama host, GUID kumpulan situs, dan GUID situs. Gunakan nilai di tengah untuk aturan kumpulan situs. URL situs yang berbeda dapat merujuk ke GUID kumpulan yang sama.
Untuk contoh pencarian dan pengenal, lihat Memahami pengenal situs SharePoint. Untuk mendapatkan pengenal dari beberapa URL tanpa mengubah kebijakan ChatGPT, gunakan petunjuk pemeriksaan di Cookbook dan skrip administrasi Python.
Untuk persyaratan pencarian Microsoft, lihat Mendapatkan situs SharePoint berdasarkan jalur.
Kelola kumpulan situs yang diizinkan dan diblokir
Gunakan kontrol workspace
Buka Kontrol Keselamatan & Keamanan aplikasi SharePoint di workspace Anda.
Di bagian Mode akses, pilih Situs yang diizinkan atau Situs yang diblokir.
Tambahkan kumpulan situs ke daftar yang dipilih. Anda juga dapat menggunakan unggahan CSV yang dijelaskan di bawah ini.
Tinjau perubahan Anda dan pilih Simpan.
Periksa kebijakan yang tersimpan dan uji konfigurasi Anda.
Situs yang ditambahkan melalui API Admin muncul di kontrol workspace. Situs yang ditambahkan di UI juga tersedia melalui API. Anda dapat menambahkan atau menghapus entri melalui salah satu antarmuka; situs tidak harus dikelola dengan metode yang sama seperti saat ditambahkan.
Beralih antara situs yang diizinkan dan diblokir
Hanya satu daftar yang boleh berisi entri pada satu waktu. Sebelum menambahkan entri dalam mode lainnya, kosongkan daftar yang ada dan simpan perubahan tersebut. Lalu pilih mode lainnya, tambahkan kumpulan yang dituju, dan simpan lagi.
Mengosongkan daftar aktif akan langsung mengubah akses saat disimpan. Mengosongkan daftar izin menghapus pembatasan situsnya; mengosongkan daftar blokir menghapus pemblokirannya. Rencanakan peralihan bersama admin lain karena jeda antara mengosongkan satu daftar dan menyimpan daftar lainnya dapat mengizinkan akses yang nantinya dibatasi oleh kebijakan akhir Anda.
Unggah kumpulan situs dari CSV
Unggahan CSV hanya mendukung kumpulan situs. Untuk mengecualikan file berdasarkan label sensitivitas, tambahkan GUID label di bagian Label sensitivitas tanpa enkripsi yang dikecualikan.
Buka Kontrol Keselamatan & Keamanan dan pilih Mode akses yang diinginkan.
Siapkan CSV berisi GUID kumpulan situs atau tripel ID situs Microsoft Graph. Gunakan satu format pengenal di seluruh file.
Pilih Unggah file CSV dan pilih file.
Tinjau hasil impor dan daftar yang dipilih. Atasi semua kesalahan atau peringatan pada baris sebelum melanjutkan.
Pilih Simpan untuk menerapkan perubahan, lalu periksa daftar yang tersimpan.
Persyaratan dan perilaku CSV:
Ukuran file maksimum: 1 MB.
Header bersifat opsional.
Gunakan satu GUID kumpulan per baris, atau tripel ID situs Graph. Tripel dapat diapit tanda kutip dalam satu bidang atau dipisahkan ke dalam tiga kolom.
Tripel Graph dikonversi menjadi GUID kumpulan. Mengimpor tripel tidak membuat aturan yang hanya berlaku untuk satu situs tertentu.
Impor menambahkan entri ke daftar yang dipilih dan mempertahankan entri yang sudah ada. Duplikat kumpulan dihapus; jumlah impor menunjukkan kumpulan yang baru ditambahkan.
Format campuran dan baris yang formatnya salah akan ditolak. Unggahan yang hanya berisi URL situs akan menampilkan peringatan dan tidak menambahkan situs. Dapatkan GUID kumpulan dari URL terlebih dahulu.
Unggahan hanya mengubah draf daftar. Unggahan tidak memperbarui akses workspace hingga Anda memilih Simpan.
Unggahan CSV yang dijelaskan di sini digunakan untuk mengelola kumpulan situs. Konfigurasikan pengecualian berdasarkan label sensitivitas secara terpisah.
Jika Anda memiliki CSV berisi URL SharePoint, alur kerja CSV utilitas Cookbook dapat mencari pengenalnya dan mengelola daftar izin melalui API. Input site_url atau url utilitas ini menggunakan format dan alur kerja yang berbeda dari unggahan pengenal di UI.
Pahami batas kebijakan dan permintaan
Batas kebijakan default adalah 10.000 kumpulan situs. Batas kebijakan workspace yang lebih tinggi, hingga 120.000 kumpulan situs, harus diaktifkan oleh OpenAI; hubungi tim OpenAI Anda sebelum merencanakan penerapan berskala lebih besar.
Setiap mutasi API dan skrip Cookbook saat ini menerima hingga 10.000 GUID kumpulan per permintaan. Batas kebijakan workspace yang lebih tinggi tidak menaikkan batas per permintaan ini. Hitung kumpulan situs yang unik, bukan URL sumber: beberapa URL dapat merujuk ke kumpulan yang sama.
Gunakan API Admin workspace
Gunakan UUID workspace dan kunci Admin workspace ChatGPT Anda dengan https://api.chatgpt.com.
Untuk perintah daftar izin dan contoh permintaan yang terus dipelihara, gunakan Cookbook:
Melihat pratinjau dan menambahkan kumpulan situs. Penambahan mempertahankan kumpulan yang sudah diizinkan.
Tinjau kebijakan saat ini sebelum membuat perubahan, lalu baca kembali dan uji akses yang dihasilkan. Menghapus kumpulan terakhir yang diizinkan atau mengosongkan daftar izin akan menghapus pembatasan situs tersebut. Jangan kirim permintaan penambahan kosong kecuali Anda memang ingin menghapus pembatasan daftar izin.
Utilitas Cookbook yang tersedia untuk umum saat ini mengelola daftar izin saja. Utilitas ini tidak mengelola daftar blokir atau pengecualian berdasarkan label sensitivitas. Gunakan kontrol workspace yang dijelaskan di atas untuk tugas tersebut.
Kecualikan file dengan label sensitivitas
Temukan GUID label
Mintalah GUID tetap dari label yang dituju kepada administrator Microsoft 365 atau Purview Anda. Gunakan GUID, bukan nama tampilannya.
Administrator dapat melihat daftar label melalui Microsoft Graph. Token memerlukan izin SensitivityLabel.Read atau SensitivityLabels.Read.All yang sesuai. Cocokkan nama label yang dituju dengan ID-nya dan periksa pengaturan perlindungannya.
Untuk persyaratan dan contoh, lihat Melihat daftar label sensitivitas dan Properti label sensitivitas. Izin label ini terpisah dari izin baca situs yang digunakan untuk mencari pengenal dari URL SharePoint.
Tambahkan pengecualian label
Buka Kontrol Keselamatan & Keamanan aplikasi SharePoint.
Masukkan GUID setiap label tanpa enkripsi di bagian Label sensitivitas tanpa enkripsi yang dikecualikan.
Simpan konfigurasi dan uji file yang didukung dengan label yang dikecualikan.
File dengan label yang didukung dan cocok dengan daftar pengecualian akan dikecualikan dari hasil aplikasi SharePoint. File dengan label yang menerapkan enkripsi sudah dikecualikan secara default.
Uji konfigurasi Anda
Gunakan file dan akun pengujian yang disetujui organisasi Anda. Sebelum menguji, pastikan akun Microsoft yang sama dapat mengakses setiap file langsung di SharePoint.
Dalam mode Situs yang diizinkan dengan daftar yang tidak kosong, periksa satu file dalam kumpulan yang diizinkan dan satu file dalam kumpulan yang tidak tercantum. Hanya kumpulan yang diizinkan yang seharusnya dapat diakses melalui aplikasi.
Dalam mode Situs yang diblokir, periksa satu file dalam kumpulan yang diblokir dan satu file dalam kumpulan yang tidak diblokir. Kumpulan yang diblokir seharusnya tidak dapat diakses; kumpulan yang tidak diblokir tetap tunduk pada izin Microsoft dan kontrol lainnya.
Periksa file pengujian yang didukung dan memiliki label sensitivitas yang dikecualikan. File tersebut seharusnya tidak muncul dalam hasil aplikasi.
Setelah perubahan melalui API, bandingkan daftar yang tersimpan di UI dengan kebijakan yang dikembalikan oleh API.
Setelah mengunggah CSV, simpan perubahan dan buka kembali kontrol untuk memastikan kumpulan yang dituju tetap tercantum.
Jika hasilnya tidak sesuai dengan kebijakan yang diinginkan, periksa workspace, mode akses yang dipilih, daftar yang tersimpan, GUID kumpulan, GUID label, jenis file yang didukung, dan izin Microsoft pengguna. Jangan mengosongkan daftar sebagai langkah pemecahan masalah kecuali Anda memang menginginkan perubahan akses yang dihasilkan.
Untuk bantuan terkait kontrol yang tidak tersedia atau akses yang tidak sesuai harapan, lihat: Menghubungi Dukungan OpenAI. Jangan sertakan kunci Admin atau token Microsoft Graph dalam permintaan dukungan Anda.
Pahami batasannya
Aturan kumpulan mencakup seluruh kumpulan situs. Aturan ini tidak dapat membatasi akses ke subsitus, folder, atau file tertentu.
Pembatasan situs SharePoint tidak otomatis membatasi akses OneDrive.
Pemfilteran label sensitivitas hanya berlaku jika Microsoft Graph menyediakan metadata label yang didukung, termasuk untuk dokumen Office, PDF, dan file MP4 yang didukung.
Jenis file yang tidak mendukung label sensitivitas, seperti file TXT dan CSV, dianggap tidak berlabel. File tersebut tetap dapat diakses jika diizinkan oleh ketentuan lainnya. Batasan jenis file ini terpisah dari pengunggahan CSV untuk mengonfigurasi akses situs.
Unggahan CSV dan utilitas contoh yang tersedia untuk umum tidak mengonfigurasi pengecualian berdasarkan label sensitivitas. Artikel ini tidak mendokumentasikan API pengelolaan label secara massal.
Kebijakan yang tersimpan atau respons API yang berhasil tidak menggantikan pengujian akses dengan akun yang dituju.
Gunakan utilitas administrasi Python
Contoh kode dan perintah lengkap tersedia dan dipelihara di OpenAI Cookbook:
Gunakan Python 3.10 atau yang lebih baru. Utilitas ini menggunakan pustaka standar Python. Baca panduan sebelum menjalankannya dan gunakan simulasi untuk meninjau perubahan.
Utilitas saat ini membaca kredensial dari variabel lingkungan; ikuti petunjuk dalam panduan untuk memasukkannya dengan aman. Utilitas ini memerlukan konfirmasi eksplisit untuk mengosongkan daftar izin. Penghapusan dapat dijalankan tanpa konfirmasi tersebut, jadi tinjau penghapusan melalui simulasi terlebih dahulu.
Untuk perilaku percobaan ulang dan kunci idempotensi opsional, lihat Mencoba ulang pembaruan kebijakan dengan aman. Gunakan kunci idempotensi hanya jika workspace mendukungnya, dan periksa kebijakan saat ini setelah terjadi kegagalan yang hasilnya tidak jelas.
Utilitas ini tidak mengaktifkan fitur workspace atau memverifikasi penerapan kebijakan. Pengujian offline utilitas ini menggunakan panggilan tiruan ke Microsoft Graph dan API Admin ChatGPT.
Perubahan yang melibatkan beberapa permintaan tidak bersifat atomik. Jika penghapusan beberapa kumpulan gagal di tengah proses, penghapusan sebelumnya mungkin sudah berhasil. Baca kebijakan saat ini sebelum mencoba lagi.
Pertanyaan umum
Apakah kontrol situs menggantikan izin Microsoft?
Tidak. Aplikasi tetap menggunakan izin Microsoft setiap pengguna. OpenAI menerapkan pemfilteran situs yang dikonfigurasi sebelum respons ditampilkan kepada pengguna dan model.
Apakah daftar izin yang kosong memblokir semua situs?
Tidak. Daftar izin yang kosong tidak berarti “blokir semua”. Jika daftar blokir berisi entri, kumpulan tersebut tetap diblokir. Jika kedua daftar tidak berisi entri, akses ditentukan oleh izin Microsoft pengguna dan kontrol lain yang dikonfigurasi.
Apakah perubahan melalui API Admin dicatat?
Perubahan kebijakan melalui API Admin dicatat melalui log audit dan kepatuhan workspace.