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ä

Kaikki konfigurointi tehdään Microsoft Graph Explorerin (https://developer.microsoft.com/graph/graph-explorer) tai vastaavan työkalun kautta. 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ä "roles": ["read"] vain luku -käyttöoikeudelle tai "roles": ["write"] luku- ja kirjoituskäyttöoikeudelle. Tällä hetkellä kaikki Intricin SharePoint-integraation työkalut ovat vain luku -tilassa.

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

Vaihe 3: Konfigurointi Intricissä

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

1. Siirry kohtaan Admin päävalikossa
2. Mene kohtaan Integraatiot admin-paneelissa
3. Etsi ja valitse SharePoint käytettävissä olevien integraatioiden luettelosta
4. Klikkaa Lisää sivusto tai Konfiguroi
5. Syötä Sivuston tunnus sivustolle, jolle myönsit pääsyn vaiheessa 2 (sama arvo kuin id vaiheessa 1)

Sivuston tunnuksen muoto:

• Käytä täydellistä sivustotunnistetta Microsoft Graphista—id-kenttää—ei sivuston URL-osoitetta selaimesta
• Esimerkki: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740
• Tämä vastaa id:tä Graph API -vastauksessa vaiheessa 1 ja sivustoa, jota käytit vaiheessa 2

Toista prosessi jokaisen sivuston kohdalla, jonka haluat tehdä saatavilla Intricissä.

Kun konfigurointi on tehty, integraatio löytää automaattisesti asemat (asiakirjakirjastot), kansiot ja tiedostot myönnetyn/myönnettyjen sivuston/sivustojen sisällä. Käyttäjät, jotka yhdistävät Microsoft-tilinsä, voivat käyttää näitä sivustoja keskusteluissa assistenttien kanssa, joissa SharePoint-integraatio on käytössä.

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.