Konfigurasjonsveiledning for SharePoint-integrasjonen

SharePoint-integrasjonen i Intric bruker Microsoft Graph med tillatelsesomfanget Sites.Selected for tilgang til SharePoint-data. Dette betyr:

• Ingen tilgang som standard: uten eksplisitt konfigurasjon har appen ingen tillatelser til noen SharePoint-nettsteder eller innholdet deres
• Kontroll på nettstedsnivå: en Entra-leieradministrator velger nøyaktig hvilke nettsteder appen kan få tilgang til. Appen kan verken se eller samhandle med andre nettsteder
• Delegerte tillatelser: appen handler på vegne av den innloggede brukeren. Selv innenfor et innvilget nettsted kan brukeren bare se filer og mapper de allerede har tilgang til i SharePoint
• Søk aktivert: når tilgang til et nettsted er innvilget, kan brukere søke i filer på det nettstedet

All konfigurasjon gjøres via Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) eller tilsvarende verktøy. Du må være administrator i Entra-leieren din for å fullføre disse trinnene.

Trinn 1: Finn nettstedet ditt (eller nettstedene dine)

Forutsetning: Du trenger Sites.Read.All godkjent i Graph Explorer for dette trinnet.

Søk etter nettsteder med et nøkkelord:

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

Eksempelsvar:

{
  "@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"
    }
  ]
}

Merk deg id-feltet til nettstedet du vil gi tilgang til. I dette eksempelet er nettstedets ID:

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

Bruk ?search=* for å liste opp alle nettsteder.

Trinn 2: Gi Intric-appen tilgang til nettstedet

Forutsetning: Du trenger Sites.FullControl.All godkjent i Graph Explorer for dette trinnet.

SharePoint-appen til Intric har følgende konfigurasjon:

Felt	Verdi
Program-ID	a1162fb9-a25e-4bd3-9c55-e7a46a085536
Visningsnavn	Intric

Bruk nettstedets ID fra trinn 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"
    }
  }]
}

Bruk "roles": ["read"] for skrivebeskyttet tilgang eller "roles": ["write"] for lese- og skrivetilgang. Foreløpig er alle verktøyene i SharePoint-integrasjonen i Intric skrivebeskyttede.

Gjenta for hvert nettsted du vil gi tilgang til.

Trinn 3: Konfigurer i Intric

Når du har gitt Intric-appen tilgang til SharePoint-nettstedet ditt (eller nettstedene dine) i Microsoft Graph, legger du til nettstedene i Intric:

1. Gå til Admin i hovedmenyen
2. Åpne Integrasjoner i adminpanelet
3. Finn og velg SharePoint fra listen over tilgjengelige integrasjoner
4. Klikk på Legg til nettsted eller Konfigurer
5. Skriv inn nettstedets ID for nettstedet du ga tilgang til i trinn 2 (samme verdi som id i trinn 1)

Format for nettstedets ID:

• Bruk hele nettstedidentifikatoren fra Microsoft Graph—feltet id, ikke nettstedets URL fra nettleseren
• Eksempel: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740
• Dette samsvarer med id i Graph API-svaret i trinn 1 og nettstedet du brukte i trinn 2

Gjenta denne prosessen for hvert nettsted du vil gjøre tilgjengelig i Intric.

Når konfigurasjonen er fullført, vil integrasjonen automatisk oppdage stasjoner (dokumentbiblioteker), mapper og filer innenfor de innvilgede nettstedene. Brukere som kobler til Microsoft-kontoene sine, vil kunne få tilgang til disse nettstedene i samtaler med assistenter som har SharePoint-integrasjonen aktivert.

Tilbakekalle tilgang

For å fjerne appens tilgang til et nettsted, list opp tillatelsene først:

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

Finn tillatelsesoppføringen for Intric-appen og slett den deretter:

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

Appen mister umiddelbart tilgangen til det nettstedet og alt innholdet der.