Află cum să gestionezi accesul la site-urile SharePoint și să excluzi din ChatGPT fișierele acceptate care au anumite etichete de sensibilitate.

Prezentare generală

Administratorii spațiului de lucru pot folosi controalele SharePoint pentru a permite colecțiile de site-uri aprobate, a bloca anumite colecții și a exclude fișierele acceptate care au anumite etichete de sensibilitate Microsoft Purview.

O colecție de site-uri SharePoint, numită și SPSite, poate conține mai multe site-uri. O regulă pentru o colecție se aplică întregii colecții, cu respectarea permisiunilor Microsoft existente ale fiecărui utilizator. Aceasta nu oferă utilizatorului acces la conținut pe care nu îl poate accesa în Microsoft 365.

Restricțiile pentru site-uri se aplică operațiunilor acceptate de căutare, navigare, preluare de fișiere și citire/scriere în SharePoint. Accesul la OneDrive este gestionat separat.

Alege modul de acces care corespunde politicii tale:

Site-uri permise: dacă lista de colecții permise conține intrări, utilizatorii pot accesa prin aplicație doar colecțiile de site-uri din listă.
Site-uri blocate: utilizatorii pot accesa colecțiile de site-uri care nu se află pe lista de colecții blocate, în limitele permisiunilor lor Microsoft.

O singură listă poate conține intrări la un moment dat. O listă goală de colecții permise nu blochează toate site-urile. Când ambele liste sunt goale, restricțiile pentru site-urile SharePoint sunt eliminate; permisiunile Microsoft și celelalte controale configurate se aplică în continuare.

Disponibilitate

Controalele și API-ul de administrare al spațiului de lucru trebuie activate pentru spațiul tău de lucru. Controalele disponibile includ liste de colecții de site-uri permise sau blocate, importuri de site-uri din CSV și excluderi bazate pe etichete de sensibilitate.

Regulile se aplică unor colecții întregi de site-uri. Aceste controale pentru colecții de site-uri nu includ delimitarea exactă la nivel de site individual, folder sau fișier și nici aplicarea Microsoft Sites.Selected.

Înainte de a începe

Identifică colecțiile de site-uri pe care organizația ta dorește să le permită sau să le blocheze.
Obține GUID-ul fiecărei colecții. Un ID complet de site Microsoft Graph conține GUID-ul colecției ca valoare din mijloc. API-ul de administrare folosește GUID-uri de colecție; instrumentul de import CSV din interfață le poate extrage și din ID-urile de site Graph cu trei componente.
Activează permisiunile Microsoft necesare aplicației SharePoint atât în setările de permisiuni ChatGPT, cât și în Microsoft Entra, inclusiv Sites.Read.All și Files.Read.All. Aceste controale filtrează accesul pe partea OpenAI; nu înlocuiesc permisiunile delegate Microsoft.
Pentru excluderile bazate pe etichete de sensibilitate, solicită administratorului Microsoft 365 sau Purview GUID-ul imuabil al fiecărei etichete fără criptare.
Pentru administrarea prin API, obține UUID-ul spațiului de lucru, o cheie de administrare a spațiului de lucru ChatGPT și, dacă trebuie să identifici colecțiile corespunzătoare adreselor URL SharePoint, un token Microsoft Graph. Cele două date de autentificare au scopuri diferite.

Despre OpenAI Cookbook

OpenAI Cookbook este colecția publică de exemple de cod și ghiduri a OpenAI. Acest articol folosește ghidul de acces la site-uri SharePoint și scriptul de administrare Python din această colecție, ambele găzduite pe GitHub. Poți deschide aceste linkuri în browser pentru a citi fișierele. Pentru a rula scriptul, descarcă-l și urmează instrucțiunile de configurare și de executare a comenzilor din ghid.

În acest articol, „Cookbook” desemnează acel ghid SharePoint, iar „utilitarul din Cookbook” desemnează scriptul Python indicat prin link. Consultă aceste resurse pentru exemple de comenzi și gestionarea listelor de colecții permise prin API.

Configurează datele de autentificare pentru administrarea prin API

Notă: trebuie să fii administrator al spațiului de lucru pentru a putea crea chei de administrare. Află mai multe.

Creează o cheie de administrare a spațiului de lucru ChatGPT

Deschide consola de administrare ChatGPT și selectează spațiul de lucru dorit.
Accesează Date de autentificare și selectează Chei de administrare.
Creează o cheie cu permisiuni Restricționate și setează Aplicații la Scriere.
Păstrează cheia în siguranță. Această cheie autorizează citirea și modificarea politicii SharePoint pentru spațiul tău de lucru.

Permisiunea necesară este chatgpt.enterprise.apps.write. Reține că nici o cheie pentru Platforma API, nici un token Microsoft Graph nu pot înlocui o cheie de administrare a spațiului de lucru ChatGPT.

Pentru mai multe informații, consultă: Gestionarea cheilor de administrare în fila Date de autentificare. Pentru variabilele de mediu folosite de script pentru datele de autentificare și un exemplu de introducere în siguranță, consultă instrucțiunile privind datele de autentificare din Cookbook.

Obține un token Microsoft Graph

Folosește procesul de autentificare Microsoft aprobat de organizația ta. Pentru o căutare interactivă, dacă organizația ta permite utilizarea Graph Explorer:

Deschide Microsoft Graph Explorer și conectează-te cu un cont de serviciu din entitatea găzduită care conține site-urile SharePoint.
Selectează permisiunile necesare pentru citirea site-urilor, de obicei Sites.Read.All, folosind Modifică permisiunile sau Acordă consimțământul pentru permisiuni. Solicită administratorului Microsoft să aprobe accesul dacă organizația ta impune acest lucru.
Deschide fila Token de acces și copiază tokenul pentru a-l folosi cu Microsoft Graph.

Pentru instrucțiunile Microsoft, consultă Utilizarea Graph Explorer.

Tokenul Graph permite obținerea identificatorilor corespunzători adreselor URL SharePoint. Cheia de administrare ChatGPT permite citirea sau actualizarea politicii ChatGPT. Utilitarul din Cookbook are nevoie de tokenul Graph doar pentru comenzile care obțin identificatori pe baza adreselor URL; citirea sau golirea unei liste existente de colecții permise necesită doar cheia de administrare ChatGPT.

Nu include niciuna dintre datele de autentificare în sisteme de control al versiunilor, documente partajate, capturi de ecran sau jurnale.

Găsește GUID-ul unei colecții de site-uri

Folosește adresa URL a site-ului SharePoint

Deschide site-ul SharePoint după ce te-ai conectat la Microsoft cu un cont care are acces la acesta.
Adaugă /_api/site/id la sfârșitul adresei URL a site-ului. De exemplu, folosește https://contoso.sharepoint.com/sites/Finance/_api/site/id.
Copiază GUID-ul returnat în răspuns.

Notă: domeniile și identificatorii din exemplele acestui articol sunt fictivi.

Folosește Microsoft Graph

Microsoft Graph returnează un ID de site cu trei componente separate prin virgulă: numele gazdei, GUID-ul colecției de site-uri și GUID-ul site-ului. Folosește valoarea din mijloc pentru o regulă aplicabilă unei colecții de site-uri. Adrese URL diferite ale site-urilor pot corespunde aceluiași GUID de colecție.

Pentru exemple de căutare și identificatori, consultă Înțelegerea identificatorilor de site SharePoint. Pentru a identifica colecțiile corespunzătoare mai multor adrese URL fără a modifica politica ChatGPT, folosește instrucțiunile de inspectare din Cookbook și scriptul de administrare Python.

Pentru cerințele Microsoft privind căutarea, consultă Obținerea unui site SharePoint pe baza căii.

Gestionează colecțiile de site-uri permise și blocate

Folosește controalele spațiului de lucru

Deschide Controale de siguranță și securitate din aplicația SharePoint în spațiul tău de lucru.
În secțiunea Mod de acces, selectează Site-uri permise sau Site-uri blocate.
Adaugă colecțiile de site-uri în lista selectată. Poți folosi și încărcarea din CSV descrisă mai jos.
Verifică modificările și selectează Salvează.
Verifică politica salvată și testează configurația.

Site-urile adăugate prin API-ul de administrare apar în controalele spațiului de lucru. Site-urile adăugate în interfață sunt disponibile și prin API. Poți adăuga sau elimina intrări prin oricare dintre cele două metode; metoda prin care ai adăugat un site nu te obligă să o folosești și ulterior.

Comută între site-urile permise și cele blocate

O singură listă poate conține intrări la un moment dat. Înainte de a adăuga intrări în celălalt mod, golește lista existentă și salvează modificarea. Apoi selectează celălalt mod, adaugă colecțiile dorite și salvează din nou.

Golirea listei active modifică accesul imediat ce salvezi. Golirea listei de colecții permise elimină restricția de acces la site-uri impusă de aceasta; golirea listei de colecții blocate elimină blocările. Planifică tranziția împreună cu ceilalți administratori, deoarece în intervalul dintre golirea unei liste și salvarea celeilalte poate fi permis un acces pe care politica finală îl va restricționa.

Încarcă colecții de site-uri din CSV

Încărcarea din CSV acceptă doar colecții de site-uri. Pentru a exclude fișiere pe baza etichetelor de sensibilitate, adaugă GUID-urile etichetelor în secțiunea Etichete de sensibilitate fără criptare excluse.

Deschide Controale de siguranță și securitate și selectează opțiunea dorită pentru Mod de acces.
Pregătește un fișier CSV cu GUID-uri de colecții de site-uri sau cu ID-uri de site Microsoft Graph formate din trei componente. Folosește același format de identificator în întregul fișier.
Selectează Încarcă fișier CSV și alege fișierul.
Verifică rezultatul importului și lista selectată. Rezolvă erorile sau avertismentele asociate rândurilor înainte de a continua.
Selectează Salvează pentru a aplica modificările, apoi verifică lista salvată.

Cerințe și comportament la importul CSV:

Dimensiunea maximă a fișierului: 1 MB.
Anteturile sunt opționale.
Folosește câte un GUID de colecție pe rând sau ID-uri de site Graph formate din trei componente. Cele trei componente pot fi incluse între ghilimele într-un singur câmp sau separate în trei coloane.
ID-urile Graph cu trei componente sunt convertite în GUID-uri de colecție. Importarea unui ID cu trei componente nu creează o regulă pentru un site individual.
Importurile adaugă intrări în lista selectată și le păstrează pe cele existente. Colecțiile duplicate sunt deduplicate; numărul raportat la import indică doar colecțiile nou-adăugate.
Formatele mixte și rândurile formatate incorect sunt respinse. Încărcarea unui fișier care conține doar adrese URL de site-uri afișează un avertisment și nu adaugă site-uri. Obține mai întâi GUID-urile colecțiilor corespunzătoare adreselor URL.
Încărcarea modifică doar versiunea nesalvată a listei. Aceasta nu actualizează accesul în spațiul de lucru până când nu selectezi Salvează.
Încărcarea din CSV descrisă aici gestionează colecții de site-uri. Configurează separat excluderile bazate pe etichete de sensibilitate.

Dacă ai un fișier CSV cu adrese URL SharePoint, fluxul CSV al utilitarului din Cookbook poate identifica colecțiile corespunzătoare și gestiona o listă de colecții permise prin API. Datele sale de intrare site_url sau url folosesc un format și un flux diferite de încărcarea identificatorilor în interfață.

Înțelege limitele politicii și ale cererilor

Limita implicită a politicii este de 10.000 de colecții de site-uri. Limitele mai mari pentru politica spațiului de lucru, de până la 120.000 de colecții de site-uri, necesită activare de către OpenAI; contactează echipa OpenAI cu care colaborezi înainte de a planifica o implementare mai amplă.

Operațiile individuale de modificare prin API și scriptul actual din Cookbook acceptă până la 10.000 de GUID-uri de colecție per cerere. O limită mai mare pentru politica spațiului de lucru nu mărește această limită per cerere. Numără colecțiile de site-uri unice, nu adresele URL sursă: mai multe adrese URL pot indica aceeași colecție.

Folosește API-ul de administrare al spațiului de lucru

Folosește UUID-ul spațiului de lucru și cheia de administrare a spațiului de lucru ChatGPT cu https://api.chatgpt.com.

Pentru comenzi actualizate de gestionare a listei de colecții permise și exemple de cereri, consultă Cookbook:

Citirea listei existente de colecții permise.
Previzualizarea și adăugarea colecțiilor de site-uri. Adăugările păstrează colecțiile permise existente.
Eliminarea unei colecții de site-uri.
Golirea listei de colecții permise.

Verifică politica actuală înainte de a face modificări, apoi citește-o din nou și testează accesul rezultat. Eliminarea ultimei colecții permise sau golirea listei de colecții permise elimină restricția de acces la site-uri impusă de aceasta. Nu trimite o cerere de adăugare goală decât dacă dorești să elimini restricțiile impuse de lista de colecții permise.

Utilitarul public din Cookbook gestionează în prezent doar liste de colecții permise. Acesta nu gestionează liste de colecții blocate sau excluderi bazate pe etichete de sensibilitate. Pentru aceste sarcini, folosește controalele spațiului de lucru descrise mai sus.

Exclude fișiere pe baza etichetelor de sensibilitate

Găsește GUID-ul etichetei

Solicită administratorului Microsoft 365 sau Purview GUID-ul imuabil al etichetei dorite. Folosește GUID-ul, nu numele afișat al etichetei.

Un administrator poate obține lista etichetelor prin Microsoft Graph. Tokenul trebuie să aibă permisiunea aplicabilă: SensitivityLabel.Read sau SensitivityLabels.Read.All. Identifică ID-ul corespunzător numelui etichetei dorite și verifică setările de protecție ale acesteia.

Pentru cerințe și exemple, consultă Listarea etichetelor de sensibilitate și Proprietățile etichetelor de sensibilitate. Aceste permisiuni pentru etichete sunt distincte de permisiunea de citire a site-urilor folosită pentru obținerea identificatorilor pe baza adreselor URL SharePoint.

Adaugă excluderi bazate pe etichete

Deschide Controale de siguranță și securitate din aplicația SharePoint.
Introdu GUID-ul fiecărei etichete fără criptare în secțiunea Etichete de sensibilitate fără criptare excluse.
Salvează configurația și testează un fișier acceptat care are eticheta exclusă.

Fișierele cu etichete acceptate care corespund celor excluse sunt eliminate din rezultatele aplicației SharePoint. Fișierele cu etichete care aplică criptare sunt deja excluse în mod implicit.

Testează configurația

Folosește fișiere și conturi de test aprobate de organizația ta. Înainte de testare, confirmă că același cont Microsoft poate accesa fiecare fișier direct în SharePoint.

În modul Site-uri permise, cu o listă care conține intrări, verifică un fișier dintr-o colecție permisă și unul dintr-o colecție care nu se află pe listă. Doar colecția permisă ar trebui să fie accesibilă prin aplicație.
În modul Site-uri blocate, verifică un fișier dintr-o colecție blocată și unul dintr-o colecție neblocată. Colecția blocată ar trebui să fie inaccesibilă; accesul la cea neblocată rămâne supus permisiunilor Microsoft și celorlalte controale.
Verifică un fișier de test acceptat care are o etichetă de sensibilitate exclusă. Acesta nu ar trebui să apară în rezultatele aplicației.
După o modificare prin API, compară lista salvată în interfață cu politica returnată de API.
După încărcarea unui fișier CSV, salvează modificările și redeschide controalele pentru a confirma că au fost păstrate colecțiile dorite.

Dacă rezultatele nu corespund politicii dorite, verifică spațiul de lucru, modul de acces selectat, lista salvată, GUID-urile colecțiilor și ale etichetelor, tipul de fișier acceptat și permisiunile Microsoft ale utilizatorului. Nu goli o listă pentru a depana o problemă decât dacă dorești modificarea accesului care rezultă din această acțiune.

Pentru ajutor cu controalele lipsă sau cu accesul neașteptat, consultă: Contactarea echipei de asistență OpenAI. Nu include chei de administrare sau tokenuri Microsoft Graph în cererea de asistență.

Înțelege limitările

O regulă pentru o colecție se aplică întregii colecții de site-uri. Aceasta nu poate limita accesul la un anumit subsite, folder sau fișier.
Restricțiile pentru site-urile SharePoint nu restricționează automat accesul la OneDrive.
Filtrarea după etichete de sensibilitate se aplică doar acolo unde Microsoft Graph pune la dispoziție metadate de etichetare acceptate, inclusiv pentru documentele Office și fișierele PDF și MP4 acceptate.
Tipurile de fișiere care nu acceptă etichete de sensibilitate, precum TXT și CSV, sunt tratate ca neetichetate. Acestea rămân accesibile dacă accesul este permis de celelalte reguli. Această limitare privind tipul de fișier nu are legătură cu încărcarea unui fișier CSV pentru configurarea accesului la site-uri.
Încărcarea fișierelor CSV și utilitarul demonstrativ public nu configurează excluderile bazate pe etichete de sensibilitate. Acest articol nu documentează un API pentru gestionarea în masă a etichetelor.
Salvarea unei politici sau primirea unui răspuns API de succes nu înlocuiește testarea accesului cu contul vizat.

Folosește utilitarul de administrare Python

Codul demonstrativ complet și comenzile sunt menținute la zi în OpenAI Cookbook:

Folosește Python 3.10 sau o versiune ulterioară. Utilitarul folosește biblioteca standard Python. Citește ghidul înainte de a-l rula și folosește simulări pentru a verifica modificările.

Versiunea actuală a utilitarului citește datele de autentificare din variabilele de mediu; urmează instrucțiunile din ghid pentru introducerea lor în siguranță. Golirea unei liste de colecții permise necesită confirmare explicită. O eliminare se poate executa fără acea confirmare, așa că verific-o mai întâi printr-o simulare.

Pentru comportamentul la reîncercare și cheile opționale de idempotență, consultă Reîncercarea în siguranță a actualizării unei politici. Folosește chei de idempotență doar dacă spațiul de lucru le acceptă și verifică politica actuală după o eroare cu rezultat incert.

Utilitarul nu activează funcțiile spațiului de lucru și nu verifică aplicarea efectivă a regulilor. Testele sale offline folosesc apeluri simulate către Microsoft Graph și API-ul de administrare ChatGPT.

Modificările care implică mai multe cereri nu sunt atomice. Dacă eliminarea mai multor colecții eșuează pe parcurs, este posibil ca eliminările anterioare să fi fost deja efectuate. Citește politica actuală înainte de a reîncerca.

Întrebări frecvente

Controalele pentru site-uri înlocuiesc permisiunile Microsoft?

Nu. Aplicația folosește în continuare permisiunile Microsoft ale fiecărui utilizator. OpenAI aplică filtrarea configurată pentru site-uri înainte ca răspunsurile să fie puse la dispoziția utilizatorului și a modelului.

O listă goală de colecții permise blochează toate site-urile?

Nu. O listă goală de colecții permise nu înseamnă „blochează tot”. Dacă lista de colecții blocate conține intrări, acele colecții rămân blocate. Când niciuna dintre liste nu conține intrări, accesul este determinat de permisiunile Microsoft ale utilizatorilor și de celelalte controale configurate.

Sunt înregistrate modificările efectuate prin API-ul de administrare?

Modificările politicii efectuate prin API-ul de administrare sunt înregistrate în jurnalele de audit și conformitate ale spațiului de lucru.

Gestionarea accesului la site-urile SharePoint și a excluderilor bazate pe etichete de sensibilitate