Översikt

Arbetsytans administratörer kan använda SharePoint-kontroller för att tillåta godkända webbplatssamlingar, blockera valda webbplatssamlingar och utesluta filer som stöds och har valda Microsoft Purview-känslighetsetiketter.

En SharePoint-webbplatssamling, även kallad SPSite, kan innehålla flera webbplatser. En samlingsregel gäller hela samlingen, med hänsyn till varje användares befintliga Microsoft-behörigheter. Den ger inte en användare åtkomst till innehåll som användaren inte har åtkomst till i Microsoft 365.

Webbplatsbegränsningar gäller för sökning, bläddring, filhämtning och läs- och skrivåtgärder som stöds i SharePoint. OneDrive-åtkomst hanteras separat.

Välj det åtkomstläge som matchar din policy:

• Tillåtna webbplatser: Om tillåtelselistan inte är tom kan användare endast komma åt de listade webbplatssamlingarna via appen.

• Blockerade webbplatser: Användare kan komma åt andra webbplatssamlingar än de som finns på blockeringslistan, i enlighet med sina Microsoft-behörigheter.

Endast en lista kan innehålla poster åt gången. En tom tillåtelselista blockerar inte alla webbplatser. När båda listorna är tomma tas SharePoint-webbplatsbegränsningarna bort. Microsoft-behörigheter och andra konfigurerade kontroller gäller fortfarande.

Tillgänglighet

Kontrollerna och arbetsytans Admin API måste aktiveras för din arbetsyta. Tillgängliga kontroller omfattar tillåtelselistor och blockeringslistor för webbplatssamlingar, webbplatsimport via CSV och undantag baserade på känslighetsetiketter.

Reglerna gäller hela webbplatssamlingar. Dessa kontroller för webbplatssamlingar omfattar inte avgränsning till enskilda webbplatser, mappar eller filer, eller tillämpning av Microsoft Sites.Selected.

Innan du börjar

• Identifiera de webbplatssamlingar som din organisation vill tillåta eller blockera.

• Hämta varje samlings GUID. Ett fullständigt webbplats-ID från Microsoft Graph innehåller samlingens GUID som mittersta värde. Admin API använder samlings-GUID:n. CSV-importören i användargränssnittet kan också extrahera dem från tredelade Graph-webbplats-ID:n.

• Aktivera de Microsoft-behörigheter som SharePoint-appen kräver i både ChatGPT:s behörighetsinställningar och Microsoft Entra, inklusive Sites.Read.All och Files.Read.All. Dessa kontroller filtrerar åtkomst på OpenAI-sidan. De ersätter inte Microsofts delegerade behörigheter.

• För undantag baserade på känslighetsetiketter ber du din Microsoft 365- eller Purview-administratör om det oföränderliga GUID:t för varje etikett utan kryptering.

• För administration via API:et behöver du arbetsytans UUID, en administratörsnyckel för ChatGPT-arbetsytan och en Microsoft Graph-token om du behöver slå upp SharePoint-URL:er. De två autentiseringsuppgifterna har olika syften.

Om OpenAI Cookbook

OpenAI Cookbook är OpenAI:s offentliga samling av exempelkod och guider. Den här artikeln använder dess guide för SharePoint-webbplatsåtkomst och administrationsskript i Python, som båda finns på GitHub. Du kan öppna länkarna i webbläsaren för att läsa filerna. För att köra skriptet laddar du ned det och följer guidens installations- och kommandoanvisningar.

I hela artikeln avser ”Cookbook” den SharePoint-guiden, och ”Cookbook-verktyget” avser det länkade Python-skriptet. Använd dessa resurser för kommandoexempel och API-baserad hantering av tillåtelselistor.

Konfigurera autentiseringsuppgifter för API-administration

Obs! Du måste vara administratör för arbetsytan för att kunna skapa administratörsnycklar. Läs mer.

Skapa en administratörsnyckel för ChatGPT-arbetsytan

1. Öppna ChatGPT:s administrationskonsol och välj den avsedda arbetsytan.

2. Gå till Autentiseringsuppgifter och välj Administratörsnycklar.

3. Skapa en nyckel med Begränsade behörigheter och ställ in Appar på Skriv.

4. Förvara nyckeln säkert. Den här nyckeln ger behörighet att läsa och ändra SharePoint-policyn för din arbetsyta.

Den behörighet som krävs är chatgpt.enterprise.apps.write. Observera att varken en nyckel för OpenAI:s API-plattform eller en Microsoft Graph-token kan ersätta en administratörsnyckel för ChatGPT-arbetsytan.

Mer information finns i: Hantera administratörsnycklar på fliken Autentiseringsuppgifter. Information om skriptets miljövariabler för autentiseringsuppgifter och ett exempel på säker inmatning finns i Cookbooks anvisningar för autentiseringsuppgifter.

Hämta en Microsoft Graph-token

Använd din organisations godkända process för Microsoft-autentisering. För en interaktiv uppslagning, om din organisation tillåter Graph Explorer:

1. Öppna Microsoft Graph Explorer och logga in med ett arbetskonto i den klientorganisation som innehåller SharePoint-webbplatserna.

2. Välj de behörigheter som krävs för att läsa webbplatserna, vanligtvis Sites.Read.All, via Ändra behörigheter eller Samtyck till behörigheter. Be din Microsoft-administratör att godkänna åtkomsten om din organisation kräver det.

3. Öppna fliken Åtkomsttoken och kopiera token för användning med Microsoft Graph.

Microsofts anvisningar finns i Arbeta med Graph Explorer.

Graph-token används för att slå upp identifierare för SharePoint-URL:er. ChatGPT-administratörsnyckeln används för att läsa eller uppdatera ChatGPT-policyn. Cookbook-verktyget behöver Graph-token endast för kommandon som slår upp URL:er. För att läsa eller tömma en befintlig tillåtelselista krävs endast ChatGPT-administratörsnyckeln.

Lägg inte någon av autentiseringsuppgifterna i versionshantering, delade dokument, skärmbilder eller loggar.

Hitta en webbplatssamlings GUID

Använd SharePoint-webbplatsens URL

1. Öppna SharePoint-webbplatsen medan du är inloggad hos Microsoft med ett konto som har åtkomst till den.

2. Lägg till /_api/site/id i slutet av webbplatsens URL. Använd till exempel https://contoso.sharepoint.com/sites/Finance/_api/site/id.

3. Kopiera det GUID som returneras i svaret.

Obs! Exempeldomäner och identifierare i den här artikeln är platshållare.

Använd Microsoft Graph

Microsoft Graph returnerar ett webbplats-ID med tre kommaseparerade delar: värdnamnet, webbplatssamlingens GUID och webbplatsens GUID. Använd det mittersta värdet för en regel för webbplatssamlingar. Olika webbplats-URL:er kan motsvara samma samlings-GUID.

Exempel på uppslagningar och identifierare finns i Förstå SharePoints webbplatsidentifierare. För att slå upp flera URL:er utan att ändra ChatGPT-policyn använder du granskningsanvisningarna i Cookbook och administrationsskriptet i Python.

Microsofts krav för uppslagning finns i Hämta en SharePoint-webbplats via sökväg.

Hantera tillåtna och blockerade webbplatssamlingar

Använd arbetsytans kontroller

1. Öppna SharePoint-appens Trygghets- och säkerhetskontroller i din arbetsyta.

2. Under Åtkomstläge väljer du Tillåtna webbplatser eller Blockerade webbplatser.

3. Lägg till webbplatssamlingarna i den valda listan. Du kan också använda CSV-uppladdningen som beskrivs nedan.

4. Granska ändringarna och välj Spara.

5. Kontrollera den sparade policyn och testa konfigurationen.

Webbplatser som läggs till via Admin API visas i arbetsytans kontroller. Webbplatser som läggs till i användargränssnittet är också tillgängliga via API:et. Du kan lägga till eller ta bort poster på båda sätten. En webbplats är inte låst till den metod som användes för att lägga till den.

Växla mellan tillåtna och blockerade webbplatser

Endast en lista kan innehålla poster åt gången. Innan du lägger till poster i det andra läget måste du tömma den befintliga listan och spara ändringen. Välj sedan det andra läget, lägg till de avsedda samlingarna och spara igen.


Om du tömmer den aktiva listan ändras åtkomsten direkt när du sparar. Om du tömmer en tillåtelselista tas dess webbplatsbegränsning bort. Om du tömmer en blockeringslista tas dess blockeringar bort. Planera övergången med andra administratörer, eftersom intervallet mellan att tömma den ena listan och spara den andra kan tillåta åtkomst som den slutliga policyn ska begränsa.

Ladda upp webbplatssamlingar från CSV

CSV-uppladdning stöder endast webbplatssamlingar. För att utesluta filer utifrån känslighetsetikett lägger du till etiketternas GUID under Uteslutna känslighetsetiketter utan kryptering.

1. Öppna Trygghets- och säkerhetskontroller och välj önskat Åtkomstläge.

2. Förbered en CSV-fil med webbplatssamlingarnas GUID eller tredelade webbplats-ID:n från Microsoft Graph. Använd samma identifierarformat i hela filen.

3. Välj Ladda upp CSV-fil och välj filen.

4. Granska importresultatet och den valda listan. Åtgärda eventuella radfel eller varningar innan du fortsätter.

5. Välj Spara för att tillämpa ändringarna och kontrollera sedan den sparade listan.

Krav och funktioner för CSV:

• Maximal filstorlek: 1 MB.

• Kolumnrubriker är valfria.

• Använd ett samlings-GUID per rad eller tredelade Graph-webbplats-ID:n. Tredelade ID:n kan anges inom citattecken i ett fält eller delas upp i tre kolumner.

• Tredelade Graph-ID:n konverteras till samlings-GUID:n. Att importera ett tredelat ID skapar inte en regel för en enskild webbplats.

• Importer lägger till poster i den valda listan och bevarar befintliga poster. Dubbletter av samlingar tas bort. Importantalet visar antalet nytillagda samlingar.

• Blandade format och felaktigt formaterade rader avvisas. Om en uppladdning endast innehåller webbplats-URL:er visas en varning och inga webbplatser läggs till. Slå först upp samlings-GUID:n för URL:erna.

• En uppladdning ändrar endast listans utkast. Åtkomsten i arbetsytan uppdateras inte förrän du väljer Spara.

• CSV-uppladdningen som beskrivs här hanterar webbplatssamlingar. Konfigurera undantag baserade på känslighetsetiketter separat.

Om du har en CSV-fil med SharePoint-URL:er kan Cookbook-verktygets CSV-arbetsflöde slå upp dem och hantera en tillåtelselista via API:et. Dess indata i site_url eller url använder ett annat format och arbetsflöde än identifieraruppladdningen i användargränssnittet.

Förstå policy- och anropsgränser

Standardgränsen för policyn är 10 000 webbplatssamlingar. Högre policygränser för arbetsytan, upp till 120 000 webbplatssamlingar, måste aktiveras av OpenAI. Kontakta ditt OpenAI-team innan du planerar en större driftsättning.

Enskilda ändringsanrop till API:et och det aktuella Cookbook-skriptet accepterar upp till 10 000 samlings-GUID:n per anrop. En högre policygräns för arbetsytan höjer inte denna gräns per anrop. Räkna unika webbplatssamlingar, inte käll-URL:er: flera URL:er kan hänvisa till samma samling.

Använd arbetsytans Admin API

Använd arbetsytans UUID och administratörsnyckeln för din ChatGPT-arbetsyta med https://api.chatgpt.com.

Aktuella kommandon för tillåtelselistor och exempel på anrop finns i Cookbook:

• Läs den befintliga tillåtelselistan.

• Förhandsgranska och lägg till webbplatssamlingar. Tillägg bevarar befintliga tillåtna samlingar.

• Ta bort en webbplatssamling.

• Töm tillåtelselistan.

Granska den aktuella policyn innan du gör ändringar. Läs den sedan igen och testa den resulterande åtkomsten. Om du tar bort den sista tillåtna samlingen eller tömmer tillåtelselistan tas den webbplatsbegränsningen bort. Skicka inte ett tomt tilläggsanrop om du inte avser att ta bort tillåtelselistans begränsningar.

Det offentliga Cookbook-verktyget hanterar för närvarande endast tillåtelselistor. Det hanterar inte blockeringslistor eller undantag baserade på känslighetsetiketter. Använd arbetsytans kontroller som beskrivs ovan för dessa uppgifter.

Uteslut filer med känslighetsetiketter

Hitta etikettens GUID

Be din Microsoft 365- eller Purview-administratör om den avsedda etikettens oföränderliga GUID. Använd dess GUID, inte dess visningsnamn.

En administratör kan lista etiketter via Microsoft Graph. Token behöver den tillämpliga behörigheten SensitivityLabel.Read eller SensitivityLabels.Read.All. Matcha den avsedda etikettens namn med dess ID och kontrollera dess skyddsinställningar.

Krav och exempel finns i Lista känslighetsetiketter och Egenskaper för känslighetsetiketter. Dessa etikettbehörigheter är separata från den läsbehörighet för webbplatser som används för att slå upp SharePoint-URL:er.

Lägg till etikettbaserade undantag

1. Öppna Trygghets- och säkerhetskontroller i SharePoint-appen.

2. Ange GUID för varje etikett utan kryptering under Uteslutna känslighetsetiketter utan kryptering.

3. Spara konfigurationen och testa en fil som stöds och har den uteslutna etiketten.

Filer med matchande etiketter som stöds utesluts från SharePoint-appens resultat. Filer med etiketter som tillämpar kryptering är redan uteslutna som standard.

Testa konfigurationen

Använd testfiler och konton som godkänts av din organisation. Kontrollera före testet att samma Microsoft-konto har åtkomst till varje fil direkt i SharePoint.

1. I läget Tillåtna webbplatser, med en lista som inte är tom, kontrollerar du en fil i en tillåten samling och en fil i en samling som inte finns med i listan. Endast den tillåtna samlingen ska vara tillgänglig via appen.

2. I läget Blockerade webbplatser kontrollerar du en fil i en blockerad samling och en fil i en samling som inte är blockerad. Den blockerade samlingen ska vara otillgänglig. För den samling som inte är blockerad gäller fortfarande Microsoft-behörigheter och andra kontroller.

3. Kontrollera en testfil som stöds och har en utesluten känslighetsetikett. Den ska inte visas i appens resultat.

4. Efter en ändring via API:et jämför du den sparade listan i användargränssnittet med den policy som API:et returnerar.

5. Efter en CSV-uppladdning sparar du ändringarna och öppnar kontrollerna igen för att bekräfta att de avsedda samlingarna finns kvar.

Om resultaten avviker från den avsedda policyn kontrollerar du arbetsytan, valt åtkomstläge, den sparade listan, samlingarnas GUID, etiketternas GUID, att filtypen stöds och användarens Microsoft-behörigheter. Töm inte en lista som en del av felsökningen om du inte avser att göra den åtkomständring det medför.

För hjälp med saknade kontroller eller oväntad åtkomst, se: Kontakta OpenAI-supporten. Ta inte med administratörsnycklar eller Microsoft Graph-token i ditt supportärende.

Förstå begränsningarna

• En samlingsregel omfattar hela webbplatssamlingen. Den kan inte begränsa åtkomsten till en viss underwebbplats, mapp eller fil.

• Begränsningar för SharePoint-webbplatser begränsar inte automatiskt åtkomsten till OneDrive.

• Filtrering efter känslighetsetiketter gäller endast där Microsoft Graph tillhandahåller etikettmetadata som stöds, bland annat för Office-dokument, PDF-filer och MP4-filer som stöds.

• Filtyper som inte stöder känslighetsetiketter, till exempel TXT- och CSV-filer, behandlas som omärkta. De förblir tillgängliga om åtkomst i övrigt är tillåten. Den här filtypsbegränsningen gäller inte uppladdning av en CSV-fil för att konfigurera webbplatsåtkomst.

• CSV-uppladdningen och det offentliga exempelverktyget konfigurerar inte undantag baserade på känslighetsetiketter. Den här artikeln dokumenterar inte något API för masshantering av etiketter.

• En sparad policy eller ett lyckat API-svar ersätter inte behovet av att testa åtkomsten med det avsedda kontot.

Använd administrationsverktyget i Python

Den fullständiga exempelkoden och kommandona hålls uppdaterade i OpenAI Cookbook:

• Administrationsguide.

• Administrationsskript i Python.

• Testfil för offlinekörning.

Använd Python 3.10 eller senare. Verktyget använder Pythons standardbibliotek. Läs guiden innan du kör verktyget och använd provkörningar för att granska ändringar.

Den aktuella versionen av verktyget läser autentiseringsuppgifter från miljövariabler. Följ guidens anvisningar för säker inmatning. Det kräver uttrycklig bekräftelse för att tömma en tillåtelselista. En borttagning kan utföras utan den bekräftelsen, så granska först borttagningen med en provkörning.

Information om återförsök och valfria idempotensnycklar finns i Gör ett säkert återförsök av en policyuppdatering. Använd idempotensnycklar endast om arbetsytan stöder dem, och granska den aktuella policyn efter ett fel med oklart utfall.

Verktyget aktiverar inte arbetsytefunktioner och kontrollerar inte att reglerna tillämpas. Dess offlinetester använder simulerade anrop till Microsoft Graph och ChatGPT Admin API.

Ändringar som omfattar flera anrop är inte atomära. Om en borttagning av flera samlingar misslyckas halvvägs kan tidigare borttagningar redan ha genomförts. Läs den aktuella policyn innan du försöker igen.

Vanliga frågor

Ersätter webbplatskontroller Microsoft-behörigheter?

Nej. Appen använder fortfarande varje användares Microsoft-behörigheter. OpenAI tillämpar den konfigurerade webbplatsfiltreringen innan svar visas för användaren och modellen.

Blockerar en tom tillåtelselista alla webbplatser?

Nej. En tom tillåtelselista betyder inte ”blockera alla”. Om en blockeringslista innehåller poster förblir dessa samlingar blockerade. När ingen av listorna innehåller poster avgör användarnas Microsoft-behörigheter och andra konfigurerade kontroller åtkomsten.

Loggas ändringar via Admin API?

Policyändringar via Admin API registreras i arbetsytans gransknings- och efterlevnadsloggar.