Pregled

Administratori radnog prostora mogu koristiti SharePoint kontrole da dozvole odobrene zbirke lokacija, blokiraju odabrane zbirke lokacija i izuzmu podržane datoteke s odabranim oznakama osjetljivosti iz servisa Microsoft Purview.

Zbirka SharePoint lokacija, koja se naziva i SPSite, može sadržavati više lokacija. Pravilo za zbirku primjenjuje se na cijelu zbirku, uz poštivanje postojećih Microsoftovih dozvola svakog korisnika. Ono korisniku ne daje pristup sadržaju kojem ne može pristupiti u servisu Microsoft 365.

Ograničenja lokacija primjenjuju se na podržane radnje pretraživanja, pregledavanja, dohvatanja datoteka te čitanja i pisanja u SharePointu. Pristupom servisu OneDrive upravlja se zasebno.

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

• Dozvoljene lokacije: Ako lista dozvoljenih nije prazna, korisnici putem aplikacije mogu pristupiti samo navedenim zbirkama lokacija.

• Blokirane lokacije: Korisnici mogu pristupiti zbirkama lokacija koje nisu na listi blokiranih, u skladu sa svojim Microsoftovim dozvolama.

Samo jedna lista može sadržavati stavke u datom trenutku. Prazna lista dozvoljenih ne blokira sve lokacije. Kada su obje liste prazne, ograničenja SharePoint lokacija se uklanjaju; Microsoftove dozvole i druge podešene kontrole i dalje se primjenjuju.

Dostupnost

Kontrole i Admin API radnog prostora moraju biti omogućeni za vaš radni prostor. Dostupne kontrole uključuju liste dozvoljenih zbirki lokacija, liste blokiranih zbirki lokacija, uvoz lokacija iz CSV datoteka i izuzimanja prema oznakama osjetljivosti.

Pravila se primjenjuju na cijele zbirke lokacija. Ove kontrole za zbirke lokacija ne uključuju ograničavanje opsega na tačno određenu lokaciju, fasciklu ili datoteku niti primjenu dozvole Microsoft Sites.Selected.

Prije nego što počnete

• Odredite zbirke lokacija koje vaša organizacija želi dozvoliti ili blokirati.

• Pribavite GUID svake zbirke. Puni ID lokacije iz servisa Microsoft Graph sadrži GUID zbirke kao srednju vrijednost. Admin API koristi GUID-ove zbirki; alat za uvoz CSV datoteka u korisničkom interfejsu može ih izdvojiti i iz trodijelnih ID-ova lokacija iz servisa Graph.

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

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

• Za administraciju putem API-ja pribavite UUID radnog prostora, administratorski ključ ChatGPT radnog prostora i Microsoft Graph token ako trebate odrediti identifikatore na osnovu SharePoint URL-ova. Te dvije vjerodajnice imaju različite namjene.

O zbirci OpenAI Cookbook

OpenAI Cookbook je javna zbirka primjera koda i vodiča kompanije OpenAI. Ovaj članak koristi njen vodič za pristup SharePoint lokacijama i Python skriptu za administraciju, koji su dostupni na GitHubu. Ove linkove 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 članku „Cookbook“ označava taj vodič za SharePoint, a „alat Cookbook“ označava povezanu Python skriptu. Koristite ove izvore za primjere naredbi i upravljanje listom dozvoljenih putem API-ja.

Postavite vjerodajnice za administraciju putem API-ja

Napomena: morate biti administrator radnog prostora da biste mogli kreirati administratorske ključeve. Pročitajte više.

Kreirajte administratorski ključ ChatGPT radnog prostora

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

2. Idite na Vjerodajnice i odaberite Administratorski ključevi.

3. Kreirajte ključ s dozvolama postavljenim na Ograničeno, a za Aplikacije odaberite Pisanje.

4. Pohranite ključ na sigurno mjesto. Ovaj ključ omogućava čitanje i mijenjanje SharePoint pravila za vaš radni prostor.

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

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

Pribavite Microsoft Graph token

Koristite postupak Microsoft autentifikacije koji je odobrila vaša organizacija. Za interaktivno pretraživanje, ako vaša organizacija dozvoljava Graph Explorer:

1. Otvorite Microsoft Graph Explorer i prijavite se poslovnim računom u organizacijskom okruženju koje sadrži SharePoint lokacije.

2. Odaberite dozvole potrebne za čitanje lokacija, obično Sites.Read.All, putem opcije Izmijeni dozvole ili Daj saglasnost za dozvole. Zatražite od Microsoft administratora da odobri pristup ako vaša organizacija to zahtijeva.

3. Otvorite karticu Pristupni token i kopirajte token za korištenje sa servisom Microsoft Graph.

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

Graph token služi za određivanje identifikatora na osnovu SharePoint URL-ova. Administratorski ključ za ChatGPT služi za čitanje ili ažuriranje pravila za ChatGPT. Alatu Cookbook Graph token je potreban samo za naredbe koje određuju identifikatore na osnovu URL-ova; za čitanje ili pražnjenje postojeće liste dozvoljenih potreban je samo administratorski ključ za ChatGPT.

Nijednu vjerodajnicu nemojte stavljati u sistem za kontrolu verzija, dijeljene dokumente, snimke ekrana ili zapisnike.

Pronađite GUID zbirke lokacija

Koristite URL SharePoint lokacije

1. Otvorite SharePoint lokaciju dok ste prijavljeni u Microsoft računom koji joj može pristupiti.

2. Na kraj URL-a lokacije dodajte /_api/site/id. Naprimjer, koristite https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopirajte GUID vraćen u odgovoru.

Napomena: domene i identifikatori u primjerima u ovom članku služe kao zamjenske vrijednosti.

Koristite Microsoft Graph

Microsoft Graph vraća ID lokacije s tri komponente odvojene zarezima: naziv hosta, GUID zbirke lokacija i GUID lokacije. Za pravilo koje se odnosi na zbirku lokacija koristite srednju vrijednost. Različiti URL-ovi lokacija mogu odgovarati istom GUID-u zbirke.

Primjere pretraživanja i identifikatora potražite u odjeljku Razumijevanje identifikatora SharePoint lokacija. Da biste odredili identifikatore za više URL-ova bez promjene pravila za ChatGPT, koristite upute za provjeru u vodiču Cookbook i Python skriptu za administraciju.

Microsoftove zahtjeve za pretraživanje potražite u odjeljku Dohvatanje SharePoint lokacije putem putanje.

Upravljajte dozvoljenim i blokiranim zbirkama lokacija

Koristite kontrole radnog prostora

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

2. U odjeljku Način pristupa odaberite Dozvoljene lokacije ili Blokirane lokacije.

3. Dodajte zbirke lokacija na odabranu listu. Možete koristiti i otpremanje CSV datoteke opisano u nastavku.

4. Pregledajte promjene i odaberite Sačuvaj.

5. Provjerite sačuvano pravilo i testirajte konfiguraciju.

Lokacije dodane putem Admin API-ja pojavljuju se u kontrolama radnog prostora. Lokacije dodane u korisničkom interfejsu dostupne su i putem API-ja. Stavke možete dodavati ili uklanjati putem oba interfejsa; način na koji ste dodali lokaciju ne ograničava kako njome kasnije upravljate.

Prebacivanje između dozvoljenih i blokiranih lokacija

Samo jedna lista može sadržavati stavke u datom trenutku. Prije dodavanja stavki u drugom načinu ispraznite postojeću listu i sačuvajte tu promjenu. Zatim odaberite drugi način, dodajte željene zbirke i ponovo sačuvajte.


Pražnjenje aktivne liste mijenja pristup odmah nakon čuvanja. Pražnjenjem liste dozvoljenih uklanja se njeno ograničenje pristupa lokacijama; pražnjenjem liste blokiranih uklanjaju se njene blokade. Planirajte prelazak s drugim administratorima jer u periodu između pražnjenja jedne liste i čuvanja druge može biti omogućen pristup koji će konačno pravilo ograničiti.

Otpremite zbirke lokacija iz CSV datoteke

Otpremanje CSV datoteke podržava samo zbirke lokacija. 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 lokacija ili trodijelnim ID-ovima lokacija iz servisa Microsoft Graph. Koristite isti format identifikatora u cijeloj datoteci.

3. Odaberite Otpremi CSV datoteku i izaberite datoteku.

4. Pregledajte rezultat uvoza i odabranu listu. Prije nastavka riješite sve greške ili upozorenja za redove.

5. Odaberite Sačuvaj da biste primijenili promjene, a zatim provjerite sačuvanu listu.

Zahtjevi i ponašanje pri uvozu CSV datoteke:

• Maksimalna veličina datoteke: 1 MB.

• Zaglavlja nisu obavezna.

• Koristite jedan GUID zbirke po redu ili trodijelne ID-ove lokacija iz servisa Graph. Trodijelne vrijednosti mogu biti navedene pod navodnicima u jednom polju ili raspoređene u tri kolone.

• Trodijelne vrijednosti iz servisa Graph pretvaraju se u GUID-ove zbirki. Uvozom trodijelne vrijednosti ne stvara se pravilo za pojedinačnu lokaciju.

• Uvoz dodaje stavke na odabranu listu i zadržava postojeće stavke. Duplikati zbirki se uklanjaju; broj uvezenih stavki prikazuje novododane zbirke.

• Miješani formati i nepravilno oblikovani redovi se odbijaju. Ako otpremljena datoteka sadrži samo URL-ove lokacija, prikazuje se upozorenje i lokacije se ne dodaju. Prvo odredite GUID-ove zbirki na osnovu URL-ova.

• Otpremanjem se mijenja samo nacrt liste. Pristup u radnom prostoru ne ažurira se dok ne odaberete Sačuvaj.

• Ovdje opisano otpremanje CSV datoteke služi za upravljanje zbirkama lokacija. Izuzimanja prema oznakama osjetljivosti podesite zasebno.

Ako imate CSV datoteku s URL-ovima SharePoint lokacija, postupak rada s CSV datotekama u alatu Cookbook može odrediti njihove identifikatore i upravljati listom dozvoljenih putem API-ja. Unos site_url ili url u tom alatu koristi drugačiji format i postupak od otpremanja identifikatora u korisničkom interfejsu.

Upoznajte se s ograničenjima pravila i zahtjeva

Zadano ograničenje pravila je 10.000 zbirki lokacija. Viša ograničenja pravila radnog prostora, do 120.000 zbirki lokacija, mora omogućiti OpenAI; obratite se svom OpenAI timu prije planiranja primjene većeg obima.

Pojedinačne operacije izmjene putem API-ja i trenutna skripta Cookbook prihvataju do 10.000 GUID-ova zbirki po zahtjevu. Više ograničenje pravila radnog prostora ne povećava ovo ograničenje po zahtjevu. Brojite jedinstvene zbirke lokacija, a ne izvorne URL-ove: više URL-ova može upućivati na istu zbirku.

Koristite Admin API radnog prostora

Koristite UUID svog radnog prostora i administratorski ključ ChatGPT radnog prostora za https://api.chatgpt.com.

Ažurne naredbe za listu dozvoljenih i primjere zahtjeva potražite u vodiču Cookbook:

• Čitanje postojeće liste dozvoljenih.

• Pregled i dodavanje zbirki lokacija. Dodavanjem se zadržavaju postojeće dozvoljene zbirke.

• Uklanjanje zbirke lokacija.

• Pražnjenje liste dozvoljenih.

Pregledajte trenutno pravilo prije promjena, zatim ga ponovo pročitajte i testirajte pristup nakon promjena. Uklanjanjem posljednje dozvoljene zbirke ili pražnjenjem liste dozvoljenih uklanja se to ograničenje pristupa lokacijama. Nemojte slati prazan zahtjev za dodavanje osim ako namjeravate ukloniti ograničenja liste dozvoljenih.

Javno dostupan alat Cookbook trenutno upravlja samo listama dozvoljenih. Ne upravlja listama blokiranih ni izuzimanjima prema oznakama osjetljivosti. Za te zadatke koristite prethodno opisane kontrole radnog prostora.

Izuzmite datoteke s oznakama osjetljivosti

Pronađite GUID oznake

Zatražite od administratora za Microsoft 365 ili Purview nepromjenjivi GUID željene oznake. Koristite GUID, a ne prikazani naziv oznake.

Administrator može izlistati oznake putem servisa Microsoft Graph. Token mora imati odgovarajuću dozvolu SensitivityLabel.Read ili SensitivityLabels.Read.All. Povežite naziv željene oznake s njenim ID-om i provjerite njene postavke zaštite.

Zahtjeve i primjere potražite u odjeljcima Prikaz liste oznaka osjetljivosti i Svojstva oznake osjetljivosti. Ove dozvole za oznake odvojene su od dozvole za čitanje lokacija koja se koristi za određivanje identifikatora na osnovu SharePoint URL-ova.

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. Sačuvajte 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

Koristite testne datoteke i račune koje je odobrila vaša organizacija. Prije testiranja potvrdite da isti Microsoft račun može pristupiti svakoj datoteci direktno u SharePointu.

1. U načinu Dozvoljene lokacije, kada lista nije prazna, provjerite datoteku u dozvoljenoj zbirci i datoteku u zbirci koja nije na listi. Samo dozvoljena zbirka treba biti dostupna putem aplikacije.

2. U načinu Blokirane lokacije provjerite datoteku u blokiranoj zbirci i datoteku u neblokiranoj zbirci. Blokirana zbirka treba biti nedostupna; na neblokiranu zbirku i dalje se primjenjuju Microsoftove dozvole i druge kontrole.

3. Provjerite podržanu testnu datoteku koja ima izuzetu oznaku osjetljivosti. Ne bi se trebala pojaviti u rezultatima aplikacije.

4. Nakon promjene putem API-ja uporedite sačuvanu listu u korisničkom interfejsu s pravilom koje API vraća.

5. Nakon otpremanja CSV datoteke sačuvajte promjene i ponovo otvorite kontrole kako biste potvrdili da su željene zbirke zadržane.

Ako se rezultati razlikuju od predviđenog pravila, provjerite radni prostor, odabrani način pristupa, sačuvanu listu, GUID-ove zbirki, GUID-ove oznaka, podržanu vrstu datoteke i korisnikove Microsoftove dozvole. Nemojte prazniti listu radi rješavanja problema osim ako namjeravate izvršiti promjenu pristupa koja time nastaje.

Za pomoć u slučaju nedostajućih kontrola ili neočekivanog pristupa pogledajte: Kontaktiranje podrške kompanije OpenAI. U zahtjev za podršku nemojte uključivati administratorske ključeve ni Microsoft Graph tokene.

Upoznajte se s ograničenjima

• Pravilo za zbirku obuhvata cijelu zbirku lokacija. Njime se pristup ne može ograničiti na određenu podlokaciju, fasciklu ili datoteku.

• Ograničenja SharePoint lokacija ne ograničavaju automatski pristup servisu OneDrive.

• Filtriranje prema oznakama osjetljivosti primjenjuje se samo tamo gdje Microsoft Graph izlaže podržane metapodatke oznaka, uključujući podržane Office dokumente, PDF i MP4 datoteke.

• Vrste datoteka koje ne podržavaju oznake osjetljivosti, kao što su TXT i CSV, tretiraju se kao neoznačene. One ostaju dostupne ako je pristup inače dozvoljen. Ovo ograničenje vrste datoteke nije povezano s otpremanjem CSV datoteke radi podešavanja pristupa lokacijama.

• Otpremanjem CSV datoteke i javno dostupnim primjerom uslužnog alata ne podešavaju se izuzimanja prema oznakama osjetljivosti. Ovaj članak ne dokumentira API za grupno upravljanje oznakama.

• Sačuvano pravilo ili uspješan odgovor API-ja ne zamjenjuju testiranje pristupa predviđenim računom.

Koristite Python alat za administraciju

Cjeloviti primjeri koda i naredbi održavaju se u zbirci OpenAI Cookbook:

• Vodič za administraciju.

• Python skripta za administraciju.

• Datoteka za testiranje bez mrežne veze.

Koristite Python 3.10 ili noviju verziju. Alat koristi standardnu Python biblioteku. Prije pokretanja pročitajte vodič, a promjene pregledajte probnim pokretanjem bez primjene promjena.

Trenutna verzija alata čita vjerodajnice iz varijabli okruženja; slijedite upute za siguran unos iz vodiča. Za pražnjenje liste dozvoljenih potrebna je izričita potvrda. Uklanjanje se može izvršiti bez te potvrde, pa ga prvo provjerite probnim pokretanjem.

Informacije o ponašanju pri ponovnom pokušaju i opcionalnim ključevima idempotentnosti potražite u odjeljku Sigurno ponavljanje ažuriranja pravila. Ključeve idempotentnosti koristite samo ako ih radni prostor podržava, a nakon neuspjeha s nejasnim ishodom provjerite trenutno pravilo.

Alat ne omogućava funkcije radnog prostora niti provjerava primjenu pravila. Njegovi testovi bez mrežne veze koriste simulirane pozive za Microsoft Graph i ChatGPT Admin API.

Promjene koje obuhvataju više zahtjeva nisu atomske. Ako uklanjanje više zbirki ne uspije usred postupka, ranija uklanjanja možda su već uspjela. Prije ponovnog pokušaja pročitajte trenutno pravilo.

Često postavljana pitanja

Zamjenjuju li kontrole lokacija Microsoftove dozvole?

Ne. Aplikacija i dalje koristi Microsoftove dozvole svakog korisnika. OpenAI primjenjuje podešeno filtriranje lokacija prije nego što se odgovori prikažu korisniku i modelu.

Blokira li prazna lista dozvoljenih sve lokacije?

Ne. Prazna lista dozvoljenih ne znači „blokiraj sve“. Ako lista blokiranih sadrži stavke, te zbirke ostaju blokirane. Kada nijedna lista ne sadrži stavke, pristup određuju korisnikove Microsoftove dozvole i druge podešene kontrole.

Bilježe li se promjene putem Admin API-ja?

Promjene pravila putem Admin API-ja bilježe se u zapisnicima radnog prostora za reviziju i usklađenost.