Научете како да управувате со пристапот до сајтовите на SharePoint и да исклучувате поддржани датотеки со избрани ознаки за чувствителност во ChatGPT.

Преглед

Администраторите на работниот простор може да ги користат контролите на SharePoint за да дозволат одобрени збирки на сајтови, да блокираат избрани збирки на сајтови и да исклучат поддржани датотеки со избрани ознаки за чувствителност од Microsoft Purview.

Збирката на сајтови во SharePoint, наречена и SPSite, може да содржи повеќе сајтови. Правилото за збирка важи за целата збирка, во рамките на постојните дозволи на секој корисник во Microsoft. Тоа не му дава на корисникот пристап до содржини до кои нема пристап во Microsoft 365.

Ограничувањата за сајтови се применуваат на поддржаните дејства во SharePoint за пребарување, прелистување, преземање датотеки и читање/запишување. Со пристапот до OneDrive се управува одделно.

Изберете го режимот на пристап што одговара на вашата политика:

Дозволени сајтови: Ако листата на дозволени сајтови не е празна, корисниците преку апликацијата може да пристапат само до наведените збирки на сајтови.
Блокирани сајтови: Корисниците може да пристапат до збирките на сајтови што не се на листата на блокирани сајтови, во рамките на нивните дозволи во Microsoft.

Само една листа може да содржи записи во даден момент. Празната листа на дозволени сајтови не ги блокира сите сајтови. Кога двете листи се празни, ограничувањата за сајтовите на SharePoint се отстрануваат; дозволите на Microsoft и другите конфигурирани контроли и понатаму важат.

Достапност

Контролите и администраторскиот API на работниот простор мора да бидат овозможени за вашиот работен простор. Достапните контроли вклучуваат листи на дозволени збирки на сајтови, листи на блокирани збирки на сајтови, увоз на сајтови од CSV и исклучувања според ознаки за чувствителност.

Правилата важат за цели збирки на сајтови. Овие контроли за збирки на сајтови не вклучуваат ограничување на опфатот на конкретен поединечен сајт, папка или датотека, ниту спроведување на Microsoft Sites.Selected.

Пред да започнете

Одредете кои збирки на сајтови вашата организација сака да ги дозволи или блокира.
Прибавете го GUID на секоја збирка. Целосниот ID на сајт од Microsoft Graph го содржи GUID на збирката како средна вредност. Администраторскиот API користи GUID на збирки; алатката за увоз на CSV во корисничкиот интерфејс може да ги извлече и од тројките од компоненти на ID на сајтови од Graph.
Овозможете ги потребните дозволи на Microsoft за апликацијата SharePoint и во поставките за дозволи на ChatGPT и во Microsoft Entra, вклучувајќи ги Sites.Read.All и Files.Read.All. Овие контроли го филтрираат пристапот на страната на OpenAI; тие не ги заменуваат делегираните дозволи на Microsoft.
За исклучувања според ознаки за чувствителност, побарајте го непроменливиот GUID на секоја ознака без шифрирање од вашиот администратор за Microsoft 365 или Purview.
За администрирање преку API, прибавете ги UUID на работниот простор, администраторски клуч за работниот простор на ChatGPT и токен за Microsoft Graph ако треба да одредувате идентификатори од URL-адреси на SharePoint. Двата акредитива имаат различни намени.

За OpenAI Cookbook

OpenAI Cookbook е јавна збирка на OpenAI со примери на код и водичи. Оваа статија ги користи неговиот водич за пристап до сајтови на SharePoint и скриптата за администрирање во Python, кои се хостирани на GitHub. Може да ги отворите овие врски во прелистувачот за да ги прочитате датотеките. За да ја извршите скриптата, преземете ја и следете ги упатствата за поставување и команди во водичот.

Во оваа статија, „Cookbook“ се однесува на тој водич за SharePoint, а „алатка од Cookbook“ се однесува на поврзаната скрипта во Python. Користете ги овие извори за примери на команди и управување со листата на дозволени сајтови преку API.

Поставете акредитиви за администрирање преку API

Напомена: мора да сте администратор на работниот простор за да може да создавате администраторски клучеви. Прочитајте повеќе.

Создајте администраторски клуч за работниот простор на ChatGPT

Отворете ја администраторската конзола на ChatGPT и изберете го саканиот работен простор.
Одете во Акредитиви и изберете Администраторски клучеви.
Создајте клуч со Ограничени дозволи и поставете ја опцијата Апликации на Запишување.
Чувајте го клучот на безбедно место. Овој клуч овозможува читање и менување на политиката за SharePoint за вашиот работен простор.

Потребната дозвола е chatgpt.enterprise.apps.write. Имајте предвид дека ниту клуч за API платформата на OpenAI ниту токен за Microsoft Graph не може да го замени администраторскиот клуч за работниот простор на ChatGPT.

За повеќе информации, видете: Управување со администраторски клучеви во картичката Акредитиви. За променливите на околината за акредитивите на скриптата и пример за безбедно внесување, видете ги упатствата за акредитиви во Cookbook.

Прибавете токен за Microsoft Graph

Користете ја постапката за автентикација на Microsoft одобрена од вашата организација. За интерактивно пребарување, ако вашата организација го дозволува Graph Explorer:

Отворете Microsoft Graph Explorer и најавете се со деловна сметка во закупецот што ги содржи сајтовите на SharePoint.
Изберете ги дозволите потребни за читање на сајтовите, обично Sites.Read.All, преку Измени дозволи или Дај согласност за дозволи. Побарајте од вашиот администратор за Microsoft да го одобри пристапот ако вашата организација го бара тоа.
Отворете ја картичката Токен за пристап и копирајте го токенот за користење со Microsoft Graph.

За упатствата на Microsoft, видете Работа со Graph Explorer.

Токенот за Graph служи за одредување идентификатори од URL-адреси на SharePoint. Администраторскиот клуч за ChatGPT служи за читање или ажурирање на политиката на ChatGPT. На алатката од Cookbook ѝ треба токенот за Graph само за команди што одредуваат идентификатори од URL-адреси; за читање или празнење на постојна листа на дозволени сајтови е потребен само администраторскиот клуч за ChatGPT.

Не внесувајте ниту еден од двата акредитива во системи за контрола на верзии, споделени документи, слики од екранот или дневници.

Најдете го GUID на збирка на сајтови

Користете ја URL-адресата на сајтот на SharePoint

Отворете го сајтот на SharePoint додека сте најавени на Microsoft со сметка што има пристап до него.
Додајте /_api/site/id на крајот од URL-адресата на сајтот. На пример, користете https://contoso.sharepoint.com/sites/Finance/_api/site/id.
Копирајте го GUID што е вратен во одговорот.

Напомена: домените и идентификаторите во примерите во оваа статија се само илустративни.

Користете Microsoft Graph

Microsoft Graph враќа ID на сајтот со три компоненти одделени со запирки: името на хостот, GUID на збирката на сајтови и GUID на сајтот. Користете ја средната вредност за правило за збирка на сајтови. Различни URL-адреси на сајтови може да упатуваат на ист GUID на збирка.

За примери за пребарување и идентификатори, видете Разбирање на идентификаторите на сајтовите на SharePoint. За да ги одредите идентификаторите за повеќе URL-адреси без да ја менувате политиката на ChatGPT, користете ги упатствата за проверка во Cookbook и скриптата за администрирање во Python.

За барањата на Microsoft за пребарување, видете Добивање сајт на SharePoint според патека.

Управувајте со дозволените и блокираните збирки на сајтови

Користете ги контролите на работниот простор

Отворете ги Контроли за безбедност и заштита на апликацијата SharePoint во вашиот работен простор.
Во Режим на пристап, изберете Дозволени сајтови или Блокирани сајтови.
Додајте ги збирките на сајтови во избраната листа. Може да ја користите и опцијата за поставување CSV опишана подолу.
Прегледајте ги промените и изберете Зачувај.
Проверете ја зачуваната политика и тестирајте ја конфигурацијата.

Сајтовите додадени преку администраторскиот API се појавуваат во контролите на работниот простор. Сајтовите додадени во корисничкиот интерфејс се достапни и преку API. Може да додавате или отстранувате записи преку кој било од двата интерфејса; начинот на додавање сајт не ве обврзува да го користите истиот начин и понатаму.

Префрлете се меѓу дозволени и блокирани сајтови

Само една листа може да содржи записи во даден момент. Пред да додадете записи во другиот режим, испразнете ја постојната листа и зачувајте ја таа промена. Потоа изберете го другиот режим, додајте ги предвидените збирки и зачувајте повторно.

Празнењето на активната листа го менува пристапот веднаш штом ќе ја зачувате промената. Празнењето на листата на дозволени сајтови го отстранува нејзиното ограничување на пристапот до сајтови; празнењето на листата на блокирани сајтови ги отстранува нејзините блокади. Испланирајте го преминот со другите администратори, бидејќи во периодот меѓу празнењето на едната листа и зачувувањето на другата може да биде дозволен пристап што конечната политика ќе го ограничи.

Поставете збирки на сајтови од CSV

Поставувањето CSV поддржува само збирки на сајтови. За да исклучите датотеки според ознака за чувствителност, додајте ги GUID на ознаките во Исклучени ознаки за чувствителност без шифрирање.

Отворете ги Контроли за безбедност и заштита и изберете го саканиот Режим на пристап.
Подгответе CSV со GUID на збирки на сајтови или со тројки од компоненти на ID на сајтови од Microsoft Graph. Користете ист формат на идентификатори во целата датотека.
Изберете Постави CSV-датотека и изберете ја датотеката.
Прегледајте ги резултатот од увозот и избраната листа. Разрешете ги сите грешки или предупредувања за редовите пред да продолжите.
Изберете Зачувај за да ги примените промените, а потоа проверете ја зачуваната листа.

Барања и однесување при увоз на CSV:

Максимална големина на датотеката: 1 MB.
Заглавијата не се задолжителни.
Користете по еден GUID на збирка во секој ред или тројки од компоненти на ID на сајтови од Graph. Тројките може да бидат во наводници во едно поле или поделени во три колони.
Тројките од Graph се претвораат во GUID на збирки. Со увоз на тројка не се создава правило за конкретен поединечен сајт.
При увоз се додаваат записи во избраната листа, а постојните се задржуваат. Дупликатите на збирки се отстрануваат; бројот прикажан по увозот се однесува на новододадените збирки.
Мешаните формати и неправилно форматираните редови се одбиваат. Ако поставената датотека содржи само URL-адреси на сајтови, се прикажува предупредување и не се додаваат сајтови. Прво одредете ги GUID на збирките од URL-адресите.
Поставувањето ја менува само нацрт-листата. Пристапот во работниот простор не се ажурира додека не изберете Зачувај.
Поставувањето CSV опишано овде служи за управување со збирки на сајтови. Конфигурирајте ги исклучувањата според ознаки за чувствителност одделно.

Ако имате CSV со URL-адреси на SharePoint, постапката за CSV во алатката од Cookbook може да ги одреди нивните идентификатори и да управува со листата на дозволени сајтови преку API. Нејзиниот влез site_url или url користи поинаков формат и постапка од поставувањето идентификатори во корисничкиот интерфејс.

Запознајте се со ограничувањата на политиката и барањата

Стандардното ограничување на политиката е 10.000 збирки на сајтови. Повисоки ограничувања на политиката за работниот простор, до 120.000 збирки на сајтови, мора да овозможи OpenAI; контактирајте со вашиот тим од OpenAI пред да планирате имплементација од поголем обем.

Поединечните операции за промена преку API и тековната скрипта од Cookbook прифаќаат до 10.000 GUID на збирки по барање. Повисокото ограничување на политиката за работниот простор не го зголемува ова ограничување по барање. Бројте ги единствените збирки на сајтови, а не изворните URL-адреси: повеќе URL-адреси може да се однесуваат на истата збирка.

Користете го администраторскиот API на работниот простор

Користете ги UUID на работниот простор и администраторскиот клуч за работниот простор на ChatGPT со https://api.chatgpt.com.

За ажурирани команди за листата на дозволени сајтови и примери на барања, користете го Cookbook:

Прочитајте ја постојната листа на дозволени сајтови.
Прегледајте и додајте збирки на сајтови. Со додавањето се задржуваат постојните дозволени збирки.
Отстранете збирка на сајтови.
Испразнете ја листата на дозволени сајтови.

Прегледајте ја тековната политика пред да правите промени, а потоа прочитајте ја повторно и тестирајте го пристапот што произлегува од неа. Со отстранување на последната дозволена збирка или со празнење на листата на дозволени сајтови се отстранува тоа ограничување на пристапот до сајтови. Не испраќајте празно барање за додавање, освен ако сакате да ги отстраните ограничувањата од листата на дозволени сајтови.

Јавно достапната алатка од Cookbook моментално управува само со листи на дозволени сајтови. Таа не управува со листи на блокирани сајтови или со исклучувања според ознаки за чувствителност. За тие задачи користете ги контролите на работниот простор опишани погоре.

Исклучете датотеки со ознаки за чувствителност

Најдете го GUID на ознаката

Побарајте го непроменливиот GUID на саканата ознака од вашиот администратор за Microsoft 365 или Purview. Користете го GUID, а не името за приказ на ознаката.

Администраторот може да добие список на ознаки преку Microsoft Graph. На токенот му е потребна соодветната дозвола SensitivityLabel.Read или SensitivityLabels.Read.All. Поврзете го името на саканата ознака со нејзиниот ID и проверете ги нејзините поставки за заштита.

За барања и примери, видете Добивање список на ознаки за чувствителност и Својства на ознаките за чувствителност. Овие дозволи за ознаки се одвоени од дозволата за читање сајтови што се користи за одредување идентификатори од URL-адреси на SharePoint.

Додајте исклучувања според ознаки

Отворете ги Контроли за безбедност и заштита во апликацијата SharePoint.
Внесете го GUID на секоја ознака без шифрирање во Исклучени ознаки за чувствителност без шифрирање.
Зачувајте ја конфигурацијата и тестирајте поддржана датотека со исклучената ознака.

Датотеките со соодветните поддржани ознаки се исклучуваат од резултатите на апликацијата SharePoint. Датотеките со ознаки што применуваат шифрирање веќе се стандардно исклучени.

Тестирајте ја конфигурацијата

Користете тест-датотеки и сметки одобрени од вашата организација. Пред тестирањето, потврдете дека истата сметка на Microsoft има пристап до секоја датотека директно во SharePoint.

Во режимот Дозволени сајтови со непразна листа, проверете датотека во дозволена збирка и датотека во збирка што не е на листата. Само дозволената збирка треба да биде достапна преку апликацијата.
Во режимот Блокирани сајтови, проверете датотека во блокирана збирка и датотека во неблокирана збирка. Блокираната збирка треба да биде недостапна; за неблокираната збирка и понатаму важат дозволите на Microsoft и другите контроли.
Проверете поддржана тест-датотека со исклучена ознака за чувствителност. Таа не треба да се појавува во резултатите на апликацијата.
По промена преку API, споредете ја зачуваната листа во корисничкиот интерфејс со политиката што ја враќа API.
По поставување CSV, зачувајте ги промените и повторно отворете ги контролите за да потврдите дека се задржани предвидените збирки.

Ако резултатите се разликуваат од предвидената политика, проверете ги работниот простор, избраниот режим на пристап, зачуваната листа, GUID на збирките, GUID на ознаките, поддржаниот тип датотека и дозволите на корисникот во Microsoft. Не празнете листа за да решите проблем, освен ако навистина ја сакате промената на пристапот што ќе произлезе од тоа.

За помош со контроли што недостасуваат или неочекуван пристап, видете: Контактирање со поддршката на OpenAI. Не вклучувајте администраторски клучеви или токени за Microsoft Graph во барањето за поддршка.

Запознајте се со ограничувањата

Правилото за збирка ја опфаќа целата збирка на сајтови. Со него не може да се ограничи пристапот до конкретен подсајт, папка или датотека.
Ограничувањата за сајтовите на SharePoint не го ограничуваат автоматски пристапот до OneDrive.
Филтрирањето според ознаки за чувствителност се применува само таму каде што Microsoft Graph обезбедува поддржани метаподатоци за ознаките, вклучително и за поддржаните документи на Office, PDF и MP4 датотеки.
Типовите што не поддржуваат ознаки за чувствителност, како TXT и CSV датотеките, се третираат како неозначени. Тие остануваат достапни ако пристапот е дозволен според другите правила. Ова ограничување за типовите датотеки е одвоено од поставувањето CSV за конфигурирање на пристапот до сајтови.
Поставувањето CSV и јавно достапната пример-алатка не ги конфигурираат исклучувањата според ознаки за чувствителност. Оваа статија не документира API за масовно управување со ознаки.
Зачуваната политика или успешниот одговор од API не го заменуваат тестирањето на пристапот со предвидената сметка.

Користете ја алатката за администрирање во Python

Целосниот пример-код и командите се одржуваат во OpenAI Cookbook:

Користете Python 3.10 или понова верзија. Алатката ја користи стандардната библиотека на Python. Прочитајте го водичот пред да ја стартувате и користете пробни извршувања без примена на промените за да ги прегледате.

Тековната алатка ги чита акредитивите од променливите на околината; следете ги упатствата за безбедно внесување во водичот. За празнење на листата на дозволени сајтови е потребна изречна потврда. Отстранувањето може да се изврши без таа потврда, па прво прегледајте го со пробно извршување без примена на промените.

За однесувањето при повторен обид и опционалните клучеви за идемпотентност, видете Безбедно повторување на ажурирањето на политиката. Користете клучеви за идемпотентност само ако работниот простор ги поддржува и проверете ја тековната политика по неуспех со нејасен исход.

Алатката не овозможува функции на работниот простор и не проверува дали правилата се спроведуваат. Нејзините офлајн тестови користат симулирани повици до Microsoft Graph и администраторскиот API на ChatGPT.

Промените со повеќе барања не се атомски. Ако отстранувањето на повеќе збирки не успее на половина пат, претходните отстранувања можеби веќе се успешно извршени. Прочитајте ја тековната политика пред да се обидете повторно.

Често поставувани прашања

Дали контролите за сајтови ги заменуваат дозволите на Microsoft?

Не. Апликацијата и понатаму ги користи дозволите на секој корисник во Microsoft. OpenAI го применува конфигурираното филтрирање на сајтови пред одговорите да им се прикажат на корисникот и на моделот.

Дали празната листа на дозволени сајтови ги блокира сите сајтови?

Не. Празната листа на дозволени сајтови не значи „блокирај ги сите“. Ако листата на блокирани сајтови содржи записи, тие збирки остануваат блокирани. Кога ниту една листа не содржи записи, пристапот го одредуваат дозволите на корисниците во Microsoft и другите конфигурирани контроли.

Дали промените преку администраторскиот API се евидентираат?

Промените на политиката преку администраторскиот API се евидентираат во дневниците за ревизија и усогласеност на работниот простор.

Управување со пристапот до сајтовите на SharePoint и исклучувањата според ознаки за чувствителност