I connettori di conoscenze SharePoint

Introduzione

Connettere le raccolte di documenti di SharePoint affinché il loro contenuto diventi conoscenza ricercabile in Docebo.

Questo connettore sincronizza i file archiviati nelle raccolte di documenti di SharePoint in Docebo Knowledge, in modo che il loro contenuto diventi ricercabile e utilizzabile da assistenti IA e agenti. Copre solo i file — non le pagine del sito, gli elenchi o altri contenuti del sito.

1. Informazioni di base

Contenuti sincronizzati

Contenuti estratti

Tipi di file supportati per l'estrazione dei contenuti

I file di dimensioni superiori a 50 MB vengono sincronizzati solo con i metadata — il loro contenuto non viene analizzato.

È previsto un connettore SharePoint Sites separato, che copre le pagine del sito e altri contenuti del sito anziché i file. Questo connettore riguarda esclusivamente i file.

2. Prerequisiti nel sistema di origine

Ruolo richiesto

Per completare la configurazione è necessario disporre di uno dei seguenti ruoli di Microsoft Entra ID (Azure AD):

• Amministratore globale, oppure
• Amministratore applicazioni o Amministratore applicazioni cloud, in combinazione con un ruolo in grado di concedere il consenso amministratore (ad es. Amministratore ruolo con privilegi)

È inoltre necessario disporre dell'accesso come Proprietario del sito o Amministratore di SharePoint su ogni sito da sincronizzare.

Impostazioni richieste

Le raccolte di documenti da sincronizzare non devono essere protette da un'etichetta di riservatezza di Microsoft Purview o da criteri di Information Rights Management (IRM), ossia di gestione dei diritti sulle informazioni, che bloccano l'estrazione dei contenuti tramite API.

I criteri di accesso condizionale non devono impedire all'entità servizio dell'app di raggiungere Microsoft Graph.

3. Preparazione nel sistema di origine

Creare la registrazione dell'app

Accedere al portale di Azure, quindi andare su Microsoft Entra ID → Registrazioni app → Nuova registrazione. Assegnare un nome all'app (ad esempio, "Connettore Docebo Knowledge"), lasciare Tipi di account supportati impostato su tenant singolo e impostare subito l'URI di reindirizzamento — scegliere Web e inserire l'URL di callback. Eseguire questa operazione durante la registrazione consente di risparmiare un passaggio in seguito. L'URL segue sempre questo schema: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback — ad esempio, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Selezionare Registra.

Registrare un'applicazione, con l'URI di reindirizzamento già inserito.

Assegnare i permessi API

Aprire l'app → Permessi API → Aggiungi un permesso e aggiungere i permessi indicati di seguito sia da Microsoft Graph sia da SharePoint. Una volta tutti i permessi aggiunti, selezionare Concedi consenso amministratore per approvarli in un'unica operazione.

Microsoft Graph

SharePoint

Permessi configurati — permessi di Microsoft Graph e SharePoint, tutti concessi.

Aggiungere un client secret

Andare su Certificati e segreti → Nuovo client secret. Inserire una descrizione e una scadenza, quindi selezionare Aggiungi. Una volta il segreto creato, copiare il valore visualizzato nella colonna Valore — non nella colonna ID segreto, che ha un aspetto simile ma non funziona per l'autenticazione. Non sarà più possibile visualizzare il valore dopo aver lasciato questa pagina.

I client secret scadono in base alla pianificazione impostata qui. Se un secret scade e non viene sostituito prima, la connessione a SharePoint smette di funzionare — impostare un promemoria prima della data di scadenza.

Aggiungere un client secret, con descrizione e scadenza impostate.

Aggiungere un certificato

L'accesso diretto alle API di SharePoint richiede un certificato oltre a un secret. Generare un certificato autofirmato e una chiave privata con OpenSSL:

openssl req -x509 -newkey rsa:2048 -keyout sharepoint-key.pem -out sharepoint-cert.pem -days 180 -nodes -subj "/CN=my-custom-cn"

cat sharepoint-key.pem | pbcopy

In alternativa, è possibile utilizzare la funzionalità integrata per creare automaticamente il certificato e la chiave privata.

Questo comando crea sharepoint-cert.pem (il certificato) e sharepoint-key.pem (la chiave privata) e copia la chiave privata negli appunti. Andare su Certificati e segreti → Certificati → Carica certificato e caricare sharepoint-cert.pem. Quindi, prendere nota dell'Identificazione personale visualizzata nell'elenco — sarà necessaria in Docebo, insieme alla chiave privata appena copiata.

Scheda Certificati con il certificato caricato e la relativa identificazione personale.

4. Azioni richieste in Docebo

Autorizzare il connettore

1. Andare su Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → SharePoint - Files. Questo menu è visibile solo ai Superadmin.
2. Inserire l'ID della directory (tenant) e l'URL del proprio sito SharePoint — senza il prefisso https:// o una barra finale.

Connettere SharePoint - Files, con i campi Tenant ID e URL di SharePoint.

3. Inserire Client ID, Client secret, Identificazione personale del certificato e Chiave privata dell'app di Azure, quindi selezionare Connetti.

Connettere SharePoint - Files, con i campi Client ID, Client secret, Identificazione personale del certificato e Chiave privata.

4. Dare il consenso nella finestra pop-up di Microsoft.
5. Nella schermata dell'ambito, selezionare i siti da cui rendere disponibili i file, da aggiungere successivamente alle raccolte di conoscenze, quindi salvare la selezione.

Selezione dell'ambito — scelta dei siti di cui sincronizzare i file.