Introduction
Connectez Jira pour que l’assistant IA et les agents puissent effectuer des recherches dans les projets sélectionnés au moment même où une question est posée.
Il s’agit d’un connecteur en temps réel. Aucune donnée Jira n’est copiée, indexée ni stockée dans Docebo. Lorsqu’une question est posée, Docebo effectue la recherche, à ce moment précis, dans les projets que vous avez rendus disponibles, à l’aide du propre compte Jira de l’utilisateur.
Fonctionnement des droits pour Jira : chaque collègue connecte son propre compte Jira la première fois que cela est nécessaire. Toutes les recherches s’exécutent ensuite au nom de cette personne ; Jira applique donc ses propres règles d’accès et seuls les contenus que cette personne pourrait ouvrir elle-même dans Jira lui sont présentés. Le compte que vous utilisez lors de la configuration sert uniquement à établir la connexion.
1. Prérequis dans le système source
Configuration requise
Ce connecteur prend uniquement en charge Jira Cloud.
Rôle requis
L’intervention d’un ou d’une admin d’organisation Atlassian est nécessaire pour créer l’application OAuth et autoriser le connecteur.
Paramètres requis
Si votre organisation utilise une liste d’applications autorisées, ajoutez-y la nouvelle application OAuth avant de procéder à l’autorisation.
2. Préparation dans le système source
Jira utilise le même type d’application que le connecteur Confluence : une application OAuth 2.0 (3LO) dans l’Atlassian Developer Console. Si vous avez déjà créé une application pour Confluence, vous pouvez la réutiliser. Ouvrez-la, puis passez directement à la section Ajouter des droits. Les champs d’application Confluence déjà accordés restent en place.
Créer l’application
Ignorez cette étape si vous réutilisez votre application Confluence.
- Accédez à l’Atlassian Developer Console et créez une nouvelle OAuth 2.0 integration.
- Nommez-la (par exemple, « Docebo Knowledge Connector ») et laissez l’option Access type définie sur Account-level (valeur par défaut).
Création d’une nouvelle intégration OAuth 2.0 (3LO), avec le choix du type d’accès.
Ajouter des droits
- Dans l’application, ouvrez Permissions. Sous Jira API, sélectionnez Add si l’API ne figure pas encore dans la liste, puis Configure.
- Restez dans l’onglet Classic scopes, sélectionnez Edit Scopes, puis cochez View Jira issue data et View user profiles.
- Ouvrez User identity API et vérifiez que View active user profile est coché. C’est déjà le cas si l’application est utilisée pour Confluence.
| API | Nom du champ d’application | Code |
|---|---|---|
| Jira API (classic scopes) | View Jira issue data | read:jira-work |
| Jira API (classic scopes) | View user profiles | read:jira-user |
| User identity API | View active user profile | read:me |
Ajouter l’URL de rappel
Sous Authorization, vérifiez que l’URL de rappel ci-dessous figure dans Callback URLs. Si ce n’est pas le cas, ajoutez-la et sélectionnez Save changes. Elle suit toujours ce format : https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, par exemple https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Il s’agit de la même URL que celle utilisée par le connecteur Confluence ; une application partagée avec Confluence la contient donc déjà.
Onglet Authorization, avec le champ Callback URL et le générateur Authorization URL.
Définir la distribution
Ignorez cette étape si vous réutilisez une application déjà configurée pour Confluence.
- Ouvrez Distribution et définissez Distribution status sur Sharing.
- Renseignez les champs obligatoires avec vos propres informations : nom du fournisseur, URL de la politique de confidentialité, URL des conditions d’utilisation, contact du support client et déclaration relative aux données personnelles.
- Sélectionnez Save changes.
Page Edit distribution controls, avec l’option Sharing sélectionnée et les informations du fournisseur renseignées.
Récupérer l’ID client et le secret client
Ouvrez Settings et copiez les valeurs Client ID et Secret de la section Authentication details. Vous les collerez ensuite dans Docebo.
3. Actions requises dans Docebo
| Informations à saisir | Où les trouver |
|---|---|
| ID client | Atlassian Developer Console → application → Settings → Authentication details |
| Secret client | Atlassian Developer Console → application → Settings → Authentication details |
Autorisation du connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → Jira. Ce menu n’est visible que par les Superadmins.
Dans l’onglet Autoriser, saisissez l’ID client et le secret client de votre application Atlassian, puis sélectionnez S’authentifier.
Dans la fenêtre contextuelle Atlassian, vérifiez les accès demandés et sélectionnez Accept. Le connecteur apparaît alors comme connecté. Aucune synchronisation ne démarre, car aucune donnée n’est copiée.
Choisissez les projets dans lesquels les recherches peuvent être effectuées, puis enregistrez votre sélection.