Konfiguration av SharePoint

Intrics SharePoint-integration använder Microsoft Graph med behörighetsomfånget Sites.Selected för åtkomst till SharePoint-data. Det innebär:

• Ingen åtkomst som standard: utan explicit konfiguration har appen inga behörigheter till några SharePoint-webbplatser eller deras innehåll
• Kontroll på webbplatsnivå: en Entra-klientadministratör väljer exakt vilka webbplatser appen får komma åt. Appen kan inte se eller interagera med några andra webbplatser
• Delegerade behörigheter: appen agerar på uppdrag av den inloggade användaren. Även inom en beviljad webbplats kan användaren enbart komma åt filer och mappar den redan har behörighet att visa i SharePoint
• Sökning aktiverad: när åtkomst till en webbplats har beviljats kan användare söka bland filer inom den webbplatsen

När en användare ansluter ber Intric om de delegerade behörigheterna Sites.Selected, User.Read och offline_access. Microsoft kräver administratörsgodkännande för Sites.Selected, så ge det för Intric-appen i Entra (Företagsprogram → Intric → Behörigheter → Bevilja administratörsgodkännande) innan användarna ansluter.

Åtkomst till enskilda webbplatser ger du via Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) eller motsvarande verktyg. Du måste vara administratör i din Entra-klientorganisation för att slutföra dessa steg.

Steg 1: Hitta din/dina webbplats(er)

Förutsättning: Du behöver Sites.Read.All godkänt i Graph Explorer för det här steget.

Sök efter webbplatser med ett nyckelord:

GET https://graph.microsoft.com/v1.0/sites?search=marketing

Exempelsvar:

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites",
  "value": [
    {
      "id": "example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "displayName": "Marketing Site",
      "name": "marketing",
      "webUrl": "https://example.sharepoint.com/sites/marketing",
      "createdDateTime": "2023-01-15T10:30:00Z"
    }
  ]
}

Notera fältet id för den webbplats du vill bevilja åtkomst till. I det här exemplet är webbplats-ID:t:

example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Använd ?search=* för att lista alla webbplatser.

Steg 2: Bevilja Intric-appen åtkomst till webbplatsen

Förutsättning: Du behöver Sites.FullControl.All godkänt i Graph Explorer för det här steget.

Intrics SharePoint-app har följande konfiguration:

Fält	Värde
Program-ID	a1162fb9-a25e-4bd3-9c55-e7a46a085536
Visningsnamn	Intric

Använd webbplats-ID:t från steg 1:

POST https://graph.microsoft.com/v1.0/sites/example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740/permissions
Content-Type: application/json

{
  "roles": ["read"],
  "grantedToIdentities": [{
    "application": {
      "id": "a1162fb9-a25e-4bd3-9c55-e7a46a085536",
      "displayName": "Intric"
    }
  }]
}

Använd "roles": ["read"]. Alla SharePoint-åtgärder i Intric är skrivskyddade, så "write" skulle ge appen mer än den använder.

Upprepa för varje webbplats du vill bevilja åtkomst till.

Steg 3: Lägg till webbplatserna i Intric

När du har beviljat Intric-appen åtkomst till din/dina SharePoint-webbplats(er) i Microsoft Graph, lägg till dessa webbplatser i Intric:

1. Öppna Admin och välj AI-verktyg under Platform
2. Öppna SharePoint och slå på Tillgänglig för din organisation
3. Öppna Tillåtna webbplatser och klicka på Lägg till webbplats
4. Fyll i de tre fälten:
   • Namn – namnet som användarna och assistenten ser för webbplatsen
   • Webbplats-ID – id för den webbplats du gav åtkomst till i steg 2
   • Beskrivning – frivilligt, men värt att skriva: assistenten läser beskrivningen för att avgöra vilken webbplats den ska leta i, så skriv vad webbplatsen innehåller

Format för webbplats-ID:

• Använd den fullständiga identifieringssträngen från Microsoft Graph – fältet id – inte webbplatsens URL från webbläsaren
• Strängen består av tre delar åtskilda av kommatecken: webbplatssamlingens värdnamn, webbplatssamlingens ID och webbplatsens ID
• Exempel: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Upprepa detta för varje webbplats du vill göra tillgänglig i Intric.

När konfigurationen är klar hittar assistenten själv dokumentbibliotek, mappar och filer på de beviljade webbplatserna. Användare som ansluter sina Microsoft-konton kan sedan använda webbplatserna i konversationer med assistenter som har SharePoint-integrationen aktiverad.

Varje webbplats du lägger till är tillgänglig för alla assistenter med SharePoint, om inte den som bygger assistenten begränsar urvalet under Konfigurera → Begränsa till specifika webbplatser.

Steg 4: Kontrollera förmågor och klassificering

På samma panel listar Förmågor de fyra åtgärderna – Lista dokumentbibliotek, Lista filer, Hämta filinnehåll och Sök. Alla fyra är skrivskyddade och står på Auto som standard, så de körs utan att fråga användaren. Du kan ställa om vilken som helst av dem till Fråga eller Av; se Förmågor och godkännande.

Du kan också ge integrationen en Säkerhetsklassificering. Då kan bara assistenter i Spaces med matchande klassificering använda den.

Återkalla åtkomst

Ta bort appens åtkomst till en webbplats genom att först lista behörigheterna:

GET https://graph.microsoft.com/v1.0/sites/{siteId}/permissions

Hitta behörighetsposten för Intric-appen och ta sedan bort den:

DELETE https://graph.microsoft.com/v1.0/sites/{siteId}/permissions/{permissionId}

Appen förlorar omedelbart åtkomsten till den webbplatsen och allt dess innehåll.