Presentación
Conecte Jira para que el asistente de IA y los agentes puedan buscar en los proyectos seleccionados cuando un usuario formule una pregunta.
Este es un conector activo. No se copia, indexa ni almacena información de Jira en Docebo. Cuando un usuario formula una pregunta, Docebo busca en los proyectos que usted ha puesto a disposición en ese momento, utilizando la propia cuenta de Jira del usuario.
Cómo funcionan los permisos para Jira: cada colaborador conecta su propia cuenta de Jira la primera vez que resulta necesario. Después, cada búsqueda se ejecuta como ese usuario, por lo que Jira aplica sus propias reglas de acceso y solo permite ver la información que el usuario podría abrir directamente en Jira. La cuenta que usted utiliza durante la configuración solo sirve para configurar la conexión.
1. Requisitos previos en el sistema de origen
Disposición necesaria
Este conector solo admite Jira Cloud.
Rol necesario
Necesitará disponer del rol de administrador de la organización de Atlassian para crear la aplicación OAuth y autorizar el conector.
Configuración necesaria
Si su organización utiliza una lista de aplicaciones permitidas, añada la nueva aplicación OAuth a dicha lista antes de autorizarla.
2. Preparación en el sistema de origen
Jira utiliza el mismo tipo de aplicación que el conector de Confluence: una aplicación OAuth 2.0 (3LO) en la consola de desarrolladores de Atlassian. Si ya ha creado una aplicación para Confluence, puede reutilizarla. Ábrala y continúe con Añadir permisos. Los ámbitos de Confluence que ya haya concedido permanecerán activos.
Crear la aplicación
Omita este paso si va a reutilizar su aplicación de Confluence.
- Acceda a la consola de desarrolladores de Atlassian y cree una nueva Integración de OAuth 2.0.
- Asígnele un nombre, por ejemplo, "Conector de Docebo Knowledge", y mantenga el Tipo de acceso configurado como Account-level (la opción predeterminada).
Crear una nueva integración OAuth 2.0 (3LO) con la opción de tipo de acceso.
Añadir permisos
- En la aplicación, abra Permissions. En Jira API, seleccione Add si todavía no aparece en la lista y, a continuación, seleccione Configure.
- Permanezca en la pestaña Classic scopes, seleccione Edit scopes y marque View Jira issue data y View user profiles.
- Abra User Identity API y asegúrese de que View active user profile esté marcado. Esta opción ya estará marcada si la aplicación se utiliza para Confluence.
| API | Nombre del ámbito | Código |
|---|---|---|
| Jira API (ámbitos clásicos) | View Jira issue data | read:jira-work |
| Jira API (ámbitos clásicos) | View user profiles | read:jira-user |
| User identity API | View active user profile | read:me |
Añadir la URL de devolución de llamada
En Authorization, asegúrese de que la URL de devolución de llamada que aparece a continuación esté incluida en Callback URLs. Si no está incluida, añádala y seleccione Save changes. Utilice siempre este patrón: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, por ejemplo, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Esta es la misma URL que utiliza el conector de Confluence, por lo que una aplicación compartida con Confluence ya la tendrá configurada.
Pestaña Autorización con el campo URL de devolución de llamada y el generador de la URL de autorización.
Definir la distribución
Omita este paso si va a reutilizar una aplicación ya configurada para Confluence.
- Abra Distribution y configure Distribution status como Sharing.
- Complete los campos obligatorios con su propia información: nombre del proveedor, URL de la política de privacidad, URL de los términos del servicio, contacto de atención al cliente y declaración de datos personales.
- Seleccione Save changes.
Edite los controles de distribución, seleccione Sharing y complete los datos del proveedor.
Obtener el ID del cliente y el secreto del cliente
Abra Settings y copie el Client ID y el Secret de Authentication details. Deberá introducirlos posteriormente en Docebo.
3. Acciones necesarias en Docebo
| Información a introducir | Dónde encontrarla |
|---|---|
| ID de cliente | Consola de desarrolladores de Atlassian → aplicación → Settings → Authentication details |
| Secreto del cliente | Consola de desarrolladores de Atlassian → aplicación → Settings → Authentication details |
Autorizar el conector
- Vaya a Add-ons and integrations → Knowledge Connectors → Create → Jira. Este menú solo está visible para los Superadministradores.
En la pestaña Authorize, introduzca el ID del cliente y el Secreto del cliente de su aplicación de Atlassian y, a continuación, seleccione Authenticate.
En la ventana emergente de Atlassian, revise el acceso solicitado y seleccione Accept. El conector aparecerá como conectado. No se iniciará ninguna sincronización, ya que no se copiará ningún dato.
Seleccione los proyectos en los que se podrán realizar búsquedas y guarde su selección.