Alamin kung paano pamahalaan ang access sa SharePoint site at ibukod ang mga sinusuportahang file na may mga napiling sensitivity label sa ChatGPT.

Pangkalahatang-ideya

Maaaring gamitin ng mga administrator ng workspace ang mga kontrol ng SharePoint para payagan ang mga aprubadong site collection, i-block ang mga napiling site collection, at ibukod ang mga sinusuportahang file na may mga napiling sensitivity label ng Microsoft Purview.

Ang isang SharePoint site collection, na tinatawag ding SPSite, ay maaaring maglaman ng maraming site. Nalalapat ang panuntunan para sa collection sa buong collection, alinsunod sa mga kasalukuyang pahintulot ng bawat user sa Microsoft. Hindi nito binibigyan ang user ng access sa content na hindi niya ma-access sa Microsoft 365.

Nalalapat ang mga paghihigpit sa site sa mga sinusuportahang pagkilos sa SharePoint: paghahanap, pag-browse, pagkuha ng file, at pagbasa/pagsulat. Hiwalay na pinamamahalaan ang access sa OneDrive.

Piliin ang mode ng access na tumutugma sa iyong patakaran:

Mga pinapayagang site: Kapag may laman ang allowlist, ang mga nakalistang site collection lang ang maa-access ng mga user sa pamamagitan ng app.
Mga naka-block na site: Maa-access ng mga user ang mga site collection na wala sa deny list, alinsunod sa kanilang mga pahintulot sa Microsoft.

Isang listahan lang ang maaaring may mga entry sa anumang oras. Hindi bina-block ng walang lamang allowlist ang lahat ng site. Kapag parehong walang laman ang mga listahan, inaalis ang mga paghihigpit sa SharePoint site; nalalapat pa rin ang mga pahintulot sa Microsoft at iba pang naka-configure na kontrol.

Availability

Kailangang i-enable para sa iyong workspace ang mga kontrol at ang Admin API ng workspace. Kabilang sa mga available na kontrol ang mga allowlist at deny list ng site collection, pag-import ng site mula sa CSV, at mga pagbubukod batay sa sensitivity label.

Nalalapat ang mga panuntunan sa buong site collection. Hindi kasama sa mga kontrol na ito ng site collection ang paglilimita ng saklaw sa isang eksaktong site, folder, o file at ang pagpapatupad ng Microsoft Sites.Selected.

Bago ka magsimula

Tukuyin ang mga site collection na gustong payagan o i-block ng iyong organisasyon.
Kunin ang GUID ng bawat collection. Ang gitnang value ng kumpletong site ID ng Microsoft Graph ay ang GUID ng collection. Gumagamit ang Admin API ng mga GUID ng collection; maaari ring kunin ng CSV importer sa UI ang mga ito mula sa mga tatlong-bahaging site ID ng Graph.
I-enable ang mga pahintulot sa Microsoft na kailangan ng SharePoint app sa parehong mga setting ng pahintulot ng ChatGPT at Microsoft Entra, kabilang ang Sites.Read.All at Files.Read.All. Sinasala ng mga kontrol na ito ang access sa panig ng OpenAI; hindi nito pinapalitan ang mga itinalagang pahintulot ng Microsoft.
Para sa mga pagbubukod batay sa sensitivity label, hingin sa iyong Microsoft 365 o Purview administrator ang hindi nababagong GUID ng bawat label na walang encryption.
Para sa pangangasiwa gamit ang API, kunin ang UUID ng iyong workspace, isang Admin key ng ChatGPT workspace, at isang Microsoft Graph token kung kailangan mong kunin ang mga identifier ng mga SharePoint URL. Magkaiba ang gamit ng dalawang kredensyal.

Tungkol sa OpenAI Cookbook

Ang OpenAI Cookbook ay pampublikong koleksyon ng OpenAI ng mga halimbawang code at gabay. Ginagamit ng artikulong ito ang gabay nito sa access sa SharePoint site at ang Python script nito para sa pangangasiwa, na parehong naka-host sa GitHub. Maaari mong buksan ang mga link na ito sa iyong browser para basahin ang mga file. Para patakbuhin ang script, i-download ito at sundin ang mga tagubilin sa gabay tungkol sa pag-setup at mga command.

Sa buong artikulong ito, tumutukoy ang “Cookbook” sa gabay na iyon sa SharePoint, at ang “Cookbook tool” sa naka-link na Python script. Gamitin ang mga sangguniang ito para sa mga halimbawa ng command at pamamahala ng allowlist gamit ang API.

I-set up ang mga kredensyal para sa pangangasiwa gamit ang API

Tandaan: Kailangan mong maging administrator ng workspace para makagawa ng mga admin key. Magbasa pa.

Gumawa ng admin key ng ChatGPT workspace

Buksan ang admin console ng ChatGPT at piliin ang nilalayong workspace.
Pumunta sa Mga Kredensyal at piliin ang Mga admin key.
Gumawa ng key na may Limitadong mga pahintulot at itakda ang Mga App sa Pagsulat.
Itago ang key sa ligtas na paraan. Nagbibigay ang key na ito ng pahintulot na basahin at baguhin ang patakaran ng SharePoint para sa iyong workspace.

Ang kinakailangang pahintulot ay chatgpt.enterprise.apps.write. Tandaan na hindi maaaring ipalit ang isang key ng API Platform o Microsoft Graph token sa isang Admin key ng ChatGPT workspace.

Para sa higit pang impormasyon, tingnan ang: Pamamahala ng mga Admin key sa tab na Mga Kredensyal. Para sa mga environment variable ng kredensyal ng script at halimbawa ng ligtas na pag-input, tingnan ang mga tagubilin sa kredensyal sa Cookbook.

Kumuha ng Microsoft Graph token

Gamitin ang proseso ng authentication sa Microsoft na inaprubahan ng iyong organisasyon. Para sa interactive na paghahanap, kung pinapayagan ng iyong organisasyon ang Graph Explorer:

Buksan ang Microsoft Graph Explorer at mag-sign in gamit ang account sa trabaho sa tenant na naglalaman ng mga SharePoint site.
Piliin ang mga pahintulot na kailangan para basahin ang mga site, karaniwan ay Sites.Read.All, gamit ang Baguhin ang mga pahintulot o Sumang-ayon sa mga pahintulot. Hilingin sa iyong Microsoft administrator na aprubahan ang access kung kinakailangan ito ng iyong organisasyon.
Buksan ang tab na Token ng access at kopyahin ang token para gamitin sa Microsoft Graph.

Para sa mga tagubilin ng Microsoft, tingnan ang Gamitin ang Graph Explorer.

Ginagamit ang Graph token para makuha ang mga identifier na tinutukoy ng mga SharePoint URL. Ginagamit ang ChatGPT Admin key para basahin o i-update ang patakaran ng ChatGPT. Kailangan lang ng Cookbook tool ang Graph token para sa mga command na kumukuha ng mga identifier ng mga URL; ChatGPT Admin key lang ang kailangan para basahin o alisin ang lahat ng laman ng kasalukuyang allowlist.

Huwag ilagay ang alinman sa dalawang kredensyal sa source control, mga nakabahaging dokumento, screenshot, o log.

Hanapin ang GUID ng isang site collection

Gamitin ang URL ng SharePoint site

Buksan ang SharePoint site habang naka-sign in sa Microsoft gamit ang isang account na may access dito.
Idagdag ang /_api/site/id sa dulo ng URL ng site. Halimbawa, gamitin ang https://contoso.sharepoint.com/sites/Finance/_api/site/id.
Kopyahin ang GUID na ibinalik sa tugon.

Tandaan: Mga placeholder ang mga halimbawang domain at identifier sa artikulong ito.

Gamitin ang Microsoft Graph

Nagbabalik ang Microsoft Graph ng site ID na may tatlong bahaging pinaghihiwalay ng kuwit: ang hostname, ang GUID ng site collection, at ang GUID ng site. Gamitin ang gitnang value para sa panuntunan ng site collection. Maaaring tumukoy ang magkakaibang URL ng site sa iisang GUID ng collection.

Para sa mga halimbawa ng paghahanap at identifier, tingnan ang Unawain ang mga identifier ng SharePoint site. Para makuha ang mga identifier ng maraming URL nang hindi binabago ang patakaran ng ChatGPT, gamitin ang mga tagubilin sa pag-inspeksyon sa Cookbook at ang Python script para sa pangangasiwa.

Para sa mga kinakailangan ng Microsoft sa paghahanap, tingnan ang Kumuha ng SharePoint site gamit ang path.

Pamahalaan ang mga pinapayagan at naka-block na site collection

Gamitin ang mga kontrol ng workspace

Buksan ang Mga Kontrol sa Kaligtasan at Seguridad ng SharePoint app sa iyong workspace.
Sa Mode ng access, piliin ang Mga pinapayagang site o Mga naka-block na site.
Idagdag ang mga site collection sa napiling listahan. Maaari mo ring gamitin ang pag-upload ng CSV na inilalarawan sa ibaba.
Suriin ang iyong mga pagbabago at piliin ang I-save.
Suriin ang naka-save na patakaran at subukan ang iyong configuration.

Lumalabas sa mga kontrol ng workspace ang mga site na idinagdag sa pamamagitan ng Admin API. Available din sa pamamagitan ng API ang mga site na idinagdag sa UI. Maaari kang magdagdag o mag-alis ng mga entry sa alinman sa dalawa; hindi ka nakatali sa paraang ginamit mo sa pagdagdag ng site.

Lumipat sa pagitan ng mga pinapayagan at naka-block na site

Isang listahan lang ang maaaring may mga entry sa anumang oras. Bago magdagdag ng mga entry sa kabilang mode, alisin ang lahat ng laman ng kasalukuyang listahan at i-save ang pagbabagong iyon. Pagkatapos, piliin ang kabilang mode, idagdag ang mga nilalayong collection, at i-save muli.

Agad na nagbabago ang access kapag na-save ang pag-aalis ng lahat ng laman ng aktibong listahan. Kapag inalis ang lahat ng laman ng allowlist, nawawala ang paghihigpit nito sa site; kapag inalis ang lahat ng laman ng deny list, nawawala ang mga pag-block nito. Planuhin ang paglipat kasama ng ibang admin dahil sa pagitan ng pag-aalis ng laman ng isang listahan at pag-save ng kabila, maaaring magkaroon ng access na lilimitahan ng iyong pinal na patakaran.

Mag-upload ng mga site collection mula sa CSV

Mga site collection lang ang sinusuportahan ng pag-upload ng CSV. Para magbukod ng mga file ayon sa sensitivity label, idagdag ang mga GUID ng label sa Mga ibinukod na sensitivity label na walang encryption.

Buksan ang Mga Kontrol sa Kaligtasan at Seguridad at piliin ang nilalayong Mode ng access.
Maghanda ng CSV na naglalaman ng mga GUID ng site collection o mga site ID ng Microsoft Graph na binubuo ng tatlong bahagi. Gumamit ng iisang format ng identifier sa buong file.
Piliin ang Mag-upload ng CSV file at piliin ang file.
Suriin ang resulta ng pag-import at ang napiling listahan. Ayusin ang anumang error o babala sa mga row bago magpatuloy.
Piliin ang I-save para ilapat ang mga pagbabago, pagkatapos ay suriin ang naka-save na listahan.

Mga kinakailangan at paraan ng pagproseso ng CSV:

Pinakamalaking laki ng file: 1 MB.
Opsyonal ang mga header.
Gumamit ng isang GUID ng collection sa bawat row, o mga site ID ng Graph na binubuo ng tatlong bahagi. Maaaring ilagay ang tatlong bahagi sa isang field na nakapaloob sa mga panipi o paghiwa-hiwalayin sa tatlong column.
Kino-convert sa mga GUID ng collection ang mga tatlong-bahaging ID ng Graph. Hindi lumilikha ng panuntunan para sa isang eksaktong site ang pag-import ng tatlong-bahaging ID.
Nagdaragdag sa napiling listahan ang mga pag-import at pinapanatili ang mga kasalukuyang entry. Inaalis ang mga dobleng collection; ang bilang ng pag-import ay tumutukoy sa mga bagong idinagdag na collection.
Tinatanggihan ang magkakahalong format at mga row na mali ang format. Nagpapakita ng babala at hindi nagdaragdag ng mga site ang upload na puro URL ng site ang laman. Kunin muna ang mga GUID ng collection na tinutukoy ng mga URL.
Draft na listahan lang ang binabago ng pag-upload. Hindi nito ina-update ang access sa workspace hangga't hindi mo pinipili ang I-save.
Pinamamahalaan ng pag-upload ng CSV na inilalarawan dito ang mga site collection. Hiwalay na i-configure ang mga pagbubukod batay sa sensitivity label.

Kung mayroon kang CSV ng mga SharePoint URL, maaaring kunin ng CSV workflow ng Cookbook tool ang mga identifier ng mga ito at pamahalaan ang allowlist sa pamamagitan ng API. Iba ang format at workflow ng site_url o url input nito kumpara sa pag-upload ng identifier sa UI.

Unawain ang mga limitasyon sa patakaran at request

Ang default na limitasyon ng patakaran ay 10,000 site collection. Kailangang i-enable ng OpenAI ang mas matataas na limitasyon sa patakaran ng workspace, hanggang 120,000 site collection; makipag-ugnayan sa iyong OpenAI team bago magplano ng mas malaking deployment.

Tumatanggap ang bawat mutation sa API at ang kasalukuyang Cookbook script ng hanggang 10,000 GUID ng collection sa bawat request. Hindi tumataas ang limitasyong ito sa bawat request kahit mas mataas ang limitasyon sa patakaran ng workspace. Bilangin ang mga natatanging site collection, hindi ang mga pinagmulang URL: maaaring tumukoy ang maraming URL sa iisang collection.

Gamitin ang Admin API ng workspace

Gamitin ang UUID ng iyong workspace at ang Admin key ng ChatGPT workspace sa https://api.chatgpt.com.

Para sa mga napapanahong command ng allowlist at halimbawa ng request, gamitin ang Cookbook:

Basahin ang kasalukuyang allowlist.
I-preview at magdagdag ng mga site collection. Pinapanatili ng mga pagdagdag ang mga kasalukuyang pinapayagang collection.
Mag-alis ng site collection.
Alisin ang lahat ng laman ng allowlist.

Suriin ang kasalukuyang patakaran bago gumawa ng mga pagbabago, pagkatapos ay basahin itong muli at subukan ang nagresultang access. Nawawala ang paghihigpit na iyon sa site kapag inalis ang huling pinapayagang collection o ang lahat ng laman ng allowlist. Huwag magpadala ng walang lamang request sa pagdagdag maliban kung nilalayon mong alisin ang mga paghihigpit ng allowlist.

Sa kasalukuyan, mga allowlist lang ang pinamamahalaan ng pampublikong Cookbook tool. Hindi nito pinamamahalaan ang mga deny list o mga pagbubukod batay sa sensitivity label. Gamitin ang mga kontrol ng workspace na inilalarawan sa itaas para sa mga gawaing iyon.

Ibukod ang mga file na may mga sensitivity label

Hanapin ang GUID ng label

Hingin sa iyong Microsoft 365 o Purview administrator ang hindi nababagong GUID ng nilalayong label. Gamitin ang GUID, hindi ang ipinapakitang pangalan nito.

Maaaring kumuha ang administrator ng listahan ng mga label sa pamamagitan ng Microsoft Graph. Kailangan ng token ang naaangkop na pahintulot na SensitivityLabel.Read o SensitivityLabels.Read.All. Itugma ang pangalan ng nilalayong label sa ID nito at suriin ang mga setting ng proteksyon nito.

Para sa mga kinakailangan at halimbawa, tingnan ang Ilista ang mga sensitivity label at Mga katangian ng sensitivity label. Hiwalay ang mga pahintulot na ito para sa label sa pahintulot na bumasa ng site na ginagamit para makuha ang mga identifier ng mga SharePoint URL.

Magdagdag ng mga pagbubukod batay sa label

Buksan ang Mga Kontrol sa Kaligtasan at Seguridad ng SharePoint app.
Ilagay ang GUID ng bawat label na walang encryption sa Mga ibinukod na sensitivity label na walang encryption.
I-save ang configuration at subukan ang isang sinusuportahang file na may ibinukod na label.

Ibinubukod sa mga resulta ng SharePoint app ang mga file na may mga tumutugmang sinusuportahang label. Ibinubukod na bilang default ang mga file na may mga label na naglalapat ng encryption.

Subukan ang iyong configuration

Gumamit ng mga pansubok na file at account na inaprubahan ng iyong organisasyon. Bago magsubok, kumpirmahing direktang maa-access sa SharePoint ng parehong Microsoft account ang bawat file.

Sa mode na Mga pinapayagang site na may listahang hindi blangko, suriin ang isang file sa pinapayagang collection at isang file sa collection na wala sa listahan. Ang pinapayagang collection lang ang dapat ma-access sa pamamagitan ng app.
Sa mode na Mga naka-block na site, suriin ang isang file sa naka-block na collection at isang file sa collection na hindi naka-block. Dapat hindi ma-access ang naka-block na collection; nakadepende pa rin sa mga pahintulot sa Microsoft at iba pang kontrol ang access sa collection na hindi naka-block.
Suriin ang isang sinusuportahang pansubok na file na may ibinukod na sensitivity label. Hindi ito dapat lumabas sa mga resulta ng app.
Pagkatapos ng pagbabago sa pamamagitan ng API, ihambing ang naka-save na listahan sa UI sa patakarang ibinalik ng API.
Pagkatapos mag-upload ng CSV, i-save ang mga pagbabago at buksang muli ang mga kontrol para kumpirmahing napanatili ang mga nilalayong collection.

Kung hindi tugma ang mga resulta sa nilalayong patakaran, suriin ang workspace, napiling access mode, naka-save na listahan, mga GUID ng collection at label, sinusuportahang uri ng file, at mga pahintulot ng user sa Microsoft. Huwag alisin ang lahat ng laman ng listahan bilang hakbang sa pag-troubleshoot maliban kung nilalayon mo ang magiging pagbabago sa access.

Para sa tulong sa mga nawawalang kontrol o hindi inaasahang access, tingnan ang: Pakikipag-ugnayan sa OpenAI Support. Huwag isama ang mga Admin key o Microsoft Graph token sa iyong kahilingan sa suporta.

Unawain ang mga limitasyon

Saklaw ng panuntunan para sa collection ang buong site collection. Hindi nito malilimitahan ang access sa isang partikular na subsite, folder, o file.
Hindi awtomatikong nililimitahan ng mga paghihigpit sa SharePoint site ang access sa OneDrive.
Nalalapat lang ang pag-filter ayon sa sensitivity label kapag ibinibigay ng Microsoft Graph ang sinusuportahang metadata ng label, kabilang ang mga sinusuportahang dokumento sa Office, PDF, at MP4 file.
Itinuturing na walang label ang mga uri ng file na hindi sinusuportahan para sa sensitivity label, gaya ng mga TXT at CSV file. Maa-access pa rin ang mga ito kung pinapayagan ng iba pang patakaran. Hiwalay ang limitasyong ito sa uri ng file sa pag-upload ng CSV para i-configure ang access sa site.
Hindi kino-configure ng pag-upload ng CSV at ng pampublikong halimbawang tool ang mga pagbubukod batay sa sensitivity label. Hindi inilalarawan sa artikulong ito ang isang API para sa maramihang pamamahala ng label.
Hindi kapalit ng pagsubok sa access gamit ang nilalayong account ang isang naka-save na patakaran o matagumpay na tugon ng API.

Gamitin ang Python tool para sa pangangasiwa

Pinapanatiling napapanahon sa OpenAI Cookbook ang kumpletong halimbawang code at mga command:

Gamitin ang Python 3.10 o mas bagong bersyon. Ginagamit ng tool ang standard library ng Python. Basahin ang gabay bago ito patakbuhin at gumamit ng mga dry run para suriin ang mga pagbabago.

Binabasa ng kasalukuyang tool ang mga kredensyal mula sa mga environment variable; sundin ang mga tagubilin sa gabay para sa ligtas na pag-input. Nangangailangan ito ng tahasang kumpirmasyon para alisin ang lahat ng laman ng allowlist. Maaaring maisagawa ang pag-aalis nang wala ang kumpirmasyong iyon, kaya suriin muna ito gamit ang dry run.

Para sa proseso ng muling pagsubok at mga opsyonal na idempotency key, tingnan ang Ligtas na subukang muli ang pag-update ng patakaran. Gumamit lang ng mga idempotency key kung sinusuportahan ang mga ito ng workspace, at suriin ang kasalukuyang patakaran pagkatapos ng pagkabigong hindi malinaw ang resulta.

Hindi ine-enable ng tool ang mga feature ng workspace at hindi nito bineberipika ang pagpapatupad ng patakaran. Gumagamit ang mga offline na pagsusuri nito ng mga kunwaring tawag sa Microsoft Graph at ChatGPT Admin API.

Hindi atomic ang mga pagbabagong nangangailangan ng maraming request. Kung mabigo sa kalagitnaan ang pag-aalis ng maraming collection, maaaring matagumpay nang naalis ang mga nauna. Basahin ang kasalukuyang patakaran bago muling subukan.

Mga madalas itanong

Pinapalitan ba ng mga kontrol sa site ang mga pahintulot sa Microsoft?

Hindi. Ginagamit pa rin ng app ang mga pahintulot ng bawat user sa Microsoft. Inilalapat ng OpenAI ang naka-configure na pag-filter ng site bago ipakita ang mga tugon sa user at modelo.

Bina-block ba ng walang lamang allowlist ang lahat ng site?

Hindi. Hindi nangangahulugang “i-block ang lahat” ang walang lamang allowlist. Kung may mga entry ang deny list, mananatiling naka-block ang mga collection na iyon. Kapag walang entry ang alinman sa dalawang listahan, ang mga pahintulot ng mga user sa Microsoft at iba pang naka-configure na kontrol ang nagtatakda ng access.

Naka-log ba ang mga pagbabago sa Admin API?

Itinatala ang mga pagbabago sa patakaran sa pamamagitan ng Admin API sa mga audit at compliance log ng workspace.

Pamamahala ng access sa SharePoint site at mga pagbubukod batay sa sensitivity label