Configurazione di SharePoint

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

• Nessun accesso per impostazione predefinita: senza configurazione esplicita, l’app non ha autorizzazioni per nessun sito SharePoint o il loro contenuto
• Controllo a livello di sito: un amministratore tenant Entra sceglie esattamente a quali siti l’app può accedere. L’app non può vedere o 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 i quali ha già l’autorizzazione in SharePoint
• Ricerca abilitata: una volta che un sito è stato concesso, gli utenti possono cercare file all’interno di quel sito

Quando un utente si collega, Intric chiede le autorizzazioni delegate Sites.Selected, User.Read e offline_access. Microsoft richiede il consenso amministrativo per Sites.Selected: concedilo per l’app Intric in Entra (Applicazioni aziendali → Intric → Autorizzazioni → Concedi il consenso amministrativo) prima che gli utenti si colleghino.

Concedi l’accesso ai singoli siti tramite Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) o strumenti equivalenti. Devi essere un amministratore nel tuo tenant Entra per completare questi passaggi.

Passaggio 1: Trova i tuoi siti

Prerequisito: Hai bisogno di Sites.Read.All con consenso in Graph Explorer per questo passaggio.

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

Puoi usare ?search=* per elencare tutti i siti.

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

Prerequisito: Hai bisogno di Sites.FullControl.All con consenso in Graph Explorer per questo passaggio.

L’app SharePoint di Intric ha la seguente configurazione:

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

Usando l’ID del sito dal 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"]. Tutte le azioni SharePoint in Intric sono in sola lettura, quindi "write" concederebbe all’app più di quanto usa.

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

Passaggio 3: Aggiungi i siti in Intric

Una volta concesso all’app Intric l’accesso ai tuoi siti SharePoint in Microsoft Graph, aggiungi quei siti a Intric:

1. Apri Admin e, sotto Platform, seleziona AI Tools
2. Apri SharePoint e attiva Available to your organisation
3. Apri Allowed sites e clicca su Add site
4. Compila i tre campi:
   • Name – il nome del sito che vedono gli utenti e l’assistente
   • Site ID – l’id del sito a cui hai concesso l’accesso nel Passaggio 2
   • Description – facoltativa, ma vale la pena scriverla: l’assistente la legge per decidere in quale sito cercare, quindi indica cosa contiene il sito

Formato dell’ID sito:

• Usa la stringa identificativa completa del sito da Microsoft Graph — il campo id — non l’URL del sito dal browser
• È composta da tre parti separate da virgole: il nome host della raccolta siti, l’ID della raccolta siti e l’ID del sito
• Esempio: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Ripeti l’operazione per ogni sito che vuoi rendere disponibile in Intric.

Una volta completata la configurazione, l’assistente trova da solo le librerie documenti, le cartelle e i file all’interno dei siti concessi. Gli utenti che collegano il proprio account Microsoft possono poi usare questi siti nelle conversazioni con gli assistenti che hanno l’integrazione SharePoint abilitata.

Ogni sito che aggiungi è disponibile per tutti gli assistenti con SharePoint, a meno che chi crea l’assistente non lo limiti in Configure → Restrict to specific sites.

Passaggio 4: Controlla azioni e classificazione

Nello stesso pannello, Capabilities elenca le quattro azioni: List drives, List files, Get file content e Search. Sono tutte in sola lettura e impostate su Auto per impostazione predefinita, quindi l’assistente le esegue senza chiedere all’utente. Puoi impostarne una qualsiasi su Ask o Off; vedi Capacità e approvazione.

Puoi anche assegnare all’integrazione una Security classification, così solo gli assistenti negli Space con una classificazione corrispondente possono usarla.

Revoca dell’accesso

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

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

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

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

L’app perderà immediatamente l’accesso a quel sito e a tutto il suo contenuto.