Шолу
Жұмыс кеңістігінің әкімшілері SharePoint басқару параметрлері арқылы мақұлданған сайттар жиынтықтарына рұқсат бере алады, таңдалған жиынтықтарды бұғаттай алады және таңдалған Microsoft Purview құпиялылық белгілері бар, қолдау көрсетілетін файлдарды алып тастай алады.
SPSite деп те аталатын SharePoint сайттар жиынтығында бірнеше сайт болуы мүмкін. Жиынтық ережесі әр пайдаланушының қолданыстағы Microsoft рұқсаттары ескеріле отырып, бүкіл жиынтыққа қолданылады. Ол пайдаланушыға Microsoft 365 жүйесінде қол жеткізе алмайтын мазмұнға рұқсат бермейді.
Сайт шектеулері SharePoint қызметінде қолдау көрсетілетін іздеу, шолу, файлдарды алу және оқу/жазу әрекеттеріне қолданылады. OneDrive қызметіне қол жеткізу бөлек басқарылады.
Саясатыңызға сәйкес келетін қол жеткізу режимін таңдаңыз:
Рұқсат етілген сайттар: Рұқсат тізімі бос болмаса, пайдаланушылар қолданба арқылы тек тізімдегі сайттар жиынтықтарына қол жеткізе алады.
Бұғатталған сайттар: Пайдаланушылар Microsoft рұқсаттарына сәйкес тыйым тізіміне кірмеген сайттар жиынтықтарына қол жеткізе алады.
Бір уақытта тек бір тізімде жазбалар болуы мүмкін. Бос рұқсат тізімі барлық сайтты бұғаттамайды. Екі тізім де бос болса, SharePoint сайттарына қойылған шектеулер жойылады; Microsoft рұқсаттары мен басқа бапталған басқару параметрлері қолданыла береді.
Қолжетімділік
Басқару параметрлері мен жұмыс кеңістігінің Admin API интерфейсін жұмыс кеңістігіңіз үшін іске қосу қажет. Қолжетімді басқару мүмкіндіктеріне сайттар жиынтықтарының рұқсат және тыйым тізімдері, сайттарды CSV арқылы импорттау және құпиялылық белгілері бойынша алып тастау кіреді.
Ережелер сайттар жиынтығына тұтастай қолданылады. Сайттар жиынтығын басқарудың бұл мүмкіндіктеріне ережені нақты бір сайтпен, қалтамен немесе файлмен шектеу және Microsoft Sites.Selected талаптарын қолдану кірмейді.
Бастамас бұрын
Ұйымыңыз рұқсат бергісі немесе бұғаттағысы келетін сайттар жиынтықтарын анықтаңыз.
Әр жиынтықтың GUID идентификаторын алыңыз. Толық Microsoft Graph сайт идентификаторының ортаңғы мәні — жиынтықтың GUID идентификаторы. Admin API жиынтықтардың GUID идентификаторларын пайдаланады; интерфейстегі CSV импорттау құралы оларды Graph сайт идентификаторларының үштіктерінен де шығарып ала алады.
ChatGPT рұқсат параметрлерінде де, Microsoft Entra жүйесінде де SharePoint қолданбасына қажетті Microsoft рұқсаттарын, соның ішінде
Sites.Read.AllжәнеFiles.Read.Allрұқсаттарын қосыңыз. Бұл параметрлер OpenAI жағында қол жеткізуді сүзеді; олар Microsoft делегатталған рұқсаттарының орнын баспайды.Құпиялылық белгілері бойынша алып тастауды баптау үшін Microsoft 365 немесе Purview әкімшісінен шифрлауды қолданбайтын әр белгінің өзгермейтін GUID идентификаторын сұраңыз.
API арқылы әкімшілендіру үшін жұмыс кеңістігінің UUID идентификаторын, ChatGPT жұмыс кеңістігінің әкімші кілтін және SharePoint URL мекенжайларының идентификаторларын анықтау қажет болса, Microsoft Graph токенін алыңыз. Бұл екі тіркелгі дерегінің қызметі әртүрлі.
OpenAI Cookbook туралы
OpenAI Cookbook — OpenAI компаниясының жалпыға қолжетімді үлгі кодтар мен нұсқаулықтар жинағы. Бұл мақалада сол жинақтың GitHub сайтында орналасқан SharePoint сайтына қол жеткізу нұсқаулығы мен Python әкімшілендіру скрипті пайдаланылады. Файлдарды оқу үшін осы сілтемелерді браузерде ашуға болады. Скриптті іске қосу үшін оны жүктеп алып, нұсқаулықтағы баптау және пәрмендерді орындау нұсқауларын орындаңыз.
Осы мақалада «Cookbook» атауы сол SharePoint нұсқаулығын, ал «Cookbook утилитасы» атауы сілтемеде берілген Python скриптін білдіреді. Пәрмен мысалдары мен API арқылы рұқсат тізімін басқару үшін осы материалдарды пайдаланыңыз.
API арқылы әкімшілендіруге арналған тіркелгі деректерін баптау
Ескертпе: әкімші кілттерін жасау үшін жұмыс кеңістігінің әкімшісі болуыңыз керек. Толығырақ оқыңыз.
ChatGPT жұмыс кеңістігінің әкімші кілтін жасау
ChatGPT әкімші консолін ашып, қажетті жұмыс кеңістігін таңдаңыз.
Тіркелгі деректері бөліміне өтіп, Әкімші кілттері тармағын таңдаңыз.
Шектеулі рұқсаттары бар кілт жасап, Қолданбалар үшін Жазу рұқсатын орнатыңыз.
Кілтті қауіпсіз жерде сақтаңыз. Бұл кілт жұмыс кеңістігіңіздің SharePoint саясатын оқуға және өзгертуге рұқсат береді.
Қажетті рұқсат — chatgpt.enterprise.apps.write. OpenAI API платформасының кілті де, Microsoft Graph токені де ChatGPT жұмыс кеңістігінің әкімші кілтін алмастыра алмайтынын ескеріңіз.
Қосымша ақпаратты Тіркелгі деректері қойындысында әкімші кілттерін басқару бөлімінен қараңыз. Скрипттің тіркелгі деректеріне арналған орта айнымалылары мен қауіпсіз енгізу мысалын Cookbook тіркелгі деректері жөніндегі нұсқауларынан қараңыз.
Microsoft Graph токенін алу
Ұйымыңыз мақұлдаған Microsoft аутентификация процесін пайдаланыңыз. Ұйымыңыз Graph Explorer қолдануға рұқсат берсе, интерактивті іздеу үшін:
Microsoft Graph Explorer құралын ашып, SharePoint сайттары орналасқан жалға алушы ортасындағы жұмыс есептік жазбасымен кіріңіз.
Рұқсаттарды өзгерту немесе Рұқсаттарға келісім беру арқылы сайттарды оқуға қажетті рұқсаттарды, әдетте
Sites.Read.Allрұқсатын таңдаңыз. Ұйымыңыз талап етсе, Microsoft әкімшісінен қол жеткізуді мақұлдауын сұраңыз.Қол жеткізу токені қойындысын ашып, Microsoft Graph қызметінде пайдалану үшін токенді көшіріңіз.
Microsoft нұсқауларын Graph Explorer құралымен жұмыс істеу бөлімінен қараңыз.
Graph токені SharePoint URL мекенжайларына сәйкес идентификаторларды анықтайды. ChatGPT әкімші кілті ChatGPT саясатын оқиды немесе жаңартады. Cookbook утилитасына Graph токені тек URL мекенжайларының идентификаторларын анықтайтын пәрмендер үшін қажет; қолданыстағы рұқсат тізімін оқу немесе тазалау үшін тек ChatGPT әкімші кілті жеткілікті.
Бұл екі тіркелгі дерегінің ешқайсысын нұсқаларды басқару жүйесіне, ортақ құжаттарға, скриншоттарға немесе журналдарға енгізбеңіз.
Сайттар жиынтығының GUID идентификаторын табу
SharePoint сайтының URL мекенжайын пайдалану
Microsoft жүйесіне сайтқа кіруге рұқсаты бар есептік жазбамен кіріп, SharePoint сайтын ашыңыз.
Сайттың URL мекенжайының соңына
/_api/site/idқосыңыз. Мысалы,https://contoso.sharepoint.com/sites/Finance/_api/site/idмекенжайын пайдаланыңыз.Жауапта қайтарылған GUID идентификаторын көшіріңіз.
Ескертпе: осы мақаладағы мысал домендер мен идентификаторлар шартты түрде берілген.
Microsoft Graph пайдалану
Microsoft Graph үтірмен бөлінген үш бөліктен тұратын сайт идентификаторын қайтарады: хост атауы, сайттар жиынтығының GUID идентификаторы және сайттың GUID идентификаторы. Сайттар жиынтығына арналған ережеде ортадағы мәнді пайдаланыңыз. Әртүрлі сайт URL мекенжайлары бір жиынтықтың GUID идентификаторына сәйкес келуі мүмкін.
Іздеу және идентификатор мысалдарын SharePoint сайт идентификаторлары туралы түсінік бөлімінен қараңыз. ChatGPT саясатын өзгертпей, бірнеше URL мекенжайының идентификаторын анықтау үшін Cookbook тексеру нұсқауларын және Python әкімшілендіру скриптін пайдаланыңыз.
Microsoft іздеу талаптарын Жол бойынша SharePoint сайтын алу бөлімінен қараңыз.
Рұқсат етілген және бұғатталған сайттар жиынтықтарын басқару
Жұмыс кеңістігінің басқару параметрлерін пайдалану
Жұмыс кеңістігіндегі SharePoint қолданбасының Қауіпсіздік және қорғау параметрлері бөлімін ашыңыз.
Қол жеткізу режимі бөлімінде Рұқсат етілген сайттар немесе Бұғатталған сайттар нұсқасын таңдаңыз.
Таңдалған тізімге сайттар жиынтықтарын қосыңыз. Төменде сипатталған CSV жүктеу әдісін де пайдалануға болады.
Өзгерістерді қарап шығып, Сақтау түймесін таңдаңыз.
Сақталған саясатты қарап, баптауларды тексеріңіз.
Admin API арқылы қосылған сайттар жұмыс кеңістігінің басқару параметрлерінде көрсетіледі. Интерфейсте қосылған сайттар API арқылы да қолжетімді. Жазбаларды екі тәсілдің кез келгенімен қосуға немесе жоюға болады; сайтты қосу тәсілі оны кейін тек сол тәсілмен басқаруға міндеттемейді.
Рұқсат етілген және бұғатталған сайттар режимдері арасында ауысу
Бір уақытта тек бір тізімде жазбалар болуы мүмкін. Басқа режимде жазбалар қоспас бұрын қолданыстағы тізімді тазалап, сол өзгерісті сақтаңыз. Содан кейін басқа режимді таңдап, қажетті жиынтықтарды қосып, қайта сақтаңыз.
Белсенді тізімді тазалап сақтаған сәтте қол жеткізу тәртібі бірден өзгереді. Рұқсат тізімін тазалау сайттарға қойылған шектеуді жояды; тыйым тізімін тазалау оның бұғаттауларын жояды. Ауысуды басқа әкімшілермен бірге жоспарлаңыз: бір тізімді тазалау мен екіншісін сақтау аралығында соңғы саясат шектейтін қол жеткізуге уақытша рұқсат берілуі мүмкін.
Сайттар жиынтықтарын CSV файлынан жүктеу
CSV жүктеу тек сайттар жиынтықтарын қолдайды. Файлдарды құпиялылық белгісі бойынша алып тастау үшін Алып тасталатын шифрлаусыз құпиялылық белгілері бөліміне белгілердің GUID идентификаторларын қосыңыз.
Қауіпсіздік және қорғау параметрлері бөлімін ашып, қажетті Қол жеткізу режимі нұсқасын таңдаңыз.
Сайттар жиынтықтарының GUID идентификаторлары немесе Microsoft Graph сайт идентификаторларының үштіктері бар CSV файлын дайындаңыз. Бүкіл файлда бір ғана идентификатор пішімін пайдаланыңыз.
CSV файлын жүктеу түймесін басып, файлды таңдаңыз.
Импорттау нәтижесін және таңдалған тізімді қарап шығыңыз. Жалғастырмас бұрын жолдардағы қателерді және ескертуге себеп болған мәселелерді түзетіңіз.
Өзгерістерді қолдану үшін Сақтау түймесін басып, сақталған тізімді тексеріңіз.
CSV талаптары мен жұмыс тәртібі:
Файлдың ең үлкен өлшемі: 1 МБ.
Баған тақырыптары міндетті емес.
Әр жолға бір жиынтықтың GUID идентификаторын немесе Graph сайт идентификаторының үштігін енгізіңіз. Үштіктерді бір өрісте тырнақшаға алып жазуға немесе үш бағанға бөлуге болады.
Graph үштіктері жиынтықтардың GUID идентификаторларына түрлендіріледі. Үштікті импорттау тек нақты бір сайтқа арналған ереже жасамайды.
Импорттау кезінде таңдалған тізімге жаңа жазбалар қосылып, бұрынғы жазбалар сақталады. Қайталанатын жиынтықтар бір рет қана есепке алынады; импорт саны жаңадан қосылған жиынтықтарды көрсетеді.
Аралас пішімдер мен дұрыс пішімделмеген жолдар қабылданбайды. Тек сайт URL мекенжайлары бар файл жүктелсе, ескерту көрсетіліп, сайттар қосылмайды. Алдымен URL мекенжайларына сәйкес жиынтықтардың GUID идентификаторларын анықтаңыз.
Жүктеу тек тізімнің жоба нұсқасын өзгертеді. Сақтау түймесін баспайынша, жұмыс кеңістігіндегі қол жеткізу тәртібі жаңармайды.
Мұнда сипатталған CSV жүктеу әдісі сайттар жиынтықтарын басқаруға арналған. Құпиялылық белгілері бойынша алып тастауды бөлек баптаңыз.
SharePoint URL мекенжайлары бар CSV файлыңыз болса, Cookbook утилитасының CSV өңдеу процесі арқылы олардың идентификаторларын анықтап, API көмегімен рұқсат тізімін басқаруға болады. Ондағы site_url немесе url кіріс деректерінің пішімі мен өңдеу процесі интерфейсте идентификаторларды жүктеуден өзгеше.
Саясат пен сұрау шектеулерін түсіну
Саясаттың әдепкі шегі — 10 000 сайттар жиынтығы. Жұмыс кеңістігінің саясат шегін 120 000 сайттар жиынтығына дейін арттыруды OpenAI іске қосуы керек; ауқымдырақ енгізуді жоспарламас бұрын OpenAI тобыңызға хабарласыңыз.
Жеке API өзгерту операциялары мен қазіргі Cookbook скрипті бір сұрауда 10 000 жиынтық GUID идентификаторына дейін қабылдайды. Жұмыс кеңістігінің саясат шегін арттыру бір сұрауға қойылған бұл шекті өзгертпейді. Бастапқы URL мекенжайларын емес, бірегей сайттар жиынтықтарын санаңыз: бірнеше URL бір жиынтыққа сілтеуі мүмкін.
Жұмыс кеңістігінің Admin API интерфейсін пайдалану
https://api.chatgpt.com мекенжайымен жұмыс істеу үшін жұмыс кеңістігінің UUID идентификаторын және ChatGPT жұмыс кеңістігінің әкімші кілтін пайдаланыңыз.
Рұқсат тізіміне арналған жаңартылып отыратын пәрмендер мен сұрау мысалдарын Cookbook жинағынан қараңыз:
Сайттар жиынтықтарын алдын ала қарау және қосу. Жаңа жиынтықтар қосылғанда бұрын рұқсат етілген жиынтықтар сақталады.
Өзгеріс енгізбес бұрын ағымдағы саясатты қарап шығыңыз. Өзгерістен кейін оны қайта оқып, қол жеткізу тәртібін тексеріңіз. Соңғы рұқсат етілген жиынтықты жою немесе рұқсат тізімін тазалау сайттарға қойылған сол шектеуді жояды. Рұқсат тізімінің шектеулерін жойғыңыз келмесе, бос қосу сұрауын жібермеңіз.
Жалпыға қолжетімді Cookbook утилитасы қазір тек рұқсат тізімдерін басқарады. Ол тыйым тізімдерін немесе құпиялылық белгілері бойынша алып тастауды басқармайды. Бұл тапсырмалар үшін жоғарыда сипатталған жұмыс кеңістігінің басқару параметрлерін пайдаланыңыз.
Құпиялылық белгілері бар файлдарды алып тастау
Белгінің GUID идентификаторын табу
Microsoft 365 немесе Purview әкімшісінен қажетті белгінің өзгермейтін GUID идентификаторын сұраңыз. Оның көрсетілетін атауын емес, GUID идентификаторын пайдаланыңыз.
Әкімші Microsoft Graph арқылы белгілер тізімін ала алады. Токенге тиісті SensitivityLabel.Read немесе SensitivityLabels.Read.All рұқсаты қажет. Қажетті белгінің атауын оның идентификаторымен сәйкестендіріп, қорғау параметрлерін тексеріңіз.
Талаптар мен мысалдарды Құпиялылық белгілерінің тізімін алу және Құпиялылық белгісінің сипаттары бөлімдерінен қараңыз. Бұл белгі рұқсаттары SharePoint URL мекенжайларының идентификаторларын анықтау үшін қолданылатын сайтты оқу рұқсатынан бөлек.
Алып тасталатын белгілерді қосу
SharePoint қолданбасының Қауіпсіздік және қорғау параметрлері бөлімін ашыңыз.
Алып тасталатын шифрлаусыз құпиялылық белгілері бөліміне шифрлауды қолданбайтын әр белгінің GUID идентификаторын енгізіңіз.
Баптауларды сақтап, алып тасталған белгісі бар, қолдау көрсетілетін файлды тексеріңіз.
Сәйкес келетін қолдау көрсетілетін белгілері бар файлдар SharePoint қолданбасының нәтижелерінен алып тасталады. Шифрлауды қолданатын белгілері бар файлдар әдепкіде-ақ алып тасталған.
Баптауларды тексеру
Ұйымыңыз мақұлдаған сынақ файлдары мен есептік жазбаларды пайдаланыңыз. Тексермес бұрын сол Microsoft есептік жазбасымен әр файлға тікелей SharePoint арқылы қол жеткізуге болатынына көз жеткізіңіз.
Рұқсат етілген сайттар режимінде тізім бос болмаса, рұқсат етілген жиынтықтағы файлды және тізімге кірмеген жиынтықтағы файлды тексеріңіз. Қолданба арқылы тек рұқсат етілген жиынтыққа қол жеткізу мүмкін болуы керек.
Бұғатталған сайттар режимінде бұғатталған жиынтықтағы файлды және бұғатталмаған жиынтықтағы файлды тексеріңіз. Бұғатталған жиынтыққа қол жеткізу мүмкін болмауы керек; бұғатталмаған жиынтыққа Microsoft рұқсаттары мен басқа басқару параметрлері қолданыла береді.
Алып тасталған құпиялылық белгісі бар, қолдау көрсетілетін сынақ файлын тексеріңіз. Ол қолданба нәтижелерінде көрсетілмеуі керек.
API арқылы өзгеріс енгізгеннен кейін интерфейсте сақталған тізімді API қайтарған саясатпен салыстырыңыз.
CSV жүктегеннен кейін өзгерістерді сақтап, қажетті жиынтықтардың сақталғанына көз жеткізу үшін басқару параметрлерін қайта ашыңыз.
Нәтижелер көзделген саясатқа сәйкес келмесе, жұмыс кеңістігін, таңдалған қол жеткізу режимін, сақталған тізімді, жиынтықтар мен белгілердің 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 және ChatGPT Admin API шақыруларының имитациясы қолданылады.
Бірнеше сұраудан тұратын өзгерістер атомарлы емес. Бірнеше жиынтықты жою кезінде процесс орта жолда тоқтаса, алдыңғы жиынтықтар жойылып қойған болуы мүмкін. Қайталап көрмес бұрын ағымдағы саясатты оқыңыз.
Жиі қойылатын сұрақтар
Сайтты басқару параметрлері Microsoft рұқсаттарының орнын баса ма?
Жоқ. Қолданба әр пайдаланушының Microsoft рұқсаттарын пайдалана береді. OpenAI жауаптарды пайдаланушы мен модельге көрсетпес бұрын бапталған сайт сүзгісін қолданады.
Бос рұқсат тізімі барлық сайтты бұғаттай ма?
Жоқ. Бос рұқсат тізімі «барлығын бұғаттау» дегенді білдірмейді. Тыйым тізімінде жазбалар болса, сол жиынтықтар бұғатталған күйде қалады. Екі тізімде де жазба болмаса, қол жеткізу тәртібін пайдаланушылардың Microsoft рұқсаттары мен басқа бапталған басқару параметрлері анықтайды.
Admin API арқылы енгізілген өзгерістер журналға жазыла ма?
Admin API арқылы саясатқа енгізілген өзгерістер жұмыс кеңістігінің аудит және сәйкестік журналдарында тіркеледі.