Konfigurera SharePoint-integrationen

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

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

All konfiguration sker via Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) eller motsvarande verktyg. Du måste vara administratör i din Entra-klient för att slutföra dessa steg.

Steg 1: Hitta din sajt (eller dina sajter)

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

Sök efter sajter 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 sajt du vill bevilja åtkomst till. I det här exemplet är sajt-ID:t:

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

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

Steg 2: Ge Intric-appen åtkomst till sajten

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

Med sajt-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"] för skrivskyddad åtkomst eller "roles": ["write"] för läs- och skrivåtkomst. För närvarande är alla verktyg i SharePoint-integrationen i Intric skrivskyddade.

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

Steg 3: Konfigurera i Intric

När du har beviljat Intric-appen åtkomst till dina SharePoint-sajter i Microsoft Graph lägger du till dem i Intric:

1. Gå till Admin i huvudmenyn
2. Navigera till Integrationer i administratörspanelen
3. Hitta och välj SharePoint i listan över tillgängliga integrationer
4. Klicka på Lägg till sajt eller Konfigurera
5. Ange sajt-ID för den sajt du beviljade åtkomst till i steg 2 (samma värde som id i steg 1)

Format för sajt-ID:

• Använd hela sajtidentifieraren från Microsoft Graph—fältet id—inte sajt-URL:en från webbläsaren
• Exempel: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740
• Det ska matcha id i Graph API-svaret i steg 1 och sajten du använde i steg 2

Upprepa processen för varje sajt du vill göra tillgänglig i Intric.

När konfigurationen är klar identifierar integrationen automatiskt enheter (dokumentbibliotek), mappar och filer inom de beviljade sajterna. Användare som ansluter sina Microsoft-konton kan komma åt dessa sajter i konversationer med assistenter där SharePoint-integrationen är aktiverad.

Återkalla åtkomst

Ta bort appens åtkomst till en sajt 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 sajten och allt dess innehåll.