Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Mengurus akses tapak SharePoint dan pengecualian label kepekaan

Ketahui cara mengurus akses tapak SharePoint dan mengecualikan fail yang disokong dengan label kepekaan terpilih dalam ChatGPT.

Dikemas kini: 27 days ago

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 ingin dibenarkan atau disekat oleh organisasi anda.

  • 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 tetapan keizinan ChatGPT dan juga Microsoft Entra, termasuk Sites.Read.All dan Files.Read.All. Kawalan ini menapis akses di pihak OpenAI; kawalan ini tidak menggantikan keizinan yang diwakilkan oleh Microsoft.

  • Untuk pengecualian label sensitiviti, minta pentadbir Microsoft 365 atau Purview anda memberikan GUID yang tidak boleh diubah bagi setiap label yang ingin anda kecualikan, termasuk label yang menggunakan penyulitan.

  • Untuk pentadbiran API, dapatkan UUID ruang kerja anda, kunci Pentadbir ruang kerja ChatGPT dan token Microsoft Graph jika anda perlu mendapatkan GUID yang sepadan dengan URL SharePoint. Kedua-dua bukti 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 & Sekuriti aplikasi SharePoint dalam ruang kerja anda.

  2. Di bawah Mod akses, pilih Tapak yang dibenarkan atau Tapak yang 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 mengalih keluar entri melalui UI atau API; kaedah yang digunakan untuk menambah tapak tidak mengehadkan pengurusannya kepada kaedah itu sahaja.

Beralih antara tapak yang dibenarkan dengan tapak yang disekat

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


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

Muat naik koleksi tapak daripada CSV

Muat naik CSV hanya menyokong koleksi tapak. Untuk mengecualikan fail mengikut label sensitiviti, tambahkan GUID label pada senarai pengecualian label sensitiviti.

  1. Buka Kawalan Keselamatan & Sekuriti 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 sahaja dalam seluruh 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 import 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 diapit 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 tapak khusus tersebut.

  • 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 yang tidak mengikut format ditolak. Muat naik yang hanya mengandungi URL tapak memaparkan amaran dan tidak menambah 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 sensitiviti secara berasingan.

Jika anda mempunyai CSV yang mengandungi URL SharePoint, aliran kerja CSV utiliti Cookbook boleh mendapatkan GUID 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.

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

Gunakan API Pentadbir ruang kerja

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

Untuk arahan senarai dibenarkan dan contoh permintaan yang sentiasa dikemas kini, gunakan Cookbook:

Semak dasar semasa sebelum membuat perubahan, kemudian baca semula dasar itu dan uji akses yang terhasil. Mengalih keluar koleksi dibenarkan yang terakhir atau mengosongkan senarai dibenarkan menghapuskan had akses tapak tersebut. Jangan hantar permintaan tambah yang kosong melainkan anda berniat untuk menghapuskan had akses senarai dibenarkan.

Utiliti Cookbook awam pada masa ini mengurus senarai dibenarkan sahaja. Utiliti ini tidak mengurus senarai sekatan atau pengecualian label sensitiviti. 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.

Tambah pengecualian label

  1. Buka Kawalan Keselamatan & Sekuriti aplikasi SharePoint.

  2. Masukkan GUID setiap label yang ingin anda kecualikan, termasuk label yang menggunakan penyulitan, dalam senarai pengecualian label sensitiviti.

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

Fail dengan label disokong yang sepadan dikecualikan daripada hasil aplikasi SharePoint. Kandungan fail yang disulitkan dikecualikan secara lalai. Akses kepada fail disulitkan yang disokong memerlukan akses fail lanjutan (fetch_advanced) serta persetujuan pentadbir Microsoft Entra, seperti yang diterangkan dalam Soalan Lazim di bawah. Pengecualian label dan keizinan Microsoft bagi pengguna yang disambungkan masih terpakai.

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:

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

Patutkah saya menambahkan label sensitiviti yang menggunakan penyulitan pada senarai pengecualian?

Ya. Tambahkan sebarang label sensitiviti Microsoft Purview jika anda mahu ChatGPT mengecualikan fail dengan label tersebut, termasuk label yang menggunakan penyulitan.

Kandungan fail yang disulitkan dikecualikan secara lalai. Untuk mendayakan akses kepada fail disulitkan yang disokong, pentadbir ruang kerja mesti mendayakan akses fail lanjutan (fetch_advanced), dan pentadbir Microsoft Entra mesti memberikan persetujuan untuk keizinan Microsoft yang diperlukan. Mendayakan tindakan itu tanpa melengkapkan proses persetujuan pentadbir tidak mencukupi.

Walaupun selepas persediaan selesai, ChatGPT hanya boleh mendapatkan kandungan yang disulitkan apabila pengguna yang disambungkan mempunyai keizinan untuk mengakses dan menyahsulit fail tersebut. Fail dengan label dalam senarai pengecualian anda kekal dikecualikan. Mendayakan akses fail lanjutan atau memberikan persetujuan pentadbir tidak mengatasi pengecualian label atau keizinan Microsoft pengguna.

Adakah kawalan tapak menggantikan keizinan Microsoft?

Tidak. Aplikasi masih menggunakan keizinan Microsoft setiap pengguna. OpenAI menggunakan penapisan tapak yang dikonfigurasikan sebelum respons dipaparkan 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, akses ditentukan oleh keizinan Microsoft pengguna dan kawalan lain yang dikonfigurasikan.

Adakah perubahan API Pentadbir direkodkan dalam log?

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

Adakah artikel ini membantu?