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.
- 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.
- 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.
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.net
a . 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.
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.
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.net
a .
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:
Inicie sesión en la consola de Atlassian Developer con su cuenta de administrador de Atlassian Jira.
Seleccione activado
Create
y seleccioneOAuth 2.0 integration
.Proporcione un nombre adecuado para la aplicación y cree la nueva aplicación.
Vaya a desde el panel de navegación de
Permissions
la izquierda. SeleccioneAdd
y haga clic enConfigure
.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
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.Vaya a
Settings
desde el panel de navegación de la izquierda para obtener ySecret
Client 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.
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".
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.
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:
- 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.
- 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.
Elección de proyectos y filtrado de datos
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.
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.
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.
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.
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.