Преглед

Администраторите на работниот простор може да ги користат контролите на 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.

• За исклучувања според ознаки за чувствителност, побарајте го од администраторот на Microsoft 365 или Purview непроменливиот GUID на секоја ознака што сакате да ја исклучите, вклучувајќи ги и ознаките што применуваат шифрирање.

• За администрирање преку API, обезбедете ги UUID на работниот простор, администраторски клуч за работниот простор во ChatGPT и токен за Microsoft Graph ако треба да ги утврдите идентификаторите што одговараат на URL-адресите на SharePoint. Клучот и токенот имаат различни намени.

За OpenAI Cookbook

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

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

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

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

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

1. Отворете ја администраторската конзола на ChatGPT и изберете го саканиот работен простор.

2. Одете во Акредитиви и изберете Администраторски клучеви.

3. Создајте клуч со Ограничени дозволи и поставете ја опцијата Апликации на Запишување.

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

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

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

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

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

1. Отворете Microsoft Graph Explorer и најавете се со деловна сметка во закупецот што ги содржи сајтовите на SharePoint.

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

3. Отворете ја картичката Токен за пристап и копирајте го токенот за користење со Microsoft Graph.

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

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

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

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

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

1. Отворете го сајтот на SharePoint додека сте најавени на Microsoft со сметка што има пристап до него.

2. Додајте /_api/site/id на крајот од URL-адресата на сајтот. На пример, користете https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Копирајте го GUID што е вратен во одговорот.

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

Користете Microsoft Graph

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

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

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

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

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

1. Во работниот простор отворете ги Контролите за безбедност и заштита на апликацијата SharePoint.

2. Во Режим на пристап, изберете Дозволени сајтови или Блокирани сајтови.

3. Додајте ги колекциите на сајтови во избраниот список. Може да ја користите и можноста за прикачување CSV опишана подолу.

4. Прегледајте ги промените и изберете Зачувај.

5. Проверете ја зачуваната политика и тестирајте ја конфигурацијата.

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

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

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


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

Прикачете колекции на сајтови од CSV

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

1. Отворете ги Контролите за безбедност и заштита и изберете го саканиот Режим на пристап.

2. Подгответе CSV со GUID-ови на колекции на сајтови или со тројки вредности што сочинуваат ID на сајт во Microsoft Graph. Користете еден ист формат на идентификатори низ целата датотека.

3. Изберете Прикачи CSV-датотека и одберете ја датотеката.

4. Прегледајте го резултатот од увозот и избраниот список. Пред да продолжите, отстранете ги сите грешки или предупредувања за редовите.

5. Изберете Зачувај за да ги примените промените, а потоа проверете го зачуваниот список.

Барања за 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.

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

1. Отворете ги Контролите за безбедност и заштита на апликацијата SharePoint.

2. Во списокот за исклучување според ознаки за чувствителност внесете го GUID на секоја ознака што сакате да ја исклучите, вклучувајќи ги и ознаките што применуваат шифрирање.

3. Зачувајте ја конфигурацијата и тестирајте со поддржана датотека што ја има исклучената ознака.

Датотеките со соодветни поддржани ознаки се исклучуваат од резултатите на апликацијата SharePoint. Содржината на шифрираните датотеки стандардно е исклучена. За пристап до поддржаните шифрирани датотеки се потребни и напреден пристап до датотеки (fetch_advanced) и согласност од администратор на Microsoft Entra, како што е опишано во често поставуваните прашања подолу. Исклучувањата според ознаки и дозволите на Microsoft за поврзаниот корисник и понатаму важат.

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

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

1. Во режимот Дозволени сајтови со непразна листа, проверете датотека во дозволена збирка и датотека во збирка што не е на листата. Само дозволената збирка треба да биде достапна преку апликацијата.

2. Во режимот Блокирани сајтови, проверете датотека во блокирана збирка и датотека во неблокирана збирка. Блокираната збирка треба да биде недостапна; за неблокираната збирка и понатаму важат дозволите на Microsoft и другите контроли.

3. Проверете поддржана тест-датотека со исклучена ознака за чувствителност. Таа не треба да се појавува во резултатите на апликацијата.

4. По промена преку API, споредете ја зачуваната листа во корисничкиот интерфејс со политиката што ја враќа API.

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

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

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

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

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

• Ограничувањата за сајтовите на SharePoint не го ограничуваат автоматски пристапот до OneDrive.

• Филтрирањето според ознаки за чувствителност се применува само таму каде што Microsoft Graph обезбедува поддржани метаподатоци за ознаките, вклучително и за поддржаните документи на Office, PDF и MP4 датотеки.

• Типовите што не поддржуваат ознаки за чувствителност, како TXT и CSV датотеките, се третираат како неозначени. Тие остануваат достапни ако пристапот е дозволен според другите правила. Ова ограничување за типовите датотеки е одвоено од поставувањето CSV за конфигурирање на пристапот до сајтови.

• Поставувањето CSV и јавно достапната пример-алатка не ги конфигурираат исклучувањата според ознаки за чувствителност. Оваа статија не документира API за масовно управување со ознаки.

• Зачуваната политика или успешниот одговор од API не го заменуваат тестирањето на пристапот со предвидената сметка.

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

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

• Водич за администрирање.

• Скрипта за администрирање во Python.

• Датотека за офлајн тестирање.

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

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

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

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

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

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

Дали треба да ги додадам ознаките за чувствителност што применуваат шифрирање во списокот за исклучување?

Да. Додајте ги сите ознаки за чувствителност од Microsoft Purview чии датотеки сакате ChatGPT да ги исклучи, вклучувајќи ги и ознаките што применуваат шифрирање.

Содржината на шифрираните датотеки стандардно е исклучена. За да се овозможи пристап до поддржаните шифрирани датотеки, администратор на работниот простор мора да овозможи напреден пристап до датотеки (fetch_advanced), а администратор на Microsoft Entra мора да даде согласност за потребните дозволи на Microsoft. Не е доволно само да се овозможи дејството без да се добие согласност од администраторот.

Дури и по поставувањето, ChatGPT може да презема шифрирана содржина само ако поврзаниот корисник има дозвола да пристапи до датотеката и да ја дешифрира. Датотеките со ознаки од вашиот список за исклучување остануваат исклучени. Овозможувањето напреден пристап до датотеки или давањето согласност од администраторот не ги поништува исклучувањата според ознаки или дозволите на Microsoft за корисникот.

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

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

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

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

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

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