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

Når en bruker kobler til, ber Intric om de delegerte tillatelsene Sites.Selected, User.Read og offline_access. Microsoft krever administratorsamtykke for Sites.Selected, så gi samtykket for Intric-appen i Entra (Bedriftsprogrammer → Intric → Tillatelser → Gi administratorsamtykke) før brukerne kobler til.

Tilgang til enkeltområder gir du gjennom 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"]. Alle SharePoint-handlinger i Intric bare leser, så "write" ville gi appen mer enn den bruker.

Gjenta for hver side du vil gi tilgang til.

Trinn 3: Legg til områdene i Intric

Når du har gitt Intric-appen tilgang til SharePoint-områdene i Microsoft Graph, legger du dem til i Intric:

1. Åpne Admin, og velg AI-verktøy under Platform
2. Åpne SharePoint og slå på Tilgjengelig for organisasjonen din
3. Åpne Tillatte områder og klikk på Legg til område
4. Fyll ut de tre feltene:
   • Navn – navnet brukerne og assistenten ser for området
   • Område-ID – id-en til området du ga tilgang til i trinn 2
   • Beskrivelse – valgfritt, men verdt å skrive: assistenten leser beskrivelsen for å avgjøre hvilket område den skal lete i, så skriv hva området inneholder

Format for område-ID:

• Bruk hele identifikatorstrengen for området fra Microsoft Graph – id-feltet – ikke URL-en til området fra nettleseren
• Den består av tre deler skilt med komma: vertsnavnet til områdesamlingen, ID-en til områdesamlingen og ID-en til området
• Eksempel: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Gjenta dette for hvert område du vil gjøre tilgjengelig i Intric.

Når oppsettet er ferdig, finner assistenten selv dokumentbibliotekene, mappene og filene på områdene som har fått tilgang. Brukere som kobler til Microsoft-kontoene sine, kan deretter bruke disse områdene i samtaler med assistenter som har SharePoint-integrasjonen aktivert.

Alle områdene du legger til, er tilgjengelige for alle assistenter med SharePoint, med mindre den som bygger assistenten, avgrenser dem under Konfigurer → Begrens til bestemte områder.

Trinn 4: Sjekk funksjoner og klassifisering

I det samme panelet viser Funksjoner de fire handlingene – List opp disker, List opp filer, Hent filinnhold og Søk. Alle fire bare leser og står på Auto som standard, så de kjører uten å spørre brukeren. Du kan sette hvilken som helst av dem til Spør eller Av; se Funksjoner og godkjenning.

Du kan også gi integrasjonen en Sikkerhetsklassifisering, slik at bare assistenter i Spaces med samsvarende klassifisering kan bruke den.

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.