Pregled

Skrbniki delovnega prostora lahko s kontrolniki za SharePoint dovolijo odobrene zbirke mest, blokirajo izbrane zbirke mest in izključijo podprte datoteke z izbranimi oznakami občutljivosti Microsoft Purview.

SharePointova zbirka mest, imenovana tudi SPSite, lahko vsebuje več mest. Pravilo za zbirko velja za celotno zbirko ob upoštevanju obstoječih Microsoftovih dovoljenj vsakega uporabnika. Uporabniku ne omogoči dostopa do vsebine, do katere ne more dostopati v storitvi Microsoft 365.

Omejitve za mesta veljajo za podprte operacije iskanja, brskanja, pridobivanja datotek ter branja in pisanja v SharePointu. Dostop do storitve OneDrive se upravlja ločeno.

Izberite način dostopa, ki ustreza vašemu pravilniku:

• Dovoljena mesta: Če seznam dovoljenih mest ni prazen, lahko uporabniki prek aplikacije dostopajo samo do navedenih zbirk mest.

• Blokirana mesta: Uporabniki lahko ob upoštevanju svojih Microsoftovih dovoljenj dostopajo do zbirk mest, ki niso na seznamu blokiranih mest.

Vnose lahko hkrati vsebuje le en seznam. Prazen seznam dovoljenih mest ne blokira vseh mest. Ko sta oba seznama prazna, se omejitve za SharePointova mesta odstranijo; Microsoftova dovoljenja in drugi nastavljeni kontrolniki še vedno veljajo.

Razpoložljivost

Kontrolnike in skrbniški API delovnega prostora je treba omogočiti za vaš delovni prostor. Razpoložljivi kontrolniki vključujejo sezname dovoljenih zbirk mest, sezname blokiranih zbirk mest, uvoz mest iz datotek CSV in izključitve po oznakah občutljivosti.

Pravila veljajo za celotne zbirke mest. Ti kontrolniki za zbirke mest ne vključujejo omejevanja na točno določeno posamezno mesto, mapo ali datoteko niti uveljavljanja dovoljenja Microsoft Sites.Selected.

Preden začnete

• Določite zbirke mest, ki jih želi vaša organizacija dovoliti ali blokirati.

• Pridobite GUID vsake zbirke. Celoten ID mesta v storitvi Microsoft Graph vsebuje GUID zbirke kot srednjo vrednost. Skrbniški API uporablja GUID-je zbirk; uvoznik CSV v uporabniškem vmesniku jih lahko tudi izlušči iz tridelnih ID-jev mest iz storitve Graph.

• Omogočite zahtevana Microsoftova dovoljenja za aplikacijo SharePoint v nastavitvah dovoljenj v ChatGPT in v storitvi Microsoft Entra, vključno z Sites.Read.All in Files.Read.All. Ti kontrolniki filtrirajo dostop na strani OpenAI; ne nadomeščajo Microsoftovih delegiranih dovoljenj.

• Za izključitve po oznakah občutljivosti prosite skrbnika storitve Microsoft 365 ali Purview za nespremenljivi GUID vsake oznake brez šifriranja.

• Za upravljanje prek API-ja pridobite UUID delovnega prostora, skrbniški ključ delovnega prostora ChatGPT in žeton za Microsoft Graph, če morate poiskati identifikatorje za SharePointove URL-je. Ti poverilnici imata različna namena.

O zbirki OpenAI Cookbook

OpenAI Cookbook je javna zbirka vzorčne kode in vodnikov podjetja OpenAI. Ta članek uporablja vodnik za dostop do SharePointovih mest in skrbniški skript v Pythonu iz te zbirke; oba sta gostovana na GitHubu. Ti povezavi lahko odprete v brskalniku in preberete datoteki. Če želite zagnati skript, ga prenesite ter upoštevajte navodila za nastavitev in ukaze v vodniku.

V tem članku se »Cookbook« nanaša na ta vodnik za SharePoint, »orodje iz zbirke Cookbook« pa na povezani skript v Pythonu. V teh virih najdete primere ukazov in navodila za upravljanje seznama dovoljenih mest prek API-ja.

Nastavite poverilnice za upravljanje prek API-ja

Opomba: za ustvarjanje skrbniških ključev morate biti skrbnik delovnega prostora. Preberite več.

Ustvarite skrbniški ključ delovnega prostora ChatGPT

1. Odprite skrbniško konzolo ChatGPT in izberite želeni delovni prostor.

2. Pojdite v razdelek Poverilnice in izberite Skrbniški ključi.

3. Ustvarite ključ z dovoljenji Omejeno in za Aplikacije nastavite Pisanje.

4. Ključ varno shranite. Ta ključ dovoljuje branje in spreminjanje pravilnika za SharePoint v vašem delovnem prostoru.

Zahtevano dovoljenje je chatgpt.enterprise.apps.write. Upoštevajte, da ključ za Platformo API in žeton za Microsoft Graph ne moreta nadomestiti skrbniškega ključa delovnega prostora ChatGPT.

Za več informacij glejte: Upravljanje skrbniških ključev na zavihku Poverilnice. Za spremenljivke okolja s poverilnicami za skript in primer varnega vnosa glejte navodila za poverilnice v zbirki Cookbook.

Pridobite žeton za Microsoft Graph

Uporabite Microsoftov postopek preverjanja pristnosti, ki ga je odobrila vaša organizacija. Za interaktivno poizvedbo, če vaša organizacija dovoljuje Graph Explorer:

1. Odprite Microsoft Graph Explorer in se prijavite s službenim računom v najemniku, ki vsebuje SharePointova mesta.

2. Z možnostjo Spremeni dovoljenja ali Podaj soglasje za dovoljenja izberite dovoljenja, potrebna za branje mest, običajno Sites.Read.All. Če vaša organizacija to zahteva, prosite Microsoftovega skrbnika, da odobri dostop.

3. Odprite zavihek Žeton za dostop in kopirajte žeton za uporabo s storitvijo Microsoft Graph.

Za Microsoftova navodila glejte Delo z orodjem Graph Explorer.

Žeton za Graph omogoča iskanje identifikatorjev za SharePointove URL-je. Skrbniški ključ za ChatGPT omogoča branje ali posodabljanje pravilnika v ChatGPT. Orodje iz zbirke Cookbook potrebuje žeton za Graph le za ukaze, ki poiščejo identifikatorje za URL-je; za branje ali izpraznitev obstoječega seznama dovoljenih mest je potreben samo skrbniški ključ za ChatGPT.

Nobene od teh poverilnic ne shranjujte v sistem za nadzor različic, skupne dokumente, posnetke zaslona ali dnevnike.

Poiščite GUID zbirke mest

Uporabite URL SharePointovega mesta

1. Odprite SharePointovo mesto, medtem ko ste v Microsoft prijavljeni z računom, ki ima dostop do njega.

2. URL-ju mesta dodajte /_api/site/id. Uporabite na primer https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopirajte GUID, vrnjen v odgovoru.

Opomba: domene in identifikatorji v primerih v tem članku so zgolj nadomestne vrednosti.

Uporabite Microsoft Graph

Microsoft Graph vrne ID mesta s tremi deli, ločenimi z vejicami: imenom gostitelja, GUID-jem zbirke mest in GUID-jem mesta. Za pravilo za zbirko mest uporabite srednjo vrednost. Različni URL-ji mest lahko ustrezajo istemu GUID-ju zbirke.

Za primere poizvedb in identifikatorjev glejte Razumevanje identifikatorjev SharePointovih mest. Če želite poiskati identifikatorje za več URL-jev, ne da bi spremenili pravilnik v ChatGPT, uporabite navodila za pregled v zbirki Cookbook in skrbniški skript v Pythonu.

Za Microsoftove zahteve za poizvedbe glejte Pridobivanje SharePointovega mesta po poti.

Upravljajte dovoljene in blokirane zbirke mest

Uporabite kontrolnike delovnega prostora

1. V delovnem prostoru odprite Kontrolnike za varnost in zaščito aplikacije SharePoint.

2. V razdelku Način dostopa izberite Dovoljena mesta ali Blokirana mesta.

3. Dodajte zbirke mest na izbrani seznam. Uporabite lahko tudi nalaganje datoteke CSV, opisano spodaj.

4. Preglejte spremembe in izberite Shrani.

5. Preverite shranjeni pravilnik in preizkusite konfiguracijo.

Mesta, dodana prek skrbniškega API-ja, so prikazana v kontrolnikih delovnega prostora. Mesta, dodana v uporabniškem vmesniku, so na voljo tudi prek API-ja. Vnose lahko dodajate ali odstranjujete prek obeh vmesnikov; način, s katerim dodate mesto, ne omejuje njegovega nadaljnjega upravljanja.

Preklopite med dovoljenimi in blokiranimi mesti

Vnose lahko hkrati vsebuje le en seznam. Preden dodate vnose v drugem načinu, izpraznite obstoječi seznam in shranite spremembo. Nato izberite drugi način, dodajte želene zbirke in znova shranite.


Izpraznitev aktivnega seznama spremeni dostop takoj, ko spremembo shranite. Izpraznitev seznama dovoljenih mest odstrani njegovo omejitev dostopa do mest; izpraznitev seznama blokiranih mest odstrani njegove blokade. Prehod načrtujte z drugimi skrbniki, saj je v času med izpraznitvijo enega seznama in shranjevanjem drugega lahko dovoljen dostop, ki ga bo končni pravilnik omejil.

Naložite zbirke mest iz datoteke CSV

Nalaganje datoteke CSV podpira samo zbirke mest. Če želite izključiti datoteke po oznakah občutljivosti, dodajte GUID-je oznak v razdelek Izključene oznake občutljivosti brez šifriranja.

1. Odprite Kontrolnike za varnost in zaščito in izberite želeni Način dostopa.

2. Pripravite datoteko CSV z GUID-ji zbirk mest ali tridelnimi ID-ji mest iz storitve Microsoft Graph. V celotni datoteki uporabljajte enotno obliko identifikatorjev.

3. Izberite Naloži datoteko CSV in izberite datoteko.

4. Preglejte rezultat uvoza in izbrani seznam. Pred nadaljevanjem odpravite vse napake in opozorila v vrsticah.

5. Izberite Shrani, da uveljavite spremembe, nato preverite shranjeni seznam.

Zahteve za CSV in delovanje uvoza:

• Največja velikost datoteke: 1 MB.

• Glave so neobvezne.

• Uporabite en GUID zbirke na vrstico ali tridelne ID-je mest iz storitve Graph. Tridelne ID-je lahko zapišete v narekovajih v eno polje ali jih razdelite v tri stolpce.

• Tridelni ID-ji iz storitve Graph se pretvorijo v GUID-je zbirk. Uvoz tridelnega ID-ja ne ustvari pravila za točno določeno mesto.

• Uvoz doda vnose na izbrani seznam in ohrani obstoječe vnose. Podvojene zbirke se združijo v en vnos; število uvoženih zbirk prikazuje na novo dodane zbirke.

• Mešane oblike in nepravilno oblikovane vrstice so zavrnjene. Če naložena datoteka vsebuje samo URL-je mest, se prikaže opozorilo, mesta pa se ne dodajo. Najprej poiščite GUID-je zbirk, ki ustrezajo URL-jem.

• Nalaganje spremeni samo osnutek seznama. Dostop v delovnem prostoru se ne posodobi, dokler ne izberete Shrani.

• Tukaj opisano nalaganje datoteke CSV je namenjeno upravljanju zbirk mest. Izključitve po oznakah občutljivosti nastavite ločeno.

Če imate datoteko CSV s SharePointovimi URL-ji, lahko s postopkom za CSV v orodju iz zbirke Cookbook poiščete njihove identifikatorje in upravljate seznam dovoljenih mest prek API-ja. Vnos site_url ali url v tem orodju uporablja drugačno obliko in postopek kot nalaganje identifikatorjev v uporabniškem vmesniku.

Seznanite se z omejitvami pravilnika in zahtev

Privzeta omejitev pravilnika je 10.000 zbirk mest. Višje omejitve pravilnika delovnega prostora, do 120.000 zbirk mest, mora omogočiti OpenAI; pred načrtovanjem uvedbe v večjem obsegu se obrnite na svojo ekipo pri OpenAI.

Posamezne operacije spreminjanja prek API-ja in trenutni skript iz zbirke Cookbook sprejmejo do 10.000 GUID-jev zbirk na zahtevo. Višja omejitev pravilnika delovnega prostora ne zviša te omejitve na zahtevo. Štejte enolične zbirke mest, ne izvornih URL-jev: več URL-jev se lahko nanaša na isto zbirko.

Uporabite skrbniški API delovnega prostora

Z naslovom https://api.chatgpt.com uporabite UUID delovnega prostora in skrbniški ključ delovnega prostora ChatGPT.

Za vzdrževane ukaze za seznam dovoljenih mest in primere zahtev uporabite zbirko Cookbook:

• Branje obstoječega seznama dovoljenih mest.

• Predogled in dodajanje zbirk mest. Dodajanje ohrani obstoječe dovoljene zbirke.

• Odstranjevanje zbirke mest.

• Izpraznitev seznama dovoljenih mest.

Pred spremembami preglejte trenutni pravilnik, nato ga znova preberite in preizkusite nastali dostop. Če odstranite zadnjo dovoljeno zbirko ali izpraznite seznam dovoljenih mest, odstranite to omejitev dostopa do mest. Ne pošiljajte prazne zahteve za dodajanje, razen če želite odstraniti omejitve seznama dovoljenih mest.

Javno dostopno orodje iz zbirke Cookbook trenutno upravlja samo sezname dovoljenih mest. Ne upravlja seznamov blokiranih mest ali izključitev po oznakah občutljivosti. Za te naloge uporabite zgoraj opisane kontrolnike delovnega prostora.

Izključite datoteke z oznakami občutljivosti

Poiščite GUID oznake

Prosite skrbnika storitve Microsoft 365 ali Purview za nespremenljivi GUID želene oznake. Uporabite GUID, ne prikaznega imena oznake.

Skrbnik lahko pridobi seznam oznak prek storitve Microsoft Graph. Žeton potrebuje ustrezno dovoljenje SensitivityLabel.Read ali SensitivityLabels.Read.All. Poiščite ID, ki ustreza imenu želene oznake, in preverite njene nastavitve zaščite.

Za zahteve in primere glejte Pridobivanje seznama oznak občutljivosti in Lastnosti oznak občutljivosti. Ta dovoljenja za oznake so ločena od dovoljenja za branje mest, ki se uporablja za iskanje identifikatorjev za SharePointove URL-je.

Dodajte izključitve po oznakah

1. Odprite Kontrolnike za varnost in zaščito aplikacije SharePoint.

2. GUID vsake oznake brez šifriranja vnesite v razdelek Izključene oznake občutljivosti brez šifriranja.

3. Shranite konfiguracijo in preizkusite podprto datoteko z izključeno oznako.

Datoteke z ustreznimi podprtimi oznakami so izključene iz rezultatov aplikacije SharePoint. Datoteke z oznakami, ki uveljavljajo šifriranje, so že privzeto izključene.

Preizkusite konfiguracijo

Uporabite preizkusne datoteke in račune, ki jih je odobrila vaša organizacija. Pred preizkusom potrdite, da lahko z istim Microsoftovim računom dostopate do vsake datoteke neposredno v SharePointu.

1. V načinu Dovoljena mesta z nepraznim seznamom preverite datoteko v dovoljeni zbirki in datoteko v zbirki, ki ni na seznamu. Prek aplikacije bi morala biti dostopna samo dovoljena zbirka.

2. V načinu Blokirana mesta preverite datoteko v blokirani zbirki in datoteko v neblokirani zbirki. Blokirana zbirka ne bi smela biti dostopna; za neblokirano zbirko še vedno veljajo Microsoftova dovoljenja in drugi kontrolniki.

3. Preverite podprto preizkusno datoteko z izključeno oznako občutljivosti. V rezultatih aplikacije se ne bi smela prikazati.

4. Po spremembi prek API-ja primerjajte shranjeni seznam v uporabniškem vmesniku s pravilnikom, ki ga vrne API.

5. Po nalaganju datoteke CSV shranite spremembe in znova odprite kontrolnike, da potrdite, da so se želene zbirke ohranile.

Če se rezultati razlikujejo od predvidenega pravilnika, preverite delovni prostor, izbrani način dostopa, shranjeni seznam, GUID-je zbirk, GUID-je oznak, podprto vrsto datoteke in uporabnikova Microsoftova dovoljenja. Med odpravljanjem težav ne izpraznite seznama, razen če želite s tem spremeniti dostop.

Za pomoč pri manjkajočih kontrolnikih ali nepričakovanem dostopu glejte: Stik s podporo OpenAI. V zahtevek za podporo ne vključujte skrbniških ključev ali žetonov za Microsoft Graph.

Seznanite se z omejitvami

• Pravilo za zbirko velja za celotno zbirko mest. Z njim ni mogoče omejiti dostopa na posamezno podmesto, mapo ali datoteko.

• Omejitve za SharePointova mesta ne omejujejo samodejno dostopa do storitve OneDrive.

• Filtriranje po oznakah občutljivosti velja le tam, kjer Microsoft Graph omogoča dostop do podprtih metapodatkov oznak, vključno s podprtimi Officeovimi dokumenti ter datotekami PDF in MP4.

• Vrste datotek, za katere oznake občutljivosti niso podprte, na primer TXT in CSV, se obravnavajo kot datoteke brez oznak. Ostanejo dostopne, če je dostop sicer dovoljen. Ta omejitev glede vrste datotek ni povezana z nalaganjem datoteke CSV za nastavitev dostopa do mest.

• Z nalaganjem datoteke CSV in javno dostopnim vzorčnim orodjem ni mogoče nastaviti izključitev po oznakah občutljivosti. Ta članek ne opisuje API-ja za množično upravljanje oznak.

• Shranjen pravilnik ali uspešen odgovor API-ja ne nadomesti preizkusa dostopa z želenim računom.

Uporabite skrbniško orodje v Pythonu

Celotna vzorčna koda in ukazi se vzdržujejo v zbirki OpenAI Cookbook:

• Skrbniški vodnik.

• Skrbniški skript v Pythonu.

• Datoteka za preizkuse brez povezave.

Uporabite Python 3.10 ali novejšo različico. Orodje uporablja standardno knjižnico Pythona. Pred zagonom preberite vodnik in spremembe preverite s poskusnimi zagoni brez uveljavitve sprememb.

Trenutna različica orodja bere poverilnice iz spremenljivk okolja; upoštevajte navodila za varen vnos v vodniku. Za izpraznitev seznama dovoljenih mest zahteva izrecno potrditev. Odstranitev se lahko izvede brez te potrditve, zato jo najprej preverite s poskusnim zagonom brez uveljavitve sprememb.

Za delovanje ponovnih poskusov in neobvezne idempotentne ključe glejte Varen ponovni poskus posodobitve pravilnika. Idempotentne ključe uporabljajte le, če jih delovni prostor podpira, po napaki z nejasnim izidom pa preglejte trenutni pravilnik.

Orodje ne omogoča funkcij delovnega prostora in ne preverja uveljavljanja pravilnika. Njegovi preizkusi brez povezave uporabljajo simulirane klice storitve Microsoft Graph in skrbniškega API-ja za ChatGPT.

Spremembe, ki obsegajo več zahtev, niso atomarne. Če odstranjevanje več zbirk spodleti med izvajanjem, so bile prejšnje odstranitve morda že uspešno izvedene. Pred ponovnim poskusom preberite trenutni pravilnik.

Pogosta vprašanja

Ali kontrolniki za mesta nadomestijo Microsoftova dovoljenja?

Ne. Aplikacija še vedno uporablja Microsoftova dovoljenja vsakega uporabnika. OpenAI uporabi nastavljeno filtriranje mest, preden se odgovori prikažejo uporabniku in modelu.

Ali prazen seznam dovoljenih mest blokira vsa mesta?

Ne. Prazen seznam dovoljenih mest ne pomeni »blokiraj vse«. Če seznam blokiranih mest vsebuje vnose, te zbirke ostanejo blokirane. Ko noben seznam ne vsebuje vnosov, dostop določajo uporabnikova Microsoftova dovoljenja in drugi nastavljeni kontrolniki.

Ali se spremembe prek skrbniškega API-ja beležijo?

Spremembe pravilnika prek skrbniškega API-ja se beležijo v revizijskih dnevnikih delovnega prostora in dnevnikih za zagotavljanje skladnosti.