SharePointin käyttöönotto

Intricin SharePoint-integraatio käyttää Microsoft Graphia Sites.Selected-käyttöoikeusalueella SharePoint-datan käyttämiseen. Tämä tarkoittaa:

• Oletuksena ei pääsyä: ilman nimenomaista konfigurointia sovelluksella ei ole käyttöoikeuksia SharePoint-sivustoihin tai niiden sisältöön
• Hallinta sivustotasolla: Entra-vuokraajarjestelmänvalvoja valitsee tarkalleen, mihin sivustoihin sovellus saa käyttää. Sovellus ei voi nähdä tai olla vuorovaikutuksessa muiden sivustojen kanssa
• Delegoidut käyttöoikeudet: sovellus toimii kirjautuneen käyttäjän puolesta. Myös myönnetyn sivuston sisällä käyttäjä voi käyttää vain tiedostoja ja kansioita, joihin hänellä on jo käyttöoikeus SharePointissa
• Haku käytössä: kun sivustoon on myönnetty pääsy, käyttäjät voivat hakea tiedostoja kyseisen sivuston sisällä

Kun käyttäjä yhdistää tilinsä, Intric pyytää delegoidut käyttöoikeudet Sites.Selected, User.Read ja offline_access. Microsoft vaatii järjestelmänvalvojan suostumuksen Sites.Selected-käyttöoikeudelle, joten myönnä se Intric-sovellukselle Entrassa (Enterprise applications → Intric → Permissions → Grant admin consent) ennen kuin käyttäjät yhdistävät tilinsä.

Myönnä pääsy yksittäisiin sivustoihin Microsoft Graph Explorerilla (https://developer.microsoft.com/graph/graph-explorer) tai vastaavalla työkalulla. Sinun on oltava järjestelmänvalvoja Entra-vuokraajassasi näiden vaiheiden suorittamiseksi.

Vaihe 1: Etsi sivustosi

Edellytys: Tarvitset Sites.Read.All hyväksyttynä Graph Explorerissa tätä vaihetta varten.

Hae sivustoja avainsanalla:

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

Esimerkkivastaus:

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

Merkitse muistiin sivuston id-kenttä, jolle haluat myöntää pääsyn. Tässä esimerkissä sivuston tunnus on:

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

Käytä ?search=* listaamaan kaikki sivustot.

Vaihe 2: Myönnä Intric-sovellukselle pääsy sivustoon

Edellytys: Tarvitset Sites.FullControl.All hyväksyttynä Graph Explorerissa tätä vaihetta varten.

Intricin SharePoint-sovelluksella on seuraava konfiguraatio:

Kenttä	Arvo
Sovellustunnus	a1162fb9-a25e-4bd3-9c55-e7a46a085536
Näyttönimi	Intric

Käyttäen sivuston tunnusta vaiheesta 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"
    }
  }]
}

Käytä arvoa "roles": ["read"]. Kaikki Intricin SharePoint-toiminnot ovat vain luku -toimintoja, joten "write" antaisi sovellukselle enemmän oikeuksia kuin se käyttää.

Toista jokaisen sivuston kohdalla, jolle haluat myöntää pääsyn.

Vaihe 3: Lisää sivustot Intriciin

Kun olet myöntänyt Intric-sovellukselle pääsyn SharePoint-sivustoillesi Microsoft Graphissa, lisää kyseiset sivustot Intriciin:

1. Avaa Admin ja valitse Platform-kohdasta AI-työkalut
2. Avaa SharePoint ja ota käyttöön Organisaatiosi käytettävissä
3. Avaa Sallitut sivustot ja klikkaa Lisää sivusto
4. Täytä kolme kenttää:
   • Nimi – nimi, jonka käyttäjät ja assistentti näkevät sivustolle
   • Sivuston tunnus – sen sivuston id, jolle myönsit pääsyn vaiheessa 2
   • Kuvaus – vapaaehtoinen, mutta kannattaa kirjoittaa: assistentti lukee sen päättäessään, mistä sivustosta se etsii, joten kerro, mitä sivusto sisältää

Sivuston tunnuksen muoto:

• Käytä täydellistä sivustotunnistetta Microsoft Graphista – id-kenttää – älä sivuston URL-osoitetta selaimesta
• Tunnus koostuu kolmesta pilkuin erotetusta osasta: sivustokokoelman isäntänimestä, sivustokokoelman tunnuksesta ja sivuston tunnuksesta
• Esimerkki: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Toista tämä jokaiselle sivustolle, jonka haluat tuoda saataville Intricissä.

Kun määritys on tehty, assistentti löytää itse myönnettyjen sivustojen asiakirjakirjastot, kansiot ja tiedostot. Käyttäjät, jotka yhdistävät Microsoft-tilinsä, voivat sen jälkeen käyttää näitä sivustoja keskusteluissa assistenttien kanssa, joissa SharePoint-integraatio on käytössä.

Jokainen lisäämäsi sivusto on kaikkien SharePointia käyttävien assistenttien käytettävissä, ellei assistentin rakentaja rajaa sitä kohdassa Määritä → Rajoita tiettyihin sivustoihin.

Vaihe 4: Tarkista ominaisuudet ja luokitus

Samassa paneelissa Ominaisuudet luettelee neljä toimintoa: Listaa levyasemat, Listaa tiedostot, Hae tiedoston sisältö ja Haku. Kaikki neljä ovat vain luku -toimintoja, ja niiden oletusasetus on Auto, joten ne toimivat kysymättä käyttäjältä. Voit vaihtaa minkä tahansa niistä tilaan Kysy tai Pois; katso MCP-palvelimen ominaisuudet ja audit-loki.

Voit myös antaa integraatiolle Turvallisuusluokitus-asetuksen, jolloin vain Spaceissa olevat assistentit, joilla on vastaava luokitus, voivat käyttää sitä.

Pääsyn peruuttaminen

Poistaaksesi sovelluksen pääsyn sivustoon, listaa ensin käyttöoikeudet:

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

Etsi Intric-sovelluksen käyttöoikeusmerkintä ja poista se sitten:

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

Sovellus menettää välittömästi pääsyn kyseiseen sivustoon ja kaikkeen sen sisältöön.