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 d'usuari també els pot extreure dels triples d'ID de lloc de Graph.
Habilita 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 d'etiquetes de confidencialitat, demana a l'administrador de Microsoft 365 o de Purview el GUID immutable de cada etiqueta que vulguis excloure, incloses les que apliquen xifratge.
Per a l'administració mitjançant l'API, obtén l'UUID del teu espai de treball, una clau d'administració de l'espai de treball de ChatGPT i un testimoni de Microsoft Graph si necessites obtenir els identificadors corresponents als 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 seguretat i protecció 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 a continuació.
Revisa els canvis i selecciona Desa.
Comprova la política desada i prova la configuració.
Els llocs afegits mitjançant l'API d'administració apareixen als controls de l'espai de treball. Els llocs afegits a la interfície d'usuari també estan disponibles a través de l'API. Pots afegir o eliminar entrades des de qualsevol de les dues interfícies; el mètode utilitzat per afegir un lloc no t'obliga a continuar utilitzant-lo.
Canvia entre llocs permesos i bloquejats
Només una de les llistes pot contenir entrades alhora. Abans d'afegir entrades a l'altre mode, buida la llista existent i desa el canvi. Després, selecciona l'altre mode, afegeix-hi les col·leccions que vulguis i torna a desar.
Buidar la llista activa modifica l'accés immediatament en desar el canvi. Buidar una llista de llocs permesos elimina la restricció d'accés als llocs d'aquella llista; buidar una llista de llocs bloquejats elimina els bloquejos. Planifica la transició amb altres administradors, perquè l'interval entre buidar una llista i desar l'altra pot permetre accessos 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 la llista d'exclusió d'etiquetes de confidencialitat.
Obre els Controls de seguretat i protecció 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 el mateix 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 advertiments de les files abans de continuar.
Selecciona Desa per aplicar els canvis i, després, comprova la llista desada.
Requisits i funcionament 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 dividir 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 existents. S'eliminen les col·leccions duplicades; el recompte de la importació indica les col·leccions afegides de nou.
Es rebutgen els formats barrejats i les files amb un format incorrecte. Si el fitxer carregat només conté URL de llocs, es mostra un advertiment i no s'afegeix cap lloc. Primer, obtén els GUID de col·lecció corresponents als URL.
La càrrega només modifica l'esborrany de la llista. No actualitza l'accés de 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 d'etiquetes de confidencialitat per separat.
Si tens un CSV amb URL de SharePoint, el flux de treball de CSV de la utilitat del Cookbook permet obtenir-ne els identificadors corresponents i gestionar una llista de llocs permesos a través de l'API. La seva entrada site_url o url utilitza un format i un flux de treball diferents dels de la càrrega d'identificadors de la interfície d'usuari.
Entén els límits de les polítiques i les sol·licituds
El límit predeterminat de la política és de 10.000 col·leccions de llocs. Els límits de la política de l'espai de treball superiors, de fins a 120.000 col·leccions de llocs, requereixen l'habilitació 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 superior de la política de 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 del teu espai de treball i una clau d'administració de l'espai de treball de ChatGPT amb https://api.chatgpt.com.
Per consultar ordres actualitzades per gestionar la llista de llocs permesos i exemples de sol·licituds, 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 a consultar-la i prova l'accés resultant. Eliminar l'última col·lecció permesa o buidar la llista de llocs permesos elimina aquesta restricció d'accés als llocs. No enviïs una sol·licitud d'addició buida tret que vulguis eliminar les restriccions de la llista de llocs permesos.
Actualment, la utilitat pública del Cookbook gestiona només llistes de llocs permesos. No gestiona llistes de llocs bloquejats ni exclusions d'etiquetes de confidencialitat. Utilitza els controls de l'espai de treball descrits més amunt per a aquestes tasques.
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 seguretat i protecció de l'aplicació de SharePoint.
Introdueix el GUID de cada etiqueta que vulguis excloure, incloses les que apliquen xifratge, a la llista d'exclusió d'etiquetes de confidencialitat.
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 de la llista s'exclouen dels resultats de l'aplicació de SharePoint. El contingut dels fitxers xifrats s'exclou per defecte. L'accés als fitxers xifrats compatibles requereix tant l'accés avançat a fitxers (fetch_advanced) com el consentiment d'un administrador de Microsoft Entra, tal com es descriu a les preguntes freqüents següents. Les exclusions d'etiquetes i els permisos de Microsoft de l'usuari connectat es continuen aplicant.
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
He d'afegir les etiquetes de confidencialitat que apliquen xifratge a la llista d'exclusió?
Sí. Afegeix totes les etiquetes de confidencialitat de Microsoft Purview associades als fitxers que vulguis que ChatGPT exclogui, incloses les que apliquen xifratge.
El contingut dels fitxers xifrats s'exclou per defecte. Per habilitar l'accés als fitxers xifrats compatibles, un administrador de l'espai de treball ha d'habilitar l'accés avançat a fitxers (fetch_advanced) i un administrador de Microsoft Entra ha de donar el consentiment per als permisos de Microsoft necessaris. No n'hi ha prou amb habilitar l'acció sense completar el procés de consentiment de l'administrador.
Fins i tot després de la configuració, ChatGPT només pot recuperar contingut xifrat quan l'usuari connectat té permís per accedir al fitxer i desxifrar-lo. Els fitxers amb etiquetes de la llista d'exclusió continuen exclosos. Habilitar l'accés avançat a fitxers o donar el consentiment de l'administrador no anul·la les exclusions d'etiquetes ni els permisos de Microsoft de l'usuari.
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 de mostrar les respostes a l'usuari i al model.
Una llista de llocs permesos buida bloqueja tots els llocs?
No. Una llista de llocs permesos buida no vol dir "bloqueja-ho tot". Si una llista de llocs bloquejats conté entrades, aquestes col·leccions continuen bloquejades. Quan cap de les dues llistes conté entrades, els permisos de Microsoft dels usuaris i els altres controls configurats determinen l'accés.
Es registren els canvis de l'API d'administració?
Els canvis de política fets mitjançant l'API d'administració queden recollits als registres d'auditoria i compliment normatiu de l'espai de treball.