Á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 webhelycsoport-GUID-okat használ; a felület CSV-importálója ezeket a háromrészes Graph-webhelyazonosítókból is ki tudja nyerni.

• Engedélyezd a SharePoint alkalmazás számára szükséges Microsoft-engedélyeket a ChatGPT engedélybeállításaiban és a Microsoft Entrában is, beleértve a Sites.Read.All és a Files.Read.All engedélyt. Ezek a beállítások az OpenAI oldalán szűrik a hozzáférést; nem helyettesítik a Microsoft delegált engedélyeit.

• A bizalmassági címke szerinti kizárásokhoz kérd el a Microsoft 365- vagy Purview-rendszergazdádtól az egyes, titkosítást nem alkalmazó címkék megváltoztathatatlan GUID-azonosítóját.

• Az API-alapú felügyelethez szerezd be a munkaterületed UUID-azonosítóját és egy ChatGPT-munkaterületi adminisztrátori kulcsot, valamint egy Microsoft Graph-tokent, ha SharePoint-URL-ekhez is kell azonosítókat lekérdezned. A két hitelesítő adat eltérő célokat 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. A munkaterületeden nyisd meg a SharePoint alkalmazás Biztonsági és védelmi beállítások részét.

2. A Hozzáférési mód résznél 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. Tekintsd át a módosításokat, és válaszd a Mentés lehetőséget.

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

Az Admin API-n keresztül hozzáadott webhelyek megjelennek a munkaterület beállításaiban. A 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, majd ments újra.


Az aktív lista kiürítése a mentéskor azonnal módosítja a hozzáférést. Az engedélyezési lista kiürítése megszünteti a webhelyekre vonatkozó korlátozását; a tiltólista kiürítése feloldja a rajta szereplő tiltásokat. Tervezd meg az átállást a többi adminisztrátorral, 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 lehetséges lehet, amelyet a végleges házirend korlátozni fog.

Webhelycsoportok feltöltése CSV-ből

A CSV-feltöltés csak webhelycsoportokat támogat. A fájlok bizalmassági címke szerinti kizárásához add meg a címkék GUID-azonosítóit a Kizárt, titkosítás nélküli bizalmassági címkék résznél.

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

2. Készíts egy CSV-fájlt a webhelycsoportok GUID-azonosítóiból vagy a Microsoft Graph háromrészes webhelyazonosítóiból. A teljes fájlban 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. Tekintsd át az importálás eredményét és a kiválasztott listát. A folytatás előtt javítsd ki a sorhibákat, és kezeld a figyelmeztetéseket.

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 követelményei és működése:

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

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

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

• A rendszer a háromrészes Graph-azonosítókat webhelycsoport-GUID-okká alakítja. Egy háromrészes azonosító importálása nem hoz létre kizárólag az adott webhelyre vonatkozó szabályt.

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

• A rendszer elutasítja a vegyes formátumokat és a hibásan formázott sorokat. Ha a feltöltés csak webhely-URL-eket tartalmaz, figyelmeztetés jelenik meg, és nem kerülnek webhelyek a listára. Először kérdezd le az URL-ekhez tartozó webhelycsoport-GUID-okat.

• A feltöltés csak a lista piszkozatát módosítja. A munkaterület hozzáférési szabályai csak a Mentés kiválasztása után frissülnek.

• 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 lekérdezheted a hozzájuk tartozó azonosítókat, és az API-n keresztül kezelheted az engedélyezési listát. A site_url vagy url bemenete más formátumot és munkafolyamatot használ, mint az azonosítók feltöltése a felületen.

A házirend- és kéréskorlátok ismertetése

A házirend alapértelmezett korlátja 10 000 webhelycsoport. A munkaterület ennél magasabb, legfeljebb 120 000 webhelycsoportra szóló házirendkorlátját az OpenAI-nak kell engedélyeznie; nagyobb bevezetés tervezése előtt vedd fel a kapcsolatot az OpenAI-kapcsolattartóiddal.

Az egyes API-módosítási műveletek és a jelenlegi Cookbook-szkript kérésenként legfeljebb 10 000 webhelycsoport-GUID-ot fogadnak el. A munkaterület magasabb házirendkorlátja nem emeli 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 címen használd a munkaterületed UUID-azonosítóját és a ChatGPT-munkaterület adminisztrátori kulcsát.

Az engedélyezési lista kezeléséhez szükséges naprakész parancsokat és kérési példákat a Cookbookban találod:

• A meglévő engedélyezési lista lekérdezé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.

Módosítás előtt tekintsd át az aktuális házirendet, majd kérdezd 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 az adott webhelykorlátozást. Ne küldj üres hozzáadási kérést, kivéve, ha meg szeretnéd szü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ímke szerinti kizárások hozzáadása

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

2. Add meg az egyes, titkosítást nem alkalmazó címkék GUID-azonosítóját a Kizárt, titkosítás nélküli bizalmassági címkék résznél.

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

A megfelelő, támogatott címkékkel ellátott fájlok nem jelennek meg a SharePoint alkalmazás találatai között. A titkosítást alkalmazó címkékkel ellátott fájlok már alapértelmezés szerint ki vannak zárva.

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.

Gyakori kérdések

A webhelybeállítások helyettesítik a Microsoft-engedélyeket?

Nem. Az alkalmazás továbbra is az egyes felhasználók Microsoft-engedélyeit 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 letiltja az összes webhelyet?

Nem. Az üres engedélyezési lista nem jelent „mindent tiltó” beállítást. Ha a tiltólista tartalmaz bejegyzéseket, azok a webhelycsoportok továbbra is letiltva maradnak. Ha egyik lista sem tartalmaz bejegyzéseket, a hozzáférést a felhasználók Microsoft-engedélyei és az egyéb konfigurált szabályozások határozzák meg.

Naplózza a rendszer az Admin API-n keresztüli módosításokat?

Az Admin API-n keresztüli házirend-módosításokat a munkaterület audit- és megfelelőségi naplózása rögzíti.