Apžvalga

Darbo erdvės administratoriai gali naudoti „SharePoint“ valdiklius, kad leistų patvirtintus svetainių rinkinius, blokuotų pasirinktus svetainių rinkinius ir neįtrauktų palaikomų failų su pasirinktomis „Microsoft Purview“ slaptumo žymomis.

„SharePoint“ svetainių rinkinyje, dar vadinamame SPSite, gali būti kelios svetainės. Rinkinio taisyklė taikoma visam rinkiniui, atsižvelgiant į kiekvieno naudotojo turimus „Microsoft“ leidimus. Ji nesuteikia naudotojui prieigos prie turinio, kurio jis negali pasiekti „Microsoft 365“.

Svetainių apribojimai taikomi palaikomiems „SharePoint“ paieškos, naršymo, failų gavimo bei skaitymo ir rašymo veiksmams. Prieiga prie „OneDrive“ valdoma atskirai.

Pasirinkite jūsų politiką atitinkantį prieigos režimą:

• Leidžiamos svetainės: kai leidžiamųjų sąrašas netuščias, naudotojai per programėlę gali pasiekti tik į jį įtrauktus svetainių rinkinius.

• Blokuojamos svetainės: naudotojai gali pasiekti svetainių rinkinius, neįtrauktus į draudžiamųjų sąrašą, jei tai leidžia jų „Microsoft“ leidimai.

Vienu metu įrašų gali būti tik viename sąraše. Tuščias leidžiamųjų sąrašas neblokuoja visų svetainių. Kai abu sąrašai tušti, „SharePoint“ svetainių apribojimai panaikinami; „Microsoft“ leidimai ir kitos sukonfigūruotos kontrolės priemonės tebetaikomi.

Prieinamumas

Valdikliai ir darbo erdvės administravimo API turi būti įjungti jūsų darbo erdvėje. Galimi valdikliai apima svetainių rinkinių leidžiamųjų ir draudžiamųjų sąrašus, svetainių importavimą iš CSV ir neįtraukimą pagal slaptumo žymas.

Taisyklės taikomos visiems svetainių rinkiniams. Šie svetainių rinkinių valdikliai neapima taikymo srities apribojimo iki konkrečios svetainės, aplanko ar failo ir Microsoft Sites.Selected leidimo vykdymo.

Prieš pradėdami

• Nustatykite, kuriuos svetainių rinkinius jūsų organizacija nori leisti arba blokuoti.

• Gaukite kiekvieno rinkinio GUID. Viso „Microsoft Graph“ svetainės ID vidurinė reikšmė yra rinkinio GUID. Administravimo API naudoja rinkinių GUID; naudotojo sąsajos CSV importavimo priemonė taip pat gali juos išgauti iš „Graph“ svetainių ID trejetų.

• Tiek „ChatGPT“ leidimų nustatymuose, tiek „Microsoft Entra“ įjunkite „SharePoint“ programai būtinus „Microsoft“ leidimus, įskaitant Sites.Read.All ir Files.Read.All. Šie valdikliai filtruoja prieigą „OpenAI“ pusėje; jie nepakeičia „Microsoft“ deleguotųjų leidimų.

• Norėdami nustatyti slaptumo žymų neįtraukimo taisykles, paprašykite „Microsoft 365“ arba „Purview“ administratoriaus pateikti nekintamą kiekvienos žymos, kurios failų nenorite įtraukti, GUID, įskaitant žymas, kuriomis taikomas šifravimas.

• Norėdami administruoti per API, gaukite savo darbo erdvės UUID, „ChatGPT“ darbo erdvės administratoriaus raktą ir, jei reikia pagal „SharePoint“ URL nustatyti identifikatorius, „Microsoft Graph“ prieigos atpažinimo ženklą. Šios dvi autentifikavimo priemonės skirtos skirtingiems tikslams.

Apie „OpenAI Cookbook“

„OpenAI Cookbook“ – tai viešas OpenAI kodo pavyzdžių ir vadovų rinkinys. Šiame straipsnyje remiamasi jo „SharePoint“ svetainių prieigos vadovu ir „Python“ administravimo scenarijumi, kurie abu pateikti „GitHub“. Norėdami perskaityti failus, galite atidaryti šias nuorodas naršyklėje. Norėdami paleisti scenarijų, atsisiųskite jį ir vadovaukitės vadove pateiktomis parengimo bei komandų instrukcijomis.

Šiame straipsnyje „Cookbook“ reiškia minėtą „SharePoint“ vadovą, o „Cookbook priemonė“ – susietą „Python“ scenarijų. Šiuose šaltiniuose rasite komandų pavyzdžius ir leidžiamųjų sąrašo valdymo per API instrukcijas.

Paruoškite kredencialus administravimui per API

Pastaba: norėdami kurti administratoriaus raktus, turite būti darbo erdvės administratorius. Skaitykite daugiau.

Sukurkite ChatGPT darbo erdvės administratoriaus raktą

1. Atidarykite ChatGPT administravimo konsolę ir pasirinkite reikiamą darbo erdvę.

2. Eikite į Kredencialai ir pasirinkite Administratoriaus raktai.

3. Sukurkite raktą su leidimų parinktimi Apriboti, o skilčiai Programėlės nustatykite Rašymas.

4. Raktą laikykite saugiai. Šis raktas suteikia teisę skaityti ir keisti jūsų darbo erdvės „SharePoint“ politiką.

Būtinas leidimas yra chatgpt.enterprise.apps.write. Atminkite, kad nei API platformos raktas, nei „Microsoft Graph“ atpažinimo ženklas negali pakeisti ChatGPT darbo erdvės administratoriaus rakto.

Daugiau informacijos rasite skiltyje Administratoriaus raktų valdymas skirtuke „Kredencialai“. Scenarijaus kredencialų aplinkos kintamuosius ir saugaus įvedimo pavyzdį rasite „Cookbook“ kredencialų instrukcijose.

Gaukite „Microsoft Graph“ atpažinimo ženklą

Naudokite organizacijos patvirtintą „Microsoft“ autentifikavimo procesą. Interaktyviai paieškai, jei jūsų organizacija leidžia naudoti „Graph Explorer“:

1. Atidarykite „Microsoft Graph Explorer“ ir prisijunkite naudodami nuomotojo, kuriam priklauso „SharePoint“ svetainės, darbo paskyrą.

2. Naudodami Keisti leidimus arba Sutikti su leidimais, pasirinkite svetainėms skaityti reikalingus leidimus, paprastai Sites.Read.All. Jei jūsų organizacija to reikalauja, paprašykite „Microsoft“ administratoriaus patvirtinti prieigą.

3. Atidarykite skirtuką Prieigos atpažinimo ženklas ir nukopijuokite atpažinimo ženklą, kad galėtumėte jį naudoti su „Microsoft Graph“.

„Microsoft“ instrukcijas rasite skiltyje Darbas su „Graph Explorer“.

„Graph“ atpažinimo ženklas naudojamas „SharePoint“ URL atitinkantiems identifikatoriams nustatyti. ChatGPT administratoriaus raktas naudojamas ChatGPT politikai skaityti arba atnaujinti. „Cookbook“ priemonei „Graph“ atpažinimo ženklo reikia tik komandoms, kurios nustato URL identifikatorius; esamam leidžiamųjų sąrašui skaityti arba išvalyti pakanka ChatGPT administratoriaus rakto.

Nedėkite nė vieno iš šių kredencialų į versijų valdymo sistemą, bendrinamus dokumentus, ekrano kopijas ar žurnalus.

Raskite svetainių rinkinio GUID

Naudokite „SharePoint“ svetainės URL

1. Atidarykite „SharePoint“ svetainę prisijungę prie „Microsoft“ paskyra, kuri turi prieigą prie jos.

2. Prie svetainės URL pridėkite /_api/site/id. Pavyzdžiui, naudokite https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Nukopijuokite atsakyme grąžintą GUID.

Pastaba: šiame straipsnyje pateikti domenų ir identifikatorių pavyzdžiai yra vietaženkliai.

Naudokite „Microsoft Graph“

„Microsoft Graph“ grąžina svetainės ID, kurį sudaro trys kableliais atskirtos dalys: pagrindinio kompiuterio vardas, svetainių rinkinio GUID ir svetainės GUID. Svetainių rinkinio taisyklei naudokite vidurinę reikšmę. Skirtingi svetainių URL gali atitikti tą patį rinkinio GUID.

Paieškos ir identifikatorių pavyzdžių rasite skiltyje Apie „SharePoint“ svetainių identifikatorius. Norėdami nustatyti kelių URL identifikatorius nekeisdami ChatGPT politikos, naudokitės „Cookbook“ tikrinimo instrukcijomis ir „Python“ administravimo scenarijumi.

„Microsoft“ paieškos reikalavimus rasite skiltyje „SharePoint“ svetainės gavimas pagal kelią.

Tvarkykite leidžiamus ir blokuojamus svetainių rinkinius

Naudokite darbo erdvės valdiklius

1. Savo darbo erdvėje atidarykite „SharePoint“ programos saugos ir apsaugos valdiklius.

2. Skiltyje Prieigos režimas pasirinkite Leidžiamos svetainės arba Blokuojamos svetainės.

3. Į pasirinktą sąrašą pridėkite svetainių rinkinius. Taip pat galite įkelti CSV failą, kaip aprašyta toliau.

4. Peržiūrėkite pakeitimus ir pasirinkite Išsaugoti.

5. Patikrinkite išsaugotą strategiją ir išbandykite konfigūraciją.

Per administravimo API pridėtos svetainės rodomos darbo erdvės valdikliuose. Naudotojo sąsajoje pridėtos svetainės taip pat pasiekiamos per API. Įrašus galite pridėti arba pašalinti abiem būdais; svetainės pridėjimo būdas neriboja tolesnio jos tvarkymo.

Perjunkite leidžiamų ir blokuojamų svetainių režimus

Vienu metu įrašų gali būti tik viename sąraše. Prieš pridėdami įrašų kitu režimu, išvalykite esamą sąrašą ir išsaugokite šį pakeitimą. Tada pasirinkite kitą režimą, pridėkite norimus rinkinius ir vėl išsaugokite.


Išvalius aktyvų sąrašą, prieiga pasikeičia iškart, kai pakeitimas išsaugomas. Išvalius leidžiamųjų sąrašą, panaikinamas jo taikomas svetainių apribojimas; išvalius draudžiamųjų sąrašą, panaikinami jo taikomi blokavimai. Suplanuokite perėjimą kartu su kitais administratoriais, nes laikotarpiu nuo vieno sąrašo išvalymo iki kito išsaugojimo gali būti leidžiama prieiga, kurią galutinė strategija ribos.

Įkelkite svetainių rinkinius iš CSV failo

Įkėlimas iš CSV failo palaikomas tik svetainių rinkiniams. Jei norite neįtraukti failų pagal slaptumo žymą, pridėkite žymų GUID į neįtraukiamų slaptumo žymų sąrašą.

1. Atidarykite saugos ir apsaugos valdiklius ir pasirinkite norimą prieigos režimą.

2. Paruoškite CSV failą su svetainių rinkinių GUID arba „Microsoft Graph“ svetainių ID trejetais. Visame faile naudokite vieną identifikatorių formatą.

3. Pasirinkite Įkelti CSV failą ir pasirinkite failą.

4. Peržiūrėkite importavimo rezultatą ir pasirinktą sąrašą. Prieš tęsdami ištaisykite eilučių klaidas ir pašalinkite įspėjimų priežastis.

5. Pasirinkite Išsaugoti, kad pritaikytumėte pakeitimus, tada patikrinkite išsaugotą sąrašą.

CSV reikalavimai ir importavimo veikimas:

• Didžiausias failo dydis: 1 MB.

• Antraštės neprivalomos.

• Kiekvienoje eilutėje pateikite po vieną rinkinio GUID arba naudokite „Graph“ svetainių ID trejetus. Trejetus galima pateikti kabutėse viename lauke arba išskaidyti į tris stulpelius.

• „Graph“ trejetai konvertuojami į rinkinių GUID. Importavus trejetą, konkrečiai svetainei skirta taisyklė nesukuriama.

• Importuojant pasirinktas sąrašas papildomas, o esami įrašai išsaugomi. Pasikartojantys rinkiniai įtraukiami tik kartą; importuotų rinkinių skaičius rodo tik naujai pridėtus rinkinius.

• Mišrūs formatai ir netaisyklingos eilutės atmetami. Įkėlus failą, kuriame yra tik svetainių URL, rodomas įspėjimas, o svetainės nepridedamos. Pirmiausia pagal URL nustatykite atitinkamus rinkinių GUID.

• Įkėlimas pakeičia tik sąrašo juodraštį. Prieiga darbo erdvėje neatnaujinama, kol nepasirenkate Išsaugoti.

• Čia aprašytas įkėlimas iš CSV failo skirtas svetainių rinkiniams tvarkyti. Slaptumo žymų neįtraukimo taisykles sukonfigūruokite atskirai.

Jei turite CSV failą su „SharePoint“ URL, naudodami „Cookbook“ priemonės CSV darbo eigą galite pagal juos nustatyti identifikatorius ir tvarkyti leidžiamųjų sąrašą per API. Jos site_url arba url įvesties formatas ir darbo eiga skiriasi nuo identifikatorių įkėlimo naudotojo sąsajoje.

Susipažinkite su strategijos ir užklausų limitais

Numatytasis strategijos limitas yra 10 000 svetainių rinkinių. Didesnius darbo erdvės strategijos limitus, iki 120 000 svetainių rinkinių, turi įjungti „OpenAI“; prieš planuodami didesnio masto diegimą, susisiekite su jus aptarnaujančia „OpenAI“ komanda.

Atskiros API keitimo operacijos ir dabartinis „Cookbook“ scenarijus priima iki 10 000 rinkinių GUID vienoje užklausoje. Didesnis darbo erdvės strategijos limitas nepadidina šio vienai užklausai taikomo limito. Skaičiuokite unikalius svetainių rinkinius, o ne pradinius URL: keli URL gali nurodyti tą patį rinkinį.

Naudokite darbo erdvės administravimo API

Kreipdamiesi į https://api.chatgpt.com, naudokite savo darbo erdvės UUID ir „ChatGPT“ darbo erdvės administratoriaus raktą.

Atnaujinamas leidžiamųjų sąrašo komandas ir užklausų pavyzdžius rasite „Cookbook“:

• Peržiūrėkite esamą leidžiamųjų sąrašą.

• Peržiūrėkite ir pridėkite svetainių rinkinius. Pridedant naujų rinkinių, esami leidžiami rinkiniai išsaugomi.

• Pašalinkite svetainių rinkinį.

• Išvalykite leidžiamųjų sąrašą.

Prieš atlikdami pakeitimus peržiūrėkite dabartinę strategiją, tada peržiūrėkite ją dar kartą ir patikrinkite, kokia prieiga suteikiama. Pašalinus paskutinį leidžiamą rinkinį arba išvalius leidžiamųjų sąrašą, panaikinamas šis svetainių apribojimas. Nesiųskite tuščios pridėjimo užklausos, nebent norite panaikinti leidžiamųjų sąrašo apribojimus.

Viešai prieinama „Cookbook“ priemonė šiuo metu tvarko tik leidžiamųjų sąrašus. Ji netvarko draudžiamųjų sąrašų ar slaptumo žymų neįtraukimo taisyklių. Šioms užduotims naudokite pirmiau aprašytus darbo erdvės valdiklius.

Neįtraukite failų su slaptumo žymomis

Raskite žymos GUID

Paprašykite „Microsoft 365“ arba „Purview“ administratoriaus reikiamos žymos nekintamo GUID. Naudokite GUID, o ne rodomą žymos pavadinimą.

Administratorius gali gauti žymų sąrašą per „Microsoft Graph“. Atpažinimo ženklui būtinas atitinkamas SensitivityLabel.Read arba SensitivityLabels.Read.All leidimas. Pagal reikiamos žymos pavadinimą nustatykite jos ID ir patikrinkite jos apsaugos nustatymus.

Reikalavimus ir pavyzdžius rasite skiltyse Slaptumo žymų sąrašo gavimas ir Slaptumo žymos ypatybės. Šie žymų leidimai skiriasi nuo svetainių skaitymo leidimo, naudojamo „SharePoint“ URL identifikatoriams nustatyti.

Pridėkite neįtraukiamas žymas

1. Atidarykite „SharePoint“ programos saugos ir apsaugos valdiklius.

2. Į neįtraukiamų slaptumo žymų sąrašą įveskite kiekvienos žymos, kurios failų nenorite įtraukti, GUID, įskaitant žymas, kuriomis taikomas šifravimas.

3. Išsaugokite konfigūraciją ir išbandykite ją su palaikomu failu, pažymėtu neįtraukiama žyma.

Failai su atitinkamomis palaikomomis žymomis neįtraukiami į „SharePoint“ programos rezultatus. Šifruotų failų turinys pagal numatytuosius nustatymus neįtraukiamas. Norint pasiekti palaikomus šifruotus failus, reikia ir išplėstinės prieigos prie failų (fetch_advanced), ir „Microsoft Entra“ administratoriaus sutikimo, kaip aprašyta toliau pateiktuose DUK. Žymų neįtraukimo taisyklės ir prijungto naudotojo „Microsoft“ leidimai tebegalioja.

Išbandykite konfigūraciją

Naudokite organizacijos patvirtintus testavimo failus ir paskyras. Prieš testuodami įsitikinkite, kad naudojant tą pačią „Microsoft“ paskyrą kiekvienas failas pasiekiamas tiesiogiai „SharePoint“.

1. Pasirinkę režimą Leidžiamos svetainės su netuščiu sąrašu, patikrinkite failą leidžiamame rinkinyje ir failą į sąrašą neįtrauktame rinkinyje. Per programėlę turėtų būti pasiekiamas tik leidžiamas rinkinys.

2. Pasirinkę režimą Blokuojamos svetainės, patikrinkite failą blokuojamame rinkinyje ir failą neblokuojamame rinkinyje. Blokuojamas rinkinys turėtų būti nepasiekiamas; neblokuojamam rinkiniui ir toliau taikomi „Microsoft“ leidimai bei kitos kontrolės priemonės.

3. Patikrinkite palaikomą testavimo failą su neįtraukiama slaptumo žyma. Jo neturėtų būti programėlės rezultatuose.

4. Atlikę pakeitimą per API, palyginkite sąsajoje išsaugotą sąrašą su API grąžinama politika.

5. Įkėlę CSV, išsaugokite pakeitimus ir vėl atidarykite valdiklius, kad įsitikintumėte, jog numatyti rinkiniai buvo išsaugoti.

Jei rezultatai neatitinka numatytos politikos, patikrinkite darbo erdvę, pasirinktą prieigos režimą, išsaugotą sąrašą, rinkinių GUID, žymų GUID, ar failo tipas palaikomas, ir naudotojo „Microsoft“ leidimus. Nevalykite sąrašo trikčių šalinimo tikslais, nebent sąmoningai siekiate taip pakeisti prieigą.

Jei reikia pagalbos dėl trūkstamų valdiklių ar netikėtos prieigos, žr. Kaip susisiekti su OpenAI palaikymo komanda. Į pagalbos užklausą neįtraukite administratoriaus raktų ar „Microsoft Graph“ atpažinimo ženklų.

Susipažinkite su apribojimais

• Rinkinio taisyklė taikoma visam svetainių rinkiniui. Ja negalima apriboti prieigos tik iki konkrečios antrinės svetainės, aplanko ar failo.

• „SharePoint“ svetainių apribojimai automatiškai neapriboja prieigos prie „OneDrive“.

• Filtravimas pagal slaptumo žymas taikomas tik tada, kai „Microsoft Graph“ pateikia palaikomų žymų metaduomenis, įskaitant palaikomus „Office“ dokumentus, PDF ir MP4 failus.

• Failai, kurių tipai nepalaiko slaptumo žymų, pavyzdžiui, TXT ir CSV, laikomi nepažymėtais. Jie lieka pasiekiami, jei prieiga leidžiama pagal kitas taisykles. Šis failų tipų apribojimas nesusijęs su CSV įkėlimu svetainių prieigai konfigūruoti.

• Neįtraukimo pagal slaptumo žymas negalima konfigūruoti nei įkeliant CSV, nei naudojant viešai pateiktą pavyzdinę priemonę. Šiame straipsnyje neaprašoma masinio žymų valdymo API.

• Išsaugota politika ar sėkmingas API atsakymas nepakeičia prieigos testavimo naudojant numatytą paskyrą.

Naudokite „Python“ administravimo priemonę

Visas pavyzdinis kodas ir komandos pateikiami bei atnaujinami „OpenAI Cookbook“:

• Administravimo vadovas.

• „Python“ administravimo scenarijus.

• Testų neprisijungus failas.

Naudokite „Python 3.10“ arba naujesnę versiją. Priemonė naudoja standartinę „Python“ biblioteką. Prieš paleisdami perskaitykite vadovą, o pakeitimus peržiūrėkite bandomuoju režimu, jų netaikydami.

Dabartinė priemonė nuskaito kredencialus iš aplinkos kintamųjų; vadovaukitės saugaus įvedimo instrukcijomis vadove. Norint išvalyti leidžiamųjų sąrašą, būtinas aiškus patvirtinimas. Pašalinimas gali būti atliktas be tokio patvirtinimo, todėl pirmiausia peržiūrėkite jį bandomuoju režimu.

Apie pakartotinius bandymus ir pasirenkamus idempotentiškumo raktus skaitykite skiltyje Saugus politikos atnaujinimo kartojimas. Idempotentiškumo raktus naudokite tik tada, kai darbo erdvė juos palaiko, o įvykus klaidai, kurios rezultatas neaiškus, patikrinkite dabartinę politiką.

Priemonė neįjungia darbo erdvės funkcijų ir netikrina, ar politika vykdoma. Jos testuose neprisijungus naudojami imituoti „Microsoft Graph“ ir ChatGPT administravimo API iškvietimai.

Keliomis užklausomis atliekami pakeitimai nėra atominiai. Jei šalinant kelis rinkinius procesas nutrūksta, ankstesni rinkiniai jau gali būti sėkmingai pašalinti. Prieš bandydami dar kartą, peržiūrėkite dabartinę politiką.

DUK

Ar į neįtraukiamų žymų sąrašą turėčiau pridėti slaptumo žymas, kuriomis taikomas šifravimas?

Taip. Pridėkite visas „Microsoft Purview“ slaptumo žymas, kuriomis pažymėtų failų „ChatGPT“ neturėtų įtraukti, įskaitant žymas, kuriomis taikomas šifravimas.

Šifruotų failų turinys pagal numatytuosius nustatymus neįtraukiamas. Kad būtų galima pasiekti palaikomus šifruotus failus, darbo erdvės administratorius turi įjungti išplėstinę prieigą prie failų (fetch_advanced), o „Microsoft Entra“ administratorius turi duoti sutikimą suteikti būtinus „Microsoft“ leidimus. Vien įjungti veiksmą negavus administratoriaus sutikimo nepakanka.

Net ir atlikus sąranką, „ChatGPT“ gali gauti šifruotą turinį tik tada, kai prijungtas naudotojas turi leidimą pasiekti ir iššifruoti failą. Failai, pažymėti į neįtraukiamų žymų sąrašą įrašytomis žymomis, ir toliau neįtraukiami. Įjungus išplėstinę prieigą prie failų arba gavus administratoriaus sutikimą, žymų neįtraukimo taisyklės ir naudotojo „Microsoft“ leidimai tebegalioja.

Ar svetainių valdikliai pakeičia „Microsoft“ leidimus?

Ne. Programa ir toliau naudoja kiekvieno naudotojo „Microsoft“ leidimus. „OpenAI“ pritaiko sukonfigūruotą svetainių filtravimą prieš pateikdama atsakymus naudotojui ir modeliui.

Ar tuščias leidžiamųjų sąrašas blokuoja visas svetaines?

Ne. Tuščias leidžiamųjų sąrašas nereiškia „blokuoti viską“. Jei draudžiamųjų sąraše yra įrašų, tie rinkiniai lieka užblokuoti. Kai abiejuose sąrašuose nėra įrašų, prieigą lemia naudotojų „Microsoft“ leidimai ir kiti sukonfigūruoti valdikliai.

Ar administravimo API pakeitimai registruojami žurnaluose?

Per administravimo API atlikti strategijos pakeitimai įrašomi į darbo erdvės audito ir atitikties žurnalus.