Ülevaade

Tööjaama administraatorid saavad SharePointi kontrollidega lubada heakskiidetud saidikogumeid, blokeerida valitud saidikogumeid ja välistada toetatud faile, millel on valitud Microsoft Purview’ tundlikkussildid.

SharePointi saidikogum, mida nimetatakse ka SPSite’iks, võib sisaldada mitut saiti. Kogumi reegel kehtib kogu kogumile, arvestades iga kasutaja olemasolevaid Microsofti õigusi. See ei anna kasutajale juurdepääsu sisule, millele tal pole Microsoft 365-s juurdepääsu.

Saidipiirangud kehtivad SharePointi toetatud otsingu-, sirvimis-, failide hankimise ning lugemis- ja kirjutamistoimingutele. OneDrive’i juurdepääsu hallatakse eraldi.

Vali oma poliitikale vastav juurdepääsurežiim:

• Lubatud saidid: kui lubatud üksuste loend pole tühi, pääsevad kasutajad rakenduse kaudu juurde ainult loetletud saidikogumitele.

• Blokeeritud saidid: kasutajad pääsevad oma Microsofti õiguste piires juurde kõigile saidikogumitele, mida pole keelatud üksuste loendis.

Korraga võib kirjeid sisaldada ainult üks loend. Tühi lubatud üksuste loend ei blokeeri kõiki saite. Kui mõlemad loendid on tühjad, eemaldatakse SharePointi saidipiirangud; Microsofti õigused ja muud seadistatud kontrollid kehtivad endiselt.

Saadavus

Kontrollid ja tööjaama Admin API peavad olema sinu tööjaamas lubatud. Saadaolevad kontrollid hõlmavad lubatud ja keelatud saidikogumite loendeid, saitide importi CSV-failist ning tundlikkussiltide välistusi.

Reeglid kehtivad tervetele saidikogumitele. Need saidikogumi kontrollid ei võimalda piirduda konkreetse saidi, kausta või failiga ega jõustada õigust Microsoft Sites.Selected.

Enne alustamist

• Tee kindlaks saidikogumid, mida sinu organisatsioon soovib lubada või blokeerida.

• Hangi iga kogumi GUID. Microsoft Graphi täieliku saidi-ID keskmine väärtus on kogumi GUID. Admin API kasutab kogumite GUID-sid; kasutajaliidese CSV-importija saab need eraldada ka Graphi saidi-ID kolmikutest.

• Luba SharePointi rakendusele vajalikud Microsofti õigused nii ChatGPT õiguste sätetes kui ka Microsoft Entras, sealhulgas Sites.Read.All ja Files.Read.All. Need sätted filtreerivad juurdepääsu OpenAI poolel ega asenda Microsofti delegeeritud õigusi.

• Tundlikkussiltide välistamiseks küsi oma Microsoft 365 või Purview administraatorilt iga välistatava sildi muutumatu GUID, sealhulgas krüptimist rakendavate siltide omad.

• API kaudu haldamiseks hangi oma tööjaama UUID, ChatGPT tööjaama administraatorivõti ja Microsoft Graphi pääsutõend, kui pead leidma SharePointi URL-idele vastavad tunnused. Neil kahel autentimisvahendil on erinev otstarve.

OpenAI Cookbookist

OpenAI Cookbook on OpenAI avalik näidiskoodi ja juhendite kogu. Selles artiklis kasutatakse kogu SharePointi saidijuurdepääsu juhendit ja Pythoni haldusskripti, mis mõlemad asuvad GitHubis. Failide lugemiseks saad need lingid brauseris avada. Skripti käivitamiseks laadi see alla ning järgi juhendi seadistus- ja käsujuhiseid.

Selles artiklis viitab „Cookbook“ nimetatud SharePointi juhendile ja „Cookbooki utiliit“ lingitud Pythoni skriptile. Neist allikatest leiad käsunäiteid ja juhiseid lubatud üksuste loendi haldamiseks API kaudu.

Identimisteabe seadistamine API kaudu haldamiseks

Märkus. Administraatorivõtmete loomiseks pead olema tööjaama administraator. Loe lähemalt.

ChatGPT tööjaama administraatorivõtme loomine

1. Ava ChatGPT halduskonsool ja vali soovitud tööjaam.

2. Ava Identimisteave ja vali Administraatorivõtmed.

3. Loo võti õigustega Piiratud ning määra jaotises Rakendused õiguseks Kirjutamine.

4. Hoia võtit turvaliselt. See võti annab õiguse lugeda ja muuta sinu tööjaama SharePointi poliitikat.

Vajalik õigus on chatgpt.enterprise.apps.write. Pane tähele, et OpenAI API Platformi võti ega Microsoft Graphi pääsutõend ei saa asendada ChatGPT tööjaama administraatorivõtit.

Lisateavet leiad siit: Administraatorivõtmete haldamine vahekaardil Identimisteave. Skripti identimisteabe keskkonnamuutujaid ja turvalise sisestamise näidet vaata Cookbooki identimisteabe juhistest.

Microsoft Graphi pääsutõendi hankimine

Kasuta oma organisatsiooni heakskiidetud Microsofti autentimisprotsessi. Interaktiivseks otsinguks, kui sinu organisatsioon lubab Graph Explorerit:

1. Ava Microsoft Graph Explorer ja logi sisse selle rentniku töökontoga, kus SharePointi saidid asuvad.

2. Vali saitide lugemiseks vajalikud õigused, tavaliselt Sites.Read.All, kasutades valikut Muuda õigusi või Anna õigustele nõusolek. Kui sinu organisatsioon seda nõuab, palu Microsofti administraatoril juurdepääs heaks kiita.

3. Ava vahekaart Pääsutõend ja kopeeri tõend Microsoft Graphiga kasutamiseks.

Microsofti juhiseid vaata jaotisest Graph Exploreri kasutamine.

Graphi pääsutõendiga leitakse SharePointi URL-idele vastavad identifikaatorid. ChatGPT administraatorivõtmega loetakse või uuendatakse ChatGPT poliitikat. Cookbooki utiliit vajab Graphi pääsutõendit ainult käskude jaoks, mis leiavad URL-idele vastavad identifikaatorid; olemasoleva lubatud üksuste loendi lugemiseks või tühjendamiseks on vaja ainult ChatGPT administraatorivõtit.

Ära lisa kumbagi autentimisvahendit versioonihaldusse, ühiskasutatavatesse dokumentidesse, kuvatõmmistele ega logidesse.

Saidi­kogumi GUID leidmine

SharePointi saidi URL-i kasutamine

1. Ava SharePointi sait, olles Microsofti sisse logitud kontoga, millel on sellele juurdepääs.

2. Lisa saidi URL-i lõppu /_api/site/id. Näiteks kasuta aadressi https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopeeri vastuses tagastatud GUID.

Märkus. Selle artikli näidisdomeenid ja -identifikaatorid on kohatäited.

Microsoft Graphi kasutamine

Microsoft Graph tagastab saidi ID, mis koosneb kolmest komadega eraldatud osast: hostinimi, saidikogumi GUID ja saidi GUID. Saidikogumi reegli jaoks kasuta keskmist väärtust. Eri saitide URL-id võivad vastata samale kogumi GUID-le.

Otsingu ja identifikaatorite näiteid leiad jaotisest SharePointi saidiidentifikaatorite selgitus. Mitme URL-i identifikaatorite leidmiseks ilma ChatGPT poliitikat muutmata kasuta Cookbooki kontrollimisjuhiseid ja Pythoni haldusskripti.

Microsofti otsingunõudeid vaata jaotisest SharePointi saidi hankimine tee järgi.

Halda lubatud ja blokeeritud saidikogumeid

Kasuta tööjaama sätteid

1. Ava oma tööjaamas SharePointi rakenduse ohutus- ja turbesätted.

2. Vali jaotises Juurdepääsurežiim kas Lubatud saidid või Blokeeritud saidid.

3. Lisa saidikogumid valitud loendisse. Võid kasutada ka allpool kirjeldatud CSV-faili üleslaadimist.

4. Vaata muudatused üle ja vali Salvesta.

5. Kontrolli salvestatud poliitikat ja testi konfiguratsiooni.

Admin API kaudu lisatud saidid kuvatakse tööjaama sätetes. Kasutajaliideses lisatud saidid on saadaval ka API kaudu. Kirjeid saab lisada ja eemaldada mõlema kaudu; saidi lisamise viis ei piira selle edasist haldamist.

Vaheta lubatud ja blokeeritud saitide režiimi

Korraga saab kirjeid sisaldada ainult üks loend. Enne teises režiimis kirjete lisamist tühjenda olemasolev loend ja salvesta muudatus. Seejärel vali teine režiim, lisa soovitud kogumid ja salvesta uuesti.


Aktiivse loendi tühjendamine muudab juurdepääsu kohe pärast salvestamist. Lubatud saitide loendi tühjendamine eemaldab selle saidipiirangu; blokeeritud saitide loendi tühjendamine eemaldab selle blokeeringud. Kavanda üleminek koos teiste administraatoritega, sest ühe loendi tühjendamise ja teise salvestamise vahel võib olla lubatud juurdepääs, mida lõplik poliitika piirab.

Laadi saidikogumid üles CSV-failist

CSV-faili üleslaadimine toetab ainult saidikogumeid. Failide välistamiseks tundlikkussildi alusel lisa siltide GUID-d tundlikkussiltide välistusloendisse.

1. Ava Ohutus- ja turbesätted ning vali soovitud juurdepääsurežiim.

2. Valmista ette CSV-fail saidikogumite GUID-de või Microsoft Graphi saidi-ID kolmikutega. Kasuta kogu failis üht tunnusevormingut.

3. Vali Laadi CSV-fail üles ja seejärel fail.

4. Vaata impordi tulemus ja valitud loend üle. Enne jätkamist lahenda ridade vead ja hoiatused.

5. Muudatuste rakendamiseks vali Salvesta, seejärel kontrolli salvestatud loendit.

CSV-faili nõuded ja impordi toimimine:

• Faili maksimaalne suurus: 1 MB.

• Päised pole kohustuslikud.

• Kasuta igal real üht kogumi GUID-d või Graphi saidi-ID kolmikut. Kolmikud võivad olla ühel väljal jutumärkides või jaotatud kolme veergu.

• Graphi kolmikud teisendatakse kogumite GUID-deks. Kolmiku importimine ei loo konkreetse saidi reeglit.

• Import lisab kirjeid valitud loendisse ja säilitab olemasolevad kirjed. Korduvad kogumid arvestatakse üheks; impordi loendur näitab äsja lisatud kogumite arvu.

• Segavorminguid ja vigase vorminguga ridu ei aktsepteerita. Kui üleslaaditud fail sisaldab ainult saitide URL-e, kuvatakse hoiatus ja saite ei lisata. Esmalt leia URL-idele vastavad kogumite GUID-d.

• Üleslaadimine muudab ainult loendi mustandit. Tööjaama juurdepääs ei muutu enne, kui valid Salvesta.

• Siin kirjeldatud CSV-faili üleslaadimisega hallatakse saidikogumeid. Seadista tundlikkussiltide välistused eraldi.

Kui sul on SharePointi URL-idega CSV-fail, saab Cookbooki utiliidi CSV-töövoog leida neile vastavad tunnused ja hallata lubatud saitide loendit API kaudu. Selle site_url või url sisendi vorming ja töövoog erinevad kasutajaliidese tunnuste üleslaadimise omadest.

Tutvu poliitika ja päringute piirangutega

Poliitika vaikepiirang on 10 000 saidikogumit. Tööjaama poliitika suuremad piirmäärad, kuni 120 000 saidikogumit, peab lubama OpenAI; enne suurema juurutuse kavandamist võta ühendust oma OpenAI meeskonnaga.

Üksikud API muutmistoimingud ja praegune Cookbooki skript aktsepteerivad kuni 10 000 kogumi GUID-d päringu kohta. Tööjaama poliitika suurem piirmäär ei suurenda päringupõhist piirmäära. Loenda kordumatuid saidikogumeid, mitte lähte-URL-e: mitu URL-i võivad viidata samale kogumile.

Kasuta tööjaama Admin API-t

Kasuta aadressil https://api.chatgpt.com oma tööjaama UUID-d ja ChatGPT tööjaama administraatorivõtit.

Ajakohased lubatud saitide loendi käsud ja päringunäited leiad Cookbookist:

• Loe olemasolevat lubatud saitide loendit.

• Vaata saidikogumite eelvaadet ja lisa need. Lisamisel säilivad olemasolevad lubatud kogumid.

• Eemalda saidikogum.

• Tühjenda lubatud saitide loend.

Vaata kehtiv poliitika enne muudatuste tegemist üle, seejärel loe seda uuesti ja testi saadud juurdepääsu. Viimase lubatud kogumi eemaldamine või lubatud saitide loendi tühjendamine eemaldab selle saidipiirangu. Ära saada tühja lisamispäringut, kui sa ei soovi lubatud saitide loendi piiranguid eemaldada.

Avalik Cookbooki utiliit haldab praegu ainult lubatud saitide loendeid. See ei halda blokeeritud saitide loendeid ega tundlikkussiltide välistusi. Nendeks toiminguteks kasuta eespool kirjeldatud tööjaama sätteid.

Tundlikkussiltidega failide välistamine

Sildi GUID leidmine

Küsi oma Microsoft 365 või Purview’ administraatorilt soovitud sildi muutumatu GUID. Kasuta GUID-d, mitte sildi kuvatavat nime.

Administraator saab siltide loendi hankida Microsoft Graphi kaudu. Pääsutõend vajab asjakohast õigust SensitivityLabel.Read või SensitivityLabels.Read.All. Leia soovitud sildi nimele vastav ID ja kontrolli selle kaitsesätteid.

Nõudeid ja näiteid vaata jaotistest Tundlikkussiltide loendi hankimine ja Tundlikkussildi atribuudid. Need sildiõigused on eraldi saidi lugemise õigusest, mida kasutatakse SharePointi URL-idele vastavate identifikaatorite leidmiseks.

Lisa siltide välistused

1. Ava SharePointi rakenduse ohutus- ja turbesätted.

2. Sisesta tundlikkussiltide välistusloendisse iga välistatava sildi GUID, sealhulgas krüptimist rakendavate siltide omad.

3. Salvesta konfiguratsioon ja testi välistatud sildiga toetatud faili.

Vastavate toetatud siltidega failid välistatakse SharePointi rakenduse tulemustest. Krüptitud failide sisu on vaikimisi välistatud. Juurdepääs toetatud krüptitud failidele nõuab nii täiustatud failijuurdepääsu (fetch_advanced) kui ka Microsoft Entra administraatori nõusolekut, nagu on kirjeldatud allolevas KKK-s. Siltide välistused ja ühendatud kasutaja Microsofti õigused kehtivad endiselt.

Seadistuse testimine

Kasuta oma organisatsiooni heakskiidetud testfaile ja kontosid. Enne testimist veendu, et sama Microsofti kontoga pääseb igale failile otse SharePointis juurde.

1. Kui režiimis Lubatud saidid pole loend tühi, kontrolli üht faili lubatud kogumis ja üht loendisse kandmata kogumis. Rakenduse kaudu peaks olema juurdepääsetav ainult lubatud kogum.

2. Režiimis Blokeeritud saidid kontrolli üht faili blokeeritud kogumis ja üht blokeerimata kogumis. Blokeeritud kogum ei tohiks olla juurdepääsetav; blokeerimata kogumile kehtivad endiselt Microsofti õigused ja muud kontrollid.

3. Kontrolli toetatud testfaili, millel on välistatud tundlikkussilt. See ei tohiks rakenduse tulemustes ilmuda.

4. Pärast API kaudu tehtud muudatust võrdle kasutajaliideses salvestatud loendit API tagastatud poliitikaga.

5. Pärast CSV-faili üleslaadimist salvesta muudatused ja ava kontrollid uuesti, et veenduda soovitud kogumite säilimises.

Kui tulemused ei vasta soovitud poliitikale, kontrolli tööjaama, valitud juurdepääsurežiimi, salvestatud loendit, kogumite GUID-sid, siltide GUID-sid, toetatud failitüüpi ja kasutaja Microsofti õigusi. Ära tühjenda loendit tõrkeotsingu käigus, kui sa ei soovi sellest tulenevat juurdepääsumuudatust.

Puuduvate kontrollide või ootamatu juurdepääsu korral leiad abi siit: OpenAI toega ühenduse võtmine. Ära lisa tugitaotlusse administraatorivõtmeid ega Microsoft Graphi pääsutõendeid.

Piirangud

• Kogumi reegel hõlmab kogu saidikogumit. Sellega ei saa piirata juurdepääsu konkreetsele alamsaidile, kaustale ega failile.

• SharePointi saidipiirangud ei piira automaatselt juurdepääsu OneDrive’ile.

• Tundlikkussildi järgi filtreerimist rakendatakse ainult siis, kui Microsoft Graph teeb toetatud siltide metaandmed kättesaadavaks. See hõlmab toetatud Office’i dokumente ning PDF- ja MP4-faile.

• Failitüüpe, mille tundlikkussilte ei toetata, näiteks TXT- ja CSV-faile, käsitletakse sildistamata failidena. Need jäävad juurdepääsetavaks, kui muud reeglid seda lubavad. See failitüübi piirang ei puuduta CSV-faili üleslaadimist saidi juurdepääsu seadistamiseks.

• CSV-faili üleslaadimise ja avaliku näidisutiliidiga ei saa seadistada tundlikkussiltide välistusi. See artikkel ei kirjelda siltide hulgihalduse API-t.

• Salvestatud poliitika või edukas API vastus ei asenda juurdepääsu testimist ettenähtud kontoga.

Pythoni haldusutiliidi kasutamine

Täielikku näidiskoodi ja käske hoitakse ajakohasena OpenAI Cookbookis:

• Haldusjuhend.

• Pythoni haldusskript.

• Võrguühenduseta testimise fail.

Kasuta Python 3.10 või uuemat versiooni. Utiliit kasutab Pythoni standardteeki. Enne käivitamist loe juhend läbi ja vaata muudatused proovikäivitustega üle.

Praegune utiliit loeb identimisteavet keskkonnamuutujatest; järgi juhendis toodud turvalise sisestamise juhiseid. Lubatud üksuste loendi tühjendamiseks nõuab utiliit selgesõnalist kinnitust. Eemaldamise saab teha ilma selle kinnituseta, seega vaata eemaldamine esmalt proovikäivitusega üle.

Korduskatsete ja valikuliste idempotentsusvõtmete kohta vaata jaotist Poliitika uuendamise turvaline korduskatse. Kasuta idempotentsusvõtmeid ainult siis, kui tööjaam neid toetab, ning kontrolli kehtivat poliitikat pärast ebaselge tulemusega tõrget.

Utiliit ei lülita sisse tööjaama funktsioone ega kontrolli piirangute jõustamist. Selle võrguühenduseta testid kasutavad Microsoft Graphi ja ChatGPT Admin API kutsete imitatsioone.

Mitmest päringust koosnevad muudatused ei ole atomaarsed. Kui mitme kogumi eemaldamine katkeb poole pealt, võivad varasemad eemaldamised olla juba õnnestunud. Enne uuesti proovimist loe kehtivat poliitikat.

KKK

Kas peaksin lisama välistusloendisse krüptimist rakendavad tundlikkussildid?

Jah. Lisa kõik Microsoft Purview tundlikkussildid, mille faile soovid lasta ChatGPT-l välistada, sealhulgas krüptimist rakendavad sildid.

Krüptitud failide sisu on vaikimisi välistatud. Toetatud krüptitud failidele juurdepääsu lubamiseks peab tööjaama administraator lubama täiustatud failijuurdepääsu (fetch_advanced) ja Microsoft Entra administraator peab andma nõusoleku vajalikele Microsofti õigustele. Ainult toimingu lubamisest ilma administraatori nõusolekuta ei piisa.

Ka pärast seadistamist saab ChatGPT krüptitud sisu hankida ainult siis, kui ühendatud kasutajal on õigus failile juurde pääseda ja see dekrüptida. Välistusloendis olevate siltidega failid jäävad välistatuks. Täiustatud failijuurdepääsu lubamine või administraatori nõusoleku andmine ei tühista siltide välistusi ega kasutaja Microsofti õigusi.

Kas saidi juurdepääsusätted asendavad Microsofti õigusi?

Ei. Rakendus kasutab endiselt iga kasutaja Microsofti õigusi. OpenAI rakendab seadistatud saidifiltrid enne vastuste kuvamist kasutajale ja mudelile.

Kas tühi lubatud saitide loend blokeerib kõik saidid?

Ei. Tühi lubatud saitide loend ei tähenda „blokeeri kõik“. Kui blokeeritud saitide loendis on kirjeid, jäävad need kogumid blokeerituks. Kui kummaski loendis pole kirjeid, määravad juurdepääsu kasutajate Microsofti õigused ja muud seadistatud piirangud.

Kas Admin API muudatused logitakse?

Admin API kaudu tehtud poliitikamuudatused salvestatakse tööjaama auditi- ja vastavuslogidesse.