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 sa isang buong 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 triple ng site ID sa Graph.
I-enable ang mga pahintulot sa Microsoft na kailangan ng SharePoint app sa parehong mga setting ng pahintulot ng ChatGPT at Microsoft Entra, kasama ang
Sites.Read.AllatFiles.Read.All. Sinasala ng mga kontrol na ito ang access sa panig ng OpenAI; hindi nila 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 gusto mong ibukod, kasama ang mga label na naglalapat ng encryption.
Para sa pangangasiwa sa API, kunin ang UUID ng iyong workspace, isang Admin key ng ChatGPT workspace, at isang Microsoft Graph token kung kailangan mong alamin ang mga identifier na katumbas ng mga URL ng SharePoint. Magkaiba ang layunin 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/idsa dulo ng URL ng site. Halimbawa, gamitin anghttps://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 bina-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 ilalim ng Mode ng access, piliin ang Mga pinapayagang site o Mga bina-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.
Tingnan ang naka-save na patakaran at subukan ang iyong configuration.
Lumalabas sa mga kontrol ng workspace ang mga site na idinagdag gamit ang Admin API. Available din sa API ang mga site na idinagdag sa UI. Maaari kang magdagdag o mag-alis ng mga entry gamit ang alinman sa dalawa; hindi ka nakatali sa paraang ginamit mo sa pagdagdag ng site.
Lumipat sa pagitan ng mga pinapayagan at bina-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 gustong collection, at i-save ulit.
Kapag inalis ang lahat ng laman ng aktibong listahan, agad na magbabago ang access sa oras na i-save ito. Ang pag-alis sa lahat ng laman ng allowlist ay nag-aalis ng paghihigpit nito sa mga site; ang pag-alis sa lahat ng laman ng deny list ay nag-aalis ng mga pag-block nito. Planuhin ang paglipat kasama ang ibang admin dahil sa pagitan ng pag-alis sa laman ng isang listahan at pag-save sa kabilang listahan, maaaring mapayagan ang 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 listahan ng mga ibinubukod na sensitivity label.
Buksan ang Mga Kontrol sa Kaligtasan at Seguridad at piliin ang gustong Mode ng access.
Maghanda ng CSV ng mga GUID ng site collection o mga triple ng site ID sa Microsoft Graph. 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 tingnan ang naka-save na listahan.
Mga kinakailangan sa CSV at kung paano ito gumagana:
Pinakamalaking laki ng file: 1 MB.
Opsyonal ang mga header.
Gumamit ng isang GUID ng collection sa bawat row, o ng mga triple ng site ID sa Graph. Maaaring ilagay ang mga triple sa isang field na nakapaloob sa panipi o hatiin sa tatlong column.
Kino-convert ang mga triple ng Graph sa mga GUID ng collection. Ang pag-import ng triple ay hindi gumagawa ng panuntunang para lang sa eksaktong site na iyon.
Nagdaragdag ang mga pag-import sa napiling listahan at pinapanatili ang mga kasalukuyang entry. Inaalis ang mga duplicate na collection; ang bilang sa pag-import ay tumutukoy sa mga bagong idinagdag na collection.
Tinatanggihan ang magkakahalong format at mga row na mali ang pagkaka-format. Kapag mga URL lang ng site ang laman ng upload, magpapakita ito ng babala at walang idadagdag na site. Alamin muna ang mga GUID ng collection na katumbas ng mga URL.
Draft na listahan lang ang nababago ng pag-upload. Hindi nito ina-update ang access sa workspace hangga't hindi mo pinipili ang I-save.
Mga site collection ang pinamamahalaan ng pag-upload ng CSV na inilalarawan dito. Hiwalay na i-configure ang mga pagbubukod batay sa sensitivity label.
Kung mayroon kang CSV ng mga URL ng SharePoint, maaaring alamin ng CSV workflow ng Cookbook utility ang mga katumbas na identifier ng mga ito at mamahala ng allowlist gamit ang 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 ng patakaran ng workspace, hanggang 120,000 site collection; makipag-ugnayan sa iyong OpenAI team bago magplano ng mas malaking deployment.
Tumatanggap ang bawat API mutation at ang kasalukuyang Cookbook script ng hanggang 10,000 GUID ng collection bawat request. Hindi tumataas ang limitasyong ito sa bawat request kahit mas mataas ang limitasyon ng 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 iyong ChatGPT workspace sa https://api.chatgpt.com.
Para sa mga pinananatiling updated na command ng allowlist at mga halimbawa ng request, gamitin ang Cookbook:
I-preview at idagdag ang mga site collection. Nananatili ang mga kasalukuyang pinapayagang collection kapag may mga idinadagdag.
Suriin ang kasalukuyang patakaran bago gumawa ng mga pagbabago, pagkatapos ay basahin itong muli at subukan ang naging access. Ang pag-alis sa huling pinapayagang collection o sa lahat ng laman ng allowlist ay nag-aalis ng paghihigpit na iyon sa mga site. Huwag magpadala ng walang-lamang request sa pagdagdag maliban kung layunin mong alisin ang mga paghihigpit ng allowlist.
Mga allowlist lang ang kasalukuyang pinamamahalaan ng pampublikong Cookbook utility. Hindi nito pinamamahalaan ang mga deny list o 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 label na ibubukod
Buksan ang Mga Kontrol sa Kaligtasan at Seguridad ng SharePoint app.
Ilagay sa listahan ng mga ibinubukod na sensitivity label ang GUID ng bawat label na gusto mong ibukod, kasama ang mga label na naglalapat ng encryption.
I-save ang configuration at subukan ang isang sinusuportahang file na may ibinukod na label.
Ang mga file na may katugmang sinusuportahang label ay ibinubukod sa mga resulta ng SharePoint app. Ibinubukod bilang default ang nilalaman ng mga naka-encrypt na file. Para ma-access ang mga sinusuportahang naka-encrypt na file, kailangan ang advanced na access sa file (fetch_advanced) at pahintulot ng admin ng Microsoft Entra, gaya ng inilalarawan sa mga madalas itanong sa ibaba. Nalalapat pa rin ang mga pagbubukod batay sa label at ang mga pahintulot sa Microsoft ng nakakonektang user.
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
Dapat ko bang idagdag sa listahan ng mga ibinubukod ang mga sensitivity label na naglalapat ng encryption?
Oo. Idagdag ang anumang sensitivity label ng Microsoft Purview na ang mga file ay gusto mong ibukod ng ChatGPT, kasama ang mga label na naglalapat ng encryption.
Ibinubukod bilang default ang nilalaman ng mga naka-encrypt na file. Para ma-enable ang access sa mga sinusuportahang naka-encrypt na file, kailangang i-enable ng admin ng workspace ang advanced na access sa file (fetch_advanced), at kailangang magbigay ng pagsang-ayon ang administrator ng Microsoft Entra para sa mga kinakailangang pahintulot sa Microsoft. Hindi sapat na i-enable ang aksyon nang hindi kinukumpleto ang pahintulot ng admin.
Kahit matapos ang setup, makakakuha lang ang ChatGPT ng naka-encrypt na nilalaman kapag may pahintulot ang nakakonektang user na i-access at i-decrypt ang file. Nananatiling ibinubukod ang mga file na may mga label na nasa iyong listahan ng mga ibinubukod. Hindi napapawalang-bisa ng pag-enable ng advanced na access sa file o pagbibigay ng pahintulot ng admin ang mga pagbubukod batay sa label o ang mga pahintulot ng user sa Microsoft.
Pinapalitan ba ng mga kontrol sa site ang mga pahintulot sa Microsoft?
Hindi. Ginagamit pa rin ng app ang mga pahintulot sa Microsoft ng bawat user. Inilalapat ng OpenAI ang naka-configure na pagsala ng site bago ipakita ang mga tugon sa user at modelo.
Bina-block ba ng walang-lamang allowlist ang lahat ng site?
Hindi. Ang walang-lamang allowlist ay hindi nangangahulugang “i-block lahat.” Kung may mga entry ang deny list, mananatiling naka-block ang mga collection na iyon. Kapag parehong walang entry ang mga listahan, ang mga pahintulot ng mga user sa Microsoft at iba pang naka-configure na kontrol ang nagtatakda ng access.
Nakala-log ba ang mga pagbabago sa Admin API?
Itinatala ang mga pagbabago sa patakaran sa Admin API sa mga log ng pag-audit at pagsunod sa mga regulasyon ng workspace.
