Introduzione
Connettere siti, pagine web e news di SharePoint in modo che il loro contenuto diventi conoscenza recuperabile in Docebo.
Questo connettore sincronizza i contenuti di siti e pagine web, nonché le news archiviate nei siti SharePoint selezionati, in Docebo Knowledge, in modo che questi contenuti diventino ricercabili e utilizzabili da assistenti IA e agenti. Copre solo le pagine dei siti, gli elenchi o altri contenuti del sito. Per i file di SharePoint è disponibile un connettore dedicato.
1. Informazioni di base
Contenuti sincronizzati
| Tipo di contenuto | Stato | Nota |
|---|---|---|
| Siti | Sincronizzati | |
| Pagine web | Sincronizzate | |
| News e avvisi | Sincronizzati | |
| File nelle raccolte documenti | Non sincronizzati | Gestiti dal connettore per i file di SharePoint |
Contenuti estratti
| Contenuto | Stato |
|---|---|
| Titolo e testo del corpo del sito | Estratti |
| Elenchi e relativi elementi | Estratti |
| Testi di news e avvisi | Estratti |
| Nome del sito, URL e gerarchia (metadata) | Estratti |
2. Prerequisiti nel sistema sorgente
Ruolo obbligatorio
Per completare la configurazione è necessario disporre di uno dei seguenti ruoli Microsoft Entra ID (Azure AD):
- Amministratore globale, oppure
- Amministratore o Cloud Application Administrator, in combinazione con un ruolo che possa concedere il consenso amministratore (ad es. Privileged Role Administrator)
È inoltre necessario disporre dell'accesso come Site Owner o SharePoint Administrator su ogni sito da sincronizzare.
Impostazioni obbligatorie
I criteri di accesso condizionale non devono impedire all'entità servizio dell'app di raggiungere Microsoft Graph.
3. Preparazione nel sistema sorgente
Creare la registrazione dell'app
Accedere al portale di Azure e andare su Microsoft Entra ID → Registrazioni app → Nuova registrazione. Assegnare un nome all'app (ad esempio, "Docebo Knowledge connector"), lasciare Tipi di account supportati impostato su single tenant e impostare subito il URI di reindirizzamento — scegliere Web e inserire l'URL di callback. Eseguire questa operazione in fase di 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 → Autorizzazioni API → Aggiungi un'autorizzazione e aggiungere i permessi indicati di seguito sia da Microsoft Graph sia da SharePoint. Una volta aggiunti tutti, selezionare Concedi consenso amministratore per approvarli in un'unica operazione.
Microsoft Graph
| Permesso | Tipo | Descrizione |
|---|---|---|
| Group.Read.All | Applicazione | Leggere tutti i gruppi |
| GroupMember.Read.All | Applicazione | Leggere tutte le appartenenze ai gruppi |
| Sites.Read.All | Applicazione | Leggere gli elementi in tutte le raccolte siti |
| User.Read.All | Applicazione | Leggere i profili completi di tutti gli utenti |
SharePoint
| Permesso | Tipo | Descrizione |
|---|---|---|
| Sites.Read.All | Applicazione | Leggere gli elementi in tutte le raccolte siti |
Aggiungere un client secret
Andare su Certificati & segreti → Nuovo segreto client. Inserire una descrizione e una scadenza, quindi selezionare Add. Una volta creato, copiare il valore mostrato nella colonna Valore — non quello della colonna ID di segreto, che ha un aspetto simile ma non funziona per l'autenticazione. Il valore non sarà più visibile 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 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 all'API di SharePoint richiede sia un certificato sia un secret.
Si consiglia di utilizzare la funzionalità integrata per creare automaticamente il certificato e la chiave privata, cliccando sul pulsante Genera il certificato.
Questa operazione crea sharepoint-cert.pem (il certificato) e compila automaticamente i campi Impronta digitale del certificato e Chiave privata. È sufficiente aggiungere il certificato alla registrazione dell'app in Certificati & segreti → Certificati → Carica certificato e caricare sharepoint-cert.pem.
Scheda Certificates con il certificato caricato e la relativa impronta digitale.
In alternativa, è possibile 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
Anche in questo modo vengono generati la chiave privata e il certificato, ma è necessario copiare manualmente la chiave privata nel campo apposito e copiare il valore Impronta digitale dopo aver caricato il certificato nella registrazione dell'app, per inserirlo nel campo corrispondente.
4. Azioni obbligatorie in Docebo
| Informazioni da inserire | Dove trovarle | Nota |
|---|---|---|
| ID directory (tenant) | Registrazione dell'app di Azure → Overview | |
| URL del sito SharePoint | Indirizzo del sito SharePoint, senza il prefisso https:// o la barra finale — ad es. yourcompany.sharepoint.com | |
| Client ID | Registrazione dell'app di Azure → Overview | |
| Client secret | Registrazione dell'app di Azure → Certificates & secrets → Client secrets — copiare la colonna Value, non Secret ID, al momento della creazione | |
| Impronta digitale del certificato | Registrazione dell'app di Azure → Certificates & secrets → Certificates, dopo aver caricato il certificato | Se si utilizza l'opzione integrata per generare il certificato, questi campi vengono compilati automaticamente |
| Chiave privata | Il file della chiave privata generato insieme al certificato — conservarlo in un luogo sicuro, poiché Azure non lo memorizza né lo mostra di nuovo | Se si utilizza l'opzione integrata per generare il certificato, questi campi vengono compilati automaticamente |
Autorizzare il connettore
- Andare su Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → SharePoint - Siti. Questo menu è visibile solo ai Superadmin.
- Inserire l'ID directory (tenant) e l'URL del sito SharePoint — senza il prefisso https:// o la barra finale.
- Inserire Client ID, Client secret, Impronta digitale del certificato e Chiave privata dell'app di Azure, quindi selezionare Connetti.
- Concedere il consenso nella finestra pop-up di Microsoft.
- Nella schermata dell'ambito, selezionare i siti da rendere disponibili per l'aggiunta successiva alle raccolte di conoscenze, quindi salvare la selezione.