Gambaran keseluruhan

Pentadbir ruang kerja boleh menggunakan kawalan SharePoint untuk membenarkan koleksi tapak yang diluluskan, menyekat koleksi tapak terpilih dan mengecualikan fail yang disokong dengan label kepekaan Microsoft Purview terpilih.

Koleksi tapak SharePoint, juga dipanggil SPSite, boleh mengandungi berbilang tapak. Peraturan koleksi terpakai pada keseluruhan koleksi, tertakluk pada keizinan Microsoft sedia ada setiap pengguna. Peraturan ini tidak memberikan pengguna akses kepada kandungan yang tidak boleh diakses oleh mereka dalam Microsoft 365.

Sekatan tapak terpakai pada carian, pelayaran, pengambilan fail dan tindakan baca/tulis SharePoint yang disokong. Akses OneDrive diurus secara berasingan.

Pilih mod akses yang sepadan dengan dasar anda:

• Tapak dibenarkan: Apabila senarai dibenarkan tidak kosong, pengguna hanya boleh mengakses koleksi tapak yang disenaraikan melalui aplikasi.

• Tapak disekat: Pengguna boleh mengakses koleksi tapak selain yang terdapat dalam senarai sekatan, tertakluk pada keizinan Microsoft mereka.

Hanya satu senarai boleh mengandungi entri pada satu-satu masa. Senarai dibenarkan yang kosong tidak menyekat semua tapak. Apabila kedua-dua senarai kosong, sekatan tapak SharePoint dihapuskan; keizinan Microsoft dan kawalan lain yang dikonfigurasikan masih terpakai.

Ketersediaan

Kawalan dan API Pentadbir ruang kerja perlu didayakan untuk ruang kerja anda. Kawalan yang tersedia termasuk senarai koleksi tapak dibenarkan, senarai sekatan koleksi tapak, import tapak melalui CSV dan pengecualian label kepekaan.

Peraturan terpakai pada keseluruhan koleksi tapak. Kawalan koleksi tapak ini tidak merangkumi penetapan skop khusus untuk tapak individu, folder atau fail, mahupun penguatkuasaan Microsoft Sites.Selected.

Sebelum anda bermula

• Kenal pasti koleksi tapak yang organisasi anda mahu benarkan atau sekat.

• Dapatkan GUID setiap koleksi. ID tapak Microsoft Graph yang lengkap mengandungi GUID koleksi sebagai nilai tengahnya. API Pentadbir menggunakan GUID koleksi; pengimport CSV dalam UI juga boleh mengekstraknya daripada set tiga komponen ID tapak Graph.

• Dayakan keizinan Microsoft yang diperlukan oleh aplikasi SharePoint dalam kedua-dua tetapan keizinan ChatGPT dan Microsoft Entra, termasuk Sites.Read.All dan Files.Read.All. Kawalan ini menapis akses di pihak OpenAI; kawalan ini tidak menggantikan keizinan Microsoft yang diwakilkan.

• Untuk pengecualian label kepekaan, minta GUID yang tidak boleh diubah bagi setiap label tanpa penyulitan daripada pentadbir Microsoft 365 atau Purview anda.

• Untuk pentadbiran API, dapatkan UUID ruang kerja anda, kunci Pentadbir ruang kerja ChatGPT dan token Microsoft Graph jika anda perlu mendapatkan pengecam bagi URL SharePoint. Kedua-dua kelayakan ini mempunyai tujuan yang berbeza.

Tentang OpenAI Cookbook

OpenAI Cookbook ialah koleksi kod contoh dan panduan OpenAI yang tersedia kepada umum. Artikel ini menggunakan panduan akses tapak SharePoint dan skrip pentadbiran Python daripada koleksi tersebut, yang kedua-duanya dihoskan di GitHub. Anda boleh membuka pautan ini dalam pelayar untuk membaca fail tersebut. Untuk menjalankan skrip, muat turunnya dan ikuti arahan persediaan serta perintah dalam panduan.

Sepanjang artikel ini, “Cookbook” merujuk kepada panduan SharePoint tersebut, dan “utiliti Cookbook” merujuk kepada skrip Python yang dipautkan. Gunakan rujukan ini untuk contoh perintah dan pengurusan senarai dibenarkan berasaskan API.

Sediakan kelayakan untuk pentadbiran API

Nota: Anda perlu menjadi pentadbir ruang kerja untuk mencipta kunci pentadbir. Baca selanjutnya.

Cipta kunci pentadbir ruang kerja ChatGPT

1. Buka konsol pentadbir ChatGPT dan pilih ruang kerja yang dimaksudkan.

2. Pergi ke Kelayakan dan pilih Kunci pentadbir.

3. Cipta kunci dengan keizinan Terhad dan tetapkan Aplikasi kepada Tulis.

4. Simpan kunci itu dengan selamat. Kunci ini memberikan kebenaran untuk membaca dan mengubah dasar SharePoint bagi ruang kerja anda.

Keizinan yang diperlukan ialah chatgpt.enterprise.apps.write. Ambil perhatian bahawa kunci Platform API dan token Microsoft Graph tidak boleh menggantikan kunci Pentadbir ruang kerja ChatGPT.

Untuk maklumat lanjut, lihat: Mengurus kunci Pentadbir dalam tab Kelayakan. Untuk pemboleh ubah persekitaran kelayakan skrip dan contoh input selamat, lihat arahan kelayakan Cookbook.

Dapatkan token Microsoft Graph

Gunakan proses pengesahan Microsoft yang diluluskan oleh organisasi anda. Untuk carian interaktif, jika organisasi anda membenarkan Graph Explorer:

1. Buka Microsoft Graph Explorer dan log masuk dengan akaun kerja dalam penyewa yang mengandungi tapak SharePoint tersebut.

2. Pilih keizinan yang diperlukan untuk membaca tapak, biasanya Sites.Read.All, menggunakan Ubah keizinan atau Berikan persetujuan untuk keizinan. Minta pentadbir Microsoft anda meluluskan akses jika organisasi anda memerlukannya.

3. Buka tab Token akses dan salin token untuk digunakan dengan Microsoft Graph.

Untuk arahan Microsoft, lihat Menggunakan Graph Explorer.

Token Graph digunakan untuk mendapatkan pengecam yang sepadan dengan URL SharePoint. Kunci Pentadbir ChatGPT digunakan untuk membaca atau mengemas kini dasar ChatGPT. Utiliti Cookbook hanya memerlukan token Graph untuk perintah yang mendapatkan pengecam bagi URL; membaca atau mengosongkan senarai dibenarkan sedia ada hanya memerlukan kunci Pentadbir ChatGPT.

Jangan letakkan mana-mana kelayakan ini dalam kawalan sumber, dokumen dikongsi, tangkapan skrin atau log.

Cari GUID koleksi tapak

Gunakan URL tapak SharePoint

1. Buka tapak SharePoint semasa log masuk ke Microsoft dengan akaun yang boleh mengaksesnya.

2. Tambahkan /_api/site/id pada hujung URL tapak. Contohnya, gunakan https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Salin GUID yang dikembalikan dalam respons.

Nota: Domain dan pengecam contoh dalam artikel ini ialah pemegang tempat.

Gunakan Microsoft Graph

Microsoft Graph mengembalikan ID tapak dengan tiga komponen yang dipisahkan oleh koma: nama hos, GUID koleksi tapak dan GUID tapak. Gunakan nilai tengah untuk peraturan koleksi tapak. URL tapak yang berbeza boleh dipadankan dengan GUID koleksi yang sama.

Untuk contoh carian dan pengecam, lihat Memahami pengecam tapak SharePoint. Untuk mendapatkan pengecam bagi berbilang URL tanpa mengubah dasar ChatGPT, gunakan arahan pemeriksaan Cookbook dan skrip pentadbiran Python.

Untuk keperluan carian Microsoft, lihat Mendapatkan tapak SharePoint mengikut laluan.

Urus koleksi tapak yang dibenarkan dan disekat

Gunakan kawalan ruang kerja

1. Buka Kawalan Keselamatan & Perlindungan aplikasi SharePoint dalam ruang kerja anda.

2. Di bawah Mod akses, pilih Tapak dibenarkan atau Tapak disekat.

3. Tambahkan koleksi tapak pada senarai yang dipilih. Anda juga boleh menggunakan muat naik CSV yang diterangkan di bawah.

4. Semak perubahan anda dan pilih Simpan.

5. Semak dasar yang disimpan dan uji konfigurasi anda.

Tapak yang ditambahkan melalui API Pentadbir muncul dalam kawalan ruang kerja. Tapak yang ditambahkan dalam UI juga tersedia melalui API. Anda boleh menambah atau membuang entri melalui mana-mana antara muka; tapak tidak terikat pada kaedah yang digunakan untuk menambahkannya.

Beralih antara tapak dibenarkan dan tapak disekat

Hanya satu senarai boleh mengandungi entri pada satu-satu masa. Sebelum menambahkan entri dalam mod yang satu lagi, kosongkan senarai sedia ada dan simpan perubahan itu. Kemudian pilih mod yang satu lagi, tambahkan koleksi yang dimaksudkan dan simpan sekali lagi.


Mengosongkan senarai aktif akan mengubah akses serta-merta apabila disimpan. Mengosongkan senarai dibenarkan akan menghapuskan sekatan tapaknya; mengosongkan senarai sekatan akan menghapuskan sekatan yang dikenakannya. Rancang peralihan bersama pentadbir lain kerana tempoh antara mengosongkan satu senarai dengan menyimpan senarai yang satu lagi mungkin membenarkan akses yang akan disekat oleh dasar akhir anda.

Muat naik koleksi tapak daripada CSV

Muat naik CSV hanya menyokong koleksi tapak. Untuk mengecualikan fail mengikut label kepekaan, tambahkan GUID label di bawah Label kepekaan tanpa penyulitan yang dikecualikan.

1. Buka Kawalan Keselamatan & Perlindungan dan pilih Mod akses yang dikehendaki.

2. Sediakan CSV yang mengandungi GUID koleksi tapak atau set tiga komponen ID tapak Microsoft Graph. Gunakan satu format pengecam untuk keseluruhan fail.

3. Pilih Muat naik fail CSV dan pilih fail.

4. Semak hasil import dan senarai yang dipilih. Selesaikan sebarang ralat atau amaran baris sebelum meneruskan.

5. Pilih Simpan untuk menggunakan perubahan, kemudian semak senarai yang disimpan.

Keperluan dan cara CSV berfungsi:

• Saiz fail maksimum: 1 MB.

• Pengepala adalah pilihan.

• Gunakan satu GUID koleksi bagi setiap baris, atau set tiga komponen ID tapak Graph. Set tiga komponen boleh diletakkan dalam tanda petikan dalam satu medan atau dipisahkan kepada tiga lajur.

• Set tiga komponen Graph ditukar kepada GUID koleksi. Mengimport set tiga komponen tidak mewujudkan peraturan untuk satu tapak khusus.

• Import menambah entri pada senarai yang dipilih dan mengekalkan entri sedia ada. Koleksi pendua dinyahgandakan; kiraan import melaporkan koleksi yang baru ditambahkan.

• Format bercampur dan baris dengan format tidak sah ditolak. Muat naik yang hanya mengandungi URL tapak akan memaparkan amaran dan tidak menambahkan tapak. Dapatkan GUID koleksi yang sepadan dengan URL terlebih dahulu.

• Muat naik hanya mengubah senarai draf. Muat naik tidak mengemas kini akses ruang kerja sehingga anda memilih Simpan.

• Muat naik CSV yang diterangkan di sini mengurus koleksi tapak. Konfigurasikan pengecualian label kepekaan secara berasingan.

Jika anda mempunyai CSV yang mengandungi URL SharePoint, aliran kerja CSV utiliti Cookbook boleh mendapatkan pengecam yang sepadan dan mengurus senarai dibenarkan melalui API. Input site_url atau url utiliti ini menggunakan format dan aliran kerja yang berbeza daripada muat naik pengecam dalam UI.

Fahami had dasar dan permintaan

Had dasar lalai ialah 10,000 koleksi tapak. Had dasar ruang kerja yang lebih tinggi, sehingga 120,000 koleksi tapak, perlu didayakan oleh OpenAI; hubungi pasukan OpenAI anda sebelum merancang pelaksanaan yang lebih besar.

Mutasi API individu dan skrip Cookbook semasa menerima sehingga 10,000 GUID koleksi bagi setiap permintaan. Had dasar ruang kerja yang lebih tinggi tidak menaikkan had bagi setiap permintaan ini. Kira koleksi tapak yang unik, bukan URL sumber: berbilang URL boleh merujuk kepada koleksi yang sama.

Gunakan API Pentadbir ruang kerja

Gunakan UUID ruang kerja dan kunci Pentadbir ruang kerja ChatGPT anda dengan https://api.chatgpt.com.

Untuk arahan senarai dibenarkan dan contoh permintaan yang diselenggara, gunakan Cookbook:

• Baca senarai dibenarkan sedia ada.

• Pratonton dan tambah koleksi tapak. Penambahan mengekalkan koleksi sedia ada yang dibenarkan.

• Buang koleksi tapak.

• Kosongkan senarai dibenarkan.

Semak dasar semasa sebelum membuat perubahan, kemudian baca semula dan uji akses yang terhasil. Membuang koleksi terakhir yang dibenarkan atau mengosongkan senarai dibenarkan akan menghapuskan sekatan tapak tersebut. Jangan hantar permintaan penambahan kosong melainkan anda mahu menghapuskan sekatan senarai dibenarkan.

Utiliti Cookbook awam pada masa ini mengurus senarai dibenarkan sahaja. Utiliti ini tidak mengurus senarai sekatan atau pengecualian label kepekaan. Gunakan kawalan ruang kerja yang diterangkan di atas untuk tugas tersebut.

Kecualikan fail dengan label kepekaan

Cari GUID label

Minta GUID yang tidak boleh diubah bagi label yang dimaksudkan daripada pentadbir Microsoft 365 atau Purview anda. Gunakan GUID, bukan nama paparannya.

Pentadbir boleh menyenaraikan label melalui Microsoft Graph. Token memerlukan keizinan SensitivityLabel.Read atau SensitivityLabels.Read.All yang berkenaan. Padankan nama label yang dimaksudkan dengan IDnya dan semak tetapan perlindungannya.

Untuk keperluan dan contoh, lihat Menyenaraikan label kepekaan dan Sifat label kepekaan. Keizinan label ini berasingan daripada keizinan membaca tapak yang digunakan untuk mendapatkan pengecam bagi URL SharePoint.

Tambahkan pengecualian label

1. Buka Kawalan Keselamatan & Perlindungan aplikasi SharePoint.

2. Masukkan GUID setiap label tanpa penyulitan di bawah Label kepekaan tanpa penyulitan yang dikecualikan.

3. Simpan konfigurasi dan uji fail yang disokong dengan label yang dikecualikan.

Fail dengan label yang disokong dan sepadan dikecualikan daripada hasil aplikasi SharePoint. Fail dengan label yang menggunakan penyulitan sudah dikecualikan secara lalai.

Uji konfigurasi anda

Gunakan fail dan akaun ujian yang diluluskan oleh organisasi anda. Sebelum menguji, pastikan akaun Microsoft yang sama boleh mengakses setiap fail secara langsung dalam SharePoint.

1. Dalam mod Tapak dibenarkan dengan senarai yang tidak kosong, semak satu fail dalam koleksi yang dibenarkan dan satu fail dalam koleksi yang tidak disenaraikan. Hanya koleksi yang dibenarkan sepatutnya boleh diakses melalui aplikasi.

2. Dalam mod Tapak disekat, semak satu fail dalam koleksi yang disekat dan satu fail dalam koleksi yang tidak disekat. Koleksi yang disekat sepatutnya tidak boleh diakses; koleksi yang tidak disekat masih tertakluk pada keizinan Microsoft dan kawalan lain.

3. Semak fail ujian yang disokong dengan label kepekaan yang dikecualikan. Fail itu sepatutnya tidak muncul dalam hasil aplikasi.

4. Selepas perubahan melalui API, bandingkan senarai yang disimpan dalam UI dengan dasar yang dikembalikan oleh API.

5. Selepas memuat naik CSV, simpan perubahan dan buka semula kawalan untuk memastikan koleksi yang dimaksudkan dikekalkan.

Jika hasil berbeza daripada dasar yang dimaksudkan, semak ruang kerja, mod akses yang dipilih, senarai yang disimpan, GUID koleksi, GUID label, jenis fail yang disokong dan keizinan Microsoft pengguna. Jangan kosongkan senarai sebagai langkah penyelesaian masalah melainkan anda memang mahu perubahan akses yang terhasil.

Untuk bantuan tentang kawalan yang tiada atau akses yang tidak dijangka, lihat: Menghubungi Sokongan OpenAI. Jangan sertakan kunci Pentadbir atau token Microsoft Graph dalam permintaan sokongan anda.

Fahami batasan

• Peraturan koleksi meliputi keseluruhan koleksi tapak. Peraturan ini tidak boleh mengehadkan akses kepada subtapak, folder atau fail tertentu.

• Sekatan tapak SharePoint tidak menyekat akses OneDrive secara automatik.

• Penapisan label kepekaan hanya terpakai apabila Microsoft Graph menyediakan metadata label yang disokong, termasuk untuk dokumen Office, fail PDF dan MP4 yang disokong.

• Jenis fail yang tidak menyokong label kepekaan, seperti fail TXT dan CSV, dianggap tidak berlabel. Fail ini masih boleh diakses jika dibenarkan oleh tetapan lain. Batasan jenis fail ini tidak berkaitan dengan muat naik CSV untuk mengkonfigurasi akses tapak.

• Muat naik CSV dan utiliti contoh awam tidak mengkonfigurasi pengecualian label kepekaan. Artikel ini tidak mendokumentasikan API pengurusan label secara pukal.

• Dasar yang disimpan atau respons API yang berjaya tidak menggantikan keperluan untuk menguji akses menggunakan akaun yang dimaksudkan.

Gunakan utiliti pentadbiran Python

Kod dan arahan contoh yang lengkap diselenggara dalam OpenAI Cookbook:

• Panduan pentadbiran.

• Skrip pentadbiran Python.

• Fail ujian luar talian.

Gunakan Python 3.10 atau lebih baharu. Utiliti ini menggunakan pustaka standard Python. Baca panduan sebelum menjalankannya dan gunakan simulasi untuk menyemak perubahan.

Utiliti semasa membaca kelayakan daripada pemboleh ubah persekitaran; ikuti arahan input selamat dalam panduan. Pengesahan jelas diperlukan untuk mengosongkan senarai dibenarkan. Pembuangan boleh dilaksanakan tanpa pengesahan tersebut, jadi semak pembuangan melalui simulasi terlebih dahulu.

Untuk cara percubaan semula berfungsi dan kunci idempotensi pilihan, lihat Mencuba semula kemas kini dasar dengan selamat. Gunakan kunci idempotensi hanya apabila ruang kerja menyokongnya, dan periksa dasar semasa selepas kegagalan yang tidak jelas.

Utiliti ini tidak mendayakan ciri ruang kerja atau mengesahkan penguatkuasaan. Ujian luar taliannya menggunakan panggilan Microsoft Graph dan API Pentadbir ChatGPT yang disimulasikan.

Perubahan yang melibatkan berbilang permintaan tidak bersifat atomik. Jika pembuangan berbilang koleksi gagal di pertengahan proses, pembuangan terdahulu mungkin sudah berjaya. Baca dasar semasa sebelum mencuba semula.

Soalan lazim

Adakah kawalan tapak menggantikan keizinan Microsoft?

Tidak. Aplikasi masih menggunakan keizinan Microsoft setiap pengguna. OpenAI menggunakan penapisan tapak yang dikonfigurasikan sebelum respons ditunjukkan kepada pengguna dan model.

Adakah senarai dibenarkan yang kosong menyekat semua tapak?

Tidak. Senarai dibenarkan yang kosong tidak bermaksud “sekat semua”. Jika senarai sekatan mengandungi entri, koleksi tersebut kekal disekat. Apabila kedua-dua senarai tidak mengandungi entri, keizinan Microsoft pengguna dan kawalan lain yang dikonfigurasikan menentukan akses.

Adakah perubahan API Pentadbir dilog?

Perubahan dasar melalui API Pentadbir direkodkan melalui pengelogan audit dan pematuhan ruang kerja.