Yfirlit

Stjórnendur vinnusvæða geta notað SharePoint-stýringar til að leyfa samþykkt vefsvæðasöfn, loka völdum vefsvæðasöfnum og útiloka studdar skrár með völdum trúnaðarmerkingum Microsoft Purview.

SharePoint-vefsvæðasafn, einnig kallað SPSite, getur innihaldið mörg vefsvæði. Safnregla gildir um allt safnið, með fyrirvara um núverandi Microsoft-heimildir hvers notanda. Hún veitir notanda ekki aðgang að efni sem hann hefur ekki aðgang að í Microsoft 365.

Takmarkanir á vefsvæðum gilda um studda leit, vöfrun, skráasókn og lestrar- og skrifaðgerðir í SharePoint. Aðgangi að OneDrive er stjórnað sérstaklega.

Veldu aðgangshaminn sem samræmist stefnunni þinni:

• Leyfð vefsvæði: Ef leyfislistinn er ekki tómur geta notendur aðeins nálgast vefsvæðasöfnin á listanum í gegnum appið.

• Lokuð vefsvæði: Notendur geta nálgast önnur vefsvæðasöfn en þau sem eru á bannlistanum, í samræmi við Microsoft-heimildir sínar.

Aðeins annar listinn getur innihaldið færslur í einu. Tómur leyfislisti lokar ekki öllum vefsvæðum. Þegar báðir listar eru tómir falla takmarkanir á SharePoint-vefsvæðum niður; Microsoft-heimildir og aðrar uppsettar stýringar gilda áfram.

Framboð

Virkja þarf stýringarnar og Admin API vinnusvæðisins fyrir þitt vinnusvæði. Tiltækar stýringar fela í sér leyfislista og bannlista fyrir vefsvæðasöfn, CSV-innflutning vefsvæða og útilokanir eftir trúnaðarmerkingum.

Reglur gilda um heil vefsvæðasöfn. Þessar stýringar fyrir vefsvæðasöfn fela ekki í sér afmörkun við einstök vefsvæði, möppur eða skrár né framfylgd Microsoft Sites.Selected.

Áður en þú byrjar

• Ákveddu hvaða vefsvæðasöfn fyrirtækið þitt vill leyfa eða loka.

• Útvegaðu GUID-auðkenni hvers safns. Í fullu Microsoft Graph-vefsvæðisauðkenni er GUID-auðkenni safnsins miðgildið. Admin API notar GUID-auðkenni safna; CSV-innflutningur í notendaviðmótinu getur einnig dregið þau út úr þríþættum Graph-vefsvæðisauðkennum.

• Virkjaðu Microsoft-heimildirnar sem SharePoint-appið krefst bæði í heimildastillingum ChatGPT og í Microsoft Entra, þar á meðal Sites.Read.All og Files.Read.All. Þessar stýringar sía aðgang hjá OpenAI; þær koma ekki í stað framseldra heimilda Microsoft.

• Fyrir útilokanir eftir trúnaðarmerkingum skaltu biðja Microsoft 365- eða Purview-stjórnandann þinn um óbreytanlegt GUID-auðkenni hverrar merkingar án dulkóðunar.

• Fyrir stjórnun í gegnum API skaltu útvega UUID-auðkenni vinnusvæðisins, stjórnandalykil ChatGPT-vinnusvæðisins og Microsoft Graph-aðgangstákn ef þú þarft að fletta upp auðkennum SharePoint-vefslóða. Þessar tvenns konar aðgangsupplýsingar þjóna ólíkum tilgangi.

Um OpenAI Cookbook

OpenAI Cookbook er opinbert safn OpenAI með dæmikóða og leiðbeiningum. Þessi grein styðst við leiðbeiningar safnsins um aðgang að SharePoint-vefsvæðum og Python-stjórnunarskriftuna, sem hvort tveggja er hýst á GitHub. Þú getur opnað þessa tengla í vafranum til að lesa skrárnar. Til að keyra skriftuna skaltu sækja hana og fylgja leiðbeiningunum um uppsetningu og skipanir.

Í þessari grein vísar „Cookbook“ til þessara SharePoint-leiðbeininga og „Cookbook-forritið“ til Python-skriftunnar sem tengt er á. Notaðu þessi gögn fyrir dæmi um skipanir og stjórnun leyfislista í gegnum API.

Settu upp aðgangsupplýsingar fyrir stjórnun í gegnum API

Athugaðu: Þú þarft að vera stjórnandi vinnusvæðis til að geta búið til stjórnandalykla. Lesa meira.

Búðu til stjórnandalykil fyrir ChatGPT-vinnusvæði

1. Opnaðu stjórnborð ChatGPT og veldu viðkomandi vinnusvæði.

2. Farðu í Aðgangsupplýsingar og veldu Stjórnandalyklar.

3. Búðu til lykil með heimildastillingunni Takmarkað og stilltu Öpp á Skrifa.

4. Geymdu lykilinn á öruggum stað. Þessi lykill veitir heimild til að lesa og breyta SharePoint-stefnu vinnusvæðisins þíns.

Nauðsynleg heimild er chatgpt.enterprise.apps.write. Athugaðu að hvorki lykill fyrir API Platform né Microsoft Graph-aðgangstákn getur komið í stað stjórnandalykils ChatGPT-vinnusvæðis.

Nánari upplýsingar: Stjórnun stjórnandalykla á flipanum Aðgangsupplýsingar. Upplýsingar um umhverfisbreytur skriftunnar fyrir aðgangsupplýsingar og dæmi um öruggan innslátt má finna í leiðbeiningum Cookbook um aðgangsupplýsingar.

Útvegaðu Microsoft Graph-aðgangstákn

Notaðu Microsoft-auðkenningarferlið sem fyrirtækið þitt hefur samþykkt. Til að fletta upp í gagnvirku viðmóti, ef fyrirtækið þitt leyfir Graph Explorer:

1. Opnaðu Microsoft Graph Explorer og skráðu þig inn með vinnureikningi í leigjandanum sem hýsir SharePoint-vefsvæðin.

2. Veldu heimildirnar sem þarf til að lesa vefsvæðin, yfirleitt Sites.Read.All, með Breyta heimildum eða Samþykkja heimildir. Biddu Microsoft-stjórnandann þinn um að samþykkja aðgang ef fyrirtækið þitt krefst þess.

3. Opnaðu flipann Aðgangstákn og afritaðu táknið til að nota með Microsoft Graph.

Leiðbeiningar Microsoft má finna í Unnið með Graph Explorer.

Graph-aðgangstáknið er notað til að fletta upp auðkennum út frá SharePoint-vefslóðum. ChatGPT-stjórnandalykillinn er notaður til að lesa eða uppfæra ChatGPT-stefnuna. Cookbook-forritið þarf Graph-aðgangstáknið aðeins fyrir skipanir sem fletta upp auðkennum vefslóða; til að lesa eða tæma núverandi leyfislista þarf aðeins ChatGPT-stjórnandalykilinn.

Ekki setja þessar aðgangsupplýsingar í útgáfustýringu, sameiginleg skjöl, skjámyndir eða annála.

Finndu GUID-auðkenni vefsvæðasafns

Notaðu vefslóð SharePoint-vefsvæðisins

1. Opnaðu SharePoint-vefsvæðið með Microsoft-reikningi sem hefur aðgang að því.

2. Bættu /_api/site/id aftan við vefslóð vefsvæðisins. Notaðu til dæmis https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Afritaðu GUID-auðkennið sem kemur í svarinu.

Athugaðu: Lén og auðkenni í dæmum þessarar greinar eru staðgenglar.

Notaðu Microsoft Graph

Microsoft Graph skilar vefsvæðisauðkenni með þremur hlutum aðskildum með kommum: hýsilheitinu, GUID-auðkenni vefsvæðasafnsins og GUID-auðkenni vefsvæðisins. Notaðu miðgildið í reglu fyrir vefsvæðasafn. Mismunandi vefslóðir geta vísað á sama GUID-auðkenni safns.

Dæmi um uppflettingu og auðkenni má finna í Auðkenni SharePoint-vefsvæða útskýrð. Til að fletta upp auðkennum fyrir margar vefslóðir án þess að breyta ChatGPT-stefnunni skaltu nota skoðunarleiðbeiningar í Cookbook og Python-stjórnunarskriftuna.

Kröfur Microsoft um uppflettingu má finna í Sækja SharePoint-vefsvæði eftir slóð.

Stjórnaðu leyfðum og lokuðum vefsvæðasöfnum

Notaðu stýringar vinnusvæðisins

1. Opnaðu Öryggis- og verndarstýringar SharePoint-appsins á vinnusvæðinu þínu.

2. Undir Aðgangshamur skaltu velja Leyfð vefsvæði eða Lokuð vefsvæði.

3. Bættu vefsvæðasöfnunum á valda listann. Þú getur einnig notað CSV-upphleðsluna sem lýst er hér að neðan.

4. Yfirfarðu breytingarnar og veldu Vista.

5. Athugaðu vistuðu stefnuna og prófaðu stillingarnar.

Vefsvæði sem bætt er við í gegnum Admin API birtast í stýringum vinnusvæðisins. Vefsvæði sem bætt er við í notendaviðmótinu eru einnig aðgengileg í gegnum API-ið. Þú getur bætt við eða fjarlægt færslur á báðum stöðum; aðferðin sem notuð er til að bæta vefsvæði við bindur það ekki við þá aðferð.

Skiptu á milli leyfðra og lokaðra vefsvæða

Aðeins annar listinn getur innihaldið færslur í einu. Áður en þú bætir við færslum í hinum hamnum skaltu tæma núverandi lista og vista þá breytingu. Veldu síðan hinn haminn, bættu við tilætluðum söfnum og vistaðu aftur.


Þegar virki listinn er tæmdur breytist aðgangurinn um leið og breytingin er vistuð. Ef leyfislisti er tæmdur falla takmarkanir hans á vefsvæðum niður; ef bannlisti er tæmdur falla lokanir hans niður. Skipuleggðu skiptin með öðrum stjórnendum því á tímabilinu frá því að annar listinn er tæmdur þar til hinn er vistaður gæti verið veittur aðgangur sem lokastefnan mun takmarka.

Hladdu upp vefsvæðasöfnum úr CSV-skrá

CSV-upphleðsla styður aðeins vefsvæðasöfn. Til að útiloka skrár eftir trúnaðarmerkingu skaltu bæta GUID-auðkennum merkinganna við undir Útilokaðar trúnaðarmerkingar án dulkóðunar.

1. Opnaðu Öryggis- og verndarstýringar og veldu þann Aðgangsham sem þú vilt nota.

2. Útbúðu CSV-skrá með GUID-auðkennum vefsvæðasafna eða þríþættum Microsoft Graph-vefsvæðisauðkennum. Notaðu sama auðkennissnið í allri skránni.

3. Veldu Hlaða upp CSV-skrá og veldu skrána.

4. Yfirfarðu niðurstöðu innflutningsins og valda listann. Leystu úr villum eða viðvörunum fyrir raðir áður en þú heldur áfram.

5. Veldu Vista til að virkja breytingarnar og athugaðu síðan vistaða listann.

Kröfur og virkni CSV-upphleðslu:

• Hámarksstærð skráar: 1 MB.

• Dálkahausar eru valfrjálsir.

• Notaðu eitt GUID-auðkenni safns í hverri röð eða þríþætt Graph-vefsvæðisauðkenni. Þríþætt auðkenni geta verið innan gæsalappa í einum reit eða skipt á þrjá dálka.

• Þríþættum Graph-auðkennum er breytt í GUID-auðkenni safna. Innflutningur á þríþættu auðkenni býr ekki til reglu fyrir einstakt vefsvæði.

• Við innflutning er bætt á valda listann og núverandi færslur varðveittar. Tvítekin söfn eru sameinuð; fjöldinn sem birtist við innflutning segir til um söfn sem nýlega var bætt við.

• Blönduðum sniðum og röðum á röngu sniði er hafnað. Ef upphlaðin skrá inniheldur aðeins vefslóðir birtist viðvörun og engum vefsvæðum er bætt við. Flettu fyrst upp GUID-auðkennum safna út frá vefslóðunum.

• Upphleðsla breytir aðeins drögum að listanum. Hún uppfærir ekki aðgang á vinnusvæðinu fyrr en þú velur Vista.

• CSV-upphleðslan sem hér er lýst er notuð til að stjórna vefsvæðasöfnum. Stilltu útilokanir eftir trúnaðarmerkingum sérstaklega.

Ef þú ert með CSV-skrá með SharePoint-vefslóðum geturðu notað CSV-vinnuferli Cookbook-forritsins til að fletta upp auðkennum þeirra og stjórna leyfislista í gegnum API-ið. Inntak þess, site_url eða url, notar annað snið og vinnuferli en upphleðsla auðkenna í notendaviðmótinu.

Kynntu þér hámarksmörk stefna og beiðna

Sjálfgefið hámark í stefnu er 10.000 vefsvæðasöfn. OpenAI þarf að virkja hærri hámarksmörk fyrir stefnu vinnusvæðis, allt að 120.000 vefsvæðasöfnum; hafðu samband við tengiliði þína hjá OpenAI áður en þú skipuleggur stærri innleiðingu.

Einstakar breytingaaðgerðir í API-inu og núverandi Cookbook-skrifta taka við allt að 10.000 GUID-auðkennum safna í hverri beiðni. Hærra hámark fyrir stefnu vinnusvæðis hækkar ekki þetta hámark fyrir hverja beiðni. Teldu einstök vefsvæðasöfn, ekki upprunalegar vefslóðir: margar vefslóðir geta vísað á sama safnið.

Notaðu Admin API vinnusvæðisins

Notaðu UUID-auðkenni vinnusvæðisins og stjórnandalykil ChatGPT-vinnusvæðisins með https://api.chatgpt.com.

Í Cookbook er að finna uppfærðar skipanir fyrir leyfislista og dæmi um beiðnir:

• Lesa núverandi leyfislista.

• Forskoða og bæta við vefsvæðasöfnum. Þegar söfnum er bætt við haldast þau söfn sem fyrir eru áfram leyfð.

• Fjarlægja vefsvæðasafn.

• Tæma leyfislistann.

Yfirfarðu núverandi stefnu áður en þú gerir breytingar, lestu hana síðan aftur og prófaðu aðganginn sem af þeim leiðir. Ef síðasta leyfða safnið er fjarlægt eða leyfislistinn tæmdur fellur sú takmörkun á vefsvæðum niður. Ekki senda tóma viðbótarbeiðni nema þú ætlir að afnema takmarkanir leyfislistans.

Opinbera Cookbook-forritið stjórnar sem stendur aðeins leyfislistum. Það stjórnar hvorki bannlistum né útilokunum eftir trúnaðarmerkingum. Notaðu stýringar vinnusvæðisins sem lýst er hér að ofan fyrir þau verkefni.

Útilokaðu skrár með trúnaðarmerkingum

Finndu GUID-auðkenni merkingarinnar

Biddu Microsoft 365- eða Purview-stjórnandann þinn um óbreytanlegt GUID-auðkenni viðkomandi merkingar. Notaðu GUID-auðkennið, ekki birtingarheitið.

Stjórnandi getur sótt lista yfir merkingar í gegnum Microsoft Graph. Aðgangstáknið þarf viðeigandi heimild, SensitivityLabel.Read eða SensitivityLabels.Read.All. Finndu auðkennið sem samsvarar heiti viðkomandi merkingar og athugaðu verndarstillingar hennar.

Kröfur og dæmi má finna í Sækja lista yfir trúnaðarmerkingar og Eiginleikar trúnaðarmerkinga. Þessar heimildir fyrir merkingar eru aðskildar frá lesheimild vefsvæða sem er notuð til að fletta upp auðkennum SharePoint-vefslóða.

Bættu við útilokunum eftir merkingum

1. Opnaðu Öryggis- og verndarstýringar SharePoint-appsins.

2. Sláðu inn GUID-auðkenni hverrar merkingar án dulkóðunar undir Útilokaðar trúnaðarmerkingar án dulkóðunar.

3. Vistaðu stillingarnar og prófaðu studda skrá með útilokuðu merkingunni.

Skrár með samsvarandi studdum merkingum eru útilokaðar frá niðurstöðum SharePoint-appsins. Skrár með merkingum sem beita dulkóðun eru þegar útilokaðar sjálfgefið.

Prófaðu stillingarnar

Notaðu prófunarskrár og reikninga sem fyrirtækið þitt hefur samþykkt. Áður en þú prófar skaltu staðfesta að sami Microsoft-reikningur hafi aðgang að hverri skrá beint í SharePoint.

1. Þegar Leyfð vefsvæði er valið og listinn er ekki tómur skaltu athuga skrá í leyfðu safni og skrá í safni sem er ekki á listanum. Aðeins leyfða safnið ætti að vera aðgengilegt í gegnum appið.

2. Þegar Lokuð vefsvæði er valið skaltu athuga skrá í lokuðu safni og skrá í safni sem er ekki lokað. Lokaða safnið ætti að vera óaðgengilegt; aðgangur að safninu sem er ekki lokað er áfram háður Microsoft-heimildum og öðrum stýringum.

3. Athugaðu studda prófunarskrá með útilokaðri trúnaðarmerkingu. Hún ætti ekki að birtast í niðurstöðum appsins.

4. Eftir breytingu í gegnum API skaltu bera vistaða listann í notendaviðmótinu saman við stefnuna sem API-ið skilar.

5. Eftir CSV-upphleðslu skaltu vista breytingarnar og opna stýringarnar aftur til að staðfesta að tilætluð söfn hafi verið varðveitt.

Ef niðurstöðurnar samræmast ekki tilætlaðri stefnu skaltu athuga vinnusvæðið, valda aðgangshaminn, vistaða listann, GUID-auðkenni safna og merkinga, stuðning við skráargerðina og Microsoft-heimildir notandans. Ekki tæma lista við bilanaleit nema þú ætlir að breyta aðgangi eins og af því leiðir.

Til að fá hjálp vegna stýringa sem vantar eða óvænts aðgangs skaltu skoða: Hafa samband við þjónustuver OpenAI. Ekki láta stjórnandalykla eða Microsoft Graph-aðgangstákn fylgja þjónustubeiðninni.

Kynntu þér takmarkanirnar

• Safnregla nær yfir allt vefsvæðasafnið. Hún getur ekki takmarkað aðgang við tiltekið undirsvæði, möppu eða skrá.

• Takmarkanir á SharePoint-vefsvæðum takmarka ekki sjálfkrafa aðgang að OneDrive.

• Síun eftir trúnaðarmerkingum á aðeins við þegar Microsoft Graph veitir aðgang að studdum lýsigögnum merkinga, þar á meðal fyrir studd Office-skjöl, PDF- og MP4-skrár.

• Skráargerðir sem styðja ekki trúnaðarmerkingar, svo sem TXT- og CSV-skrár, eru meðhöndlaðar sem ómerktar. Þær eru áfram aðgengilegar ef aðgangur er að öðru leyti heimill. Þessi takmörkun á skráargerðum er óháð því að hlaða upp CSV-skrá til að stilla aðgang að vefsvæðum.

• Hvorki CSV-upphleðsla né opinbera dæmiforritið stillir útilokanir eftir trúnaðarmerkingum. Þessi grein lýsir ekki API fyrir fjöldastjórnun merkinga.

• Vistuð stefna eða svar um að API-beiðni hafi tekist kemur ekki í stað þess að prófa aðgang með viðkomandi reikningi.

Notaðu Python-stjórnunarforritið

Dæmikóðanum í heild og skipunum er viðhaldið í OpenAI Cookbook:

• Stjórnunarleiðbeiningar.

• Python-stjórnunarskrifta.

• Prófunarskrá fyrir prófanir án nettengingar.

Notaðu Python 3.10 eða nýrra. Forritið notar staðalsafn Python. Lestu leiðbeiningarnar áður en þú keyrir það og notaðu prufukeyrslur til að yfirfara breytingar.

Núverandi útgáfa forritsins les aðgangsupplýsingar úr umhverfisbreytum; fylgdu leiðbeiningunum um örugga innsláttaraðferð. Það krefst skýrrar staðfestingar áður en leyfislisti er tæmdur. Færsla getur verið fjarlægð án þeirrar staðfestingar, svo yfirfarðu slíka aðgerð fyrst með prufukeyrslu.

Upplýsingar um endurtilraunir og valfrjálsa ídempótenslykla má finna í Endurtaka stefnuuppfærslu á öruggan hátt. Notaðu ídempótenslykla aðeins þegar vinnusvæðið styður þá og skoðaðu núverandi stefnu eftir villu ef óljóst er hvort aðgerðin tókst.

Forritið virkjar ekki eiginleika vinnusvæðisins og staðfestir ekki að reglunum sé framfylgt. Prófanir þess án nettengingar nota hermdar Microsoft Graph- og ChatGPT Admin API-kallanir.

Breytingar sem krefjast margra beiðna eru ekki framkvæmdar sem ein óskipt aðgerð. Ef aðgerð til að fjarlægja mörg söfn mistekst í miðju ferli gætu einhver söfn þegar hafa verið fjarlægð. Lestu núverandi stefnu áður en þú reynir aftur.

Algengar spurningar

Koma stýringar vefsvæða í stað Microsoft-heimilda?

Nei. Appið notar áfram Microsoft-heimildir hvers notanda. OpenAI beitir uppsettri síun vefsvæða áður en notandinn og líkanið fá svörin.

Lokar tómur leyfislisti öllum vefsvæðum?

Nei. Tómur leyfislisti þýðir ekki „loka öllu“. Ef bannlisti inniheldur færslur eru þau söfn áfram lokuð. Þegar hvorugur listinn inniheldur færslur ráðast aðgangsheimildir af Microsoft-heimildum notenda og öðrum uppsettum stýringum.

Eru breytingar í gegnum Admin API skráðar?

Stefnubreytingar í gegnum Admin API eru skráðar í úttektar- og regluvörsluannála vinnusvæðisins.