Yleiskatsaus
Työtilan ylläpitäjät voivat SharePoint-asetuksilla sallia hyväksytyt sivustokokoelmat, estää valitut sivustokokoelmat ja sulkea pois tuetut tiedostot, joilla on valitut Microsoft Purview -luottamuksellisuustunnisteet.
SharePoint-sivustokokoelma, jota kutsutaan myös nimellä SPSite, voi sisältää useita sivustoja. Kokoelmasääntö koskee koko kokoelmaa kunkin käyttäjän nykyisten Microsoft-käyttöoikeuksien puitteissa. Se ei anna käyttäjälle oikeutta sisältöön, jota hän ei voi käyttää Microsoft 365:ssä.
Sivustorajoitukset koskevat tuettuja SharePointin haku-, selaus-, tiedostonhaku- sekä luku- ja kirjoitustoimintoja. OneDriven käyttöä hallitaan erikseen.
Valitse käytäntöäsi vastaava käyttötila:
Sallitut sivustot: Kun sallittujen luettelossa on merkintöjä, käyttäjät voivat käyttää sovelluksen kautta vain luettelossa olevia sivustokokoelmia.
Estetyt sivustot: Käyttäjät voivat käyttää muita kuin estettyjen luettelossa olevia sivustokokoelmia Microsoft-käyttöoikeuksiensa puitteissa.
Vain yhdessä luettelossa voi olla merkintöjä kerrallaan. Tyhjä sallittujen luettelo ei estä kaikkia sivustoja. Kun molemmat luettelot ovat tyhjiä, SharePoint-sivustojen rajoitukset poistuvat. Microsoftin käyttöoikeudet ja muut määritetyt rajoitukset ovat edelleen voimassa.
Saatavuus
Asetukset ja työtilan Admin API on otettava erikseen käyttöön työtilassasi. Käytettävissä ovat sallittujen ja estettyjen sivustokokoelmien luettelot, sivustojen CSV-tuonti ja luottamuksellisuustunnisteisiin perustuvat poissulut.
Säännöt koskevat kokonaisia sivustokokoelmia. Nämä sivustokokoelmien asetukset eivät sisällä tarkkaa rajausta yksittäiseen sivustoon, kansioon tai tiedostoon eivätkä Microsoft Sites.Selected -käyttöoikeuden valvontaa.
Ennen aloittamista
Selvitä, mitkä sivustokokoelmat organisaatiosi haluaa sallia tai estää.
Hanki kunkin kokoelman GUID-tunnus. Microsoft Graphin täydellisen sivustotunnuksen keskimmäinen arvo on kokoelman GUID-tunnus. Admin API käyttää kokoelmien GUID-tunnuksia. Käyttöliittymän CSV-tuontitoiminto voi myös poimia ne Graphin kolmiosaisista sivustotunnuksista.
Ota SharePoint-sovelluksen tarvitsemat Microsoft-käyttöoikeudet, kuten
Sites.Read.AlljaFiles.Read.All, käyttöön sekä ChatGPT:n käyttöoikeusasetuksissa että Microsoft Entrassa. Nämä asetukset rajaavat pääsyä OpenAI:n puolella. Ne eivät korvaa Microsoftin delegoituja käyttöoikeuksia.Pyydä luottamuksellisuustunnisteisiin perustuvia poissulkemisia varten Microsoft 365- tai Purview-järjestelmänvalvojalta kunkin poissuljettavan tunnisteen muuttumaton GUID-tunnus, myös salausta käyttävien tunnisteiden osalta.
Hanki API-hallintaa varten työtilasi UUID-tunnus, ChatGPT-työtilan järjestelmänvalvoja-avain ja Microsoft Graph -käyttöoikeustietue, jos sinun on selvitettävä SharePointin URL-osoitteita vastaavat tunnukset. Näillä kahdella tunnistetiedolla on eri käyttötarkoitukset.
Tietoa OpenAI Cookbookista
OpenAI Cookbook on OpenAI:n julkinen esimerkkikoodien ja oppaiden kokoelma. Tässä artikkelissa käytetään sen SharePoint-sivustojen käytön hallintaopasta ja Python-hallintaskriptiä, jotka molemmat ovat GitHubissa. Voit lukea tiedostot avaamalla linkit selaimessa. Jos haluat suorittaa skriptin, lataa se ja noudata oppaan asennus- ja komento-ohjeita.
Tässä artikkelissa ”Cookbook” tarkoittaa kyseistä SharePoint-opasta ja ”Cookbook-työkalu” linkitettyä Python-skriptiä. Näistä lähteistä löydät komentoesimerkit ja ohjeet sallittujen luettelon hallintaan APIn kautta.
Määritä API-hallinnan tunnistetiedot
Huomautus: Sinun on oltava työtilan ylläpitäjä, jotta voit luoda ylläpitoavaimia. Lue lisää.
Luo ChatGPT-työtilan ylläpitoavain
Avaa ChatGPT:n hallintakonsoli ja valitse haluamasi työtila.
Siirry kohtaan Tunnistetiedot ja valitse Ylläpitoavaimet.
Luo avain, jonka käyttöoikeustaso on Rajoitettu, ja aseta kohdan Sovellukset arvoksi Kirjoitus.
Säilytä avain turvallisesti. Tämä avain antaa oikeuden lukea ja muuttaa työtilasi SharePoint-käytäntöä.
Vaadittu käyttöoikeus on chatgpt.enterprise.apps.write. Huomaa, että API-alustan avain tai Microsoft Graph -käyttöoikeustietue ei voi korvata ChatGPT-työtilan ylläpitoavainta.
Lisätietoja on artikkelissa Ylläpitoavainten hallinta Tunnistetiedot-välilehdellä. Skriptin tunnistetietojen ympäristömuuttujat ja esimerkki tietojen turvallisesta syöttämisestä ovat Cookbookin tunnistetieto-ohjeissa.
Hanki Microsoft Graph -käyttöoikeustietue
Käytä organisaatiosi hyväksymää Microsoft-todennusprosessia. Jos organisaatiosi sallii Graph Explorerin käytön, voit tehdä vuorovaikutteisen haun näin:
Avaa Microsoft Graph Explorer ja kirjaudu sisään SharePoint-sivustot sisältävän vuokraajan työtilillä.
Valitse sivustojen lukemiseen tarvittavat käyttöoikeudet, yleensä
Sites.Read.All, kohdasta Muokkaa käyttöoikeuksia tai Anna suostumus käyttöoikeuksiin. Pyydä Microsoft-ylläpitäjää hyväksymään käyttöoikeus, jos organisaatiosi edellyttää sitä.Avaa Käyttöoikeustietue-välilehti ja kopioi tietue Microsoft Graphia varten.
Microsoftin ohjeet ovat kohdassa Graph Explorerin käyttäminen.
Graph-käyttöoikeustietueella selvitetään SharePointin URL-osoitteita vastaavat tunnisteet. ChatGPT:n ylläpitoavaimella luetaan tai päivitetään ChatGPT-käytäntöä. Cookbook-työkalu tarvitsee Graph-käyttöoikeustietueen vain komentoihin, jotka selvittävät URL-osoitteita vastaavat tunnisteet. Nykyisen sallittujen luettelon lukemiseen tai tyhjentämiseen tarvitaan vain ChatGPT:n ylläpitoavain.
Älä tallenna kumpaakaan tunnistetietoa versionhallintaan, jaettuihin asiakirjoihin, näyttökuviin tai lokeihin.
Selvitä sivustokokoelman GUID-tunniste
Käytä SharePoint-sivuston URL-osoitetta
Avaa SharePoint-sivusto, kun olet kirjautunut Microsoftiin tilillä, jolla on sivuston käyttöoikeus.
Lisää sivuston URL-osoitteen loppuun
/_api/site/id. Käytä esimerkiksi osoitettahttps://contoso.sharepoint.com/sites/Finance/_api/site/id.Kopioi vastauksessa palautettu GUID-tunniste.
Huomautus: Tämän artikkelin esimerkkitoimialueet ja -tunnisteet ovat paikkamerkkejä.
Käytä Microsoft Graphia
Microsoft Graph palauttaa sivustotunnisteen, jossa on kolme pilkuin erotettua osaa: isäntänimi, sivustokokoelman GUID-tunniste ja sivuston GUID-tunniste. Käytä keskimmäistä arvoa sivustokokoelman säännössä. Eri sivustojen URL-osoitteet voivat vastata samaa kokoelman GUID-tunnistetta.
Esimerkkejä hauista ja tunnisteista on kohdassa Tietoa SharePoint-sivustojen tunnisteista. Voit selvittää useita URL-osoitteita vastaavat tunnisteet muuttamatta ChatGPT-käytäntöä käyttämällä Cookbookin tarkastusohjeita ja Python-hallintaskriptiä.
Microsoftin hakuvaatimukset ovat kohdassa SharePoint-sivuston hakeminen polun perusteella.
Hallitse sallittuja ja estettyjä sivustokokoelmia
Käytä työtilan asetuksia
Avaa työtilassasi SharePoint-sovelluksen Turvallisuus- ja suojausasetukset.
Valitse Käyttötila-kohdasta Sallitut sivustot tai Estetyt sivustot.
Lisää sivustokokoelmat valittuun luetteloon. Voit myös käyttää alla kuvattua CSV-latausta.
Tarkista muutokset ja valitse Tallenna.
Tarkista tallennettu käytäntö ja testaa määritys.
Admin API:n kautta lisätyt sivustot näkyvät työtilan asetuksissa. Käyttöliittymässä lisätyt sivustot ovat käytettävissä myös API:n kautta. Voit lisätä tai poistaa merkintöjä kummallakin tavalla. Sivuston lisäämistapa ei rajoita sen myöhempää hallintaa.
Vaihda sallittujen ja estettyjen sivustojen välillä
Vain yhdessä luettelossa voi olla merkintöjä kerrallaan. Ennen kuin lisäät merkintöjä toisessa tilassa, tyhjennä nykyinen luettelo ja tallenna muutos. Valitse sitten toinen tila, lisää haluamasi kokoelmat ja tallenna uudelleen.
Aktiivisen luettelon tyhjentäminen muuttaa pääsyä sivustoihin heti, kun muutos tallennetaan. Sallittujen luettelon tyhjentäminen poistaa sen asettaman sivustorajoituksen. Estettyjen luettelon tyhjentäminen poistaa sen asettamat estot. Suunnittele siirtymä yhdessä muiden järjestelmänvalvojien kanssa, sillä yhden luettelon tyhjentämisen ja toisen tallentamisen välisenä aikana pääsy voi olla sallittu kohteisiin, joita lopullinen käytäntö rajoittaa.
Lataa sivustokokoelmia CSV-tiedostosta
CSV-lataus tukee vain sivustokokoelmia. Jos haluat sulkea tiedostoja pois luottamuksellisuustunnisteen perusteella, lisää tunnisteiden GUID-tunnukset luottamuksellisuustunnisteiden poissulkemisluetteloon.
Avaa Turvallisuus- ja suojausasetukset ja valitse haluamasi Käyttötila.
Valmistele CSV-tiedosto, joka sisältää sivustokokoelmien GUID-tunnukset tai Microsoft Graphin kolmiosaiset sivustotunnukset. Käytä samaa tunnistemuotoa koko tiedostossa.
Valitse Lataa CSV-tiedosto ja valitse tiedosto.
Tarkista tuonnin tulos ja valittu luettelo. Korjaa mahdolliset rivikohtaiset virheet ja varoitusten syyt ennen jatkamista.
Ota muutokset käyttöön valitsemalla Tallenna ja tarkista sitten tallennettu luettelo.
CSV-tiedoston vaatimukset ja tuonnin toiminta:
Tiedoston enimmäiskoko: 1 Mt.
Otsikot ovat valinnaisia.
Käytä yhtä kokoelman GUID-tunnusta riviä kohden tai Graphin kolmiosaisia sivustotunnuksia. Kolmiosaiset tunnukset voivat olla lainausmerkeissä yhdessä kentässä tai jaettuina kolmeen sarakkeeseen.
Graphin kolmiosaiset tunnukset muunnetaan kokoelmien GUID-tunnuksiksi. Kolmiosaisen tunnuksen tuonti ei luo yksittäiseen sivustoon kohdistuvaa sääntöä.
Tuonti lisää merkintöjä valittuun luetteloon ja säilyttää nykyiset merkinnät. Kokoelmien kaksoiskappaleet poistetaan. Tuonnin lukumäärä kertoo uusien lisättyjen kokoelmien määrän.
Eri tunnistemuotojen yhdistelmät ja virheellisesti muotoillut rivit hylätään. Jos lataus sisältää vain sivustojen URL-osoitteita, näytetään varoitus eikä sivustoja lisätä. Selvitä ensin URL-osoitteita vastaavat kokoelmien GUID-tunnukset.
Lataus muuttaa vain luettelon luonnosta. Se ei muuta työtilan pääsyä sivustoihin ennen kuin valitset Tallenna.
Tässä kuvattu CSV-lataus on tarkoitettu sivustokokoelmien hallintaan. Määritä luottamuksellisuustunnisteisiin perustuvat poissulkemiset erikseen.
Jos sinulla on SharePointin URL-osoitteet sisältävä CSV-tiedosto, Cookbook-apuohjelman CSV-työnkululla voit selvittää niitä vastaavat tunnukset ja hallita sallittujen luetteloa API:n kautta. Sen site_url- tai url-syötteen muoto ja työnkulku eroavat käyttöliittymän tunnisteiden latauksesta.
Tutustu käytäntöjen ja pyyntöjen rajoihin
Käytännön oletusraja on 10 000 sivustokokoelmaa. Työtilan käytäntörajan nostaminen enintään 120 000 sivustokokoelmaan edellyttää OpenAI:n hyväksyntää ja käyttöönottoa. Ota yhteyttä OpenAI-tiimiisi ennen laajemman käyttöönoton suunnittelua.
Yksittäiset API-muutosoperaatiot ja nykyinen Cookbook-skripti hyväksyvät enintään 10 000 kokoelman GUID-tunnusta pyyntöä kohden. Työtilan korkeampi käytäntöraja ei nosta tätä pyyntökohtaista rajaa. Laske yksilölliset sivustokokoelmat, älä lähteen URL-osoitteita: useat URL-osoitteet voivat viitata samaan kokoelmaan.
Käytä työtilan Admin API:a
Käytä työtilasi UUID-tunnusta ja ChatGPT-työtilan järjestelmänvalvoja-avainta osoitteessa https://api.chatgpt.com.
Ajantasaiset sallittujen luettelon komennot ja pyyntöesimerkit löytyvät Cookbookista:
Esikatsele ja lisää sivustokokoelmia. Lisäykset säilyttävät nykyiset sallitut kokoelmat.
Tarkista nykyinen käytäntö ennen muutosten tekemistä. Lue se sitten uudelleen ja testaa, miten muutokset vaikuttavat pääsyyn. Viimeisen sallitun kokoelman poistaminen tai sallittujen luettelon tyhjentäminen poistaa kyseisen sivustorajoituksen. Älä lähetä tyhjää lisäyspyyntöä, ellet halua poistaa sallittujen luettelon rajoituksia.
Julkinen Cookbook-apuohjelma hallitsee tällä hetkellä vain sallittujen luetteloita. Se ei hallitse estettyjen luetteloita eikä luottamuksellisuustunnisteisiin perustuvia poissulkemisia. Käytä näihin tehtäviin edellä kuvattuja työtilan asetuksia.
Sulje tiedostoja pois luottamuksellisuustunnisteiden perusteella
Selvitä tunnisteen GUID
Pyydä Microsoft 365- tai Purview-ylläpitäjältä halutun tunnisteen muuttumaton GUID-tunniste. Käytä GUID-tunnistetta, älä näyttönimeä.
Ylläpitäjä voi hakea tunnisteluettelon Microsoft Graphin kautta. Käyttöoikeustietue tarvitsee soveltuvan SensitivityLabel.Read- tai SensitivityLabels.Read.All-käyttöoikeuden. Etsi halutun tunnisteen nimeä vastaava ID ja tarkista sen suojausasetukset.
Vaatimukset ja esimerkit ovat kohdissa Luottamuksellisuustunnisteiden luettelointi ja Luottamuksellisuustunnisteen ominaisuudet. Nämä tunnisteiden käyttöoikeudet ovat erillisiä sivustojen lukuoikeudesta, jolla selvitetään SharePointin URL-osoitteita vastaavat tunnisteet.
Lisää tunnisteisiin perustuvia poissulkemisia
Avaa SharePoint-sovelluksen Turvallisuus- ja suojausasetukset.
Lisää luottamuksellisuustunnisteiden poissulkemisluetteloon kunkin poissuljettavan tunnisteen GUID, myös salausta käyttävien tunnisteiden osalta.
Tallenna määritys ja testaa tuettua tiedostoa, jossa on poissuljettu tunniste.
Tiedostot, joiden tuetut tunnisteet vastaavat luettelon tunnisteita, suljetaan pois SharePoint-sovelluksen tuloksista. Salattujen tiedostojen sisältö suljetaan oletusarvoisesti pois. Tuettujen salattujen tiedostojen käyttö edellyttää sekä laajennettua tiedostojen käyttöä (fetch_advanced) että Microsoft Entra -järjestelmänvalvojan suostumusta, kuten alla olevissa usein kysytyissä kysymyksissä kuvataan. Tunnisteisiin perustuvat poissulkemiset ja yhteyden muodostaneen käyttäjän Microsoft-käyttöoikeudet ovat edelleen voimassa.
Testaa määritykset
Käytä organisaatiosi hyväksymiä testitiedostoja ja -tilejä. Varmista ennen testausta, että sama Microsoft-tili voi käyttää jokaista tiedostoa suoraan SharePointissa.
Kun Sallitut sivustot -tilan luettelossa on merkintöjä, testaa tiedostoa sallitussa kokoelmassa ja tiedostoa kokoelmassa, jota ei ole luettelossa. Vain sallitun kokoelman pitäisi olla käytettävissä sovelluksen kautta.
Testaa Estetyt sivustot -tilassa tiedostoa estetyssä kokoelmassa ja tiedostoa kokoelmassa, jota ei ole estetty. Estetyn kokoelman ei pitäisi olla käytettävissä. Estämättömään kokoelmaan sovelletaan edelleen Microsoftin käyttöoikeuksia ja muita rajoituksia.
Testaa tuettua testitiedostoa, jolla on poissuljettu luottamuksellisuustunniste. Sen ei pitäisi näkyä sovelluksen tuloksissa.
Vertaa API-muutoksen jälkeen käyttöliittymään tallennettua luetteloa APIn palauttamaan käytäntöön.
Tallenna muutokset CSV-latauksen jälkeen ja avaa asetukset uudelleen varmistaaksesi, että halutut kokoelmat säilyivät.
Jos tulokset poikkeavat tarkoitetusta käytännöstä, tarkista työtila, valittu käyttötila, tallennettu luettelo, kokoelmien GUID-tunnisteet, luottamuksellisuustunnisteiden GUID-tunnisteet, tiedostotyypin tuki ja käyttäjän Microsoft-käyttöoikeudet. Älä tyhjennä luetteloa vianmäärityksen yhteydessä, ellet halua siitä aiheutuvaa muutosta käyttöön.
Jos asetuksia puuttuu tai käyttöoikeudet toimivat odottamattomasti, katso Yhteydenotto OpenAI-tukeen. Älä sisällytä tukipyyntöön ylläpitoavaimia tai Microsoft Graph -käyttöoikeustietueita.
Huomioi rajoitukset
Kokoelmasääntö kattaa koko sivustokokoelman. Sillä ei voi rajata käyttöä tiettyyn alisivustoon, kansioon tai tiedostoon.
SharePoint-sivustojen rajoitukset eivät automaattisesti rajoita OneDriven käyttöä.
Luottamuksellisuustunnisteisiin perustuva suodatus koskee vain tiedostoja, joiden tuetut tunnisteiden metatiedot Microsoft Graph tuo saataville. Näitä ovat tuetut Office-asiakirjat sekä PDF- ja MP4-tiedostot.
Tiedostotyyppejä, jotka eivät tue luottamuksellisuustunnisteita, kuten TXT- ja CSV-tiedostoja, käsitellään tunnisteettomina. Ne ovat edelleen käytettävissä, jos käyttö on muutoin sallittua. Tämä tiedostotyyppirajoitus ei liity CSV-tiedoston lataamiseen sivustojen käyttöoikeuksien määrittämistä varten.
CSV-latauksella ja julkisella esimerkkityökalulla ei voi määrittää luottamuksellisuustunnisteisiin perustuvia poissulkuja. Tässä artikkelissa ei kuvata tunnisteiden massahallinnan APIa.
Tallennettu käytäntö tai onnistunut API-vastaus ei korvaa käytön testaamista tarkoitetulla tilillä.
Käytä Python-hallintatyökalua
Täydellistä esimerkkikoodia ja komentoja ylläpidetään OpenAI Cookbookissa:
Käytä Pythonin versiota 3.10 tai uudempaa. Työkalu käyttää Pythonin vakiokirjastoa. Lue opas ennen työkalun suorittamista ja tarkista muutokset koeajoilla.
Työkalun nykyinen versio lukee tunnistetiedot ympäristömuuttujista. Noudata oppaan ohjeita tietojen turvalliseen syöttämiseen. Sallittujen luettelon tyhjentäminen edellyttää erillistä vahvistusta. Poisto voi onnistua ilman tätä vahvistusta, joten tarkista poisto ensin koeajolla.
Tietoa uudelleenyritysten toiminnasta ja valinnaisista idempotenssiavaimista on kohdassa Käytännön päivityksen turvallinen uudelleenyritys. Käytä idempotenssiavaimia vain, jos työtila tukee niitä, ja tarkista nykyinen käytäntö epäselvän virhetilanteen jälkeen.
Työkalu ei ota työtilan ominaisuuksia käyttöön eikä varmista rajoitusten toteutumista. Sen offline-testit käyttävät simuloituja Microsoft Graph- ja ChatGPT Admin API -kutsuja.
Useasta pyynnöstä koostuvat muutokset eivät ole atomisia. Jos usean kokoelman poisto epäonnistuu kesken suorituksen, aiemmat poistot ovat saattaneet jo onnistua. Lue nykyinen käytäntö ennen uudelleenyritystä.
Usein kysytyt kysymykset
Pitäisikö salausta käyttävät luottamuksellisuustunnisteet lisätä poissulkemisluetteloon?
Kyllä. Lisää kaikki Microsoft Purview -luottamuksellisuustunnisteet, joiden tiedostot haluat ChatGPT:n sulkevan pois, myös salausta käyttävät tunnisteet.
Salattujen tiedostojen sisältö suljetaan oletusarvoisesti pois. Tuettujen salattujen tiedostojen käytön salliminen edellyttää, että työtilan järjestelmänvalvoja ottaa käyttöön laajennetun tiedostojen käytön (fetch_advanced) ja Microsoft Entra -järjestelmänvalvoja antaa suostumuksen tarvittaviin Microsoft-käyttöoikeuksiin. Pelkkä toiminnon käyttöönotto ilman järjestelmänvalvojan suostumusta ei riitä.
Myös määritysten tekemisen jälkeen ChatGPT voi hakea salattua sisältöä vain, jos yhteyden muodostaneella käyttäjällä on oikeus käyttää tiedostoa ja purkaa sen salaus. Tiedostot, joissa on poissulkemisluetteloon kuuluva tunniste, pysyvät poissuljettuina. Laajennetun tiedostojen käytön käyttöönotto tai järjestelmänvalvojan suostumus ei ohita tunnisteisiin perustuvia poissulkemisia eikä käyttäjän Microsoft-käyttöoikeuksia.
Korvaavatko sivustojen hallinta-asetukset Microsoft-käyttöoikeudet?
Eivät. Sovellus käyttää edelleen kunkin käyttäjän Microsoft-käyttöoikeuksia. OpenAI soveltaa määritettyä sivustosuodatusta ennen vastausten näyttämistä käyttäjälle ja mallille.
Estääkö tyhjä sallittujen luettelo kaikki sivustot?
Ei. Tyhjä sallittujen luettelo ei tarkoita ”estä kaikki”. Jos estettyjen luettelossa on merkintöjä, kyseiset kokoelmat pysyvät estettyinä. Kun kummassakaan luettelossa ei ole merkintöjä, pääsy määräytyy käyttäjien Microsoft-käyttöoikeuksien ja muiden määritettyjen asetusten perusteella.
Kirjataanko Admin API:n kautta tehdyt muutokset lokiin?
Admin API:n kautta tehdyt käytäntömuutokset tallennetaan työtilan valvonta- ja vaatimustenmukaisuuslokeihin.
