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-tunniste. Microsoft Graphin täydellisen sivustotunnisteen keskimmäinen arvo on kokoelman GUID-tunniste. Admin API käyttää kokoelmien GUID-tunnisteita. Käyttöliittymän CSV-tuontityökalu voi poimia ne myös Graphin kolmiosaisista sivustotunnisteista.

• Ota SharePoint-sovelluksen edellyttämät Microsoft-käyttöoikeudet käyttöön sekä ChatGPT:n käyttöoikeusasetuksissa että Microsoft Entrassa, mukaan lukien Sites.Read.All ja Files.Read.All. Nämä asetukset suodattavat käyttöä OpenAI:n puolella. Ne eivät korvaa Microsoftin delegoituja käyttöoikeuksia.

• Pyydä luottamuksellisuustunnisteisiin perustuvia poissulkuja varten Microsoft 365- tai Purview-ylläpitäjältä kunkin salaamattoman tunnisteen muuttumaton GUID-tunniste.

• Hanki API-hallintaa varten työtilasi UUID-tunniste, ChatGPT-työtilan ylläpitoavain sekä Microsoft Graph -käyttöoikeustietue, jos sinun on selvitettävä SharePointin URL-osoitteita vastaavat tunnisteet. 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

1. Avaa ChatGPT:n hallintakonsoli ja valitse haluamasi työtila.

2. Siirry kohtaan Tunnistetiedot ja valitse Ylläpitoavaimet.

3. Luo avain, jonka käyttöoikeustaso on Rajoitettu, ja aseta kohdan Sovellukset arvoksi Kirjoitus.

4. 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:

1. Avaa Microsoft Graph Explorer ja kirjaudu sisään SharePoint-sivustot sisältävän vuokraajan työtilillä.

2. 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ä.

3. 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

1. Avaa SharePoint-sivusto, kun olet kirjautunut Microsoftiin tilillä, jolla on sivuston käyttöoikeus.

2. Lisää sivuston URL-osoitteen loppuun /_api/site/id. Käytä esimerkiksi osoitetta https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. 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

1. Avaa työtilassasi SharePoint-sovelluksen Turvallisuus- ja suojausasetukset.

2. Valitse kohdassa Käyttötila joko Sallitut sivustot tai Estetyt sivustot.

3. Lisää sivustokokoelmat valittuun luetteloon. Voit myös käyttää jäljempänä kuvattua CSV-latausta.

4. Tarkista muutokset ja valitse Tallenna.

5. Tarkista tallennettu käytäntö ja testaa määritykset.

Admin APIn kautta lisätyt sivustot näkyvät työtilan asetuksissa. Käyttöliittymässä lisätyt sivustot ovat käytettävissä myös APIn kautta. Voit lisätä tai poistaa merkintöjä kummalla tahansa 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ää halutut kokoelmat ja tallenna uudelleen.


Aktiivisen luettelon tyhjentäminen muuttaa käyttöä heti tallennettaessa. Sallittujen luettelon tyhjentäminen poistaa sen asettaman sivustorajoituksen. Estettyjen luettelon tyhjentäminen poistaa sen estot. Suunnittele siirtymä muiden ylläpitäjien kanssa, sillä yhden luettelon tyhjentämisen ja toisen tallentamisen välisenä aikana käyttö voi olla sallittua kohteisiin, joita lopullinen käytäntö rajoittaa.

Lataa sivustokokoelmat CSV-tiedostosta

CSV-lataus tukee vain sivustokokoelmia. Jos haluat sulkea tiedostoja pois luottamuksellisuustunnisteen perusteella, lisää tunnisteiden GUID-tunnisteet kohtaan Poissuljetut luottamuksellisuustunnisteet ilman salausta.

1. Avaa Turvallisuus- ja suojausasetukset ja valitse haluamasi Käyttötila.

2. Luo CSV-tiedosto, joka sisältää sivustokokoelmien GUID-tunnisteet tai Microsoft Graphin kolmiosaiset sivustotunnisteet. Käytä samaa tunnistemuotoa koko tiedostossa.

3. Valitse Lataa CSV-tiedosto ja valitse tiedosto.

4. Tarkista tuonnin tulos ja valittu luettelo. Korjaa mahdolliset rivivirheet ja selvitä varoitukset ennen jatkamista.

5. 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-tunnistetta riviä kohden tai Graphin kolmiosaisia sivustotunnisteita. Kolmiosaiset tunnisteet voi sijoittaa lainausmerkeissä yhteen kenttään tai jakaa kolmeen sarakkeeseen.

• Graphin kolmiosaiset tunnisteet muunnetaan kokoelmien GUID-tunnisteiksi. Kolmiosaisen tunnisteen tuonti ei luo yksittäiseen sivustoon rajattua sääntöä.

• Tuonti lisää merkintöjä valittuun luetteloon ja säilyttää olemassa olevat merkinnät. Kokoelmien kaksoiskappaleet poistetaan. Tuonnin lukumäärä kertoo uusien lisättyjen kokoelmien määrän.

• Eri tunnistemuotojen sekoitukset ja virheellisesti muotoillut rivit hylätään. Jos lataus sisältää vain sivustojen URL-osoitteita, näyttöön tulee varoitus eikä sivustoja lisätä. Selvitä ensin URL-osoitteita vastaavat kokoelmien GUID-tunnisteet.

• Lataus muuttaa vain luettelon luonnosta. Se ei päivitä työtilan käyttöoikeuksia, ennen kuin valitset Tallenna.

• Tässä kuvattu CSV-lataus on tarkoitettu sivustokokoelmien hallintaan. Määritä luottamuksellisuustunnisteisiin perustuvat poissulut erikseen.

Jos sinulla on SharePointin URL-osoitteet sisältävä CSV-tiedosto, voit Cookbook-työkalun CSV-työnkululla selvittää niitä vastaavat tunnisteet ja hallita sallittujen luetteloa APIn kautta. Sen site_url- tai url-syötteen muoto ja työnkulku eroavat käyttöliittymän tunnistelatauksesta.

Huomioi käytäntöjen ja pyyntöjen rajoitukset

Käytännön oletusraja on 10 000 sivustokokoelmaa. Työtilan käytäntörajat voidaan nostaa enintään 120 000 sivustokokoelmaan, mutta OpenAI:n on otettava korotus käyttöön. 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-tunnistetta pyyntöä kohden. Työtilan korkeampi käytäntöraja ei nosta tätä pyyntökohtaista rajaa. Laske yksilölliset sivustokokoelmat, älä lähde-URL-osoitteita: useat URL-osoitteet voivat viitata samaan kokoelmaan.

Käytä työtilan Admin APIa

Käytä työtilasi UUID-tunnistetta ja ChatGPT-työtilan ylläpitoavainta osoitteessa https://api.chatgpt.com.

Ajantasaiset sallittujen luettelon komennot ja pyyntöesimerkit ovat Cookbookissa:

• Nykyisen sallittujen luettelon lukeminen.

• Sivustokokoelmien esikatselu ja lisääminen. Lisäykset säilyttävät nykyiset sallitut kokoelmat.

• Sivustokokoelman poistaminen.

• Sallittujen luettelon tyhjentäminen.

Tarkista nykyinen käytäntö ennen muutoksia, lue se sitten uudelleen ja testaa käytön toimivuus muutosten jälkeen. Viimeisen sallitun kokoelman poistaminen tai sallittujen luettelon tyhjentäminen poistaa kyseisen sivustorajoituksen. Älä lähetä tyhjää lisäyspyyntöä, ellet halua poistaa sallittujen luettelon rajoituksia.

Julkisella Cookbook-työkalulla voi tällä hetkellä hallita vain sallittujen luetteloita. Sillä ei voi hallita estettyjen luetteloita eikä luottamuksellisuustunnisteisiin perustuvia poissulkuja. 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 poissulkuja

1. Avaa SharePoint-sovelluksen Turvallisuus- ja suojausasetukset.

2. Syötä kunkin salaamattoman tunnisteen GUID-tunniste kohtaan Poissuljetut luottamuksellisuustunnisteet ilman salausta.

3. Tallenna määritykset ja testaa tuettua tiedostoa, jolla on poissuljettu tunniste.

Tiedostot, joilla on määritettyjä tunnisteita vastaavat tuetut tunnisteet, suljetaan pois SharePoint-sovelluksen tuloksista. Tiedostot, joilla on salausta käyttävä tunniste, suljetaan jo oletusarvoisesti pois.

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.

1. 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.

2. 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.

3. Testaa tuettua testitiedostoa, jolla on poissuljettu luottamuksellisuustunniste. Sen ei pitäisi näkyä sovelluksen tuloksissa.

4. Vertaa API-muutoksen jälkeen käyttöliittymään tallennettua luetteloa APIn palauttamaan käytäntöön.

5. 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:

• Hallintaopas.

• Python-hallintaskripti.

• Offline-testitiedosto.

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

Korvaavatko sivustoasetukset Microsoftin käyttöoikeudet?

Eivät. Sovellus käyttää edelleen kunkin käyttäjän Microsoft-käyttöoikeuksia. OpenAI soveltaa määritettyä sivustosuodatusta ennen kuin vastaukset näytetään 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ä, käyttäjien Microsoft-käyttöoikeudet ja muut määritetyt rajoitukset määräävät, mitä sisältöä voi käyttää.

Kirjataanko Admin APIn muutokset lokiin?

Admin APIn kautta tehdyt käytäntömuutokset kirjataan työtilan valvonta- ja vaatimustenmukaisuuslokeihin.