Përmbledhje

Administratorët e hapësirës së punës mund të përdorin kontrollet e SharePoint për të lejuar koleksionet e miratuara të sajteve, për të bllokuar koleksione të zgjedhura sajtesh dhe për të përjashtuar skedarët e mbështetur me etiketa të caktuara ndjeshmërie të Microsoft Purview.

Një koleksion sajtesh i SharePoint, i quajtur edhe SPSite, mund të përmbajë disa sajte. Një rregull koleksioni zbatohet për të gjithë koleksionin, në varësi të lejeve ekzistuese të çdo përdoruesi në Microsoft. Ai nuk i jep një përdoruesi qasje në përmbajtje që nuk mund t'i qaset në Microsoft 365.

Kufizimet e sajteve zbatohen për veprimet e mbështetura të kërkimit, shfletimit, marrjes së skedarëve dhe leximit/shkrimit në SharePoint. Qasja në OneDrive menaxhohet veçmas.

Zgjidhni modalitetin e qasjes që përputhet me politikën tuaj:

• Sajte të lejuara: Kur lista e lejimit nuk është e zbrazët, përdoruesit mund të kenë qasje përmes aplikacionit vetëm në koleksionet e sajteve që janë në listë.

• Sajte të bllokuara: Përdoruesit mund të kenë qasje në koleksionet e sajteve që nuk janë në listën e bllokimit, në varësi të lejeve të tyre në Microsoft.

Vetëm njëra listë mund të përmbajë elemente në një moment të caktuar. Një listë e zbrazët lejimi nuk i bllokon të gjitha sajtet. Kur të dyja listat janë të zbrazëta, kufizimet e sajteve të SharePoint hiqen; lejet e Microsoft dhe kontrollet e tjera të konfiguruara vazhdojnë të zbatohen.

Disponueshmëria

Kontrollet dhe API-ja e administrimit të hapësirës së punës duhet të aktivizohen për hapësirën tuaj të punës. Kontrollet e disponueshme përfshijnë lista lejimi dhe lista bllokimi për koleksionet e sajteve, importimin e sajteve nga CSV dhe përjashtime sipas etiketave të ndjeshmërisë.

Rregullat zbatohen për koleksione të tëra sajtesh. Kufizimi i fushës së zbatimit në një sajt, dosje ose skedar të caktuar dhe zbatimi i Microsoft Sites.Selected nuk përfshihen në këto kontrolle të koleksioneve të sajteve.

Para se të filloni

• Identifikoni koleksionet e sajteve që organizata juaj dëshiron të lejojë ose të bllokojë.

• Merrni GUID-në e çdo koleksioni. Një ID e plotë sajti nga Microsoft Graph përmban GUID-në e koleksionit si vlerën e mesit. API-ja e administrimit përdor GUID-të e koleksioneve; importuesi i CSV-së në ndërfaqe mund t'i nxjerrë ato edhe nga ID-të tripjesëshe të sajteve nga Graph.

• Aktivizoni lejet e Microsoft që kërkon aplikacioni SharePoint si te cilësimet e lejeve në ChatGPT, ashtu edhe në Microsoft Entra, përfshirë Sites.Read.All dhe Files.Read.All. Këto kontrolle filtrojnë qasjen nga ana e OpenAI; ato nuk i zëvendësojnë lejet e deleguara të Microsoft.

• Për përjashtimet sipas etiketave të ndjeshmërisë, kërkojini administratorit tuaj të Microsoft 365 ose Purview GUID-në e pandryshueshme të çdo etikete pa enkriptim.

• Për administrim përmes API-së, merrni UUID-në e hapësirës suaj të punës, një çelës administrimi të hapësirës së punës në ChatGPT dhe një token të Microsoft Graph nëse duhet të gjeni identifikuesit për URL-të e SharePoint. Dy kredencialet kanë qëllime të ndryshme.

Rreth OpenAI Cookbook

OpenAI Cookbook është koleksioni publik i OpenAI me shembuj kodi dhe udhëzues. Ky artikull përdor udhëzuesin e tij për qasjen në sajtet e SharePoint dhe skriptin e administrimit në Python, të dy të publikuar në GitHub. Mund t'i hapni këto lidhje në shfletuesin tuaj për të lexuar skedarët. Për të ekzekutuar skriptin, shkarkojeni dhe ndiqni udhëzimet për konfigurimin dhe komandat në udhëzues.

Në të gjithë këtë artikull, “Cookbook” i referohet atij udhëzuesi për SharePoint dhe “mjeti i Cookbook” i referohet skriptit Python në lidhjen e dhënë. Përdorni këto burime për shembuj komandash dhe për menaxhimin e listës së lejimit përmes API-së.

Konfiguroni kredencialet për administrim përmes API-së

Shënim: Duhet të jeni administrator i hapësirës së punës që të mund të krijoni çelësa administrimi. Lexoni më shumë.

Krijoni një çelës administrimi të hapësirës së punës në ChatGPT

1. Hapni konsolën e administrimit të ChatGPT dhe zgjidhni hapësirën e dëshiruar të punës.

2. Shkoni te Kredencialet dhe zgjidhni Çelësat e administrimit.

3. Krijoni një çelës me leje Të kufizuara dhe caktoni Aplikacionet në Shkrim.

4. Ruajeni çelësin në mënyrë të sigurt. Ky çelës autorizon leximin dhe ndryshimin e politikës së SharePoint për hapësirën tuaj të punës.

Leja e kërkuar është chatgpt.enterprise.apps.write. Vini re se një çelës nga Platforma API dhe një token i Microsoft Graph nuk mund të zëvendësojnë një çelës administrimi të hapësirës së punës në ChatGPT.

Për më shumë informacion, shihni: Menaxhimi i çelësave të administrimit në skedën Kredencialet. Për variablat e mjedisit të kredencialeve të skriptit dhe një shembull të futjes së sigurt të tyre, shihni udhëzimet për kredencialet në Cookbook.

Merrni një token të Microsoft Graph

Përdorni procesin e autentikimit në Microsoft të miratuar nga organizata juaj. Për një kërkim ndërveprues, nëse organizata juaj lejon Graph Explorer:

1. Hapni Microsoft Graph Explorer dhe hyni me një llogari pune në instancën e organizatës që përmban sajtet e SharePoint.

2. Zgjidhni lejet e nevojshme për të lexuar sajtet, zakonisht Sites.Read.All, duke përdorur Ndrysho lejet ose Jep pëlqimin për lejet. Kërkojini administratorit tuaj të Microsoft të miratojë qasjen nëse organizata juaj e kërkon këtë.

3. Hapni skedën Tokeni i qasjes dhe kopjoni tokenin për ta përdorur me Microsoft Graph.

Për udhëzimet e Microsoft, shihni Punoni me Graph Explorer.

Tokeni i Graph shërben për të gjetur identifikuesit që u përkasin URL-ve të SharePoint. Çelësi i administrimit të ChatGPT lexon ose përditëson politikën e ChatGPT. Mjeti i Cookbook ka nevojë për tokenin e Graph vetëm për komandat që gjejnë identifikuesit nga URL-të; leximi ose zbrazja e një liste ekzistuese lejimi kërkon vetëm çelësin e administrimit të ChatGPT.

Mos vendosni asnjërin prej kredencialeve në sisteme të kontrollit të versioneve, dokumente të përbashkëta, pamje ekrani ose regjistra.

Gjeni GUID-në e një koleksioni sajtesh

Përdorni URL-në e sajtit të SharePoint

1. Hapni sajtin e SharePoint pasi të keni hyrë në Microsoft me një llogari që ka qasje në të.

2. Shtoni /_api/site/id në fund të URL-së së sajtit. Për shembull, përdorni https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopjoni GUID-në e kthyer në përgjigje.

Shënim: domenet dhe identifikuesit e përdorur si shembuj në këtë artikull janë vlera ilustruese.

Përdorni Microsoft Graph

Microsoft Graph kthen një ID sajti me tre përbërës të ndarë me presje: emrin e hostit, GUID-në e koleksionit të sajteve dhe GUID-në e sajtit. Përdorni vlerën e mesit për një rregull që zbatohet për koleksionin e sajteve. URL të ndryshme sajtesh mund të japin të njëjtën GUID koleksioni.

Për shembuj të kërkimit dhe të identifikuesve, shihni Kuptoni identifikuesit e sajteve të SharePoint. Për të gjetur identifikuesit për disa URL pa ndryshuar politikën e ChatGPT, përdorni udhëzimet e inspektimit në Cookbook dhe skriptin e administrimit në Python.

Për kërkesat e Microsoft lidhur me kërkimin, shihni Merrni një sajt të SharePoint sipas shtegut.

Menaxhoni koleksionet e lejuara dhe të bllokuara të sajteve

Përdorni kontrollet e hapësirës së punës

1. Hapni Kontrollet e sigurisë dhe mbrojtjes të aplikacionit SharePoint në hapësirën tuaj të punës.

2. Te Modaliteti i qasjes, zgjidhni Sajte të lejuara ose Sajte të bllokuara.

3. Shtoni koleksionet e sajteve në listën e zgjedhur. Mund të përdorni edhe ngarkimin e CSV-së të përshkruar më poshtë.

4. Shqyrtoni ndryshimet tuaja dhe zgjidhni Ruaj.

5. Kontrolloni politikën e ruajtur dhe testoni konfigurimin tuaj.

Sajtet e shtuara përmes API-së së administrimit shfaqen te kontrollet e hapësirës së punës. Sajtet e shtuara në ndërfaqe janë gjithashtu të disponueshme përmes API-së. Mund të shtoni ose të hiqni elemente përmes cilësdo ndërfaqe; metoda e përdorur për të shtuar një sajt nuk ju detyron të përdorni vetëm atë metodë për të.

Kaloni mes sajteve të lejuara dhe atyre të bllokuara

Vetëm njëra listë mund të përmbajë elemente në një moment të caktuar. Para se të shtoni elemente në modalitetin tjetër, zbrazni listën ekzistuese dhe ruani atë ndryshim. Më pas zgjidhni modalitetin tjetër, shtoni koleksionet e synuara dhe ruani sërish.


Zbrazja e listës aktive e ndryshon qasjen menjëherë sapo ruhet. Zbrazja e një liste lejimi heq kufizimin e saj për sajtet; zbrazja e një liste bllokimi heq bllokimet e saj. Planifikojeni kalimin me administratorët e tjerë, sepse intervali mes zbrazjes së njërës listë dhe ruajtjes së tjetrës mund të lejojë qasje që politika juaj përfundimtare do ta kufizojë.

Ngarkoni koleksione sajtesh nga CSV

Ngarkimi i CSV-së mbështet vetëm koleksionet e sajteve. Për të përjashtuar skedarë sipas etiketës së ndjeshmërisë, shtoni GUID-të e etiketave te Etiketat e përjashtuara të ndjeshmërisë pa enkriptim.

1. Hapni Kontrollet e sigurisë dhe mbrojtjes dhe zgjidhni Modalitetin e qasjes që dëshironi.

2. Përgatitni një CSV me GUID-të e koleksioneve të sajteve ose me ID-të tripjesëshe të sajteve nga Microsoft Graph. Përdorni të njëjtin format identifikuesi në të gjithë skedarin.

3. Zgjidhni Ngarko skedar CSV dhe përzgjidhni skedarin.

4. Shqyrtoni rezultatin e importimit dhe listën e zgjedhur. Zgjidhni çdo gabim ose paralajmërim për rreshtat para se të vazhdoni.

5. Zgjidhni Ruaj për të zbatuar ndryshimet, pastaj kontrolloni listën e ruajtur.

Kërkesat dhe funksionimi i CSV-së:

• Madhësia maksimale e skedarit: 1 MB.

• Titujt e kolonave janë opsionalë.

• Përdorni një GUID koleksioni për rresht ose ID tripjesëshe sajtesh nga Graph. ID-të tripjesëshe mund të vendosen brenda thonjëzave në një fushë ose të ndahen në tre kolona.

• ID-të tripjesëshe të Graph konvertohen në GUID koleksionesh. Importimi i një ID-je tripjesëshe nuk krijon një rregull vetëm për një sajt të caktuar.

• Importimet shtojnë elemente në listën e zgjedhur dhe ruajnë elementet ekzistuese. Koleksionet e përsëritura mbahen vetëm një herë; numri i raportuar nga importimi përfshin vetëm koleksionet e shtuara rishtazi.

• Formatet e përziera dhe rreshtat e formatuar gabim refuzohen. Një ngarkim që përmban vetëm URL sajtesh shfaq një paralajmërim dhe nuk shton sajte. Gjeni fillimisht GUID-të e koleksioneve që u përkasin URL-ve.

• Ngarkimi ndryshon vetëm listën e paruajtur. Ai nuk e përditëson qasjen në hapësirën e punës derisa të zgjidhni Ruaj.

• Ngarkimi i CSV-së i përshkruar këtu menaxhon koleksionet e sajteve. Konfiguroni veçmas përjashtimet sipas etiketave të ndjeshmërisë.

Nëse keni një CSV me URL të SharePoint, rrjedha e punës me CSV e mjetit të Cookbook mund të gjejë identifikuesit e tyre dhe të menaxhojë një listë lejimi përmes API-së. Hyrjet e tij site_url ose url përdorin format dhe rrjedhë pune të ndryshme nga ngarkimi i identifikuesve në ndërfaqe.

Kuptoni kufijtë e politikës dhe të kërkesave

Kufiri i parazgjedhur i politikës është 10 000 koleksione sajtesh. Kufijtë më të lartë të politikës së hapësirës së punës, deri në 120 000 koleksione sajtesh, kërkojnë aktivizim nga OpenAI; kontaktoni ekipin tuaj të OpenAI para se të planifikoni një zbatim në shkallë më të gjerë.

Operacionet individuale të ndryshimit përmes API-së dhe skripti aktual i Cookbook pranojnë deri në 10 000 GUID koleksionesh për kërkesë. Një kufi më i lartë i politikës së hapësirës së punës nuk e rrit këtë kufi për kërkesë. Numëroni koleksionet unike të sajteve, jo URL-të burimore: disa URL mund t'i referohen të njëjtit koleksion.

Përdorni API-në e administrimit të hapësirës së punës

Përdorni UUID-në e hapësirës suaj të punës dhe çelësin e administrimit të hapësirës së punës në ChatGPT me https://api.chatgpt.com.

Për komanda të përditësuara të listës së lejimit dhe shembuj kërkesash, përdorni Cookbook:

• Lexoni listën ekzistuese të lejimit.

• Shikoni paraprakisht dhe shtoni koleksione sajtesh. Shtimet i ruajnë koleksionet ekzistuese të lejuara.

• Hiqni një koleksion sajtesh.

• Zbrazni listën e lejimit.

Shqyrtoni politikën aktuale para se të bëni ndryshime, pastaj lexojeni sërish dhe testoni qasjen që rezulton. Heqja e koleksionit të fundit të lejuar ose zbrazja e listës së lejimit e heq atë kufizim për sajtet. Mos dërgoni një kërkesë shtimi të zbrazët, përveçse kur synoni të hiqni kufizimet e listës së lejimit.

Mjeti publik i Cookbook aktualisht menaxhon vetëm lista lejimi. Ai nuk menaxhon lista bllokimi ose përjashtime sipas etiketave të ndjeshmërisë. Për këto detyra, përdorni kontrollet e hapësirës së punës të përshkruara më sipër.

Përjashtoni skedarët me etiketa ndjeshmërie

Gjeni GUID-në e etiketës

Kërkojini administratorit tuaj të Microsoft 365 ose Purview GUID-në e pandryshueshme të etiketës së synuar. Përdorni GUID-në, jo emrin e afishuar të etiketës.

Një administrator mund t'i listojë etiketat përmes Microsoft Graph. Tokeni ka nevojë për lejen përkatëse SensitivityLabel.Read ose SensitivityLabels.Read.All. Gjeni ID-në që i përket emrit të etiketës së synuar dhe kontrolloni cilësimet e saj të mbrojtjes.

Për kërkesat dhe shembujt, shihni Listoni etiketat e ndjeshmërisë dhe Vetitë e etiketës së ndjeshmërisë. Këto leje për etiketat janë të veçanta nga leja e leximit të sajteve, që përdoret për të gjetur identifikuesit nga URL-të e SharePoint.

Shtoni përjashtime sipas etiketave

1. Hapni Kontrollet e sigurisë dhe mbrojtjes të aplikacionit SharePoint.

2. Vendosni GUID-në e çdo etikete pa enkriptim te Etiketat e përjashtuara të ndjeshmërisë pa enkriptim.

3. Ruani konfigurimin dhe testoni një skedar të mbështetur me etiketën e përjashtuar.

Skedarët me etiketa të mbështetura që përputhen me ato të përjashtuara nuk përfshihen në rezultatet e aplikacionit SharePoint. Skedarët me etiketa që zbatojnë enkriptim janë tashmë të përjashtuar si parazgjedhje.

Testoni konfigurimin tuaj

Përdorni skedarë dhe llogari testimi të miratuara nga organizata juaj. Para testimit, konfirmoni se e njëjta llogari Microsoft mund të ketë qasje në çdo skedar drejtpërdrejt në SharePoint.

1. Në modalitetin Sajte të lejuara, me një listë jo të zbrazët, kontrolloni një skedar në një koleksion të lejuar dhe një skedar në një koleksion që nuk është në listë. Vetëm koleksioni i lejuar duhet të jetë i qasshëm përmes aplikacionit.

2. Në modalitetin Sajte të bllokuara, kontrolloni një skedar në një koleksion të bllokuar dhe një skedar në një koleksion të pabllokuar. Koleksioni i bllokuar duhet të jetë i paqasshëm; koleksioni i pabllokuar mbetet subjekt i lejeve të Microsoft dhe i kontrolleve të tjera.

3. Kontrolloni një skedar testimi të mbështetur që mban një etiketë ndjeshmërie të përjashtuar. Ai nuk duhet të shfaqet në rezultatet e aplikacionit.

4. Pas një ndryshimi përmes API-së, krahasoni listën e ruajtur në ndërfaqe me politikën e kthyer nga API-ja.

5. Pas ngarkimit të një CSV-je, ruani ndryshimet dhe rihapni kontrollet për të konfirmuar se koleksionet e synuara janë ruajtur.

Nëse rezultatet ndryshojnë nga politika e synuar, kontrolloni hapësirën e punës, modalitetin e zgjedhur të qasjes, listën e ruajtur, GUID-të e koleksioneve, GUID-të e etiketave, llojin e mbështetur të skedarit dhe lejet e përdoruesit në Microsoft. Mos e zbrazni një listë si hap për zgjidhjen e problemeve, përveçse kur synoni ndryshimin e qasjes që vjen si pasojë.

Për ndihmë me kontrollet që mungojnë ose me qasjen e papritur, shihni: Kontaktimi i mbështetjes së OpenAI. Mos përfshini çelësa administrimi ose tokenë të Microsoft Graph në kërkesën tuaj për mbështetje.

Kuptoni kufizimet

• Një rregull koleksioni mbulon të gjithë koleksionin e sajteve. Ai nuk mund ta kufizojë qasjen në një nënsajt, dosje ose skedar të caktuar.

• Kufizimet e sajteve të SharePoint nuk e kufizojnë automatikisht qasjen në OneDrive.

• Filtrimi sipas etiketave të ndjeshmërisë zbatohet vetëm kur Microsoft Graph vë në dispozicion metadatat e etiketave të mbështetura, përfshirë dokumentet e mbështetura të Office dhe skedarët PDF e MP4.

• Llojet që nuk mbështesin etiketat e ndjeshmërisë, si skedarët TXT dhe CSV, trajtohen si pa etiketa. Ata mbeten të qasshëm nëse rregullat e tjera e lejojnë. Ky kufizim i llojit të skedarit nuk lidhet me ngarkimin e një CSV-je për të konfiguruar qasjen në sajte.

• Ngarkimi i CSV-së dhe mjeti publik demonstrues nuk konfigurojnë përjashtime sipas etiketave të ndjeshmërisë. Ky artikull nuk dokumenton një API për menaxhimin në masë të etiketave.

• Një politikë e ruajtur ose një përgjigje e suksesshme nga API-ja nuk e zëvendëson testimin e qasjes me llogarinë përkatëse.

Përdorni mjetin e administrimit në Python

Kodi i plotë demonstrues dhe komandat mirëmbahen në OpenAI Cookbook:

• Udhëzuesi i administrimit.

• Skripti i administrimit në Python.

• Skedari i testeve pa lidhje interneti.

Përdorni Python 3.10 ose një version të mëvonshëm. Mjeti përdor bibliotekën standarde të Python. Lexoni udhëzuesin para se ta ekzekutoni dhe përdorni ekzekutime provë pa zbatim për të shqyrtuar ndryshimet.

Mjeti aktual i lexon kredencialet nga variablat e mjedisit; ndiqni udhëzimet e udhëzuesit për futjen e tyre në mënyrë të sigurt. Ai kërkon konfirmim të shprehur për zbrazjen e një liste lejimi. Heqja e një elementi mund të kryhet pa atë konfirmim, ndaj shqyrtojeni fillimisht me një ekzekutim provë pa zbatim.

Për mënyrën e riprovimit dhe çelësat opsionalë të idempotencës, shihni Riprovoni në mënyrë të sigurt përditësimin e një politike. Përdorni çelësa idempotence vetëm kur hapësira e punës i mbështet dhe kontrolloni politikën aktuale pas një dështimi me rezultat të paqartë.

Mjeti nuk aktivizon veçori të hapësirës së punës dhe nuk verifikon zbatimin e politikës. Testet e tij pa lidhje interneti përdorin thirrje të simuluara të Microsoft Graph dhe të API-së së administrimit të ChatGPT.

Ndryshimet që përfshijnë disa kërkesa nuk janë atomike. Nëse heqja e disa koleksioneve dështon gjatë procesit, heqjet e mëparshme mund të jenë kryer tashmë me sukses. Lexoni politikën aktuale para se të riprovoni.

Pyetje të shpeshta

A i zëvendësojnë kontrollet e sajteve lejet e Microsoft?

Jo. Aplikacioni vazhdon të përdorë lejet e çdo përdoruesi në Microsoft. OpenAI zbaton filtrimin e konfiguruar të sajteve para se përgjigjet t'i shfaqen përdoruesit dhe modelit.

A i bllokon të gjitha sajtet një listë e zbrazët lejimi?

Jo. Një listë e zbrazët lejimi nuk do të thotë “blloko gjithçka”. Nëse një listë bllokimi përmban elemente, ato koleksione mbeten të bllokuara. Kur asnjëra listë nuk përmban elemente, qasja përcaktohet nga lejet e përdoruesve në Microsoft dhe kontrollet e tjera të konfiguruara.

A regjistrohen ndryshimet e bëra përmes API-së së administrimit?

Ndryshimet e politikës të bëra përmes API-së së administrimit regjistrohen në regjistrat e auditimit dhe të pajtueshmërisë të hapësirës së punës.