Ħarsa ġenerali
L-amministraturi tal-workspace jistgħu jużaw il-kontrolli ta’ SharePoint biex jippermettu ġabriet ta’ siti approvati, jimblukkaw ġabriet ta’ siti magħżula, u jeskludu fajls appoġġjati b’tikketti tas-sensittività magħżula ta’ Microsoft Purview.
Ġabra ta’ siti ta’ SharePoint, imsejħa wkoll SPSite, jista’ jkun fiha diversi siti. Regola dwar ġabra tapplika għall-ġabra kollha, soġġetta għall-permessi eżistenti ta’ Microsoft ta’ kull utent. Ma tagħtix lill-utent aċċess għal kontenut li ma jistax jaċċessa f’Microsoft 365.
Ir-restrizzjonijiet fuq is-siti japplikaw għal azzjonijiet appoġġjati ta’ tiftix, ibbrawżjar, irkupru ta’ fajls, u qari/kitba f’SharePoint. L-aċċess għal OneDrive jiġi mmaniġġjat separatament.
Agħżel il-modalità tal-aċċess li taqbel mal-politika tiegħek:
Siti permessi: Meta l-lista ta’ permessi ma tkunx vojta, l-utenti jistgħu jaċċessaw biss il-ġabriet ta’ siti elenkati permezz tal-app.
Siti mblukkati: L-utenti jistgħu jaċċessaw ġabriet ta’ siti għajr dawk fil-lista ta’ imblukkar, soġġetti għall-permessi tagħhom ta’ Microsoft.
Lista waħda biss jista’ jkollha entrati fi kwalunkwe ħin. Lista ta’ permessi vojta ma timblokkax is-siti kollha. Meta ż-żewġ listi jkunu vojta, jitneħħew ir-restrizzjonijiet fuq is-siti ta’ SharePoint; il-permessi ta’ Microsoft u kontrolli oħra kkonfigurati jibqgħu japplikaw.
Disponibbiltà
Il-kontrolli u l-API tal-amministrazzjoni tal-workspace jeħtieġ li jiġu attivati għall-workspace tiegħek. Il-kontrolli disponibbli jinkludu listi ta’ permessi u listi ta’ imblukkar għal ġabriet ta’ siti, importazzjonijiet ta’ siti minn CSV, u esklużjonijiet skont it-tikketti tas-sensittività.
Ir-regoli japplikaw għal ġabriet sħaħ ta’ siti. Dawn il-kontrolli tal-ġabriet ta’ siti ma jinkludux limitazzjoni għal sit individwali, fowlder jew fajl speċifiku, jew infurzar ta’ Microsoft Sites.Selected.
Qabel tibda
Identifika l-ġabriet ta’ siti li l-organizzazzjoni tiegħek trid tippermetti jew timblokka.
Ikseb il-GUID ta’ kull ġabra. ID sħiħ ta’ sit ta’ Microsoft Graph fih il-GUID tal-ġabra bħala l-valur tan-nofs. L-API tal-amministrazzjoni tuża GUIDs ta’ ġabriet; l-importatur tas-CSV fl-interfaċċa jista’ wkoll jestrattahom mill-IDs tas-siti ta’ Graph bi tliet komponenti.
Attiva l-permessi ta’ Microsoft meħtieġa mill-app ta’ SharePoint kemm fis-settings tal-permessi ta’ ChatGPT kif ukoll f’Microsoft Entra, inklużi
Sites.Read.AlluFiles.Read.All. Dawn il-kontrolli jiffiltraw l-aċċess min-naħa ta’ OpenAI; ma jiħdux post il-permessi delegati ta’ Microsoft.Għall-esklużjonijiet skont it-tikketti tas-sensittività, itlob lill-amministratur tiegħek ta’ Microsoft 365 jew Purview il-GUID immutabbli ta’ kull tikketta mingħajr kriptaġġ.
Għall-amministrazzjoni permezz tal-API, ikseb l-UUID tal-workspace tiegħek, ċavetta tal-amministrazzjoni tal-workspace ta’ ChatGPT, u token ta’ Microsoft Graph jekk għandek bżonn issib l-identifikaturi għal URLs ta’ SharePoint. Iż-żewġ kredenzjali għandhom skopijiet differenti.
Dwar l-OpenAI Cookbook
L-OpenAI Cookbook huwa l-ġabra pubblika ta’ OpenAI ta’ kodiċi ta’ eżempju u gwidi. Dan l-artiklu juża l-gwida tiegħu għall-aċċess għas-siti ta’ SharePoint u l-iskritt ta’ amministrazzjoni f’Python, it-tnejn ospitati fuq GitHub. Tista’ tiftaħ dawn il-links fil-brawżer tiegħek biex taqra l-fajls. Biex tħaddem l-iskritt, niżżlu u segwi l-istruzzjonijiet tal-gwida dwar il-konfigurazzjoni u l-kmandi.
F’dan l-artiklu, “Cookbook” jirreferi għal dik il-gwida ta’ SharePoint, u “għodda tal-Cookbook” tirreferi għall-iskritt ta’ Python fil-link. Uża dawn ir-referenzi għal eżempji ta’ kmandi u għall-ġestjoni ta’ listi ta’ permessi permezz tal-API.
Ikkonfigura l-kredenzjali għall-amministrazzjoni permezz tal-API
Nota: Trid tkun amministratur tal-workspace biex tkun tista’ toħloq ċwievet tal-amministrazzjoni. Aqra aktar.
Oħloq ċavetta tal-amministrazzjoni tal-workspace ta’ ChatGPT
Iftaħ il-konsol tal-amministrazzjoni ta’ ChatGPT u agħżel il-workspace mixtieq.
Mur f’Kredenzjali u agħżel Ċwievet tal-amministrazzjoni.
Oħloq ċavetta b’permessi Ristretti u ssettja Apps għal Kitba.
Aħżen iċ-ċavetta b’mod sigur. Din iċ-ċavetta tawtorizza l-qari u t-tibdil tal-politika ta’ SharePoint għall-workspace tiegħek.
Il-permess meħtieġ huwa chatgpt.enterprise.apps.write. Innota li ċavetta tal-Pjattaforma tal-API u token ta’ Microsoft Graph ma jistgħux jieħdu post ċavetta tal-amministrazzjoni tal-workspace ta’ ChatGPT.
Għal aktar informazzjoni, ara: Ġestjoni taċ-ċwievet tal-amministrazzjoni fit-tab Kredenzjali. Għall-varjabbli tal-ambjent tal-iskritt li jżommu l-kredenzjali u eżempju ta’ kif iddaħħalhom b’mod sigur, ara l-istruzzjonijiet tal-Cookbook dwar il-kredenzjali.
Ikseb token ta’ Microsoft Graph
Uża l-proċess ta’ awtentikazzjoni ta’ Microsoft approvat mill-organizzazzjoni tiegħek. Għal tiftix interattiv, jekk l-organizzazzjoni tiegħek tippermetti Graph Explorer:
Iftaħ Microsoft Graph Explorer u idħol b’kont tax-xogħol fit-tenant li fih is-siti ta’ SharePoint.
Agħżel il-permessi meħtieġa biex taqra s-siti, tipikament
Sites.Read.All, permezz ta’ Immodifika l-permessi jew Agħti l-kunsens għall-permessi. Itlob lill-amministratur tiegħek ta’ Microsoft japprova l-aċċess jekk l-organizzazzjoni tiegħek teħtieġ dan.Iftaħ it-tab Token tal-aċċess u kkopja t-token biex tużah ma’ Microsoft Graph.
Għall-istruzzjonijiet ta’ Microsoft, ara Aħdem ma’ Graph Explorer.
It-token ta’ Graph jintuża biex jinstabu l-identifikaturi li jikkorrispondu għall-URLs ta’ SharePoint. Iċ-ċavetta tal-amministrazzjoni ta’ ChatGPT tintuża biex tinqara jew tiġi aġġornata l-politika ta’ ChatGPT. L-għodda tal-Cookbook teħtieġ it-token ta’ Graph biss għal kmandi li jsibu l-identifikaturi għal URLs; biex taqra jew tbattal lista ta’ permessi eżistenti, teħtieġ biss iċ-ċavetta tal-amministrazzjoni ta’ ChatGPT.
Tpoġġi l-ebda waħda miż-żewġ kredenzjali f’sistemi ta’ kontroll tal-verżjonijiet tal-kodiċi, dokumenti kondiviżi, screenshots jew reġistri.
Sib il-GUID ta’ ġabra ta’ siti
Uża l-URL tas-sit ta’ SharePoint
Iftaħ is-sit ta’ SharePoint waqt li tkun dħalt f’Microsoft b’kont li għandu aċċess għalih.
Żid
/_api/site/idfit-tarf tal-URL tas-sit. Pereżempju, użahttps://contoso.sharepoint.com/sites/Finance/_api/site/id.Ikkopja l-GUID li jingħata fit-tweġiba.
Nota: id-dominji u l-identifikaturi fl-eżempji ta’ dan l-artiklu huma valuri fittizji.
Uża Microsoft Graph
Microsoft Graph jagħti ID tas-sit bi tliet komponenti separati b’virgoli: l-isem tal-host, il-GUID tal-ġabra ta’ siti u l-GUID tas-sit. Uża l-valur tan-nofs għal regola dwar ġabra ta’ siti. URLs ta’ siti differenti jistgħu jikkorrispondu għall-istess GUID ta’ ġabra.
Għal eżempji ta’ tiftix u identifikaturi, ara Ifhem l-identifikaturi tas-siti ta’ SharePoint. Biex issib l-identifikaturi għal diversi URLs mingħajr ma tbiddel il-politika ta’ ChatGPT, uża l-istruzzjonijiet ta’ spezzjoni fil-Cookbook u l-iskritt ta’ amministrazzjoni f’Python.
Għar-rekwiżiti ta’ Microsoft għat-tiftix, ara Ikseb sit ta’ SharePoint permezz tal-passaġġ tiegħu.
Immaniġġja l-ġabriet ta’ siti permessi u mblukkati
Uża l-kontrolli tal-workspace
Iftaħ il-Kontrolli tas-sikurezza u s-sigurtà tal-app ta’ SharePoint fil-workspace tiegħek.
Taħt Modalità tal-aċċess, agħżel Siti permessi jew Siti mblukkati.
Żid il-ġabriet ta’ siti mal-lista magħżula. Tista’ wkoll tuża t-tlugħ ta’ CSV deskritt hawn taħt.
Irrevedi l-bidliet tiegħek u agħżel Issejvja.
Iċċekkja l-politika ssejvjata u ttestja l-konfigurazzjoni tiegħek.
Siti miżjuda permezz tal-API tal-amministrazzjoni jidhru fil-kontrolli tal-workspace. Siti miżjuda fl-interfaċċa huma disponibbli wkoll permezz tal-API. Tista’ żżid jew tneħħi entrati permezz ta’ kwalunkwe waħda miż-żewġ interfaċċi; il-metodu li tuża biex iżżid sit ma jorbtux ma’ dak il-metodu.
Aqleb bejn siti permessi u siti mblukkati
Lista waħda biss jista’ jkollha entrati fi kwalunkwe ħin. Qabel iżżid entrati fil-modalità l-oħra, battal il-lista eżistenti u ssejvja dik il-bidla. Imbagħad agħżel il-modalità l-oħra, żid il-ġabriet maħsuba u erġa’ ssejvja.
Meta tbattal il-lista attiva, l-aċċess jinbidel minnufih malli tissejvja. Meta tbattal lista ta’ permessi, tneħħi r-restrizzjoni tagħha fuq is-siti; meta tbattal lista ta’ imblukkar, tneħħi l-imblukkar tagħha. Ippjana t-tranżizzjoni ma’ amministraturi oħra, għax il-ħin bejn meta tbattal lista u tissejvja l-oħra jista’ jippermetti aċċess li l-politika finali tiegħek se tirrestrinġi.
Tella’ ġabriet ta’ siti minn CSV
It-tlugħ ta’ CSV jappoġġja biss ġabriet ta’ siti. Biex teskludi fajls skont it-tikketta tas-sensittività, żid il-GUIDs tat-tikketti taħt Tikketti tas-sensittività esklużi mingħajr kriptaġġ.
Iftaħ il-Kontrolli tas-sikurezza u s-sigurtà u agħżel il-Modalità tal-aċċess mixtieqa.
Ipprepara CSV b’GUIDs ta’ ġabriet ta’ siti jew IDs tas-siti ta’ Microsoft Graph bi tliet komponenti. Uża format wieħed ta’ identifikaturi fil-fajl kollu.
Agħżel Tella’ fajl CSV u agħżel il-fajl.
Irrevedi r-riżultat tal-importazzjoni u l-lista magħżula. Irranġa kwalunkwe żball jew twissija fir-ringieli qabel tkompli.
Agħżel Issejvja biex tapplika l-bidliet, imbagħad iċċekkja l-lista ssejvjata.
Rekwiżiti u mġiba tas-CSV:
Daqs massimu tal-fajl: 1 MB.
L-intestaturi huma fakultattivi.
Uża GUID wieħed ta’ ġabra għal kull ringiela, jew IDs tas-siti ta’ Graph bi tliet komponenti. It-tliet komponenti jistgħu jitqiegħdu bejn virgoletti f’qasam wieħed jew jinqasmu fi tliet kolonni.
L-IDs ta’ Graph bi tliet komponenti jiġu kkonvertiti f’GUIDs ta’ ġabriet. L-importazzjoni ta’ ID bi tliet komponenti ma toħloqx regola għal sit speċifiku.
L-importazzjonijiet iżidu entrati mal-lista magħżula u jżommu l-entrati eżistenti. Il-ġabriet duplikati jingħaqdu f’entrata waħda; l-għadd tal-importazzjoni juri l-ġabriet li jkunu għadhom kemm żdiedu.
Formati mħallta u ringieli f’format ħażin jiġu rrifjutati. Jekk ittella’ fajl li fih biss URLs tas-siti, tintwera twissija u ma jiżdiedu l-ebda siti. L-ewwel sib il-GUIDs tal-ġabriet li jikkorrispondu għall-URLs.
It-tlugħ ta’ fajl ibiddel biss l-abbozz tal-lista. Ma jaġġornax l-aċċess tal-workspace sakemm tagħżel Issejvja.
It-tlugħ ta’ CSV deskritt hawn jimmaniġġja ġabriet ta’ siti. Ikkonfigura l-esklużjonijiet skont it-tikketti tas-sensittività separatament.
Jekk għandek CSV ta’ URLs ta’ SharePoint, il-fluss tax-xogħol tas-CSV fl-għodda tal-Cookbook jista’ jsib l-identifikaturi tagħhom u jimmaniġġja lista ta’ permessi permezz tal-API. L-input site_url jew url tagħha juża format u fluss tax-xogħol differenti mit-tlugħ ta’ identifikaturi fl-interfaċċa.
Ifhem il-limiti tal-politika u tat-talbiet
Il-limitu predefinit tal-politika huwa ta’ 10,000 ġabra ta’ siti. Limiti ogħla tal-politika tal-workspace, sa 120,000 ġabra ta’ siti, jeħtieġu attivazzjoni minn OpenAI; ikkuntattja lit-tim tiegħek ta’ OpenAI qabel tippjana implimentazzjoni akbar.
Operazzjonijiet individwali ta’ tibdil permezz tal-API u l-iskritt attwali tal-Cookbook jaċċettaw sa 10,000 GUID ta’ ġabriet għal kull talba. Limitu ogħla tal-politika tal-workspace ma jżidx dan il-limitu għal kull talba. Għodd il-ġabriet uniċi ta’ siti, mhux il-URLs tas-sors: diversi URLs jistgħu jirreferu għall-istess ġabra.
Uża l-API tal-amministrazzjoni tal-workspace
Uża l-UUID tal-workspace tiegħek u ċ-ċavetta tal-amministrazzjoni tal-workspace ta’ ChatGPT ma’ https://api.chatgpt.com.
Għal kmandi aġġornati tal-lista ta’ permessi u eżempji ta’ talbiet, uża l-Cookbook:
Agħti daqqa t’għajn u żid ġabriet ta’ siti. Iż-żidiet iżommu l-ġabriet permessi eżistenti.
Irrevedi l-politika attwali qabel tagħmel bidliet, imbagħad erġa’ aqraha u ttestja l-aċċess li jirriżulta. Meta tneħħi l-aħħar ġabra permessa jew tbattal il-lista ta’ permessi, tneħħi dik ir-restrizzjoni fuq is-siti. Tibgħatx talba ta’ żieda vojta sakemm ma tkunx trid tneħħi r-restrizzjonijiet tal-lista ta’ permessi.
L-għodda pubblika tal-Cookbook bħalissa timmaniġġja listi ta’ permessi biss. Ma timmaniġġjax listi ta’ imblukkar jew esklużjonijiet skont it-tikketti tas-sensittività. Uża l-kontrolli tal-workspace deskritti hawn fuq għal dawn il-kompiti.
Eskludi fajls b’tikketti tas-sensittività
Sib il-GUID tat-tikketta
Itlob lill-amministratur tiegħek ta’ Microsoft 365 jew Purview il-GUID immutabbli tat-tikketta mixtieqa. Uża l-GUID, mhux l-isem li jintwera.
Amministratur jista’ jelenka t-tikketti permezz ta’ Microsoft Graph. It-token jeħtieġ il-permess applikabbli SensitivityLabel.Read jew SensitivityLabels.Read.All. Qabbel l-isem tat-tikketta mixtieqa mal-ID tagħha u ċċekkja s-settings tal-protezzjoni tagħha.
Għar-rekwiżiti u eżempji, ara Elenka t-tikketti tas-sensittività u Proprjetajiet tat-tikketta tas-sensittività. Dawn il-permessi tat-tikketti huma separati mill-permess tal-qari tas-siti użat biex jinstabu l-identifikaturi għal URLs ta’ SharePoint.
Żid esklużjonijiet skont it-tikketti
Iftaħ il-Kontrolli tas-sikurezza u s-sigurtà tal-app ta’ SharePoint.
Daħħal il-GUID ta’ kull tikketta mingħajr kriptaġġ taħt Tikketti tas-sensittività esklużi mingħajr kriptaġġ.
Issejvja l-konfigurazzjoni u ttestja fajl appoġġjat bit-tikketta eskluża.
Fajls b’tikketti appoġġjati li jaqblu jiġu esklużi mir-riżultati tal-app ta’ SharePoint. Fajls b’tikketti li japplikaw il-kriptaġġ huma diġà esklużi b’mod awtomatiku.
Ittestja l-konfigurazzjoni tiegħek
Uża fajls u kontijiet tat-test approvati mill-organizzazzjoni tiegħek. Qabel l-ittestjar, ikkonferma li l-istess kont ta’ Microsoft għandu aċċess għal kull fajl direttament f’SharePoint.
Fil-modalità Siti permessi b’lista li mhix vojta, iċċekkja fajl f’ġabra permessa u fajl f’ġabra li mhix fil-lista. Il-ġabra permessa biss għandha tkun aċċessibbli permezz tal-app.
Fil-modalità Siti mblukkati, iċċekkja fajl f’ġabra mblukkata u fajl f’ġabra li mhix imblukkata. Il-ġabra mblukkata m’għandhiex tkun disponibbli; il-ġabra li mhix imblukkata tibqa’ soġġetta għall-permessi ta’ Microsoft u kontrolli oħra.
Iċċekkja fajl tat-test appoġġjat li għandu tikketta tas-sensittività eskluża. M’għandux jidher fir-riżultati tal-app.
Wara bidla permezz tal-API, qabbel il-lista ssejvjata fl-interfaċċa mal-politika mogħtija mill-API.
Wara li ttella’ CSV, issejvja l-bidliet u erġa’ iftaħ il-kontrolli biex tikkonferma li l-ġabriet maħsuba nżammu.
Jekk ir-riżultati jvarjaw mill-politika maħsuba, iċċekkja l-workspace, il-modalità tal-aċċess magħżula, il-lista ssejvjata, il-GUIDs tal-ġabriet, il-GUIDs tat-tikketti, it-tip ta’ fajl appoġġjat u l-permessi ta’ Microsoft tal-utent. Tbattalx lista biex issolvi problema sakemm ma tkunx trid il-bidla fl-aċċess li tirriżulta minn dan.
Għal għajnuna b’kontrolli neqsin jew aċċess mhux mistenni, ara: Kif tikkuntattja l-Appoġġ ta’ OpenAI. Tinkludix ċwievet tal-amministrazzjoni jew tokens ta’ Microsoft Graph fit-talba tiegħek għall-appoġġ.
Ifhem il-limitazzjonijiet
Regola dwar ġabra tkopri l-ġabra ta’ siti kollha. Ma tistax tillimita l-aċċess għal sottosit, fowlder jew fajl partikolari.
Ir-restrizzjonijiet fuq is-siti ta’ SharePoint ma jirrestrinġux awtomatikament l-aċċess għal OneDrive.
Il-filtrazzjoni skont it-tikketti tas-sensittività tapplika biss fejn Microsoft Graph jagħmel disponibbli metadata tat-tikketti appoġġjata, inkluż f’dokumenti ta’ Office u fajls PDF u MP4 appoġġjati.
Tipi ta’ fajls li mhumiex appoġġjati għat-tikketti tas-sensittività, bħal fajls TXT u CSV, jitqiesu bħala fajls mingħajr tikketta. Jibqgħu aċċessibbli jekk ikunu permessi mill-kontrolli l-oħra. Din il-limitazzjoni fuq it-tip ta’ fajl hija separata mit-tlugħ ta’ CSV biex jiġi kkonfigurat l-aċċess għas-siti.
La t-tlugħ ta’ CSV u lanqas l-għodda pubblika ta’ eżempju ma jikkonfiguraw esklużjonijiet skont it-tikketti tas-sensittività. Dan l-artiklu ma jiddokumentax API għall-ġestjoni tat-tikketti bil-massa.
Politika ssejvjata jew tweġiba mill-API li tindika suċċess ma tiħux post l-ittestjar tal-aċċess bil-kont maħsub.
Uża l-għodda ta’ amministrazzjoni f’Python
Il-kodiċi u l-kmandi sħaħ tal-eżempju jinżammu aġġornati fl-OpenAI Cookbook:
Uża Python 3.10 jew verżjoni aktar ġdida. L-għodda tuża l-librerija standard ta’ Python. Aqra l-gwida qabel tħaddimha u uża simulazzjonijiet biex tirrevedi l-bidliet.
L-għodda attwali taqra l-kredenzjali minn varjabbli tal-ambjent; uża l-istruzzjonijiet fil-gwida biex iddaħħalhom b’mod sigur. Teħtieġ konferma espliċita biex tbattal lista ta’ permessi. Tneħħija tista’ titwettaq mingħajr dik il-konferma, għalhekk irrevediha l-ewwel b’simulazzjoni.
Għall-imġiba meta terġa’ tipprova u ċ-ċwievet fakultattivi tal-idempotenza, ara Erġa’ pprova aġġornament tal-politika b’mod sigur. Uża ċ-ċwievet tal-idempotenza biss meta l-workspace jappoġġjahom, u spezzjona l-politika attwali wara falliment b’riżultat mhux ċar.
L-għodda ma tattivax karatteristiċi tal-workspace u lanqas tivverifika jekk ir-regoli humiex qed jiġu infurzati. It-testijiet offline tagħha jużaw sejħiet simulati lil Microsoft Graph u lill-API tal-amministrazzjoni ta’ ChatGPT.
Bidliet b’diversi talbiet mhumiex atomiċi. Jekk it-tneħħija ta’ diversi ġabriet tfalli f’nofs il-proċess, xi tneħħijiet preċedenti jistgħu jkunu diġà rnexxew. Aqra l-politika attwali qabel terġa’ tipprova.
Mistoqsijiet frekwenti
Il-kontrolli tas-siti jieħdu post il-permessi ta’ Microsoft?
Le. L-app tibqa’ tuża l-permessi ta’ Microsoft ta’ kull utent. OpenAI tapplika l-filtrazzjoni tas-siti kkonfigurata qabel ma t-tweġibiet jintwerew lill-utent u lill-mudell.
Lista ta’ permessi vojta timblokka s-siti kollha?
Le. Lista ta’ permessi vojta ma tfissirx “imblokka kollox”. Jekk lista ta’ imblukkar ikollha entrati, dawk il-ġabriet jibqgħu mblukkati. Meta l-ebda lista ma jkollha entrati, il-permessi ta’ Microsoft tal-utenti u kontrolli oħra kkonfigurati jiddeterminaw l-aċċess.
Il-bidliet permezz tal-API tal-amministrazzjoni jiġu rreġistrati?
Il-bidliet fil-politika permezz tal-API tal-amministrazzjoni jiġu rreġistrati fir-reġistri tal-awditjar u tal-konformità tal-workspace.
