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 administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector de Microsoft Graph en la nube de Confluence. Complementa las instrucciones generales que se proporcionan en el artículo Configuración de conectores de Microsoft Graph en el Centro de administración de Microsoft 365. Si aún no lo ha hecho, lea todo el artículo para comprender el proceso de configuración general.

Cada paso del proceso de instalación se muestra a continuación junto con una nota que indica que debe seguir las instrucciones de configuración general u otras instrucciones que se aplican solo al conector de Confluence Cloud, incluida la información sobre solución de problemas y limitaciones.

Antes de empezar

Debe ser el administrador del inquilino de Microsoft 365 de su organización y el administrador del sitio de Confluence de la organización.

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.

Paso 1: Agregar un conector en el Centro de administración de Microsoft 365

Incorporación del conector de Microsoft Graph en la nube de Confluence

Siga las instrucciones generales de configuración.

Paso 2: Asignar un nombre a la conexión

Siga las instrucciones generales de configuración.

Paso 3: Configurar las opciones de conexión

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/>. Puede elegir Autenticación básica o OAuth 2.0 (recomendado) para autenticarse en el sitio de Confluence.

Sugerencia

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

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. Para más información sobre cómo generar un token de API, consulte la documentación de Atlassian sobre cómo administrar tokens de API para su cuenta de Atlassian.

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.
  1. Haga clic en Guardar.
  2. 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.
  3. 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.

Paso 4: Seleccionar propiedades y filtrar datos

En este paso, puede agregar o quitar las propiedades disponibles del origen de datos de Confluence. Microsoft 365 ha seleccionado algunas propiedades de forma predeterminada.

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.

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 que se han modificado 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.

Paso 5: Administrar permisos de búsqueda

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.

Paso 6: Asignar etiquetas de propiedad

Siga las instrucciones generales de configuración.

Paso 7: Administrar esquema

Siga las instrucciones generales de configuración.

Paso 8: Elegir la configuración de actualización

Siga las instrucciones generales de configuración.

Nota:

Para las actualizaciones de permisos de acceso, solo se aplica la programación de rastreo completa.

Paso 9: Revisión de la conexión

Siga las instrucciones generales de configuración.

Después de publicar la conexión, debe personalizar la página de resultados de 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.

Paso 10: Configurar la página de resultados de búsqueda

Después de publicar 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 en la nube de Confluence. Copie y pegue el json de diseño de resultados para empezar.

Limitaciones

El conector de Confluence Cloud tiene las siguientes limitaciones conocidas en su versión más reciente:

  • El conector de Confluence Cloud no indexa los archivos adjuntos y los comentarios.
  • Las implementaciones del servidor de indexación y del centro de datos se publican como conectores independientes.

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 pasos de solución de problemas para los problemas más vistos aquí.

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