Leer en inglés

Compartir a través de


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

Captura de pantalla que muestra la pantalla de creación de conexiones para Microsoft Graph Connector for Jira cloud.

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

Captura de pantalla que muestra la pestaña Usuarios donde puede configurar permisos de acceso y reglas de asignación de 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

Captura de pantalla que muestra la pestaña Sincronizar donde puede configurar la frecuencia de rastreo.

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.