Pārskats

Darbvietu administratori var izmantot SharePoint iestatījumus, lai atļautu apstiprinātas vietņu kolekcijas, bloķētu izvēlētas vietņu kolekcijas un izslēgtu atbalstītus failus ar izvēlētām Microsoft Purview sensitivitātes etiķetēm.

SharePoint vietņu kolekcijā, ko dēvē arī par SPSite, var būt vairākas vietnes. Kolekcijas kārtula attiecas uz visu kolekciju, ievērojot katra lietotāja esošās Microsoft atļaujas. Tā nepiešķir lietotājam piekļuvi saturam, kuram viņš nevar piekļūt Microsoft 365.

Vietņu ierobežojumi attiecas uz atbalstītajām SharePoint meklēšanas, pārlūkošanas, failu izgūšanas un lasīšanas/rakstīšanas darbībām. Piekļuve OneDrive tiek pārvaldīta atsevišķi.

Izvēlieties savai politikai atbilstošu piekļuves režīmu:

• Atļautās vietnes: ja atļauto vietņu sarakstā ir ieraksti, lietotāji lietotnē var piekļūt tikai sarakstā iekļautajām vietņu kolekcijām.

• Bloķētās vietnes: lietotāji atbilstoši savām Microsoft atļaujām var piekļūt vietņu kolekcijām, kas nav iekļautas bloķēto vietņu sarakstā.

Vienlaikus ieraksti var būt tikai vienā sarakstā. Tukšs atļauto vietņu saraksts nebloķē visas vietnes. Ja abi saraksti ir tukši, SharePoint vietņu ierobežojumi tiek atcelti; Microsoft atļaujas un citi konfigurētie piekļuves nosacījumi joprojām ir spēkā.

Pieejamība

Šie iestatījumi un darbvietas Admin API ir jāiespējo jūsu darbvietai. Pieejamās iespējas ietver atļauto un bloķēto vietņu kolekciju sarakstus, vietņu importēšanu no CSV un izslēgšanu pēc sensitivitātes etiķetēm.

Kārtulas attiecas uz veselām vietņu kolekcijām. Šie vietņu kolekciju iestatījumi neietver ierobežošanu līdz konkrētai vietnei, mapei vai failam un Microsoft Sites.Selected atļaujas piemērošanu.

Pirms darba sākšanas

• Nosakiet vietņu kolekcijas, kuras organizācija vēlas atļaut vai bloķēt.

• Iegūstiet katras kolekcijas GUID. Pilnā Microsoft Graph vietnes ID vidējā vērtība ir kolekcijas GUID. Admin API izmanto kolekciju GUID; lietotāja saskarnes CSV importēšanas rīks tos var iegūt arī no Graph vietņu ID trijniekiem.

• Iespējojiet SharePoint lietotnei nepieciešamās Microsoft atļaujas gan ChatGPT atļauju iestatījumos, gan Microsoft Entra, tostarp Sites.Read.All un Files.Read.All. Šie iestatījumi filtrē piekļuvi OpenAI pusē; tie neaizstāj Microsoft deleģētās atļaujas.

• Lai konfigurētu izslēgšanu pēc sensitivitātes etiķetēm, lūdziet Microsoft 365 vai Purview administratoram katras etiķetes bez šifrēšanas nemainīgo GUID.

• Administrēšanai ar API iegūstiet darbvietas UUID, ChatGPT darbvietas administratora atslēgu un Microsoft Graph pilnvaru, ja nepieciešams noteikt SharePoint URL atbilstošos identifikatorus. Šie abi akreditācijas dati ir paredzēti atšķirīgiem mērķiem.

Par OpenAI Cookbook

OpenAI Cookbook ir OpenAI publiski pieejams koda piemēru un rokasgrāmatu krājums. Šajā rakstā izmantota tā SharePoint vietņu piekļuves rokasgrāmata un Python administrēšanas skripts, kas abi ir izvietoti GitHub. Šīs saites varat atvērt pārlūkprogrammā, lai izlasītu failus. Lai palaistu skriptu, lejupielādējiet to un izpildiet rokasgrāmatas norādījumus par iestatīšanu un komandām.

Šajā rakstā ar “Cookbook” ir domāta minētā SharePoint rokasgrāmata, savukārt ar “Cookbook utilītu” — saistītais Python skripts. Izmantojiet šos resursus, lai skatītu komandu piemērus un pārvaldītu atļauto vietņu sarakstu ar API.

Akreditācijas datu iestatīšana administrēšanai ar API

Piezīme: lai izveidotu administratora atslēgas, jums jābūt darbvietas administratoram. Lasīt vairāk.

ChatGPT darbvietas administratora atslēgas izveide

1. Atveriet ChatGPT administratora konsoli un atlasiet paredzēto darbvietu.

2. Atveriet sadaļu Akreditācijas dati un atlasiet Administratora atslēgas.

3. Izveidojiet atslēgu ar atļaujām Ierobežotas un sadaļā Lietotnes iestatiet Rakstīšana.

4. Glabājiet atslēgu drošā vietā. Šī atslēga ļauj nolasīt un mainīt jūsu darbvietas SharePoint politiku.

Nepieciešamā atļauja ir chatgpt.enterprise.apps.write. Ņemiet vērā, ka ne API platformas atslēga, ne Microsoft Graph pilnvara nevar aizstāt ChatGPT darbvietas administratora atslēgu.

Papildinformāciju skatiet rakstā Administratora atslēgu pārvaldība cilnē Akreditācijas dati. Skripta akreditācijas datu vides mainīgos un drošas ievades piemēru skatiet Cookbook norādījumos par akreditācijas datiem.

Microsoft Graph pilnvaras iegūšana

Izmantojiet organizācijas apstiprināto Microsoft autentifikācijas procesu. Lai veiktu interaktīvu meklēšanu, ja organizācija atļauj izmantot Graph Explorer:

1. Atveriet Microsoft Graph Explorer un pierakstieties ar darba kontu nomniekā, kurā atrodas SharePoint vietnes.

2. Atlasiet vietņu lasīšanai nepieciešamās atļaujas, parasti Sites.Read.All, izmantojot Mainīt atļaujas vai Piekrist atļaujām. Ja organizācija to pieprasa, lūdziet Microsoft administratoram apstiprināt piekļuvi.

3. Atveriet cilni Piekļuves pilnvara un nokopējiet pilnvaru izmantošanai ar Microsoft Graph.

Microsoft norādījumus skatiet rakstā Darbs ar Graph Explorer.

Graph pilnvara ļauj noteikt SharePoint URL atbilstošos identifikatorus. ChatGPT administratora atslēga ļauj nolasīt vai atjaunināt ChatGPT politiku. Cookbook utilītai Graph pilnvara ir nepieciešama tikai komandām, kas nosaka URL atbilstošos identifikatorus; esoša atļauto vietņu saraksta nolasīšanai vai notīrīšanai nepieciešama tikai ChatGPT administratora atslēga.

Neievietojiet nevienu no šiem akreditācijas datiem versiju vadības sistēmā, koplietojamos dokumentos, ekrānuzņēmumos vai žurnālos.

Vietņu kolekcijas GUID atrašana

Izmantojiet SharePoint vietnes URL

1. Atveriet SharePoint vietni, kad esat pierakstījies Microsoft ar kontu, kuram ir piekļuve šai vietnei.

2. Vietnes URL beigās pievienojiet /_api/site/id. Piemēram, izmantojiet https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Nokopējiet atbildē atgriezto GUID.

Piezīme: šī raksta piemēros izmantotie domēni un identifikatori ir vietturi.

Izmantojiet Microsoft Graph

Microsoft Graph atgriež vietnes ID ar trim komatiem atdalītām daļām: resursdatora nosaukumu, vietņu kolekcijas GUID un vietnes GUID. Vietņu kolekcijas kārtulai izmantojiet vidējo vērtību. Dažādiem vietņu URL var atbilst viens un tas pats kolekcijas GUID.

Meklēšanas un identifikatoru piemērus skatiet sadaļā Izpratne par SharePoint vietņu identifikatoriem. Lai noteiktu vairākiem URL atbilstošos identifikatorus, nemainot ChatGPT politiku, izmantojiet Cookbook pārbaudes norādījumus un Python administrēšanas skriptu.

Microsoft prasības meklēšanai skatiet rakstā SharePoint vietnes iegūšana pēc ceļa.

Atļauto un bloķēto vietņu kolekciju pārvaldība

Izmantojiet darbvietas iestatījumus

1. Darbvietā atveriet SharePoint lietotnes sadaļu Drošības un aizsardzības iestatījumi.

2. Sadaļā Piekļuves režīms atlasiet Atļautās vietnes vai Bloķētās vietnes.

3. Pievienojiet vietņu kolekcijas izvēlētajam sarakstam. Varat izmantot arī tālāk aprakstīto CSV augšupielādi.

4. Pārskatiet izmaiņas un atlasiet Saglabāt.

5. Pārbaudiet saglabāto politiku un izmēģiniet konfigurāciju.

Vietnes, kas pievienotas ar Admin API, tiek rādītas darbvietas iestatījumos. Lietotāja saskarnē pievienotās vietnes ir pieejamas arī ar API. Ierakstus var pievienot vai noņemt abos veidos; vietnes pievienošanai izmantotais veids neierobežo turpmāko pārvaldību.

Pārslēgšanās starp atļautajām un bloķētajām vietnēm

Vienlaikus ieraksti var būt tikai vienā sarakstā. Pirms ierakstu pievienošanas otrā režīmā notīriet esošo sarakstu un saglabājiet šīs izmaiņas. Pēc tam atlasiet otru režīmu, pievienojiet paredzētās kolekcijas un vēlreiz saglabājiet.


Aktīvā saraksta notīrīšana maina piekļuvi uzreiz pēc saglabāšanas. Notīrot atļauto vietņu sarakstu, tiek atcelts tā vietņu ierobežojums; notīrot bloķēto vietņu sarakstu, tiek atcelta tajā norādīto vietņu bloķēšana. Plānojiet pāreju kopā ar citiem administratoriem, jo laikā starp viena saraksta notīrīšanu un otra saglabāšanu var tikt atļauta piekļuve, ko galīgā politika ierobežos.

Vietņu kolekciju augšupielāde no CSV

CSV augšupielāde atbalsta tikai vietņu kolekcijas. Lai izslēgtu failus pēc sensitivitātes etiķetes, pievienojiet etiķešu GUID sadaļā Izslēgtās sensitivitātes etiķetes bez šifrēšanas.

1. Atveriet sadaļu Drošības un aizsardzības iestatījumi un izvēlieties vajadzīgo iestatījuma Piekļuves režīms vērtību.

2. Sagatavojiet CSV failu ar vietņu kolekciju GUID vai Microsoft Graph vietņu ID trijniekiem. Visā failā izmantojiet vienu identifikatoru formātu.

3. Atlasiet Augšupielādēt CSV failu un izvēlieties failu.

4. Pārskatiet importēšanas rezultātu un izvēlēto sarakstu. Pirms turpināt, novērsiet visas rindu kļūdas un brīdinājumu cēloņus.

5. Atlasiet Saglabāt, lai piemērotu izmaiņas, un pēc tam pārbaudiet saglabāto sarakstu.

CSV prasības un darbība:

• Maksimālais faila lielums: 1 MB.

• Galvenes nav obligātas.

• Katrā rindā norādiet vienu kolekcijas GUID vai izmantojiet Graph vietņu ID trijniekus. Trijniekus var norādīt pēdiņās vienā laukā vai sadalīt trīs kolonnās.

• Graph trijnieki tiek pārvērsti par kolekciju GUID. Importējot trijnieku, netiek izveidota kārtula konkrētai vietnei.

• Importēšana papildina izvēlēto sarakstu un saglabā esošos ierakstus. Kolekciju dublikāti tiek noņemti; importēšanas skaits norāda no jauna pievienotās kolekcijas.

• Jaukti formāti un nepareizi veidotas rindas tiek noraidītas. Augšupielādējot failu, kurā ir tikai vietņu URL, tiek parādīts brīdinājums un vietnes netiek pievienotas. Vispirms nosakiet URL atbilstošos kolekciju GUID.

• Augšupielāde maina tikai saraksta melnrakstu. Tā nemaina piekļuvi darbvietā, kamēr neatlasāt Saglabāt.

• Šeit aprakstītā CSV augšupielāde paredzēta vietņu kolekciju pārvaldībai. Izslēgšanu pēc sensitivitātes etiķetēm konfigurējiet atsevišķi.

Ja jums ir CSV fails ar SharePoint URL, izmantojiet Cookbook utilītas CSV darbplūsmu, lai noteiktu tiem atbilstošos identifikatorus un pārvaldītu atļauto vietņu sarakstu ar API. Tās site_url vai url ievades formāts un darbplūsma atšķiras no identifikatoru augšupielādes lietotāja saskarnē.

Politikas un pieprasījumu limitu izpratne

Noklusējuma politikas limits ir 10 000 vietņu kolekciju. Lielāki darbvietas politikas limiti — līdz 120 000 vietņu kolekciju — ir jāiespējo OpenAI; pirms plašākas ieviešanas plānošanas sazinieties ar savu OpenAI komandu.

Atsevišķas API izmaiņu operācijas un pašreizējais Cookbook skripts pieņem līdz 10 000 kolekciju GUID vienā pieprasījumā. Lielāks darbvietas politikas limits nepalielina šo viena pieprasījuma limitu. Skaitiet unikālās vietņu kolekcijas, nevis avota URL: vairāki URL var norādīt uz vienu un to pašu kolekciju.

Izmantojiet darbvietas Admin API

Izmantojiet darbvietas UUID un ChatGPT darbvietas administratora atslēgu ar https://api.chatgpt.com.

Aktuālās atļauto vietņu saraksta komandas un pieprasījumu piemērus skatiet Cookbook:

• Esošā atļauto vietņu saraksta nolasīšana.

• Vietņu kolekciju priekšskatīšana un pievienošana. Pievienojot jaunas kolekcijas, esošās atļautās kolekcijas tiek saglabātas.

• Vietņu kolekcijas noņemšana.

• Atļauto vietņu saraksta notīrīšana.

Pirms izmaiņu veikšanas pārskatiet pašreizējo politiku, pēc tam nolasiet to vēlreiz un pārbaudiet iegūto piekļuvi. Noņemot pēdējo atļauto kolekciju vai notīrot atļauto vietņu sarakstu, tiek atcelts šis vietņu ierobežojums. Nesūtiet tukšu pievienošanas pieprasījumu, ja vien nevēlaties atcelt atļauto vietņu saraksta ierobežojumus.

Publiski pieejamā Cookbook utilīta pašlaik pārvalda tikai atļauto vietņu sarakstus. Tā nepārvalda bloķēto vietņu sarakstus vai izslēgšanu pēc sensitivitātes etiķetēm. Šiem uzdevumiem izmantojiet iepriekš aprakstītos darbvietas iestatījumus.

Failu izslēgšana pēc sensitivitātes etiķetēm

Etiķetes GUID atrašana

Lūdziet Microsoft 365 vai Purview administratoram vajadzīgās etiķetes nemainīgo GUID. Izmantojiet GUID, nevis etiķetes parādāmo nosaukumu.

Administrators var iegūt etiķešu sarakstu ar Microsoft Graph. Pilnvarai nepieciešama attiecīgā atļauja SensitivityLabel.Read vai SensitivityLabels.Read.All. Atrodiet vajadzīgās etiķetes nosaukumam atbilstošo ID un pārbaudiet tās aizsardzības iestatījumus.

Prasības un piemērus skatiet rakstos Sensitivitātes etiķešu saraksta iegūšana un Sensitivitātes etiķetes rekvizīti. Šīs etiķešu atļaujas ir atsevišķas no vietņu lasīšanas atļaujas, ko izmanto SharePoint URL atbilstošo identifikatoru noteikšanai.

Etiķešu pievienošana izslēgšanai

1. Atveriet SharePoint lietotnes sadaļu Drošības un aizsardzības iestatījumi.

2. Sadaļā Izslēgtās sensitivitātes etiķetes bez šifrēšanas ievadiet katras etiķetes GUID, kas nepiemēro šifrēšanu.

3. Saglabājiet konfigurāciju un pārbaudiet atbalstītu failu ar izslēgto etiķeti.

Faili ar atbilstošām atbalstītajām etiķetēm tiek izslēgti no SharePoint lietotnes rezultātiem. Faili ar etiķetēm, kas piemēro šifrēšanu, jau tiek izslēgti pēc noklusējuma.

Konfigurācijas pārbaude

Izmantojiet organizācijas apstiprinātus testa failus un kontus. Pirms pārbaudes pārliecinieties, ka ar to pašu Microsoft kontu var piekļūt katram failam tieši SharePoint.

1. Režīmā Atļautās vietnes ar sarakstu, kurā ir ieraksti, pārbaudiet failu atļautā kolekcijā un failu sarakstā neiekļautā kolekcijā. Lietotnē jābūt pieejamai tikai atļautajai kolekcijai.

2. Režīmā Bloķētās vietnes pārbaudiet failu bloķētā kolekcijā un failu nebloķētā kolekcijā. Bloķētajai kolekcijai jābūt nepieejamai; nebloķētajai kolekcijai joprojām ir spēkā Microsoft atļaujas un citi piekļuves nosacījumi.

3. Pārbaudiet atbalstītu testa failu ar izslēgtu sensitivitātes etiķeti. Tam nevajadzētu parādīties lietotnes rezultātos.

4. Pēc izmaiņu veikšanas ar API salīdziniet lietotāja saskarnē saglabāto sarakstu ar API atgriezto politiku.

5. Pēc CSV augšupielādes saglabājiet izmaiņas un atkārtoti atveriet iestatījumus, lai pārliecinātos, ka paredzētās kolekcijas ir saglabātas.

Ja rezultāti neatbilst paredzētajai politikai, pārbaudiet darbvietu, izvēlēto piekļuves režīmu, saglabāto sarakstu, kolekciju GUID, etiķešu GUID, atbalstīto faila tipu un lietotāja Microsoft atļaujas. Nenotīriet sarakstu problēmu novēršanas nolūkā, ja vien nevēlaties ar to saistītās piekļuves izmaiņas.

Lai saņemtu palīdzību, ja trūkst iestatījumu vai piekļuve neatbilst gaidītajam, skatiet: Sazināšanās ar OpenAI atbalsta dienestu. Atbalsta pieprasījumā neiekļaujiet administratora atslēgas vai Microsoft Graph pilnvaras.

Ierobežojumu izpratne

• Kolekcijas kārtula attiecas uz visu vietņu kolekciju. Ar to nevar ierobežot piekļuvi konkrētai apakšvietnei, mapei vai failam.

• SharePoint vietņu ierobežojumi automātiski neierobežo piekļuvi OneDrive.

• Filtrēšana pēc sensitivitātes etiķetēm attiecas tikai uz failiem, kuriem Microsoft Graph nodrošina atbalstīto etiķešu metadatus, tostarp atbalstītajiem Office dokumentiem, PDF un MP4 failiem.

• Failu tipi, kuriem sensitivitātes etiķetes netiek atbalstītas, piemēram, TXT un CSV faili, tiek uzskatīti par failiem bez etiķetēm. Tie joprojām ir pieejami, ja to atļauj pārējie piekļuves nosacījumi. Šis failu tipu ierobežojums nav saistīts ar CSV augšupielādi vietņu piekļuves konfigurēšanai.

• Ar CSV augšupielādi un publiski pieejamo paraugutilītu nevar konfigurēt izslēgšanu pēc sensitivitātes etiķetēm. Šajā rakstā nav aprakstīts API etiķešu lielapjoma pārvaldībai.

• Saglabāta politika vai sekmīga API atbilde neaizstāj piekļuves pārbaudi ar paredzēto kontu.

Izmantojiet Python administrēšanas utilītu

Pilns piemēra kods un komandas tiek uzturētas OpenAI Cookbook:

• Administrēšanas rokasgrāmata.

• Python administrēšanas skripts.

• Bezsaistes testu fails.

Izmantojiet Python 3.10 vai jaunāku versiju. Utilīta izmanto Python standarta bibliotēku. Pirms utilītas palaišanas izlasiet rokasgrāmatu un izmantojiet izmēģinājuma izpildi, lai pārskatītu izmaiņas.

Pašreizējā utilīta nolasa akreditācijas datus no vides mainīgajiem; ievērojiet rokasgrāmatas norādījumus par drošu ievadi. Atļauto vietņu saraksta notīrīšanai ir nepieciešams nepārprotams apstiprinājums. Noņemšanu var izpildīt bez šī apstiprinājuma, tāpēc vispirms pārbaudiet to ar izmēģinājuma izpildi.

Informāciju par atkārtotiem mēģinājumiem un neobligātām idempotences atslēgām skatiet sadaļā Droša politikas atjaunināšanas atkārtošana. Izmantojiet idempotences atslēgas tikai tad, ja darbvieta tās atbalsta, un pēc kļūmes ar neskaidru iznākumu pārbaudiet pašreizējo politiku.

Utilīta neiespējo darbvietas funkcijas un nepārbauda, vai politika tiek piemērota. Tās bezsaistes testos tiek izmantoti imitēti Microsoft Graph un ChatGPT Admin API izsaukumi.

Izmaiņas, kurām nepieciešami vairāki pieprasījumi, nav atomāras. Ja vairāku kolekciju noņemšana neizdodas procesa vidū, iepriekšējās noņemšanas darbības jau var būt sekmīgi pabeigtas. Pirms atkārtota mēģinājuma nolasiet pašreizējo politiku.

Bieži uzdotie jautājumi

Vai vietņu piekļuves iestatījumi aizstāj Microsoft atļaujas?

Nē. Lietotne joprojām izmanto katra lietotāja Microsoft atļaujas. OpenAI piemēro konfigurēto vietņu filtrēšanu, pirms atbildes tiek parādītas lietotājam un modelim.

Vai tukšs atļauto vietņu saraksts bloķē visas vietnes?

Nē. Tukšs atļauto vietņu saraksts nenozīmē “bloķēt visu”. Ja bloķēto vietņu sarakstā ir ieraksti, šīs kolekcijas paliek bloķētas. Ja nevienā sarakstā nav ierakstu, piekļuvi nosaka lietotāju Microsoft atļaujas un citi konfigurētie piekļuves nosacījumi.

Vai ar Admin API veiktās izmaiņas tiek reģistrētas?

Ar Admin API veiktās politikas izmaiņas tiek reģistrētas darbvietas audita un atbilstības žurnālos.