Compartir a través de

Conector de Microsoft Graph en la nube de Confluence

  • Artículo

El conector de Microsoft Graph en la nube de Confluence permite a su organización indexar el contenido de Confluence. Después de configurar el conector y los datos de índice desde el sitio de Confluence, los usuarios finales pueden buscar esos contenidos en Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a los administradores de Microsoft 365 que son responsables de configurar, ejecutar y supervisar el conector de Microsoft Graph en la nube de Confluence. Complementa las instrucciones generales proporcionadas en la configuración de conectores de Microsoft Graph en el Centro de administración de Microsoft 365.

Ventajas

  • Funcionalidades de búsqueda mejoradas: los usuarios pueden formular preguntas en lenguaje natural sobre el contenido wiki en Copilot, como:
    • Resumen del documento de arquitectura
    • Cómo obtener acceso a un portal
  • Compatibilidad con la búsqueda semántica: los usuarios pueden realizar consultas de lenguaje natural para obtener respuestas precisas.

Requisitos previos

  1. Debe ser el administrador del inquilino de Microsoft 365 de su organización y el administrador del sitio de Confluence de la organización.
  2. Autenticación: asegúrese de que tiene credenciales de autenticación con el acceso adecuado.

Limitaciones

  • No indexa los archivos adjuntos ni los comentarios.

Importante

  • Atlassian está desusando un conjunto de API en la nube de Confluence (versión V1) y lanzando nuevas API (versión V2). Puede leer sobre sus anuncios aquí o aquí. Algunas de estas API v1 en desuso las usa el conector solo para las conexiones de OAuth . Por lo tanto, después de este cambio, es posible que las conexiones de Confluence existentes dejen de funcionar. Este cambio está programado para enero de 24.
  • El cambio para migrar a las nuevas API v2 se publicó a todos los clientes en diciembre de 2023. Después de esta versión, las conexiones existentes deben volver a autenticarse. Las nuevas API v2 también requieren algunos ámbitos más (en comparación con las API de v1 anteriores) que deben proporcionarse durante la nueva autenticación. Se requiere un nuevo conjunto de ámbitos (lista completa): read:group:confluence, read:user:confluence, , Read:space:confluenceread:content-details:confluence, Read:permission:confluence, , read:content.metadata:confluenceread:audit-log:confluencey read:page:confluence.

Introducción

En este vídeo se proporciona una guía paso a paso sobre cómo agregar el conector de Microsoft Graph en la nube de Confluence.

1. Nombre para mostrar

Un nombre para mostrar se usa para identificar cada referencia 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 Confluence Cloud

Para conectarse al sitio de Confluence, use la dirección URL del sitio. Normalmente, una dirección URL del sitio en la nube de Confluence se parece a https://< organization_name.atlassian.net/>.

3. Tipo de autenticación

Para autenticar y sincronizar contenido desde Confluence On-prem, elija uno de los dos métodos admitidos:

Sugerencia

Asegúrese de que la cuenta de servicio tiene acceso de vista al contenido de Confluence que desea indexar.

a. Autenticación básica
Para autenticarse mediante la autenticación básica, escriba el nombre de usuario (normalmente el correo electrónico) y el token de API. Para ayudar a generar un token de API, consulte la guía de Atlassian.

b. OAuth 2.0 (recomendado)
Registre una aplicación en Confluence Cloud para que la aplicación Microsoft Search y Microsoft 365 Copilot puedan 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 Confluence.

  2. Haga clic en Crear y seleccione OAuth 2.0 integration.

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

  4. Vaya a Permissions desde el panel de navegación de la izquierda. Haga clic en Agregar para Confluence API. Una vez agregado, haga clic en Configurar y Editar ámbitos y seleccione los siguientes ámbitos.

    Nombre de ámbito Código Descripción
    Ver los detalles del contenido read:content-details:confluence Rastreo de contenido que cumple los criterios.
    Ver grupos read:group:confluence Para acceder a los permisos de grupo de contenido.
    Ver los detalles del usuario read:user:confluence Para acceder a los detalles de usuario individuales para admitir permisos.

  5. Haga clic en Guardar.

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

  7. Vaya a Configuración desde el panel de navegación de la izquierda. Obtendrá el id. de cliente y el secreto de esta página.

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

6. Lanzamiento a un público limitado

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 más información sobre el lanzamiento limitado, haga clic aquí.

En este momento, está listo para crear la conexión para ServiceNow Knowledge. Puede hacer clic en el botón "Crear" y el conector de Microsoft Graph en la nube de Confluence inicia la página de indexación desde la cuenta de Confluence.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., establecemos valores predeterminados en función de lo que funciona mejor con los datos de Confluence. Los valores predeterminados son los siguientes:

Usuarios  
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  
Incluir o excluir espacio Todo
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, haga clic aquí.
Sync  
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la Custom Setup opción .

Configuración personalizada

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

Usuarios

Permisos de acceso

El conector de Microsoft Graph en la nube de Confluence admite permisos de búsqueda visibles para todos o solo las 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 búsqueda de los usuarios que tengan acceso a ellos. En Confluence Cloud, los permisos de seguridad para usuarios y grupos se definen mediante permisos de espacio y restricciones de página. Las restricciones de nivel de página, si están presentes, tienen prioridad sobre los permisos de espacio.

Si no hay restricciones de página, el conector comprueba si hay permisos de nivel de espacio:

  • En caso de que el espacio tenga habilitado el acceso de "usuarios anónimos", el contenido es visible para todos los usuarios del inquilino.
  • En caso de que no se habilite el "acceso anónimo", no se respetan los permisos de nivel de espacio.
  • En caso de que no se definan permisos de nivel de espacio, el contenido no es visible para ningún usuario del inquilino.

Importante

Los permisos se administran solo en el nivel de espacio y página, y no se tienen en cuenta los permisos de página primaria.

Si elige Solo personas con acceso a este origen de datos, debe elegir aún más si el sitio de Confluence tiene Microsoft Entra ID usuarios aprovisionados o usuarios que no son de AAD.

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

  1. Elija la opción Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Confluence es el mismo que el userprincipalName (UPN) de los usuarios de Microsoft Entra ID.
  2. Elija la opción que no es de AAD si el identificador de correo electrónico de los usuarios de Confluence es diferente del userprincipalName (UPN) de los usuarios de Microsoft Entra ID.

Nota:

  • Si elige Microsoft Entra ID como el tipo de origen de identidad, el conector asigna los identificadores de correo electrónico de los usuarios obtenidos de Confluence directamente a la propiedad UPN de Microsoft Entra ID.
  • Si eligió "No AAD" para el tipo de identidad, consulte Asignación de identidades que no son de Azure AD para obtener instrucciones sobre cómo asignar las identidades. Puede usar esta opción para proporcionar la expresión regular de asignación del identificador de correo electrónico a UPN.
  • Novedades a usuarios o grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten actualmente el procesamiento de actualizaciones de permisos.

Contenido

Inclusión o exclusión de datos que desea indexar

Con una cadena de Lenguaje de consulta de confluencia (CQL), puede especificar condiciones para sincronizar páginas. Es como una cláusula Where en una instrucción SELECT de SQL . Por ejemplo, puede optar por indexar solo las páginas modificadas en los dos últimos años. Para obtener información sobre cómo crear su propia cadena de consulta, consulte Búsqueda avanzada mediante CQL. El conector indexa todos los blogs y páginas de forma predeterminada.

Sugerencia

Puede usar el filtro CQL para indexar el contenido modificado después de un tiempo determinado mediante lastModified >= "2018/12/31"

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y la cadena de CQL.

Administrar propiedades

En este paso, puede agregar o quitar las propiedades disponibles del origen de datos de Confluence. De forma predeterminada, se seleccionan algunas propiedades. La lista de propiedades que seleccione aquí puede afectar a cómo puede filtrar, buscar y ver los resultados en Microsoft 365 Copilot.

Source (propiedad) Etiqueta Descripción
Autores authors Nombre de las personas que participaron o colaboraron en el elemento del origen de datos.
CreatedByName createdBy Nombre de la persona que más recientemente editó el elemento en el origen de datos.
CreatedOn createdDateTime Fecha y hora en que se creó el elemento en el origen de datos.
IconUrl iconUrl Dirección URL del icono asociado del elemento.
Cargo title El título del elemento que desea que se muestre en la búsqueda y en otras experiencias.
UpdatedByName lastModifiedBy Nombre de la persona que más recientemente editó el elemento en el origen de datos.
UpdatedOn lastModifiedDateTime Fecha y hora en que el elemento se modificó por última vez en el origen de datos.
Url url Dirección URL de destino del elemento en el origen de datos.

Vista previa de datos

Use el botón vista previa de los resultados para comprobar las propiedades y los filtros seleccionados.

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 Microsoft Graph de Confluence Cloud. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, haga clic aquí. Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Revisión y prueba de la conexión

Para MS Search, si necesita personalizar la página de resultados de la búsqueda. Para obtener información sobre cómo personalizar los resultados de la búsqueda, vea Personalizar la página de resultados de búsqueda.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.