Introduzione
Collegare gli spazi Confluence in modo che il contenuto delle pagine diventi conoscenza ricercabile in Docebo.
Questo connettore sincronizza interi spazi Confluence, con il contenuto e la gerarchia delle pagine, anziché singoli file: per questo motivo è elencato come connettore di tipo "Siti". È questa la differenza principale rispetto ai connettori SharePoint e Google Drive.
1. Informazioni di base
Quali contenuti vengono sincronizzati
| Tipo di contenuto | Stato | Nota |
|---|---|---|
| Pagine pubblicate all'interno di uno spazio selezionato | Sincronizzato | |
| Etichette delle pagine | Sincronizzato | |
| File e allegati all'interno delle pagine | Non sincronizzato | Fuori ambito — questo connettore copre solo il contenuto delle pagine, non i file |
| Commenti | Non sincronizzato | |
| Pagine in bozza o non pubblicate | Non sincronizzato | |
| Spazi archiviati | Non sincronizzato |
Quali contenuti vengono estratti
| Contenuto | Stato |
|---|---|
| Titolo della pagina e testo del corpo | Estratto |
| Nome dello spazio, chiave e URL della pagina | Estratto |
| Metadata e gerarchia delle pagine (struttura superiore/secondaria, timestamp) | Estratto |
| Etichette delle pagine | Estratto |
| Immagini in linea, diagrammi e output delle macro renderizzate | Non estratto |
| Commenti | Non estratto |
| Cronologia delle pagine e confronti tra versioni | Non estratto |
| Contenuto dei file allegati | Non estratto |
2. Prerequisiti nel sistema di origine
Ruolo richiesto
È necessario un amministratore dell'organizzazione Atlassian — un amministratore del sito Confluence non è sufficiente. L'accesso come amministratore dell'organizzazione è ciò che consente al connettore di identificare correttamente gli utenti e di raggiungere ogni spazio; un amministratore del sito non può garantire né l'una né l'altra cosa.
Impostazioni richieste
- Questo connettore supporta solo Confluence Cloud. Confluence Data Center non è supportato.
- Se l'organizzazione utilizza una lista di app consentite, aggiungervi la nuova app OAuth prima di procedere con l'autorizzazione.
3. Preparazione nel sistema di origine
Creare l'app
Accedere alla Atlassian Developer Console, selezionare Crea → Integrazione OAuth 2.0 e assegnare un nome all'app (ad esempio, "Docebo Knowledge Connector"). Scegliere un tipo di accesso: nella maggior parte dei casi, utilizzare A livello di account — garantisce l'accesso a ogni sito dell'organizzazione Atlassian del cliente. Scegliere A livello di risorsa solo se l'organizzazione dispone di diversi siti separati e si desidera collegarne specificamente uno solo.
Creare una nuova integrazione OAuth 2.0 (3LO), con la scelta del tipo di accesso.
Aggiungere i permessi
Aprire l'app → Permessi e aggiungere sia l' API User identity sia l'API di Confluence. Per l'API di Confluence, aggiungere gli ambiti presenti in entrambe le schede Ambiti classici e Ambiti granulari — il connettore di Docebo li utilizza entrambi.
API User identity
| Nome dell'ambito | Descrizione | Codice |
|---|---|---|
| Visualizza il profilo dell'utente attivo | Visualizza i dettagli del profilo dell'utente attualmente connesso. | read:me |
| Visualizza i profili utente | Necessario per visualizzare i profili degli utenti. | read:account |
API User identity — ambiti selezionati nella Atlassian Developer Console.
API di Confluence — Ambiti classici
| Nome dell'ambito | Codice |
|---|---|
| Leggi il riepilogo degli spazi Confluence | read:confluence-space.summary |
| Leggi le proprietà dei contenuti Confluence | read:confluence-props |
| Leggi i contenuti dettagliati di Confluence | read:confluence-content.all |
| Leggi il riepilogo dei contenuti Confluence | read:confluence-content.summary |
| Cerca nei contenuti e nei riepiloghi degli spazi Confluence | search:confluence |
| Leggi i permessi dei contenuti in Confluence | read:confluence-content.permission |
| Leggi l'utente | read:confluence-user |
| Leggi i gruppi di utenti | read:confluence-groups |
| Scarica gli allegati dei contenuti | readonly:content.attachment:confluence |
API di Confluence — scheda Ambiti classici nella Atlassian Developer Console.
API di Confluence — Ambiti granulari
| Nome dell'ambito | Codice |
|---|---|
| Visualizza i contenuti dettagliati | read:content:confluence |
| Visualizza i dettagli del contenuto | read:content-details:confluence |
| Visualizza i dettagli dello spazio | read:space-details:confluence |
| Visualizza le pagine | read:page:confluence |
| Visualizza i gruppi | read:group:confluence |
| Visualizza i dettagli utente | read:user:confluence |
| Visualizza gli spazi | read:space:confluence |
| Visualizza le proprietà degli spazi | read:space.property:confluence |
| Visualizza le impostazioni degli spazi | read:space.setting:confluence |
| Verifica i permessi dei contenuti | read:content.permission:confluence |
| Visualizza le restrizioni dei contenuti e i permessi degli spazi | read:permission:confluence |
| Leggi l'indirizzo email | read:email-address:confluence |
API di Confluence — scheda Ambiti granulari nella Atlassian Developer Console.
Configurare l'autenticazione
Aprire Autorizzazione, abilitare OAuth 2.0 (3LO) e impostare l'URL di callback. L'URL di callback 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 Salva le modifiche.
Scheda Autorizzazione con il campo URL di callback e il generatore dell'URL di autorizzazione.
Definire la distribuzione
Aprire Distribuzione e impostare Stato della distribuzione su Condivisione — ciò consente a qualsiasi account Atlassian di autorizzare il connettore, non solo a quello che ha creato l'app. Compilare i dettagli relativi al fornitore e alla sicurezza richiesti: nome del fornitore, URL dell'informativa sulla privacy, URL delle condizioni d'uso e un contatto per l'assistenza clienti. In Dichiarazione sui dati personali, indicare se l'app memorizza dati personali, quindi selezionare Salva le modifiche.
Modifica dei controlli di distribuzione, con l'opzione Condivisione selezionata e i dettagli del fornitore compilati.
4. Azioni richieste in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| URL del sito Confluence | L'indirizzo di Confluence Cloud, ad es. yourcompany.atlassian.net |
| Client ID | Atlassian Developer Console → app → Impostazioni → Dettagli di autenticazione |
| Client Secret | Atlassian Developer Console → app → Impostazioni → Dettagli di autenticazione |
Autorizzare il connettore
- Accedere a Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → Confluence. Questo menu è visibile solo ai Superadmin.
- Inserire l'URL di Confluence (ad esempio, https://yourcompany.atlassian.net), quindi selezionare Continua.
Collega Confluence — scheda Configurazione con il campo URL di Confluence.
- Inserire il Client ID e il Client Secret dell'app Atlassian (Impostazioni → Dettagli di autenticazione), quindi selezionare Autentica.
Collega Confluence — scheda Autentica con i campi Client ID e Client Secret.
- Nella finestra pop-up di Atlassian, esaminare gli accessi richiesti e selezionare Accetta.
Schermata di consenso di Atlassian per il connettore Docebo.
- Nella scheda Scopo, selezionare gli spazi da rendere disponibili per l'aggiunta successiva alle raccolte di conoscenze, quindi salvare la selezione.
Collega Confluence — scheda Scopo per la selezione degli spazi da sincronizzare.