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; sąsajos CSV importavimo priemonė taip pat gali juos išgauti iš „Graph“ svetainių ID trejetų.

• Įjunkite „SharePoint“ programėlei būtinus „Microsoft“ leidimus tiek ChatGPT leidimų nustatymuose, tiek „Microsoft Entra“, į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 neįtraukimą pagal slaptumo žymas, paprašykite „Microsoft 365“ arba „Purview“ administratoriaus kiekvienos šifravimo netaikančios žymos nekintamo GUID.

• Administravimui per API gaukite darbo erdvės UUID, ChatGPT darbo erdvės administratoriaus raktą ir „Microsoft Graph“ atpažinimo ženklą, jei reikia nustatyti „SharePoint“ URL identifikatorius. Šių dviejų kredencialų paskirtis skiriasi.

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ą.

Valdykite leidžiamus ir blokuojamus svetainių rinkinius

Naudokite darbo erdvės valdiklius

1. Darbo erdvėje atidarykite „SharePoint“ programėlės skiltį Saugos ir saugumo valdikliai.

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

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

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

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

Per administravimo API pridėtos svetainės rodomos darbo erdvės valdikliuose. 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 neapriboja tolesnio jos valdymo.

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 numatytus rinkinius ir išsaugokite dar kartą.


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

Įkelkite svetainių rinkinius iš CSV

Įkeliant CSV palaikomi tik svetainių rinkiniai. Norėdami neįtraukti failų pagal slaptumo žymą, pridėkite žymų GUID skiltyje Neįtraukiamos slaptumo žymos be šifravimo.

1. Atidarykite skiltį Saugos ir saugumo valdikliai ir pasirinkite norimą parinkties Prieigos režimas reikšmę.

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

3. Pasirinkite Įkelti CSV failą ir nurodykite 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 veikimas:

• Didžiausias failo dydis: 1 MB.

• Antraštės neprivalomos.

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

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

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

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

• Įkėlus pakeičiamas tik sąrašo juodraštis. Darbo erdvės prieiga neatnaujinama, kol nepasirenkate Išsaugoti.

• Čia aprašytas CSV įkėlimas skirtas svetainių rinkiniams valdyti. Neįtraukimą pagal slaptumo žymas konfigūruokite atskirai.

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

Susipažinkite su politikos ir užklausų limitais

Numatytasis politikos limitas yra 10 000 svetainių rinkinių. Didesnius darbo erdvės politikos limitus, iki 120 000 svetainių rinkinių, turi įjungti OpenAI; prieš planuodami didesnį 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 politikos limitas nepadidina šio vienos užklausos limito. Skaičiuokite unikalius svetainių rinkinius, o ne pradinius URL: keli URL gali nurodyti tą patį rinkinį.

Naudokite darbo erdvės administravimo API

Su 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“:

• Esamo leidžiamųjų sąrašo peržiūra.

• Svetainių rinkinių peržiūra ir pridėjimas. Pridedant išsaugomi esami leidžiami rinkiniai.

• Svetainių rinkinio pašalinimas.

• Leidžiamųjų sąrašo išvalymas.

Prieš keisdami peržiūrėkite dabartinę politiką, tada peržiūrėkite ją dar kartą ir išbandykite prieigą po pakeitimų. 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ša „Cookbook“ priemonė šiuo metu valdo tik leidžiamųjų sąrašus. Ji nevaldo draudžiamųjų sąrašų ar neįtraukimo pagal slaptumo žymas. Š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įtraukimo pagal žymas taisykles

1. Atidarykite „SharePoint“ programėlės skiltį Saugos ir saugumo valdikliai.

2. Skiltyje Neįtraukiamos slaptumo žymos be šifravimo įveskite kiekvienos šifravimo netaikančios žymos GUID.

3. Išsaugokite konfigūraciją ir išbandykite palaikomą failą su neįtraukiama žyma.

Failai su atitinkančiomis palaikomomis žymomis neįtraukiami į „SharePoint“ programėlės rezultatus. Failai su šifravimą taikančiomis žymomis jau neįtraukiami pagal numatytuosius nustatymus.

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 svetainių valdikliai pakeičia „Microsoft“ leidimus?

Ne. Programėlė ir toliau naudoja kiekvieno naudotojo „Microsoft“ leidimus. OpenAI taiko 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 blokuojami. Kai nė viename sąraše nėra įrašų, prieigą lemia naudotojų „Microsoft“ leidimai ir kitos sukonfigūruotos kontrolės priemonės.

Ar administravimo API pakeitimai registruojami žurnaluose?

Per administravimo API atlikti politikos pakeitimai registruojami darbo erdvės audito ir atitikties žurnaluose.