Oppsett av SharePoint

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

• Ingen tilgang som standard: uten eksplisitt konfigurasjon har appen ingen tillatelser til noen SharePoint-sider eller innholdet deres
• Kontroll på sidenivå: en Entra-leieradministrator velger nøyaktig hvilke sider appen kan få tilgang til. Appen kan ikke se eller samhandle med andre sider
• Delegerte tillatelser: appen handler på vegne av den påloggede brukeren. Selv innenfor en godkjent side kan brukeren bare få tilgang til filer og mapper de allerede har tillatelse til å se i SharePoint
• Søk aktivert: når en side er godkjent, kan brukere søke etter filer innenfor den siden

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 siden(e) dine

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

Søk etter sider 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"
    }
  ]
}

Fra svaret, noter id-feltet til siden du vil gi tilgang til. I dette eksemplet er side-ID-en:

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

Du kan bruke ?search=* for å liste opp alle sider.

Trinn 2: Gi Intric-appen tilgang til siden

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

Intrics SharePoint-app har følgende konfigurasjon:

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

Bruker side-ID-en 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 eller "roles": ["write"] for lese- og skrivetilgang. For øyeblikket er alle verktøy i SharePoint-integrasjonen i Intric skrivebeskyttede.

Gjenta for hver side du vil gi tilgang til.

Trinn 3: Konfigurer i Intric

Når du har gitt Intric-appen tilgang til SharePoint-siden(e) dine i Microsoft Graph, legg til disse sidene i Intric:

1. Naviger til Admin i hovedmenyen
2. Gå til Integrasjoner i adminpanelet
3. Finn og velg SharePoint fra listen over tilgjengelige integrasjoner
4. Klikk på Legg til side eller Konfigurer
5. Skriv inn Side-ID for siden du ga tilgang til i Trinn 2 (samme verdi som id fra Trinn 1)

Format for side-ID:

• Bruk den fullstendige sideidentifikatorstrengen fra Microsoft Graph — id-feltet — ikke sideURL-en 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 siden du brukte i Trinn 2

Gjenta denne prosessen for hver side du vil gjøre tilgjengelig i Intric.

Når konfigurert, vil integrasjonen automatisk oppdage stasjonene (dokumentbibliotekene), mappene og filene innenfor den/de godkjente siden(e). Brukere som kobler til Microsoft-kontoene sine vil kunne få tilgang til disse sidene i samtaler med assistenter som har SharePoint-integrasjonen aktivert.

Tilbakekalle tilgang

For å fjerne appens tilgang til en side, list først opp tillatelsene:

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 vil umiddelbart miste tilgangen til den siden og alt dens innhold.