Introduzione
Connettere Jira per consentire all'assistente IA e agli agenti di effettuare ricerche nei progetti selezionati nel momento in cui un utente pone una domanda.
Si tratta di un connettore in tempo reale. Nessun contenuto di Jira viene copiato, indicizzato o archiviato in Docebo. Quando un utente pone una domanda, Docebo effettua la ricerca in quel momento nei progetti resi disponibili, utilizzando l'account Jira dell'utente stesso.
Come funzionano i permessi per Jira: ogni collega connette il proprio account Jira la prima volta che è necessario. Ogni ricerca viene quindi eseguita con le credenziali di tale utente, in modo che Jira applichi le proprie regole di accesso e l'utente veda solo ciò che potrebbe aprire direttamente in Jira. L'account utilizzato durante la configurazione serve solo a configurare la connessione.
1. Prerequisiti nel sistema sorgente
Configurazione obbligatoria
Questo connettore supporta solo Jira Cloud.
Ruolo obbligatorio
Per creare l'app OAuth e autorizzare il connettore è necessario un amministratore dell'organizzazione Atlassian.
Impostazioni obbligatorie
Se l'organizzazione utilizza un elenco di app consentite, aggiungervi la nuova app OAuth prima di procedere con l'autorizzazione.
2. Preparazione nel sistema sorgente
Jira utilizza lo stesso tipo di app del connettore Confluence: un'app OAuth 2.0 (3LO) nell'Atlassian Developer Console. Se è già stata creata un'app per Confluence, è possibile riutilizzarla. Aprirla, quindi proseguire con Aggiungi i permessi. Gli eventuali ambiti di Confluence già concessi restano invariati.
Creare l'app
Saltare questo passaggio se si sta riutilizzando la propria app Confluence.
- Accedere all'Atlassian Developer Console e creare una nuova OAuth 2.0 integration.
- Assegnarle un nome (ad esempio, "Docebo Knowledge Connector") e lasciare Access type impostato su Account-level (l'impostazione predefinita).
Creare una nuova integrazione OAuth 2.0 (3LO), scegliendo il tipo di accesso.
Aggiungere i permessi
- Nell'app, aprire Permissions. In Jira API, selezionare Add se non è ancora presente nell'elenco, quindi Configure.
- Rimanere nella scheda Classic scopes, selezionare Edit Scopes e spuntare View Jira issue data e View user profiles.
- Aprire User identity API e assicurarsi che View active user profile sia spuntato. Lo è già se l'app viene utilizzata per Confluence.
| API | Nome dell'ambito | Codice |
|---|---|---|
| Jira API (ambiti classici) | View Jira issue data | read:jira-work |
| Jira API (ambiti classici) | View user profiles | read:jira-user |
| User identity API | View active user profile | read:me |
Aggiungere l'URL di callback
In Authorization, assicurarsi che l'URL di reindirizzamento indicato di seguito sia presente in Callback URLs. In caso contrario, aggiungerlo e selezionare Save changes. 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.
Si tratta dello stesso URL utilizzato dal connettore Confluence, quindi un'app condivisa con Confluence lo include già.
Scheda Authorization con il campo Callback URL e il generatore di Authorization URL.
Definire la distribuzione
Saltare questo passaggio se si sta riutilizzando un'app già configurata per Confluence.
- Aprire Distribution e impostare Distribution status su Sharing.
- Compilare i campi obbligatori con le proprie informazioni: nome del fornitore, URL dell'informativa sulla privacy, URL delle condizioni d'uso, contatto dell'assistenza clienti e la dichiarazione sui dati personali.
- Selezionare Save changes.
Controlli di modifica della distribuzione, con l'opzione Sharing selezionata e i dettagli del fornitore compilati.
Recuperare il Client ID e il Client secret
Aprire Settings e copiare il Client ID e il Secret da Authentication details. Questi dati dovranno essere incollati in Docebo.
3. Azioni obbligatorie in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| Client ID | Atlassian Developer Console → app → Settings → Authentication details |
| Client secret | Atlassian Developer Console → app → Settings → Authentication details |
Autorizzare il connettore
- Accedere a Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → Jira. Questo menu è visibile solo ai Superadmin.
Nella scheda Autorizza, inserire il Client ID e il Client secret dell'app Atlassian, quindi selezionare Autentica.
Nella finestra pop-up di Atlassian, verificare l'accesso richiesto e selezionare Accetta. Il connettore risulta quindi connesso. Non viene avviata alcuna sincronizzazione, poiché nessun contenuto viene copiato.
Scegliere i progetti in cui è possibile effettuare ricerche, quindi salvare la selezione.