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 kolekcije lokacija koje vaša organizacija želi dozvoliti ili blokirati.

• Pribavite GUID svake kolekcije. Puni Microsoft Graph ID lokacije sadrži GUID kolekcije kao srednju vrijednost. Administratorski API koristi GUID-ove kolekcija; alat za CSV uvoz u korisničkom interfejsu može ih izdvojiti i iz trojki vrijednosti koje čine Graph ID-jeve lokacija.

• Omogućite Microsoftove dozvole koje zahtijeva aplikacija SharePoint i u postavkama dozvola za ChatGPT i u usluzi 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 koju želite izuzeti, uključujući oznake koje primjenjuju šifriranje.

• Za administraciju putem API-ja pribavite UUID svog radnog prostora, administratorski ključ za ChatGPT radni prostor i Microsoft Graph token ako trebate odrediti identifikatore na osnovu SharePoint URL-ova. Ta dva podatka za autentifikaciju 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 kolekcijama lokacija

Koristite kontrole radnog prostora

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

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

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

4. Pregledajte izmjene i odaberite Sačuvaj.

5. Provjerite sačuvanu politiku i testirajte konfiguraciju.

Lokacije dodane putem administratorskog API-ja prikazuju 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 je lokacija dodana ne ograničava kasnije upravljanje njome.

Pređite s dozvoljenih na blokirane lokacije ili obratno

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


Pražnjenje aktivne liste mijenja pristup čim se izmjena sačuva. Pražnjenjem liste dozvoljenih lokacija uklanja se ograničenje pristupa na te lokacije; pražnjenjem liste blokiranih lokacija uklanjaju se 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čna politika ograničiti.

Otpremite kolekcije lokacija iz CSV datoteke

Otpremanje CSV datoteke podržava samo kolekcije lokacija. Da biste izuzeli datoteke prema oznaci osjetljivosti, dodajte GUID-ove oznaka na listu izuzimanja prema oznakama osjetljivosti.

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

2. Pripremite CSV datoteku s GUID-ovima kolekcija lokacija ili trojkama vrijednosti koje čine Microsoft Graph ID-jeve lokacija. Koristite isti format identifikatora u cijeloj datoteci.

3. Odaberite Otpremi CSV datoteku i izaberite datoteku.

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

5. Odaberite Sačuvaj da primijenite izmjene, a zatim provjerite sačuvanu listu.

Zahtjevi i način rada CSV uvoza:

• Maksimalna veličina datoteke: 1 MB.

• Zaglavlja nisu obavezna.

• Koristite jedan GUID kolekcije po redu ili trojke vrijednosti koje čine Graph ID-jeve lokacija. Trojke mogu biti navedene pod navodnicima u jednom polju ili razdvojene u tri kolone.

• Graph trojke pretvaraju se u GUID-ove kolekcija. Uvozom trojke ne kreira se pravilo za tačno određenu lokaciju.

• Uvoz dodaje stavke na odabranu listu i zadržava postojeće stavke. Duplikati kolekcija se uklanjaju; broj uvezenih kolekcija odnosi se na novododane kolekcije.

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

• Otpremanje mijenja samo nacrt liste. Pristup u radnom prostoru ne mijenja se dok ne odaberete Sačuvaj.

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

Ako imate CSV datoteku sa SharePoint URL-ovima, postupak za rad s CSV datotekama u alatu Cookbook može odrediti odgovarajuće identifikatore i upravljati listom dozvoljenih lokacija putem API-ja. Njegovi ulazni podaci site_url ili url koriste drugačiji format i postupak od otpremanja identifikatora u korisničkom interfejsu.

Upoznajte se s ograničenjima politike i zahtjeva

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

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

Koristite administratorski API radnog prostora

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

Ažurirane naredbe za liste dozvoljenih lokacija i primjere zahtjeva potražite u resursu Cookbook:

• Pročitajte postojeću listu dozvoljenih lokacija.

• Pregledajte i dodajte kolekcije lokacija. Dodavanjem se zadržavaju postojeće dozvoljene kolekcije.

• Uklonite kolekciju lokacija.

• Ispraznite listu dozvoljenih lokacija.

Pregledajte trenutnu politiku prije izmjena, a zatim je ponovo pročitajte i testirajte pristup nakon izmjena. Uklanjanjem posljednje dozvoljene kolekcije ili pražnjenjem liste dozvoljenih lokacija uklanja se ograničenje pristupa na te lokacije. Ne šaljite prazan zahtjev za dodavanje osim ako namjeravate ukloniti ograničenja liste dozvoljenih lokacija.

Javno dostupan alat Cookbook trenutno upravlja samo listama dozvoljenih lokacija. Ne upravlja listama blokiranih lokacija niti 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 zaštite i sigurnosti aplikacije SharePoint.

2. U listu izuzimanja prema oznakama osjetljivosti unesite GUID svake oznake koju želite izuzeti, uključujući oznake koje primjenjuju šifriranje.

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. Sadržaj šifriranih datoteka izuzet je prema zadanim postavkama. Pristup podržanim šifriranim datotekama zahtijeva i napredni pristup datotekama (fetch_advanced) i saglasnost administratora za Microsoft Entra, kako je opisano u odjeljku s čestim pitanjima u nastavku. Izuzimanja prema oznakama i Microsoftove dozvole povezanog korisnika i dalje se primjenjuju.

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.

Česta pitanja

Trebam li dodati oznake osjetljivosti koje primjenjuju šifriranje na listu izuzimanja?

Da. Dodajte sve Microsoft Purview oznake osjetljivosti za čije datoteke želite da ih ChatGPT izuzme, uključujući oznake koje primjenjuju šifriranje.

Sadržaj šifriranih datoteka izuzet je prema zadanim postavkama. Da bi se omogućio pristup podržanim šifriranim datotekama, administrator radnog prostora mora omogućiti napredni pristup datotekama (fetch_advanced), a administrator za Microsoft Entra mora dati saglasnost za potrebne Microsoftove dozvole. Samo omogućavanje radnje bez saglasnosti administratora nije dovoljno.

Čak i nakon podešavanja, ChatGPT može dohvatiti šifrirani sadržaj samo ako povezani korisnik ima dozvolu za pristup datoteci i njeno dešifriranje. Datoteke s oznakama na vašoj listi izuzimanja ostaju izuzete. Omogućavanje naprednog pristupa datotekama ili davanje saglasnosti administratora ne poništava izuzimanja prema oznakama niti Microsoftove dozvole korisnika.

Zamjenjuju li kontrole lokacija Microsoftove dozvole?

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

Blokira li prazna lista dozvoljenih lokacija sve lokacije?

Ne. Prazna lista dozvoljenih lokacija ne znači „blokiraj sve“. Ako lista blokiranih lokacija sadrži stavke, te kolekcije ostaju blokirane. Kada nijedna lista ne sadrži stavke, pristup određuju Microsoftove dozvole korisnika i druge konfigurirane kontrole.

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

Izmjene politike izvršene putem administratorskog API-ja bilježe se u evidencijama revizije i usklađenosti radnog prostora.