Conector de Microsoft Graph en la nube de Atlassian Jira

El conector de Microsoft Graph en la nube jira de Atlassian permite a su organización indexar los problemas de la instancia de la nube de Jira. Después de configurar el conector, los usuarios finales pueden buscar estos problemas desde Jira en Microsoft Copilot y desde cualquier cliente de Microsoft Search.

Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector de Jira Cloud Graph.

Capacidades

• Problemas de índice (o incidencias) desde la nube de Jira
• Permitir que los usuarios finales hagan preguntas relacionadas con el seguimiento de proyectos, las consultas de soporte técnico o la ejecución de tareas en Copilot.
  • Busque el problema con la aplicación móvil que no se carga.
  • Busque las tareas de Jira notificadas por John para actualizar la documentación sobre la migración de API.
  • Resumir CP-1234.
• Use la búsqueda semántica en Copilot para permitir a los usuarios encontrar contenido relevante basado en palabras clave, preferencias personales y conexiones sociales.

Limitaciones

• El conector no admite el rol de aplicación "Cualquier usuario que haya iniciado sesión" para conceder acceso a los problemas a los usuarios.
• El conector no indexa los datos adjuntos.

Requisitos previos

• Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.

• Dirección URL de la instancia de jira cloud: para conectarse a los datos de Jira, necesita la dirección URL de la instancia de Jira de su organización. La dirección URL de la instancia de Jira de su organización suele ser similar https://<your-organization-domain>.atlassian.neta . Si aún no tiene una instancia, consulte la página para crear una instancia de prueba.

• Cuenta de servicio: para conectarse a Jira y permitir que Microsoft Graph Connector actualice los problemas con regularidad, necesita una cuenta de servicio con los siguientes permisos concedidos.

  Nombre del permiso	Tipo de permiso	Requerido para
  Examinar proyectos	Permiso de proyecto	Problemas de rastreo de Jira. Este permiso es obligatorio para los proyectos que deben indexarse.
  Permisos de seguridad de nivel de problema	Seguridad de nivel de problema	Rastrear diferentes tipos de problemas. Este permiso es opcional.
  Examinar usuarios y grupos	Permiso global	Recorte de seguridad basado en los permisos de acceso de los resultados de búsqueda. Este permiso es opcional y es necesario para seleccionar Only people with access to this data source la opción en el paso 4 siguiente.
  Administrar Jira	Permiso global	Recorte de seguridad basado en los permisos de acceso de los resultados de búsqueda. Este permiso es opcional y es necesario para seleccionar Only people with access to this data source la opción en el paso 4 siguiente.

Introducción

1. Nombre para mostrar

Se usa un nombre para mostrar para identificar cada cita en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

2. Dirección URL de la nube de Jira

Para conectarse a los datos de la nube de Jira, necesita la dirección URL de la instancia de Jira de su organización. La dirección URL de la instancia de Jira de su organización suele ser similar https://<your-organization-domain>.atlassian.neta .

3. Tipo de autenticación

Para autenticar y sincronizar problemas desde Jira, elija uno de los dos métodos admitidos:

a. Autenticación básica
Escriba el nombre de usuario de la cuenta (normalmente el identificador de correo electrónico) y el token de API para autenticarse mediante la autenticación básica. Consulte la documentación de Atlassian sobre cómo administrar tokens de API para su cuenta de Atlassian para obtener más información sobre cómo generar un token de API.

b. Atlassian Jira OAuth 2.0 (recomendado)

Para usar Jira OAuth para la autenticación, siga estos pasos.

Registre una aplicación en Atlassian Jira para que la aplicación Microsoft Search pueda acceder a la instancia. Para más información, consulte la documentación de soporte técnico de Atlassian sobre cómo habilitar OAuth 2.0.

En los pasos siguientes se proporcionan instrucciones sobre cómo registrar la aplicación:

1. Inicie sesión en la consola de Atlassian Developer con su cuenta de administrador de Atlassian Jira.

2. Seleccione activado Create y seleccione OAuth 2.0 integration.

3. Proporcione un nombre adecuado para la aplicación y cree la nueva aplicación.

4. Vaya a desde el panel de navegación de Permissions la izquierda. Seleccione Add y haga clic en Configure.Jira API En el encabezado "Permisos granulares", agregue los ámbitos siguientes.

   #	Nombre de ámbito	Código
   1	Ver campos	read:field:jira
   2	Visualización de avatares	read:avatar:jira
   3	Ver categorías de proyecto	read:project-category:jira
   4	Ver proyectos	read:project:jira
   5	Lectura de configuraciones de campo	read:field-configuration:jira
   6	Ver tipos de problemas	read:issue-type:jira
   7	Ver las propiedades del proyecto	read:project.property:jira
   8	Visualización de usuarios	read:user:jira
   9	Ver roles de aplicación	read:application-role:jira
   10	Ver grupos	read:group:jira
   11	Leer jerarquías de tipos de problema	read:issue-type-hierarchy:jira
   12	Ver versiones del proyecto	read:project-version:jira
   13	Ver componentes del proyecto	read:project.component:jira
   14	Visualización de los detalles del problema	read:issue-details:jira
   15	Visualización de registros de auditoría	read:audit-log:jira
   16	Ver meta del problema	read:issue-meta:jira
   17	Ver roles de proyecto	read:project-role:jira
   18	Ver los niveles de seguridad de problemas	read:issue-security-level:jira
   19	Ver esquemas de seguridad de problemas	read:issue-security-scheme:jira
   20	Ver esquemas de permisos	read:permission-scheme:jira
   21	Ver permisos	read:permission:jira

5. Vaya a Authorization desde el panel de navegación de la izquierda. Agregue la dirección URL de devolución de llamada para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback y guarde los cambios.

6. Vaya a Settings desde el panel de navegación de la izquierda para obtener y SecretClient ID desde esta página.

Complete el paso de configuración de conexión mediante el id. de cliente y el secreto.

Nota:

• Consulte la lista de ámbitos de las aplicaciones de OAuth 2.0 para obtener más información sobre los permisos de Jira.
• Los permisos de OAuth originales (clásicos) están en desuso para la nube de Jira. Consulte el anuncio de registro de cambios para obtener más información.

4. Lanzamiento a audiencia limitada

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para obtener más información sobre el lanzamiento limitado, consulte Lanzamiento preconfigurado.

En este momento, está listo para crear la conexión para la nube de Jira. Puede hacer clic en el botón "Crear" para publicar los problemas de conexión e índice desde su cuenta de Jira.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., tenemos valores predeterminados basados en lo que funciona mejor con los datos jira. Puede ver los valores predeterminados siguientes:

Usuarios	Descripción
Permisos de acceso	Solo las personas con acceso al contenido en el origen de datos.
Identidades de mapa	Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.

Contenido	Descripción
Proyectos de sitio	Todos los proyectos están indexados.
Filtrar datos	Todos los problemas se indizan. No se aplica ningún filtro de tiempo ni criterios JQL.
Administrar propiedades	Para comprobar las propiedades predeterminadas y su esquema, consulte el contenido.

Sincronizar	Descripción
Rastreo incremental	Frecuencia: Cada 15 minutos
Rastreo completo	Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la opción "Configuración personalizada".

Configuración personalizada

La configuración personalizada es para aquellos administradores que quieren editar los valores predeterminados de la configuración enumerada en la tabla anterior. Una vez que haga clic en la opción "Configuración personalizada", verá tres pestañas más: Usuarios, Contenido y Sincronización.

Usuarios

Permisos de acceso

El conector Atlassian Jira admite permisos de búsqueda visibles para todos los usuarios o solo personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de la búsqueda solo para los usuarios que tengan acceso a ellos. En Atlassian Jira, los permisos de seguridad se definen mediante esquemas de permisos de proyecto que contienen grupos de nivel de sitio y roles de proyecto. La seguridad de nivel de problema también se puede definir mediante esquemas de permisos de nivel de problema.

Importante

El conector de Jira cloud Graph debe poder leer el identificador de correo electrónico de un usuario en Jira para asignar permisos de seguridad en Microsoft Search. Esto requiere que se asegure de lo siguiente:

• Todos los usuarios, que forman parte de cuentas administradas, deben tener seleccionada la configuración de cuenta administrada en la configuración de visibilidad del perfil.

  Todos los usuarios deben haber seleccionado la opción "Cualquiera" para su configuración de visibilidad de perfil. Para más información sobre la configuración de visibilidad del perfil, consulte la documentación de Atlassian.

• Los usuarios que no forman parte de la cuenta administrada (igual que la cuenta de rastreo), deben tener seleccionado "Cualquiera" en la configuración de visibilidad de su perfil.

  Para las organizaciones que usan "Cuentas administradas" (todas las cuentas de Atlassian con direcciones de correo electrónico del dominio comprobado se convierten en cuentas administradas. Consulte esta documentación para obtener más información).

Además, la cuenta de rastreo usada durante la configuración de conexión debe tener el dominio de cuenta administrada.

Asignación de identidades

El método predeterminado para asignar las identidades de origen de datos con Microsoft Entra ID consiste en comprobar si el identificador de Email de los usuarios de Jira es el mismo que userprincipalName (UPN) o correo de los usuarios de Microsoft Entra. Si cree que la asignación predeterminada no funcionaría para su organización, puede proporcionar una fórmula de asignación personalizada. Para más información sobre la asignación de identidades no Microsoft Entra ID, consulte Asignación de identidades que no son de Azure AD.

Para identificar qué opción es adecuada para su organización:

1. Elija la opción Microsoft Entra ID si el identificador de Email de los usuarios de Jira es el mismo que el UserPrincipalName (UPN) de los usuarios de Microsoft Entra ID.
2. Elija la opción No Microsoft Entra ID si el identificador de Email de los usuarios de Jira es diferente de UserPrincipalName (UPN) y Email de los usuarios de Microsoft Entra ID.

Nota:

Novedades a grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten el procesamiento de actualizaciones de permisos.

Contenido

Elección de proyectos y filtrado de datos

1. Proyectos de sitio

   Puede elegir para la conexión para indexar todo el sitio jira o solo proyectos específicos.

   • Si decide indexar todo el sitio jira, los problemas de Jira en todos los proyectos del sitio se indizan. Los nuevos proyectos y problemas se indexan durante el siguiente rastreo después de crearlos.

   • Si elige proyectos individuales, solo se indizan los problemas de Jira en los proyectos seleccionados.

   Nota:

   Cuando se concede el permiso Examinar proyectos a un proyecto jira, se muestra en la selección del proyecto y se puede rastrear. Si falta un proyecto, compruebe los permisos de su cuenta.

2. Filtrar datos

   También puede elegir filtrar los problemas de Jira que se indexen de dos maneras.

   • Especifique el período de tiempo de modificación del problema. Esta opción solo indexará los problemas de Jira creados o modificados en el período de tiempo seleccionado de forma gradual en función del rastreo actual.

   • Especifique el JQL. Esta opción solo indexará los problemas de Jira que se devuelven después de filtrar en función del lenguaje de consulta Jira (JQL) proporcionado. Para más información sobre el uso de JQL, consulte la documentación de soporte técnico de Atlassian sobre el uso de la búsqueda avanzada con el lenguaje de consulta Jira.

   Sugerencia

   Puede usar el filtro JQL para indexar solo tipos de problemas de Jira específicos mediante "issueType in (Bug,Improvement)"

Administrar propiedades

Aquí, puede agregar o quitar propiedades disponibles del origen de datos jira, asignar un esquema a la propiedad (definir si una propiedad se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad. Las propiedades seleccionadas de forma predeterminada se enumeran a continuación.

Source (propiedad)	Etiqueta	Descripción	Esquema
Autores	Autores	Asigne un nombre a todas las personas que participaron o colaboraron en el elemento del origen de datos.	Recuperar
Creados	Fecha y hora de creación	Datos y hora en que se creó el elemento en el origen de datos	Consulta, recuperación
IssueDescription	Contenido	Descripción del problema	Búsqueda
IssueIconURL	IconUrl	Dirección URL del icono que representa el tipo de problema.	Recuperar
IssueId
IssueKey
IssueLink	url	La dirección URL objetivo del elemento en el origen de datos	Consulta, recuperación
IssueStatus			Consulta
IssueSummary
ProjectName			Consulta
ReporterEmailId	Creada por		Recuperar
ReporterName			Consulta, recuperación
Título	Título	El título del elemento que desea que se muestre en Copilot y otras experiencias de búsqueda	Buscar, consultar, recuperar
Actualizado	Fecha de la última modificación	Fecha y hora en que el elemento se modificó por última vez en el origen de datos.	Consulta, recuperación

Nota:

• El conector Atlassian Jira puede indexar los campos de problema predeterminados y los campos de problema creados personalizados.
• Si un campo creado personalizado seleccionado no está presente en algunos tipos de problema jira, el campo se ingerirá como NULL (en blanco).

La lista de propiedades que seleccione aquí puede afectar a cómo puede filtrar, buscar y ver los resultados en Copilot para Microsoft 365.

Vista previa de datos

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y el filtro de consulta.

Sincronizar

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector de Graph. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Configurar la página de resultados de búsqueda

Después de crear la conexión, debe personalizar la página de resultados de búsqueda con verticales y tipos de resultados. Para obtener información sobre cómo personalizar los resultados de la búsqueda, revise cómo administrar los tipos de resultados y verticales. También puede usar el diseño de resultados de ejemplo para el conector jira. Copie y pegue el json de diseño de resultados para empezar después de revisar el esquema de la conexión con el esquema necesario para el diseño de ejemplo.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector. Puede encontrar los pasos de solución de problemas para los problemas más vistos en la guía de solución de problemas del conector de Microsoft Graph de Atlassian Jira Cloud.

Si tiene algún otro problema o quiere proporcionar comentarios, póngase en contacto con nosotros en soporte técnico de Microsoft Graph.