SharePoint-integraation määritysopas

Intricin SharePoint-integraatio käyttää Microsoft Graphia Sites.Selected-käyttöoikeusalueen avulla SharePoint-tietojen käyttämiseen. Tämä tarkoittaa seuraavaa:

• Ei oletuskäyttöoikeuksia: ilman eksplisiittistä määritystä sovelluksella ei ole oikeuksia yhteenkään SharePoint-sivustoon tai sen sisältöön
• Sivustotason hallinta: Entra-vuokraajajärjestelmänvalvoja valitsee tarkalleen, mihin sivustoihin sovellus voi käyttää. Sovellus ei voi nähdä tai käyttää muita sivustoja
• 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 niitä tiedostoja ja kansioita, joihin hänellä on jo oikeudet SharePointissa
• Haku käytössä: kun sivustolle on myönnetty käyttöoikeus, käyttäjät voivat hakea tiedostoja kyseisellä sivustolla

Kaikki määritykset tehdään Microsoft Graph Explorerin (https://developer.microsoft.com/graph/graph-explorer) tai vastaavan työkalun avulla. Sinun on oltava Entra-vuokraajasi järjestelmänvalvoja näiden vaiheiden suorittamiseksi.

Vaihe 1: Etsi sivustosi

Edellytys: Tässä vaiheessa tarvitset Graph Explorerissa hyväksytyn Sites.Read.All-oikeuden.

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 sen sivuston id-kenttä, jolle haluat myöntää käyttöoikeuden. Tässä esimerkissä sivuston tunnus on:

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

Luettele kaikki sivustot käyttämällä ?search=*.

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

Edellytys: Tässä vaiheessa tarvitset Graph Explorerissa hyväksytyn Sites.FullControl.All-oikeuden.

Intricin SharePoint-sovelluksella on seuraava kokoonpano:

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

Käytä vaiheessa 1 löytämääsi sivuston tunnusta:

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öön tai "roles": ["write"] luku- ja kirjoituskäyttöön. Tällä hetkellä kaikki Intricin SharePoint-integraation työkalut ovat vain luku -tilassa.

Toista tämä jokaisen sivuston kohdalla, jolle haluat myöntää käyttöoikeuden.

Vaihe 3: Määritä Intricissä

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

1. Siirry Admin-osioon päävalikossa
2. Avaa Integraatiot hallintapaneelissa
3. Etsi ja valitse SharePoint käytettävissä olevien integraatioiden luettelosta
4. Klikkaa Lisää sivusto tai Määritä
5. Syötä vaiheessa 2 käyttöoikeuden myöntämäsi sivuston sivuston tunnus (sama arvo kuin kenttä id vaiheessa 1)

Sivuston tunnuksen muoto:

• Käytä Microsoft Graphin täyttä sivustotunnusta—kenttä id, ei sivuston URL-osoitetta selaimesta
• Esimerkki: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740
• Vastaa vaiheen 1 Graph API -vastauksen id-kenttää ja vaiheessa 2 käytettyä sivustoa

Toista tämä prosessi jokaisen sivuston kohdalla, jonka haluat ottaa käyttöön Intricissä.

Määrityksen jälkeen integraatio löytää automaattisesti asematiedostot (asiakirjakirjastot), kansiot ja tiedostot myönnettyjen sivustojen sisältä. Käyttäjät, jotka yhdistävät Microsoft-tilinsä, voivat käyttää näitä sivustoja keskusteluissa sellaisten assistenttien kanssa, joilla SharePoint-integraatio on käytössä.

Käyttöoikeuden peruuttaminen

Poista sovelluksen pääsy sivustoon luettelemalla 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.