Áttekintés

A munkaterület adminisztrátorai a SharePoint beállításaival engedélyezhetik a jóváhagyott webhelycsoportokat, letilthatják a kiválasztott webhelycsoportokat, és kizárhatják a kiválasztott Microsoft Purview bizalmassági címkékkel ellátott, támogatott fájlokat.

Egy SharePoint-webhelycsoport, más néven SPSite, több webhelyet is tartalmazhat. A webhelycsoportra vonatkozó szabály a teljes csoportra érvényes, az egyes felhasználók meglévő Microsoft-engedélyeinek figyelembevételével. Nem biztosít hozzáférést a felhasználónak olyan tartalomhoz, amelyet a Microsoft 365-ben nem érhet el.

A webhelykorlátozások a támogatott SharePoint-keresési, böngészési, fájllekérési, valamint olvasási és írási műveletekre érvényesek. A OneDrive-hozzáférés kezelése ettől független.

Válaszd ki a házirendednek megfelelő hozzáférési módot:

• Engedélyezett webhelyek: Ha az engedélyezési lista nem üres, a felhasználók csak a felsorolt webhelycsoportokat érhetik el az alkalmazáson keresztül.

• Letiltott webhelyek: A felhasználók a tiltólistán szereplőkön kívüli webhelycsoportokat érhetik el, a Microsoft-engedélyeiknek megfelelően.

Egyszerre csak az egyik lista tartalmazhat bejegyzéseket. Az üres engedélyezési lista nem tiltja le az összes webhelyet. Ha mindkét lista üres, a SharePoint-webhelyek korlátozásai megszűnnek; a Microsoft-engedélyek és az egyéb konfigurált szabályozások továbbra is érvényesek.

Elérhetőség

A beállításokat és a munkaterületi Admin API-t engedélyezni kell a munkaterületedhez. Az elérhető funkciók közé tartoznak a webhelycsoportok engedélyezési és tiltólistái, a webhelyek CSV-importálása és a bizalmassági címke szerinti kizárások.

A szabályok teljes webhelycsoportokra érvényesek. Ezek a webhelycsoport-szintű beállítások nem támogatják az egyes webhelyekre, mappákra vagy fájlokra szűkített hatókört, illetve a Microsoft Sites.Selected érvényesítését.

Mielőtt elkezdenéd

• Határozd meg, mely webhelycsoportokat szeretné a szervezeted engedélyezni vagy letiltani.

• Szerezd be az egyes webhelycsoportok GUID-azonosítóját. A teljes Microsoft Graph-webhelyazonosító középső értéke a webhelycsoport GUID-azonosítója. Az Admin API a webhelycsoportok GUID-azonosítóit használja; a felhasználói felület CSV-importálója a háromtagú Graph-webhelyazonosítókból is ki tudja nyerni őket.

• Engedélyezd a SharePoint alkalmazás által igényelt Microsoft-jogosultságokat a ChatGPT jogosultsági beállításaiban és a Microsoft Entrában is, beleértve a Sites.Read.All és a Files.Read.All jogosultságot. Ezek a beállítások az OpenAI oldalán szűrik a hozzáférést; nem helyettesítik a Microsoft delegált jogosultságait.

• A bizalmassági címke szerinti kizárásokhoz kérd el a Microsoft 365- vagy Purview-rendszergazdától minden kizárni kívánt címke megváltoztathatatlan GUID-azonosítóját, beleértve a titkosítást alkalmazó címkékét is.

• Az API-n keresztüli adminisztrációhoz szerezd be a munkaterületed UUID-azonosítóját és egy ChatGPT-munkaterületi rendszergazdai kulcsot, valamint egy Microsoft Graph-tokent, ha SharePoint-URL-ekhez tartozó azonosítókat is ki kell keresned. A két hitelesítő adat eltérő célt szolgál.

Az OpenAI Cookbook bemutatása

Az OpenAI Cookbook az OpenAI nyilvános példakód- és útmutatógyűjteménye. Ez a cikk a gyűjtemény SharePoint-webhelyhozzáférési útmutatójára és Python-alapú felügyeleti szkriptjére támaszkodik; mindkettő a GitHubon érhető el. A fájlok elolvasásához megnyithatod ezeket a hivatkozásokat a böngésződben. A szkript futtatásához töltsd le, majd kövesd az útmutató beállítási és parancshasználati utasításait.

Ebben a cikkben a „Cookbook” ezt a SharePoint-útmutatót jelenti, a „Cookbook segédprogram” pedig a hivatkozott Python-szkriptet. Ezekben a forrásokban találsz parancspéldákat és útmutatást az engedélyezési lista API-alapú kezeléséhez.

Hitelesítő adatok beállítása az API-alapú felügyelethez

Megjegyzés: Adminisztrátori kulcsokat csak munkaterületi adminisztrátorként hozhatsz létre. További információ.

ChatGPT-munkaterületi adminisztrátori kulcs létrehozása

1. Nyisd meg a ChatGPT adminisztrátori konzolját, és válaszd ki a kívánt munkaterületet.

2. Lépj a Hitelesítő adatok részre, és válaszd az Adminisztrátori kulcsok lehetőséget.

3. Hozz létre egy kulcsot Korlátozott engedélyekkel, és állítsd az Alkalmazások engedélyét Írás értékre.

4. Tárold biztonságosan a kulcsot. Ez a kulcs feljogosít a munkaterületed SharePoint-házirendjének lekérdezésére és módosítására.

A szükséges engedély: chatgpt.enterprise.apps.write. Fontos, hogy sem az API Platform kulcsa, sem a Microsoft Graph-token nem helyettesítheti a ChatGPT-munkaterület adminisztrátori kulcsát.

További információ: Adminisztrátori kulcsok kezelése a Hitelesítő adatok lapon. A szkript hitelesítő adatokhoz használt környezeti változóiról és a biztonságos adatbevitel példájáról a Cookbook hitelesítő adatokra vonatkozó útmutatójában olvashatsz.

Microsoft Graph-token beszerzése

A szervezeted által jóváhagyott Microsoft-hitelesítési folyamatot használd. Interaktív lekérdezéshez, ha a szervezeted engedélyezi a Graph Explorer használatát:

1. Nyisd meg a Microsoft Graph Explorert, és jelentkezz be egy munkahelyi fiókkal abba a bérlőbe, amely a SharePoint-webhelyeket tartalmazza.

2. Az Engedélyek módosítása vagy az Engedélyek jóváhagyása lehetőséggel válaszd ki a webhelyek olvasásához szükséges engedélyeket, általában a Sites.Read.All engedélyt. Ha a szervezeted megköveteli, kérd meg a Microsoft-rendszergazdádat a hozzáférés jóváhagyására.

3. Nyisd meg a Hozzáférési token lapot, és másold ki a tokent a Microsoft Graphban való használathoz.

A Microsoft útmutatójáért lásd: A Graph Explorer használata.

A Graph-token a SharePoint-URL-ekhez tartozó azonosítók lekérdezésére szolgál. A ChatGPT adminisztrátori kulcsa a ChatGPT-házirend lekérdezésére vagy frissítésére szolgál. A Cookbook segédprogramnak csak az URL-ekhez tartozó azonosítókat lekérdező parancsokhoz kell Graph-token; egy meglévő engedélyezési lista lekérdezéséhez vagy kiürítéséhez csak a ChatGPT adminisztrátori kulcsa szükséges.

Egyik hitelesítő adatot se helyezd el verziókezelőben, megosztott dokumentumokban, képernyőképeken vagy naplókban.

Webhelycsoport GUID-azonosítójának megkeresése

A SharePoint-webhely URL-címének használata

1. Nyisd meg a SharePoint-webhelyet, miközben olyan fiókkal vagy bejelentkezve a Microsoftba, amely hozzáfér a webhelyhez.

2. Illeszd a /_api/site/id útvonalat a webhely URL-címének végére. Például: https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Másold ki a válaszban kapott GUID-azonosítót.

Megjegyzés: A cikkben szereplő példadomainek és -azonosítók helyőrzők.

A Microsoft Graph használata

A Microsoft Graph által visszaadott webhelyazonosító három, vesszővel elválasztott részből áll: az állomásnévből, a webhelycsoport GUID-azonosítójából és a webhely GUID-azonosítójából. A webhelycsoportra vonatkozó szabályhoz a középső értéket használd. Különböző webhely-URL-ekhez is tartozhat ugyanaz a webhelycsoport-GUID.

A lekérdezésre és az azonosítókra vonatkozó példákért lásd: A SharePoint-webhelyazonosítók ismertetése. Ha több URL-hez szeretnéd lekérdezni az azonosítókat a ChatGPT-házirend módosítása nélkül, használd a Cookbook ellenőrzési útmutatóját és a Python-alapú felügyeleti szkriptet.

A Microsoft lekérdezési követelményeiért lásd: SharePoint-webhely lekérése útvonal alapján.

Engedélyezett és letiltott webhelycsoportok kezelése

A munkaterület beállításainak használata

1. Nyisd meg a SharePoint alkalmazás Biztonsági és védelmi beállítások paneljét a munkaterületeden.

2. A Hozzáférési mód alatt válaszd az Engedélyezett webhelyek vagy a Letiltott webhelyek lehetőséget.

3. Add hozzá a webhelycsoportokat a kiválasztott listához. Az alább ismertetett CSV-feltöltést is használhatod.

4. Ellenőrizd a módosításokat, majd válaszd a Mentés lehetőséget.

5. Ellenőrizd a mentett szabályzatot, és teszteld a konfigurációt.

Az Admin API-n keresztül hozzáadott webhelyek megjelennek a munkaterület beállításaiban. A felhasználói felületen hozzáadott webhelyek az API-n keresztül is elérhetők. Mindkét felületen hozzáadhatsz és eltávolíthatsz bejegyzéseket; a webhely hozzáadásának módja nem köti a későbbi kezelését ugyanahhoz a módszerhez.

Váltás az engedélyezett és a letiltott webhelyek között

Egyszerre csak az egyik lista tartalmazhat bejegyzéseket. Mielőtt a másik módban adnál hozzá bejegyzéseket, ürítsd ki a meglévő listát, és mentsd a módosítást. Ezután válaszd ki a másik módot, add hozzá a kívánt webhelycsoportokat, és ments újra.


Az aktív lista kiürítése a mentéskor azonnal megváltoztatja a hozzáférést. Az engedélyezési lista kiürítése megszünteti a webhelyekre vonatkozó korlátozást; a tiltólista kiürítése feloldja a tiltásokat. Egyeztesd az átállást a többi rendszergazdával, mert az egyik lista kiürítése és a másik mentése közötti időszakban olyan hozzáférés is lehetővé válhat, amelyet a végleges szabályzat korlátoz majd.

Webhelycsoportok feltöltése CSV-fájlból

A CSV-feltöltés csak webhelycsoportokat támogat. A fájlok bizalmassági címke szerinti kizárásához add hozzá a címkék GUID-azonosítóját a bizalmassági címkék kizárási listájához.

1. Nyisd meg a Biztonsági és védelmi beállítások panelt, és válaszd ki a kívánt módot a Hozzáférési mód alatt.

2. Készíts egy CSV-fájlt a webhelycsoportok GUID-azonosítóival vagy a Microsoft Graph háromtagú webhelyazonosítóival. A fájlban végig ugyanazt az azonosítóformátumot használd.

3. Válaszd a CSV-fájl feltöltése lehetőséget, majd válaszd ki a fájlt.

4. Ellenőrizd az importálás eredményét és a kiválasztott listát. A folytatás előtt javítsd a sorokban jelzett hibákat és a figyelmeztetést kiváltó problémákat.

5. A módosítások alkalmazásához válaszd a Mentés lehetőséget, majd ellenőrizd a mentett listát.

A CSV-feltöltés követelményei és működése:

• Maximális fájlméret: 1 MB.

• A fejléc megadása nem kötelező.

• Soronként egy webhelycsoport GUID-azonosítóját vagy egy háromtagú Graph-webhelyazonosítót adj meg. A háromtagú azonosítók megadhatók egyetlen mezőben, idézőjelek között, vagy három oszlopra bontva.

• A rendszer a háromtagú Graph-azonosítókat a webhelycsoportok GUID-azonosítóivá alakítja. Egy háromtagú azonosító importálása nem hoz létre egyetlen konkrét webhelyre vonatkozó szabályt.

• Az importálás új bejegyzésekkel bővíti a kiválasztott listát, és megőrzi a meglévőket. Az ismétlődő webhelycsoportok csak egyszer szerepelnek a listán; az importálási darabszám az újonnan hozzáadott webhelycsoportokat jelzi.

• A rendszer elutasítja a vegyes formátumokat és a hibás formátumú sorokat. Ha a feltöltött fájl csak webhely-URL-eket tartalmaz, figyelmeztetés jelenik meg, és a rendszer nem ad hozzá webhelyeket. Először keresd ki az URL-ekhez tartozó webhelycsoportok GUID-azonosítóit.

• A feltöltés csak a lista piszkozatát módosítja. A munkaterület hozzáférési beállításai csak a Mentés kiválasztása után változnak meg.

• Az itt ismertetett CSV-feltöltés webhelycsoportok kezelésére szolgál. A bizalmassági címke szerinti kizárásokat külön állítsd be.

Ha SharePoint-URL-eket tartalmazó CSV-fájlod van, a Cookbook segédprogram CSV-munkafolyamatával kikeresheted a hozzájuk tartozó azonosítókat, és az API-n keresztül kezelheted az engedélyezési listát. A segédprogram site_url vagy url bemenete más formátumot és munkafolyamatot használ, mint a felhasználói felület azonosítófeltöltési funkciója.

A szabályzat és a kérések korlátai

A szabályzat alapértelmezett korlátja 10 000 webhelycsoport. A munkaterület szabályzatának magasabb, legfeljebb 120 000 webhelycsoportra emelt korlátját az OpenAI-nak kell engedélyeznie; nagyobb léptékű bevezetés tervezése előtt vedd fel a kapcsolatot az OpenAI kapcsolattartó csapatával.

Az egyes API-módosítási műveletek és a jelenlegi Cookbook-szkript kérésenként legfeljebb 10 000 webhelycsoport GUID-azonosítóját fogadják el. A munkaterület szabályzatának magasabb korlátja nem növeli ezt a kérésenkénti korlátot. Az egyedi webhelycsoportokat számold, ne a forrás-URL-eket: több URL is hivatkozhat ugyanarra a webhelycsoportra.

A munkaterület Admin API-jának használata

A https://api.chatgpt.com használatához add meg a munkaterületed UUID-azonosítóját és a ChatGPT-munkaterület rendszergazdai kulcsát.

Az engedélyezési lista kezelésére szolgáló, naprakészen tartott parancsokat és a példakéréseket a Cookbookban találod:

• A meglévő engedélyezési lista lekérése.

• Webhelycsoportok előnézete és hozzáadása. A hozzáadás megőrzi a már engedélyezett webhelycsoportokat.

• Webhelycsoport eltávolítása.

• Az engedélyezési lista kiürítése.

A módosítások előtt ellenőrizd az aktuális szabályzatot, majd kérd le újra, és teszteld az így beállított hozzáférést. Az utolsó engedélyezett webhelycsoport eltávolítása vagy az engedélyezési lista kiürítése megszünteti a webhelyekre vonatkozó korlátozást. Ne küldj üres hozzáadási kérést, hacsak nem szeretnéd megszüntetni az engedélyezési lista korlátozásait.

A nyilvános Cookbook-segédprogram jelenleg csak engedélyezési listákat kezel. Tiltólistákat és bizalmassági címke szerinti kizárásokat nem kezel. Ezekhez a feladatokhoz a munkaterület fent ismertetett beállításait használd.

Fájlok kizárása bizalmassági címkék alapján

A címke GUID-azonosítójának megkeresése

Kérd el a Microsoft 365- vagy Purview-rendszergazdádtól a kívánt címke megváltoztathatatlan GUID-azonosítóját. A GUID-azonosítót használd, ne a megjelenítendő nevet.

A rendszergazda a Microsoft Graphon keresztül listázhatja a címkéket. A tokenhez a megfelelő SensitivityLabel.Read vagy SensitivityLabels.Read.All engedély szükséges. Keresd meg a kívánt címke nevéhez tartozó azonosítót, és ellenőrizd a védelmi beállításait.

A követelményekért és példákért lásd: Bizalmassági címkék listázása és A bizalmassági címkék tulajdonságai. Ezek a címkeengedélyek függetlenek a SharePoint-URL-ekhez tartozó azonosítók lekérdezéséhez használt webhelyolvasási engedélytől.

Címkealapú kizárások hozzáadása

1. Nyisd meg a SharePoint alkalmazás Biztonsági és védelmi beállítások paneljét.

2. Add meg a kizárni kívánt címkék GUID-azonosítóját a bizalmassági címkék kizárási listáján, beleértve a titkosítást alkalmazó címkéket is.

3. Mentsd a konfigurációt, és teszteld egy olyan támogatott fájllal, amelyen a kizárt címke szerepel.

A listán szereplő támogatott címkékkel ellátott fájlok nem jelennek meg a SharePoint alkalmazás találatai között. A titkosított fájlok tartalma alapértelmezés szerint ki van zárva. A támogatott titkosított fájlok eléréséhez speciális fájlhozzáférés (fetch_advanced) és Microsoft Entra-rendszergazdai hozzájárulás is szükséges, az alábbi GYIK-ben leírtak szerint. A címkealapú kizárások és a csatlakoztatott felhasználó Microsoft-jogosultságai továbbra is érvényesek.

A konfiguráció tesztelése

A szervezeted által jóváhagyott tesztfájlokat és fiókokat használd. Tesztelés előtt ellenőrizd, hogy ugyanazzal a Microsoft-fiókkal közvetlenül a SharePointban minden fájl elérhető-e.

1. Engedélyezett webhelyek módban, nem üres listával ellenőrizz egy fájlt egy engedélyezett webhelycsoportban, és egy másikat egy nem listázott webhelycsoportban. Az alkalmazáson keresztül csak az engedélyezett webhelycsoportnak szabad elérhetőnek lennie.

2. Letiltott webhelyek módban ellenőrizz egy fájlt egy letiltott webhelycsoportban, és egy másikat egy nem letiltott webhelycsoportban. A letiltott webhelycsoportnak elérhetetlennek kell lennie; a nem letiltott webhelycsoportra továbbra is érvényesek a Microsoft-engedélyek és az egyéb szabályozások.

3. Ellenőrizz egy támogatott tesztfájlt, amely kizárt bizalmassági címkével van ellátva. Ennek nem szabad megjelennie az alkalmazás találatai között.

4. API-n keresztüli módosítás után hasonlítsd össze a felületen mentett listát az API által visszaadott házirenddel.

5. CSV-feltöltés után mentsd a módosításokat, majd nyisd meg újra a beállításokat, és ellenőrizd, hogy a kívánt webhelycsoportok szerepelnek-e a listán.

Ha az eredmények eltérnek a kívánt házirendtől, ellenőrizd a munkaterületet, a kiválasztott hozzáférési módot, a mentett listát, a webhelycsoportok és a címkék GUID-azonosítóit, a fájltípus támogatottságát és a felhasználó Microsoft-engedélyeit. Hibaelhárítás céljából ne üríts ki listát, kivéve, ha szándékodban áll az ezzel járó hozzáférés-változás.

Ha egyes beállítások hiányoznak, vagy a hozzáférés nem a várakozások szerint működik, itt kérhetsz segítséget: Kapcsolatfelvétel az OpenAI ügyfélszolgálatával. A támogatási kérelemben ne adj meg adminisztrátori kulcsokat vagy Microsoft Graph-tokeneket.

A korlátozások ismertetése

• A webhelycsoportra vonatkozó szabály a teljes webhelycsoportra érvényes. Nem korlátozható vele a hozzáférés egy adott alwebhelyre, mappára vagy fájlra.

• A SharePoint-webhelyek korlátozásai nem korlátozzák automatikusan a OneDrive-hozzáférést.

• A bizalmassági címkék szerinti szűrés csak ott érvényesül, ahol a Microsoft Graph elérhetővé teszi a támogatott címke-metaadatokat, ideértve a támogatott Office-dokumentumokat, PDF- és MP4-fájlokat.

• A bizalmassági címkék szempontjából nem támogatott fájltípusokat – például a TXT- és CSV-fájlokat – a rendszer címke nélküliként kezeli. Ezek továbbra is elérhetők, ha a hozzáférés egyébként engedélyezett. Ez a fájltípus-korlátozás független a webhelyhozzáférés beállítására szolgáló CSV-feltöltéstől.

• A CSV-feltöltéssel és a nyilvános példasegédprogrammal nem állíthatók be bizalmassági címke szerinti kizárások. Ez a cikk nem ismertet tömeges címkekezelő API-t.

• A mentett házirend vagy a sikeres API-válasz nem helyettesíti a hozzáférés tesztelését a használni kívánt fiókkal.

A Python-alapú felügyeleti segédprogram használata

A teljes példakód és a parancsok naprakész változata az OpenAI Cookbookban található:

• Felügyeleti útmutató.

• Python-alapú felügyeleti szkript.

• Offline tesztfájl.

A Python 3.10-es vagy újabb verzióját használd. A segédprogram a Python standard könyvtárát használja. Futtatás előtt olvasd el az útmutatót, és próbafuttatásokkal ellenőrizd a módosításokat.

A segédprogram jelenlegi verziója környezeti változókból olvassa be a hitelesítő adatokat; kövesd az útmutató biztonságos adatbevitelre vonatkozó utasításait. Az engedélyezési lista kiürítéséhez kifejezett megerősítést kér. Egy elem eltávolítása e megerősítés nélkül is végrehajtható, ezért először próbafuttatással ellenőrizd az eltávolítást.

Az újrapróbálkozás működéséről és az opcionális idempotenciakulcsokról lásd: Házirendfrissítés biztonságos újrapróbálása. Csak akkor használj idempotenciakulcsokat, ha a munkaterület támogatja őket, és bizonytalan kimenetelű hiba után ellenőrizd az aktuális házirendet.

A segédprogram nem engedélyez munkaterületi funkciókat, és nem ellenőrzi a szabályok érvényesülését. Offline tesztjei szimulált Microsoft Graph- és ChatGPT Admin API-hívásokat használnak.

A több kérésből álló módosítások nem atomi műveletek. Ha több webhelycsoport eltávolítása közben hiba történik, a korábbi eltávolítások már sikeresen végbemehettek. Újrapróbálkozás előtt kérdezd le az aktuális házirendet.

GYIK

Hozzá kell adnom a titkosítást alkalmazó bizalmassági címkéket a kizárási listához?

Igen. Adj hozzá minden olyan Microsoft Purview bizalmassági címkét, amelynek fájljait ki szeretnéd zárni a ChatGPT-ből, beleértve a titkosítást alkalmazó címkéket is.

A titkosított fájlok tartalma alapértelmezés szerint ki van zárva. A támogatott titkosított fájlokhoz való hozzáféréshez a munkaterület rendszergazdájának engedélyeznie kell a speciális fájlhozzáférést (fetch_advanced), egy Microsoft Entra-rendszergazdának pedig hozzá kell járulnia a szükséges Microsoft-jogosultságok megadásához. A művelet engedélyezése önmagában, rendszergazdai hozzájárulás nélkül nem elegendő.

A ChatGPT a beállítás után is csak akkor tud titkosított tartalmat lekérni, ha a csatlakoztatott felhasználó jogosult a fájl elérésére és visszafejtésére. A kizárási listán szereplő címkékkel ellátott fájlok továbbra is ki vannak zárva. A speciális fájlhozzáférés engedélyezése vagy a rendszergazdai hozzájárulás megadása nem írja felül a címkealapú kizárásokat vagy a felhasználó Microsoft-jogosultságait.

A webhelyekre vonatkozó beállítások helyettesítik a Microsoft-jogosultságokat?

Nem. Az alkalmazás továbbra is az egyes felhasználók Microsoft-jogosultságait használja. Az OpenAI még azelőtt alkalmazza a beállított webhelyszűrést, hogy a válaszok eljutnának a felhasználóhoz és a modellhez.

Az üres engedélyezési lista minden webhelyet letilt?

Nem. Az üres engedélyezési lista nem jelent „mindenre kiterjedő tiltást”. Ha a tiltólista tartalmaz bejegyzéseket, az azon szereplő webhelycsoportok továbbra is le vannak tiltva. Ha egyik lista sem tartalmaz bejegyzéseket, a hozzáférést a felhasználók Microsoft-jogosultságai és az egyéb megadott beállítások határozzák meg.

Naplózza a rendszer az Admin API-n keresztül végzett módosításokat?

Az Admin API-n keresztül végzett szabályzatmódosításokat a munkaterület audit- és megfelelőségi naplói rögzítik.