Guida alla configurazione dell'integrazione SharePoint

L’integrazione SharePoint di Intric utilizza Microsoft Graph con l’ambito di autorizzazione Sites.Selected per accedere ai dati di SharePoint. Ciò significa:

• Nessun accesso per impostazione predefinita: senza una configurazione esplicita, l’app non ha autorizzazioni per nessun sito SharePoint o relativo contenuto
• Controllo a livello di sito: un amministratore del tenant Entra sceglie esattamente quali siti l’app può raggiungere. L’app non può vedere né interagire con altri siti
• Autorizzazioni delegate: l’app agisce per conto dell’utente che ha effettuato l’accesso. Anche all’interno di un sito concesso, l’utente può accedere solo ai file e alle cartelle per cui ha già autorizzazioni in SharePoint
• Ricerca abilitata: una volta concesso l’accesso a un sito, gli utenti possono cercare i file al suo interno

Tutta la configurazione viene eseguita tramite Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) o strumenti equivalenti. Per completare questi passaggi devi essere un amministratore del tuo tenant Entra.

Passaggio 1: Trova i tuoi siti

Prerequisito: Per questo passaggio hai bisogno di Sites.Read.All approvato in Graph Explorer.

Cerca i siti usando una parola chiave:

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

Risposta di esempio:

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

Dalla risposta, annota il campo id del sito a cui vuoi concedere l’accesso. In questo esempio, l’ID del sito è:

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

Usa ?search=* per elencare tutti i siti.

Passaggio 2: Concedi all’app Intric l’accesso al sito

Prerequisito: Per questo passaggio hai bisogno di Sites.FullControl.All approvato in Graph Explorer.

L’app SharePoint di Intric ha la seguente configurazione:

Campo	Valore
ID applicazione	a1162fb9-a25e-4bd3-9c55-e7a46a085536
Nome visualizzato	Intric

Usa l’ID del sito ottenuto nel Passaggio 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"
    }
  }]
}

Usa "roles": ["read"] per l’accesso in sola lettura o "roles": ["write"] per l’accesso in lettura e scrittura. Attualmente tutti gli strumenti dell’integrazione SharePoint in Intric sono in sola lettura.

Ripeti per ogni sito a cui vuoi concedere l’accesso.

Passaggio 3: Configura in Intric

Dopo aver concesso all’app Intric l’accesso ai tuoi siti SharePoint in Microsoft Graph, aggiungili a Intric:

1. Vai su Admin nel menu principale
2. Apri Integrazioni nel pannello di amministrazione
3. Trova e seleziona SharePoint dall’elenco delle integrazioni disponibili
4. Clicca su Aggiungi sito o Configura
5. Inserisci l’ID del sito a cui hai concesso l’accesso nel Passaggio 2 (lo stesso valore del campo id del Passaggio 1)

Formato dell’ID del sito:

• Usa l’identificatore completo del sito da Microsoft Graph—il campo id, non l’URL del sito dal browser
• Esempio: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740
• Corrisponde al valore id nella risposta Graph API al Passaggio 1 e al sito usato al Passaggio 2

Ripeti questo processo per ogni sito che vuoi rendere disponibile in Intric.

Una volta configurata, l’integrazione rileverà automaticamente le unità (raccolte documenti), le cartelle e i file all’interno dei siti concessi. Gli utenti che collegano i propri account Microsoft potranno accedere a questi siti nelle conversazioni con gli assistenti che hanno l’integrazione SharePoint abilitata.

Revocare l’accesso

Per rimuovere l’accesso dell’app a un sito, elenca prima le autorizzazioni:

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

Trova la voce di autorizzazione per l’app Intric, quindi eliminala:

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

L’app perderà immediatamente l’accesso a quel sito e a tutti i suoi contenuti.