Visió general
Els administradors de l'espai de treball poden utilitzar els controls de SharePoint per permetre col·leccions de llocs aprovades, bloquejar col·leccions de llocs seleccionades i excloure fitxers compatibles amb determinades etiquetes de confidencialitat de Microsoft Purview.
Una col·lecció de llocs de SharePoint, també anomenada SPSite, pot contenir diversos llocs. Una regla de col·lecció s'aplica a tota la col·lecció, subjecta als permisos de Microsoft que ja té cada usuari. No dona a un usuari accés a contingut al qual no pot accedir a Microsoft 365.
Les restriccions de llocs s'apliquen a les accions compatibles de cerca, navegació, recuperació de fitxers i lectura i escriptura de SharePoint. L'accés a OneDrive es gestiona per separat.
Tria el mode d'accés que s'ajusti a la teva política:
Llocs permesos: Si la llista de permesos no és buida, els usuaris només poden accedir a través de l'aplicació a les col·leccions de llocs que hi figuren.
Llocs bloquejats: Els usuaris poden accedir a les col·leccions de llocs que no figuren a la llista de bloquejats, d'acord amb els seus permisos de Microsoft.
Només una de les llistes pot contenir entrades alhora. Una llista de permesos buida no bloqueja tots els llocs. Quan totes dues llistes són buides, s'eliminen les restriccions dels llocs de SharePoint; els permisos de Microsoft i la resta de controls configurats es continuen aplicant.
Disponibilitat
Els controls i l'API d'administració de l'espai de treball han d'estar activats per al teu espai de treball. Els controls disponibles inclouen llistes de col·leccions de llocs permeses i bloquejades, importacions de llocs des de CSV i exclusions per etiquetes de confidencialitat.
Les regles s'apliquen a col·leccions de llocs senceres. Aquests controls de col·lecció de llocs no inclouen la delimitació a un lloc, una carpeta o un fitxer concrets ni l'aplicació de Microsoft Sites.Selected.
Abans de començar
Identifica les col·leccions de llocs que la teva organització vol permetre o bloquejar.
Obtén el GUID de cada col·lecció. Un ID de lloc complet de Microsoft Graph conté el GUID de la col·lecció com a valor central. L'API d'administració utilitza GUID de col·lecció; l'importador de CSV de la interfície també els pot extreure dels triples d'ID de lloc de Graph.
Activa els permisos de Microsoft que requereix l'aplicació de SharePoint tant a la configuració de permisos de ChatGPT com a Microsoft Entra, inclosos
Sites.Read.AlliFiles.Read.All. Aquests controls filtren l'accés a la banda d'OpenAI; no substitueixen els permisos delegats de Microsoft.Per a les exclusions per etiquetes de confidencialitat, demana a l'administrador de Microsoft 365 o Purview el GUID immutable de cada etiqueta sense xifratge.
Per a l'administració mitjançant l'API, obtén l'UUID de l'espai de treball, una clau d'administració de l'espai de treball de ChatGPT i un testimoni de Microsoft Graph si necessites resoldre URL de SharePoint. Les dues credencials tenen finalitats diferents.
Sobre l'OpenAI Cookbook
L'OpenAI Cookbook és la col·lecció pública de codi d'exemple i guies d'OpenAI. Aquest article utilitza la seva guia d'accés als llocs de SharePoint i el seu script d'administració en Python, tots dos allotjats a GitHub. Pots obrir aquests enllaços al navegador per llegir els fitxers. Per executar l'script, baixa'l i segueix les instruccions de configuració i d'ús de les ordres de la guia.
En aquest article, "Cookbook" fa referència a aquesta guia de SharePoint, i "utilitat del Cookbook", a l'script de Python enllaçat. Utilitza aquestes referències per consultar exemples d'ordres i gestionar llistes de permesos mitjançant l'API.
Configura les credencials per a l'administració mitjançant l'API
Nota: has de ser administrador de l'espai de treball per poder crear claus d'administració. Més informació.
Crea una clau d'administració de l'espai de treball de ChatGPT
Obre la consola d'administració de ChatGPT i selecciona l'espai de treball que vulguis.
Ves a Credencials i selecciona Claus d'administració.
Crea una clau amb permisos Restringits i estableix Aplicacions en Escriptura.
Desa la clau de manera segura. Aquesta clau autoritza a llegir i modificar la política de SharePoint del teu espai de treball.
El permís necessari és chatgpt.enterprise.apps.write. Tingues en compte que ni una clau de la Plataforma d'API ni un testimoni de Microsoft Graph poden substituir una clau d'administració de l'espai de treball de ChatGPT.
Per obtenir més informació, consulta: Gestió de les claus d'administració a la pestanya Credencials. Per consultar les variables d'entorn de credencials de l'script i un exemple d'introducció segura, consulta les instruccions sobre credencials del Cookbook.
Obtén un testimoni de Microsoft Graph
Utilitza el procés d'autenticació de Microsoft aprovat per la teva organització. Per fer una consulta interactiva, si la teva organització permet utilitzar Graph Explorer:
Obre Microsoft Graph Explorer i inicia la sessió amb un compte de feina de l'inquilí que conté els llocs de SharePoint.
Selecciona els permisos necessaris per llegir els llocs, normalment
Sites.Read.All, mitjançant Modifica els permisos o Dona el consentiment als permisos. Demana a l'administrador de Microsoft que aprovi l'accés si la teva organització ho requereix.Obre la pestanya Testimoni d'accés i copia el testimoni per utilitzar-lo amb Microsoft Graph.
Per consultar les instruccions de Microsoft, consulta Treballa amb Graph Explorer.
El testimoni de Graph permet resoldre els URL de SharePoint per obtenir-ne els identificadors. La clau d'administració de ChatGPT permet llegir o actualitzar la política de ChatGPT. La utilitat del Cookbook només necessita el testimoni de Graph per a les ordres que resolen URL; per llegir o buidar una llista de permesos existent, només cal la clau d'administració de ChatGPT.
No incloguis cap de les dues credencials en sistemes de control de versions, documents compartits, captures de pantalla ni registres.
Troba el GUID d'una col·lecció de llocs
Utilitza l'URL del lloc de SharePoint
Obre el lloc de SharePoint amb la sessió iniciada a Microsoft amb un compte que hi tingui accés.
Afegeix
/_api/site/idal final de l'URL del lloc. Per exemple, utilitzahttps://contoso.sharepoint.com/sites/Finance/_api/site/id.Copia el GUID que es retorna a la resposta.
Nota: els dominis i els identificadors d'exemple d'aquest article són valors de mostra.
Utilitza Microsoft Graph
Microsoft Graph retorna un ID de lloc amb tres components separats per comes: el nom d'amfitrió, el GUID de la col·lecció de llocs i el GUID del lloc. Utilitza el valor central per a una regla de col·lecció de llocs. Diferents URL de llocs poden correspondre al mateix GUID de col·lecció.
Per veure exemples de consultes i identificadors, consulta Comprèn els identificadors de lloc de SharePoint. Per resoldre diversos URL sense canviar la política de ChatGPT, utilitza les instruccions d'inspecció del Cookbook i l'script d'administració en Python.
Per conèixer els requisits de consulta de Microsoft, consulta Obtén un lloc de SharePoint a partir del camí.
Gestiona les col·leccions de llocs permeses i bloquejades
Utilitza els controls de l'espai de treball
Obre els Controls de protecció i seguretat de l'aplicació de SharePoint al teu espai de treball.
A Mode d'accés, selecciona Llocs permesos o Llocs bloquejats.
Afegeix les col·leccions de llocs a la llista seleccionada. També pots utilitzar la càrrega de CSV que es descriu més avall.
Revisa els canvis i selecciona Desa.
Comprova la política desada i prova la configuració.
Els llocs afegits a través de l'API d'administració apareixen als controls de l'espai de treball. Els llocs afegits a la interfície també estan disponibles a través de l'API. Pots afegir o eliminar entrades des de qualsevol de les dues vies; el mètode utilitzat per afegir un lloc no obliga a gestionar-lo sempre amb el mateix mètode.
Canvia entre llocs permesos i bloquejats
Només una de les llistes pot contenir entrades alhora. Abans d'afegir entrades en l'altre mode, buida la llista existent i desa el canvi. A continuació, selecciona l'altre mode, afegeix les col·leccions previstes i torna a desar.
Buidar la llista activa canvia l'accés immediatament en desar. Buidar una llista de permesos elimina la restricció de llocs que imposa; buidar una llista de bloquejats elimina els bloquejos. Planifica la transició amb els altres administradors, perquè durant l'interval entre buidar una llista i desar l'altra es pot permetre un accés que la política final restringirà.
Carrega col·leccions de llocs des d'un CSV
La càrrega de CSV només admet col·leccions de llocs. Per excloure fitxers segons l'etiqueta de confidencialitat, afegeix els GUID de les etiquetes a Etiquetes de confidencialitat excloses sense xifratge.
Obre els Controls de protecció i seguretat i selecciona el Mode d'accés que vulguis.
Prepara un CSV amb GUID de col·leccions de llocs o triples d'ID de lloc de Microsoft Graph. Utilitza un únic format d'identificador a tot el fitxer.
Selecciona Carrega un fitxer CSV i tria el fitxer.
Revisa el resultat de la importació i la llista seleccionada. Resol els errors o avisos de les files abans de continuar.
Selecciona Desa per aplicar els canvis i, a continuació, comprova la llista desada.
Requisits i comportament del CSV:
Mida màxima del fitxer: 1 MB.
Les capçaleres són opcionals.
Utilitza un GUID de col·lecció per fila o triples d'ID de lloc de Graph. Els triples es poden incloure entre cometes en un sol camp o repartir en tres columnes.
Els triples de Graph es converteixen en GUID de col·lecció. Importar un triple no crea una regla per a un lloc concret.
Les importacions afegeixen entrades a la llista seleccionada i conserven les que ja hi ha. S'eliminen els duplicats de les col·leccions; el recompte de la importació indica les col·leccions afegides de nou.
Es rebutgen els formats barrejats i les files mal formades. Si el fitxer carregat només conté URL de llocs, es mostra un avís i no s'afegeix cap lloc. Resol primer els URL per obtenir els GUID de les col·leccions.
La càrrega només modifica l'esborrany de la llista. No actualitza l'accés a l'espai de treball fins que selecciones Desa.
La càrrega de CSV que es descriu aquí gestiona col·leccions de llocs. Configura les exclusions per etiquetes de confidencialitat per separat.
Si tens un CSV amb URL de SharePoint, el flux de treball amb CSV de la utilitat del Cookbook permet resoldre'ls i gestionar una llista de permesos a través de l'API. L'entrada site_url o url d'aquesta utilitat utilitza un format i un flux de treball diferents dels de la càrrega d'identificadors de la interfície.
Coneix els límits de la política i de les sol·licituds
El límit predeterminat de la política és de 10.000 col·leccions de llocs. Els límits de política més alts per a l'espai de treball, fins a 120.000 col·leccions de llocs, requereixen l'activació per part d'OpenAI; contacta amb el teu equip d'OpenAI abans de planificar un desplegament més gran.
Les operacions individuals de modificació de l'API i l'script actual del Cookbook admeten fins a 10.000 GUID de col·lecció per sol·licitud. Un límit de política més alt per a l'espai de treball no augmenta aquest límit per sol·licitud. Compta les col·leccions de llocs úniques, no els URL d'origen: diversos URL poden fer referència a la mateixa col·lecció.
Utilitza l'API d'administració de l'espai de treball
Utilitza l'UUID de l'espai de treball i la clau d'administració de l'espai de treball de ChatGPT amb https://api.chatgpt.com.
Per consultar ordres i exemples de sol·licituds actualitzats per a les llistes de permesos, utilitza el Cookbook:
Previsualitza i afegeix col·leccions de llocs. Les addicions conserven les col·leccions permeses existents.
Revisa la política actual abans de fer canvis; després, torna-la a llegir i comprova l'accés resultant. Eliminar l'última col·lecció permesa o buidar la llista de permesos elimina aquesta restricció de llocs. No enviïs una sol·licitud d'addició buida tret que vulguis eliminar les restriccions de la llista de permesos.
La utilitat pública del Cookbook actualment gestiona només llistes de permesos. No gestiona llistes de bloquejats ni exclusions per etiquetes de confidencialitat. Per a aquestes tasques, utilitza els controls de l'espai de treball descrits més amunt.
Exclou fitxers amb etiquetes de confidencialitat
Troba el GUID de l'etiqueta
Demana a l'administrador de Microsoft 365 o Purview el GUID immutable de l'etiqueta que vulguis. Utilitza el GUID, no el nom que es mostra.
Un administrador pot obtenir la llista d'etiquetes a través de Microsoft Graph. El testimoni necessita el permís SensitivityLabel.Read o SensitivityLabels.Read.All, segons correspongui. Identifica l'ID que correspon al nom de l'etiqueta que vulguis i comprova'n la configuració de protecció.
Per consultar els requisits i exemples, consulta Obtén la llista d'etiquetes de confidencialitat i Propietats de les etiquetes de confidencialitat. Aquests permisos d'etiquetes són independents del permís de lectura de llocs que s'utilitza per resoldre els URL de SharePoint.
Afegeix exclusions d'etiquetes
Obre els Controls de protecció i seguretat de l'aplicació de SharePoint.
Introdueix el GUID de cada etiqueta sense xifratge a Etiquetes de confidencialitat excloses sense xifratge.
Desa la configuració i fes una prova amb un fitxer compatible que tingui l'etiqueta exclosa.
Els fitxers amb etiquetes compatibles que coincideixin amb les excloses no apareixen als resultats de l'aplicació de SharePoint. Els fitxers amb etiquetes que apliquen xifratge ja s'exclouen per defecte.
Prova la configuració
Utilitza fitxers i comptes de prova aprovats per la teva organització. Abans de fer les proves, confirma que el mateix compte de Microsoft pot accedir a cada fitxer directament a SharePoint.
En el mode Llocs permesos, amb una llista que no estigui buida, comprova un fitxer d'una col·lecció permesa i un altre d'una col·lecció que no sigui a la llista. Només la col·lecció permesa hauria de ser accessible a través de l'aplicació.
En el mode Llocs bloquejats, comprova un fitxer d'una col·lecció bloquejada i un altre d'una col·lecció no bloquejada. La col·lecció bloquejada no hauria de ser accessible; la col·lecció no bloquejada continua subjecta als permisos de Microsoft i a altres controls.
Comprova un fitxer de prova compatible que tingui una etiqueta de confidencialitat exclosa. No hauria d'aparèixer als resultats de l'aplicació.
Després d'un canvi a través de l'API, compara la llista desada a la interfície amb la política que retorna l'API.
Després de carregar un CSV, desa els canvis i torna a obrir els controls per confirmar que s'han conservat les col·leccions previstes.
Si els resultats no coincideixen amb la política prevista, comprova l'espai de treball, el mode d'accés seleccionat, la llista desada, els GUID de les col·leccions i les etiquetes, la compatibilitat del tipus de fitxer i els permisos de Microsoft de l'usuari. No buidis una llista per resoldre un problema tret que vulguis aplicar el canvi d'accés que se'n deriva.
Si necessites ajuda perquè falten controls o l'accés no és l'esperat, consulta: Contactar amb el servei d'assistència d'OpenAI. No incloguis claus d'administració ni testimonis de Microsoft Graph a la sol·licitud d'assistència.
Coneix les limitacions
Una regla de col·lecció abasta tota la col·lecció de llocs. No pot limitar l'accés a un sublloc, una carpeta o un fitxer concrets.
Les restriccions dels llocs de SharePoint no restringeixen automàticament l'accés a OneDrive.
El filtratge per etiquetes de confidencialitat només s'aplica quan Microsoft Graph proporciona metadades d'etiqueta compatibles, inclosos els documents d'Office i els fitxers PDF i MP4 compatibles.
Els tipus de fitxer no compatibles amb les etiquetes de confidencialitat, com ara TXT i CSV, es tracten com a fitxers sense etiqueta. Continuen sent accessibles si la resta de controls ho permeten. Aquesta limitació del tipus de fitxer és independent de la càrrega d'un CSV per configurar l'accés als llocs.
Ni la càrrega de CSV ni la utilitat pública d'exemple configuren exclusions per etiquetes de confidencialitat. Aquest article no documenta cap API de gestió massiva d'etiquetes.
Una política desada o una resposta correcta de l'API no substitueixen la comprovació de l'accés amb el compte previst.
Utilitza la utilitat d'administració en Python
El codi d'exemple complet i les ordres es mantenen actualitzats a l'OpenAI Cookbook:
Utilitza Python 3.10 o una versió posterior. La utilitat fa servir la biblioteca estàndard de Python. Llegeix la guia abans d'executar-la i fes simulacions per revisar els canvis.
La utilitat actual llegeix les credencials de les variables d'entorn; segueix les instruccions de la guia per introduir-les de manera segura. Cal una confirmació explícita per buidar una llista de permesos. Una eliminació es pot executar sense aquesta confirmació; per tant, revisa-la primer amb una simulació.
Per conèixer el comportament dels reintents i les claus d'idempotència opcionals, consulta Reintenta una actualització de la política de manera segura. Utilitza claus d'idempotència només si l'espai de treball les admet i inspecciona la política actual després d'un error de resultat ambigu.
La utilitat no activa funcions de l'espai de treball ni comprova que s'apliqui la política. Les proves sense connexió utilitzen crides simulades a Microsoft Graph i a l'API d'administració de ChatGPT.
Els canvis que impliquen diverses sol·licituds no són atòmics. Si l'eliminació de diverses col·leccions falla a mig procés, és possible que les eliminacions anteriors ja s'hagin completat. Llegeix la política actual abans de tornar-ho a provar.
Preguntes freqüents
Els controls de llocs substitueixen els permisos de Microsoft?
No. L'aplicació continua utilitzant els permisos de Microsoft de cada usuari. OpenAI aplica el filtratge de llocs configurat abans que les respostes es mostrin a l'usuari i al model.
Una llista de permesos buida bloqueja tots els llocs?
No. Una llista de permesos buida no vol dir "bloqueja-ho tot". Si una llista de bloquejats conté entrades, aquestes col·leccions continuen bloquejades. Quan cap de les dues llistes conté entrades, els permisos de Microsoft dels usuaris i la resta de controls configurats determinen l'accés.
Es registren els canvis de l'API d'administració?
Els canvis de política fets a través de l'API d'administració queden recollits als registres d'auditoria i compliment de l'espai de treball.