Pregled

Administratori radnog prostora mogu upotrijebiti kontrole za SharePoint kako bi dopustili odobrene zbirke web-mjesta, blokirali odabrane zbirke web-mjesta i izuzeli podržane datoteke s odabranim oznakama osjetljivosti servisa Microsoft Purview.

Zbirka web-mjesta sustava SharePoint, koja se naziva i SPSite, može sadržavati više web-mjesta. Pravilo za zbirku primjenjuje se na cijelu zbirku, uz poštovanje postojećih Microsoftovih dozvola svakog korisnika. Korisniku se time ne daje pristup sadržaju kojem ne može pristupiti u sustavu Microsoft 365.

Ograničenja web-mjesta primjenjuju se na podržane radnje pretraživanja, pregledavanja, dohvaćanja datoteka te čitanja i pisanja u sustavu SharePoint. Pristupom servisu OneDrive upravlja se zasebno.

Odaberite način pristupa koji odgovara vašem pravilniku:

• Dopuštena web-mjesta: Ako popis dopuštenih nije prazan, korisnici kroz aplikaciju mogu pristupiti samo zbirkama web-mjesta na popisu.

• Blokirana web-mjesta: Korisnici mogu pristupiti zbirkama web-mjesta koje nisu na popisu blokiranih, u skladu sa svojim Microsoftovim dozvolama.

Samo jedan popis istodobno može sadržavati unose. Prazan popis dopuštenih ne blokira sva web-mjesta. Kada su oba popisa prazna, ograničenja web-mjesta sustava SharePoint uklanjaju se; Microsoftove dozvole i druge konfigurirane kontrole i dalje se primjenjuju.

Dostupnost

Kontrole i administratorski API radnog prostora moraju biti omogućeni za vaš radni prostor. Dostupne kontrole uključuju popise dopuštenih zbirki web-mjesta, popise blokiranih zbirki web-mjesta, uvoz web-mjesta iz CSV datoteka i izuzimanja prema oznakama osjetljivosti.

Pravila se primjenjuju na cijele zbirke web-mjesta. Ove kontrole zbirki web-mjesta ne uključuju ograničavanje opsega na pojedinačno web-mjesto, mapu ili datoteku ni provedbu dozvole Microsoft Sites.Selected.

Prije početka

• Odredite zbirke web-mjesta koje vaša organizacija želi dopustiti ili blokirati.

• Pribavite GUID svake zbirke. Puni ID web-mjesta iz servisa Microsoft Graph sadrži GUID zbirke kao srednju vrijednost. Administratorski API upotrebljava GUID-ove zbirki; alat za uvoz CSV datoteka u korisničkom sučelju može ih izdvojiti i iz trodijelnih ID-jeva web-mjesta iz servisa Graph.

• Omogućite potrebne Microsoftove dozvole za aplikaciju SharePoint u postavkama dozvola ChatGPT-a i u servisu Microsoft Entra, uključujući Sites.Read.All i Files.Read.All. Te kontrole filtriraju pristup na strani OpenAI-ja; ne zamjenjuju Microsoftove delegirane dozvole.

• Za izuzimanja prema oznakama osjetljivosti zatražite od administratora sustava Microsoft 365 ili servisa Purview nepromjenjivi GUID svake oznake bez šifriranja.

• Za administraciju putem API-ja pribavite UUID radnog prostora, administratorski ključ radnog prostora za ChatGPT i token za Microsoft Graph ako trebate pronaći identifikatore za URL-ove sustava SharePoint. Te dvije vjerodajnice imaju različite namjene.

O zbirci OpenAI Cookbook

OpenAI Cookbook javna je zbirka primjera koda i vodiča tvrtke OpenAI. Ovaj se članak oslanja na njezin vodič za pristup web-mjestima sustava SharePoint i administracijsku skriptu u Pythonu, koji su dostupni na GitHubu. Te poveznice možete otvoriti u pregledniku da biste pročitali datoteke. Da biste pokrenuli skriptu, preuzmite je i slijedite upute za postavljanje i naredbe iz vodiča.

U ovom se članku naziv „Cookbook” odnosi na taj vodič za SharePoint, a izraz „alat iz zbirke Cookbook” na povezanu skriptu u Pythonu. U tim izvorima potražite primjere naredbi i upute za upravljanje popisom dopuštenih putem API-ja.

Postavite vjerodajnice za administraciju putem API-ja

Napomena: za izradu administratorskih ključeva morate biti administrator radnog prostora. Pročitajte više.

Izradite administratorski ključ radnog prostora za ChatGPT

1. Otvorite administratorsku konzolu za ChatGPT i odaberite željeni radni prostor.

2. Otvorite Vjerodajnice i odaberite Administratorski ključevi.

3. Izradite ključ s dozvolama postavljenima na Ograničeno i postavite Aplikacije na Pisanje.

4. Pohranite ključ na sigurno mjesto. Taj ključ ovlašćuje čitanje i mijenjanje pravilnika za SharePoint u vašem radnom prostoru.

Potrebna je dozvola chatgpt.enterprise.apps.write. Imajte na umu da ključ za Platformu API i token za Microsoft Graph ne mogu zamijeniti administratorski ključ radnog prostora za ChatGPT.

Više informacija potražite u članku: Upravljanje administratorskim ključevima na kartici Vjerodajnice. Varijable okruženja za vjerodajnice skripte i primjer sigurnog unosa potražite u uputama za vjerodajnice u zbirci Cookbook.

Pribavite token za Microsoft Graph

Upotrijebite postupak provjere autentičnosti za Microsoft koji je odobrila vaša organizacija. Za interaktivno pronalaženje identifikatora, ako vaša organizacija dopušta Graph Explorer:

1. Otvorite Microsoft Graph Explorer i prijavite se poslovnim računom u klijentu koji sadrži web-mjesta sustava SharePoint.

2. Odaberite dozvole potrebne za čitanje web-mjesta, obično Sites.Read.All, s pomoću opcije Izmijeni dozvole ili Daj pristanak za dozvole. Zatražite od Microsoftova administratora da odobri pristup ako to vaša organizacija zahtijeva.

3. Otvorite karticu Pristupni token i kopirajte token za upotrebu sa servisom Microsoft Graph.

Microsoftove upute potražite u članku Rad s alatom Graph Explorer.

Token za Graph služi za pronalaženje identifikatora koji odgovaraju URL-ovima sustava SharePoint. Administratorski ključ za ChatGPT služi za čitanje ili ažuriranje pravilnika za ChatGPT. Alatu iz zbirke Cookbook token za Graph potreban je samo za naredbe koje pronalaze identifikatore za URL-ove; za čitanje ili pražnjenje postojećeg popisa dopuštenih potreban je samo administratorski ključ za ChatGPT.

Nijednu od tih vjerodajnica nemojte pohranjivati u sustav za upravljanje izvornim kodom, zajedničke dokumente, snimke zaslona ili zapisnike.

Pronađite GUID zbirke web-mjesta

Upotrijebite URL web-mjesta sustava SharePoint

1. Otvorite web-mjesto sustava SharePoint dok ste prijavljeni u Microsoft računom koji mu može pristupiti.

2. Na kraj URL-a web-mjesta dodajte /_api/site/id. Na primjer, upotrijebite https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopirajte GUID vraćen u odgovoru.

Napomena: domene i identifikatori navedeni kao primjeri u ovom članku služe kao rezervirana mjesta.

Upotrijebite Microsoft Graph

Microsoft Graph vraća ID web-mjesta s tri komponente odvojene zarezima: naziv glavnog računala, GUID zbirke web-mjesta i GUID web-mjesta. Za pravilo koje se odnosi na zbirku web-mjesta upotrijebite srednju vrijednost. Različiti URL-ovi web-mjesta mogu upućivati na isti GUID zbirke.

Primjere pronalaženja i identifikatora potražite u odjeljku Razumijevanje identifikatora web-mjesta sustava SharePoint. Da biste pronašli identifikatore za više URL-ova bez promjene pravilnika za ChatGPT, upotrijebite upute za provjeru u zbirci Cookbook i administracijsku skriptu u Pythonu.

Microsoftove preduvjete za pronalaženje potražite u odjeljku Dohvaćanje web-mjesta sustava SharePoint prema putanji.

Upravljajte dopuštenim i blokiranim zbirkama web-mjesta

Upotrijebite kontrole radnog prostora

1. U radnom prostoru otvorite Kontrole sigurnosti i zaštite aplikacije SharePoint.

2. U odjeljku Način pristupa odaberite Dopuštena web-mjesta ili Blokirana web-mjesta.

3. Dodajte zbirke web-mjesta na odabrani popis. Možete se poslužiti i prijenosom CSV datoteke opisanim u nastavku.

4. Pregledajte promjene i odaberite Spremi.

5. Provjerite spremljeni pravilnik i testirajte konfiguraciju.

Web-mjesta dodana putem administratorskog API-ja prikazuju se u kontrolama radnog prostora. Web-mjesta dodana u korisničkom sučelju dostupna su i putem API-ja. Unose možete dodavati ili uklanjati putem bilo kojeg od tih sučelja; način na koji je web-mjesto dodano ne ograničava kasnije upravljanje njime.

Prebacivanje između dopuštenih i blokiranih web-mjesta

Samo jedan popis istodobno može sadržavati unose. Prije dodavanja unosa u drugom načinu ispraznite postojeći popis i spremite tu promjenu. Zatim odaberite drugi način, dodajte željene zbirke i ponovno spremite.


Pražnjenje aktivnog popisa mijenja pristup čim spremite promjenu. Pražnjenjem popisa dopuštenih uklanja se njegovo ograničenje web-mjesta; pražnjenjem popisa blokiranih uklanjaju se njegove blokade. Planirajte prijelaz s drugim administratorima jer u razdoblju između pražnjenja jednog popisa i spremanja drugog može biti omogućen pristup koji će konačni pravilnik ograničiti.

Prenesite zbirke web-mjesta iz CSV datoteke

Prijenos CSV datoteke podržava samo zbirke web-mjesta. Da biste izuzeli datoteke prema oznaci osjetljivosti, dodajte GUID-ove oznaka u odjeljak Izuzete oznake osjetljivosti bez šifriranja.

1. Otvorite Kontrole sigurnosti i zaštite i odaberite željeni Način pristupa.

2. Pripremite CSV datoteku s GUID-ovima zbirki web-mjesta ili trodijelnim ID-jevima web-mjesta iz servisa Microsoft Graph. U cijeloj datoteci upotrebljavajte isti format identifikatora.

3. Odaberite Prenesi CSV datoteku i odaberite datoteku.

4. Pregledajte rezultat uvoza i odabrani popis. Prije nastavka riješite sve pogreške ili upozorenja u redcima.

5. Odaberite Spremi da biste primijenili promjene, a zatim provjerite spremljeni popis.

Preduvjeti i ponašanje pri prijenosu CSV datoteke:

• Najveća veličina datoteke: 1 MB.

• Zaglavlja nisu obavezna.

• Upotrijebite jedan GUID zbirke po retku ili trodijelne ID-jeve web-mjesta iz servisa Graph. Trodijelni ID-jevi mogu biti navedeni pod navodnicima u jednom polju ili raspoređeni u tri stupca.

• Trodijelni ID-jevi iz servisa Graph pretvaraju se u GUID-ove zbirki. Uvozom trodijelnog ID-ja ne stvara se pravilo za pojedinačno web-mjesto.

• Uvozom se dodaju unosi na odabrani popis, a postojeći se zadržavaju. Duplikati zbirki uklanjaju se; broj uvezenih zbirki odnosi se na novododane zbirke.

• Miješani formati i nepravilno oblikovani redci odbacuju se. Ako prenesena datoteka sadrži samo URL-ove web-mjesta, prikazuje se upozorenje i web-mjesta se ne dodaju. Najprije pronađite GUID-ove zbirki koji odgovaraju URL-ovima.

• Prijenos mijenja samo radnu verziju popisa. Pristup u radnom prostoru ne ažurira se dok ne odaberete Spremi.

• Ovdje opisani prijenos CSV datoteke služi za upravljanje zbirkama web-mjesta. Izuzimanja prema oznakama osjetljivosti konfigurirajte zasebno.

Ako imate CSV datoteku s URL-ovima sustava SharePoint, postupak za CSV u alatu iz zbirke Cookbook omogućuje pronalaženje njihovih identifikatora i upravljanje popisom dopuštenih putem API-ja. Njegov unos site_url ili url upotrebljava drukčiji format i postupak od prijenosa identifikatora u korisničkom sučelju.

Upoznajte se s ograničenjima pravilnika i zahtjeva

Zadano ograničenje pravilnika iznosi 10.000 zbirki web-mjesta. Viša ograničenja pravilnika radnog prostora, do 120.000 zbirki web-mjesta, mora omogućiti OpenAI; prije planiranja veće implementacije obratite se svojem timu u OpenAI-ju.

Pojedinačne operacije izmjene putem API-ja i trenutačna skripta iz zbirke Cookbook prihvaćaju do 10.000 GUID-ova zbirki po zahtjevu. Više ograničenje pravilnika radnog prostora ne povećava to ograničenje po zahtjevu. Brojite jedinstvene zbirke web-mjesta, a ne izvorne URL-ove: više URL-ova može upućivati na istu zbirku.

Upotrijebite administratorski API radnog prostora

Upotrijebite UUID svojeg radnog prostora i administratorski ključ radnog prostora za ChatGPT uz https://api.chatgpt.com.

Ažurirane naredbe za popis dopuštenih i primjere zahtjeva potražite u zbirci Cookbook:

• Čitanje postojećeg popisa dopuštenih.

• Pregled i dodavanje zbirki web-mjesta. Pri dodavanju se zadržavaju postojeće dopuštene zbirke.

• Uklanjanje zbirke web-mjesta.

• Pražnjenje popisa dopuštenih.

Prije izmjena pregledajte trenutačni pravilnik, a zatim ga ponovno pročitajte i testirajte pristup nakon promjena. Uklanjanjem posljednje dopuštene zbirke ili pražnjenjem popisa dopuštenih uklanja se to ograničenje web-mjesta. Nemojte slati prazan zahtjev za dodavanje osim ako želite ukloniti ograničenja popisa dopuštenih.

Javno dostupan alat iz zbirke Cookbook trenutačno upravlja samo popisima dopuštenih. Ne upravlja popisima blokiranih ni izuzimanjima prema oznakama osjetljivosti. Za te zadatke upotrijebite prethodno opisane kontrole radnog prostora.

Izuzmite datoteke s oznakama osjetljivosti

Pronađite GUID oznake

Zatražite od administratora sustava Microsoft 365 ili servisa Purview nepromjenjivi GUID željene oznake. Upotrijebite GUID, a ne prikazni naziv oznake.

Administrator može dobiti popis oznaka putem servisa Microsoft Graph. Token mora imati odgovarajuću dozvolu SensitivityLabel.Read ili SensitivityLabels.Read.All. Povežite naziv željene oznake s njezinim ID-jem i provjerite njezine postavke zaštite.

Preduvjete i primjere potražite u člancima Popis oznaka osjetljivosti i Svojstva oznaka osjetljivosti. Te dozvole za oznake odvojene su od dozvole za čitanje web-mjesta koja se upotrebljava za pronalaženje identifikatora za URL-ove sustava SharePoint.

Dodajte izuzimanja prema oznakama

1. Otvorite Kontrole sigurnosti i zaštite aplikacije SharePoint.

2. Unesite GUID svake oznake bez šifriranja u odjeljak Izuzete oznake osjetljivosti bez šifriranja.

3. Spremite konfiguraciju i testirajte podržanu datoteku s izuzetom oznakom.

Datoteke s odgovarajućim podržanim oznakama izuzimaju se iz rezultata aplikacije SharePoint. Datoteke s oznakama koje primjenjuju šifriranje već su izuzete prema zadanim postavkama.

Testirajte konfiguraciju

Upotrebljavajte testne datoteke i račune koje je odobrila vaša organizacija. Prije testiranja potvrdite da isti Microsoftov račun može pristupiti svakoj datoteci izravno u sustavu SharePoint.

1. U načinu Dopuštena web-mjesta s popisom koji nije prazan provjerite datoteku u dopuštenoj zbirci i datoteku u zbirci koja nije na popisu. Kroz aplikaciju bi trebala biti dostupna samo dopuštena zbirka.

2. U načinu Blokirana web-mjesta provjerite datoteku u blokiranoj zbirci i datoteku u zbirci koja nije blokirana. Blokirana zbirka trebala bi biti nedostupna; na zbirku koja nije blokirana i dalje se primjenjuju Microsoftove dozvole i druge kontrole.

3. Provjerite podržanu testnu datoteku s izuzetom oznakom osjetljivosti. Ne bi se trebala pojavljivati u rezultatima aplikacije.

4. Nakon promjene putem API-ja usporedite spremljeni popis u korisničkom sučelju s pravilnikom koji vraća API.

5. Nakon prijenosa CSV datoteke spremite promjene i ponovno otvorite kontrole da biste potvrdili da su željene zbirke zadržane.

Ako rezultati ne odgovaraju željenom pravilniku, provjerite radni prostor, odabrani način pristupa, spremljeni popis, GUID-ove zbirki, GUID-ove oznaka, podržanu vrstu datoteke i korisnikove Microsoftove dozvole. Nemojte prazniti popis radi otklanjanja poteškoća osim ako želite promjenu pristupa koja će time nastati.

Za pomoć s kontrolama koje nedostaju ili neočekivanim pristupom pogledajte: Kontaktiranje podrške za OpenAI. U zahtjev za podršku nemojte uključivati administratorske ključeve ni tokene za Microsoft Graph.

Upoznajte se s ograničenjima

• Pravilo za zbirku obuhvaća cijelu zbirku web-mjesta. Njime se pristup ne može ograničiti na određeno podmjesto, mapu ili datoteku.

• Ograničenja web-mjesta sustava SharePoint ne ograničavaju automatski pristup servisu OneDrive.

• Filtriranje prema oznakama osjetljivosti primjenjuje se samo ondje gdje Microsoft Graph omogućuje pristup metapodacima podržanih oznaka, uključujući podržane dokumente sustava Office te datoteke PDF i MP4.

• Vrste datoteka koje ne podržavaju oznake osjetljivosti, kao što su TXT i CSV, smatraju se neoznačenima. Ostaju dostupne ako je pristup inače dopušten. To ograničenje vrsta datoteka nije povezano s prijenosom CSV datoteke radi konfiguriranja pristupa web-mjestima.

• Prijenosom CSV datoteke i javno dostupnim oglednim alatom ne konfiguriraju se izuzimanja prema oznakama osjetljivosti. Ovaj članak ne opisuje API za skupno upravljanje oznakama.

• Spremljeni pravilnik ili uspješan odgovor API-ja nisu zamjena za testiranje pristupa predviđenim računom.

Upotrijebite administracijski alat u Pythonu

Cjelovit primjer koda i naredbe održavaju se u zbirci OpenAI Cookbook:

• Vodič za administraciju.

• Administracijska skripta u Pythonu.

• Datoteka za izvanmrežno testiranje.

Upotrijebite Python 3.10 ili noviji. Alat upotrebljava standardnu biblioteku Pythona. Prije pokretanja pročitajte vodič i pregledajte promjene probnim izvođenjem bez njihove primjene.

Trenutačna verzija alata čita vjerodajnice iz varijabli okruženja; slijedite upute za siguran unos iz vodiča. Za pražnjenje popisa dopuštenih potrebna je izričita potvrda. Uklanjanje se može izvršiti bez te potvrde, stoga ga najprije pregledajte probnim izvođenjem bez primjene promjena.

Ponašanje pri ponovnom pokušaju i neobavezne ključeve idempotentnosti potražite u odjeljku Sigurno ponavljanje ažuriranja pravilnika. Ključeve idempotentnosti upotrebljavajte samo ako ih radni prostor podržava, a nakon pogreške s nejasnim ishodom provjerite trenutačni pravilnik.

Alat ne omogućuje značajke radnog prostora niti provjerava provedbu pravila. Njegovi izvanmrežni testovi upotrebljavaju simulirane pozive za Microsoft Graph i administratorski API za ChatGPT.

Promjene koje obuhvaćaju više zahtjeva nisu atomske. Ako uklanjanje više zbirki ne uspije usred postupka, prethodna uklanjanja možda su već uspjela. Prije ponovnog pokušaja pročitajte trenutačni pravilnik.

Česta pitanja

Zamjenjuju li kontrole web-mjesta Microsoftove dozvole?

Ne. Aplikacija i dalje upotrebljava Microsoftove dozvole svakog korisnika. OpenAI primjenjuje konfigurirano filtriranje web-mjesta prije nego što se odgovori prikažu korisniku i modelu.

Blokira li prazan popis dopuštenih sva web-mjesta?

Ne. Prazan popis dopuštenih ne znači „blokiraj sve”. Ako popis blokiranih sadrži unose, te zbirke ostaju blokirane. Kada nijedan popis ne sadrži unose, pristup određuju korisnikove Microsoftove dozvole i druge konfigurirane kontrole.

Bilježe li se promjene izvršene putem administratorskog API-ja?

Promjene pravilnika izvršene putem administratorskog API-ja bilježe se u zapisnicima za reviziju i usklađenost radnog prostora.