Ü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 kolmeosalistest saidi-ID-dest.

• Luba SharePointi rakendusele vajalikud Microsofti õigused nii ChatGPT õiguste seadetes kui ka Microsoft Entras, sealhulgas Sites.Read.All ja Files.Read.All. Need kontrollid filtreerivad juurdepääsu OpenAI poolel; need ei asenda Microsofti delegeeritud õigusi.

• Tundlikkussiltide välistamiseks küsi oma Microsoft 365 või Purview’ administraatorilt iga krüptimiseta sildi muutumatu GUID.

• API kaudu haldamiseks hangi oma tööjaama UUID ja ChatGPT tööjaama administraatorivõti ning Microsoft Graphi pääsutõend, kui pead leidma SharePointi URL-idele vastavad identifikaatorid. Neid kahte autentimisvahendit kasutatakse eri otstarbel.

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.

Lubatud ja blokeeritud saidikogumite haldamine

Tööjaama kontrollide kasutamine

1. Ava oma tööjaamas SharePointi rakenduse ohutus- ja turbekontrollid.

2. Jaotises Juurdepääsurežiim vali 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 seadistust.

Admin API kaudu lisatud saidid kuvatakse tööjaama kontrollides. Kasutajaliideses lisatud saidid on kättesaadavad ka API kaudu. Kirjeid saab lisada või eemaldada mõlema liidese kaudu; saidi lisamise viis ei kohusta edaspidi sama viisi kasutama.

Lubatud ja blokeeritud saitide režiimi vahetamine

Korraga võib 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 üksuste loendi tühjendamine eemaldab selle saidipiirangu; keelatud üksuste loendi tühjendamine eemaldab selle blokeeringud. Kavanda üleminek koos teiste administraatoritega, sest ühe loendi tühjendamise ja teise salvestamise vahel võib olla võimalik juurdepääs, mida lõplik poliitika piirab.

Saidikogumite üleslaadimine CSV-failist

CSV-faili üleslaadimine toetab ainult saidikogumeid. Failide välistamiseks tundlikkussildi järgi lisa siltide GUID-d jaotisse Välistatud krüptimiseta tundlikkussildid.

1. Ava ohutus- ja turbekontrollid ning vali soovitud juurdepääsurežiim.

2. Koosta CSV-fail saidikogumite GUID-de või Microsoft Graphi kolmeosaliste saidi-ID-dega. Kasuta kogu failis üht identifikaatorivormingut.

3. Vali Laadi CSV-fail üles ja vali fail.

4. Vaata impordi tulemus ja valitud loend üle. Enne jätkamist lahenda kõik 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 on valikulised.

• Kasuta igal real üht kogumi GUID-d või Graphi kolmeosalist saidi-ID-d. Kolmeosalise ID võib panna jutumärkides ühele väljale või jagada kolme veeru vahel.

• Graphi kolmeosalised ID-d teisendatakse kogumite GUID-deks. Kolmeosalise ID importimine ei loo üksiku saidi reeglit.

• Import lisab kirjeid valitud loendisse ja säilitab olemasolevad kirjed. Korduvad kogumid lisatakse vaid üks kord; imporditud kogumite arv näitab äsja lisatud kogumeid.

• Segavormingud ja vigased read lükatakse tagasi. Kui üleslaaditav fail sisaldab ainult saitide URL-e, kuvatakse hoiatus ja saite ei lisata. Leia esmalt URL-idele vastavad kogumite GUID-d.

• Üleslaadimine muudab ainult loendi mustandit. See ei muuda tööjaama juurdepääsu enne, kui valid Salvesta.

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

Kui sul on SharePointi URL-idega CSV-fail, saad Cookbooki utiliidi CSV-töövooga leida neile vastavad identifikaatorid ja hallata API kaudu lubatud üksuste loendit. Selle site_url- või url-sisendi vorming ja töövoog erinevad kasutajaliidese identifikaatorite üleslaadimisest.

Poliitika- ja päringupiirangud

Poliitika vaikimisi piirang on 10 000 saidikogumit. Tööjaama poliitika suurema limiidi, kuni 120 000 saidikogumit, peab lubama OpenAI; enne suurema juurutuse kavandamist võta ühendust oma OpenAI meeskonnaga.

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

Tööjaama Admin API kasutamine

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

Lubatud üksuste loendi ajakohased käsud ja päringunäited leiad Cookbookist:

• Olemasoleva lubatud üksuste loendi lugemine.

• Saidikogumite eelvaade ja lisamine. Lisamisel säilivad olemasolevad lubatud kogumid.

• Saidikogumi eemaldamine.

• Lubatud üksuste loendi tühjendamine.

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

Avalik Cookbooki utiliit haldab praegu ainult lubatud üksuste loendeid. See ei halda keelatud üksuste loendeid ega tundlikkussiltide välistusi. Nende toimingute jaoks kasuta eespool kirjeldatud tööjaama kontrolle.

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.

Siltide välistuste lisamine

1. Ava SharePointi rakenduse ohutus- ja turbekontrollid.

2. Sisesta iga krüptimiseta sildi GUID jaotisse Välistatud krüptimiseta tundlikkussildid.

3. Salvesta seadistus ja testi toetatud faili, millel on välistatud silt.

Vastavate toetatud siltidega failid jäetakse SharePointi rakenduse tulemustest välja. Krüptimist rakendavate siltidega failid on juba vaikimisi välistatud.

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 saidikontrollid asendavad Microsofti õigusi?

Ei. Rakendus kasutab endiselt iga kasutaja Microsofti õigusi. OpenAI rakendab seadistatud saidifiltrit enne, kui vastused kasutajale ja mudelile nähtavaks tehakse.

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

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

Kas Admin API muudatused logitakse?

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