Conector de Microsoft Graph local de Confluence (versión preliminar)

El conector de Microsoft Graph local de Confluence permite a su organización indexar el contenido del servidor o centro de datos 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.

Nota:

El conector de Microsoft Graph local de Confluence está en versión preliminar. Si desea obtener acceso anticipado para probarlo, regístrese con este formulario.

Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector de Microsoft Graph local de Confluence. Complementa las instrucciones generales proporcionadas en Configuración de conectores de Microsoft Graph en el Centro de administración de Microsoft 365.

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 Microsoft Graph local de Confluence, incluida la información sobre la solución de problemas y las limitaciones.

Antes de empezar

Instalación del agente del conector de Microsoft Graph (GCA)

Para indexar el contenido del servidor o centro de datos de Confluence, debe instalar y registrar el agente del conector. Consulte Instalación del agente del conector de Microsoft Graph para obtener más información.

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

Nota:

GCA se puede instalar en otra máquina Windows y no es necesario que esté en la misma máquina que el servidor local. La máquina puede ayudar a generar el identificador de aplicación y el secreto que se pueden usar para la configuración. Debe asegurarse de que la máquina GCA está encendida durante el rastreo. 

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

Siga las instrucciones generales del paso 1: Agregar un conector de Microsoft Graph en el Centro de administración de Microsoft 365.

Paso 2: Asignar un nombre a la conexión

Siga las instrucciones generales del paso 2: Asignar un nombre a la conexión.

Paso 3: Configurar las opciones de conexión

Paso 3.1: Seleccionar tipo de implementación

Seleccione la opción Servidor o Centro de datos para indexar el contenido local de Confluence y seleccione Siguiente.

Paso 3.2: Escriba la dirección URL de la instancia de Confluence.

Para conectarse al sitio de Confluence, use la dirección URL del sitio.

Paso 3.3: Seleccionar el agente del conector de Microsoft

Seleccione el agente del conector en la lista desplegable. El agente envía de forma segura contenido local de Confluence al índice de Microsoft.

Paso 3.4: Instalación del complemento On-Prem de Confluence

• Descargar la aplicación desde el complemento on-prem de Microsoft Graph Connectors Confluence | Atlassian Marketplace.
• Inicie sesión en el sistema de confluence.
• Haga clic en el icono de configuración:> haga clic en Administrar aplicaciones
• Haga clic en Cargar aplicación .
• Elija el archivo descargado y continúe

Nota:

El complemento es compatible con la versión de confluencia superior a la 8.0.

Paso 3.5: Seleccionar tipo de autenticación

Puede elegir Autenticación básica o OAuth 1.0a (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 (solo disponible para pruebas en versión preliminar):

Escriba el nombre de usuario de una cuenta de servicio (normalmente el identificador de correo electrónico) y la contraseña para autenticarse mediante la autenticación básica.

OAuth 1.0a

Genere un par de claves pública y privada y cree un vínculo de aplicación en el sitio local de Confluence para que el agente del conector pueda acceder a la instancia. Para más información, consulte el paso 1 en la documentación para desarrolladores de Atlassian sobre cómo configurar OAuth 1.0a.

Paso 3.5.1 Generación de un par de claves pública y privada RSA

Ejecute los siguientes comandos de openssl en el terminal de máquina local.

Paso	Get-Help
Generación de una clave privada de 1024 bits	openssl genrsa -out confluence_privatekey.pem 1024
Creación de un certificado X509	openssl req -newkey rsa:1024 -x509 -key confluence_privatekey.pem -out confluence_publickey.cer -days 365
Extraer la clave privada (formato PKCS8) en el confluence_privatekey.pcks8 archivo	openssl pkcs8 -topk8 -nocrypt -in confluence_privatekey.pem -out confluence_privatekey.pcks8
Extracción de la clave pública del certificado al confluence_publickey.pem archivo	openssl x509 -pubkey -noout -in confluence_publickey.cer > confluence_publickey.pem

Paso 3.5.2 Creación de un vínculo de aplicación

1. En Confluence, vaya a Administración (icono de engranaje) >Configuración> generalVínculos de aplicación en el panel lateral.

2. En el cuadro de texto Escriba la dirección URL de la aplicación que desea vincular , escriba cualquier dirección URL. Por ejemplo, y, a continuación, https://example.com seleccione Crear nuevo vínculo. Ignore No response was received from the URL you entered warning and select Continue (Omitir No se recibió respuesta desde la dirección URL que escribió advertencia) y seleccione Continue (Continuar).

3. En la primera pantalla del cuadro de diálogo Vincular aplicaciones , proporcione un nombre de aplicación y seleccione Tipo de aplicación genérico . Active la casilla Crear vínculo entrante . El resto de campos son opcionales. Seleccione Continuar.

   

4. En la segunda pantalla del cuadro de diálogo Vincular aplicaciones , escriba los detalles del consumidor para el cliente de ejemplo:

   Campo	Valor recomendado
   Clave de consumidor	OAuthkey
   Nombre del consumidor	Microsoft Graph connector App
   Clave pública	Copie la clave pública del confluence_publickey.pem archivo generado a partir del paso 3.4.1 y péguela en este campo (por ejemplo, iuasge87awegrq3...).

5. Seleccione Continuar. Después de la creación correcta, el vínculo de la aplicación se muestra en la pantalla siguiente.

   

Paso 3.4.3 Escriba la clave de consumidor y la clave privada para iniciar sesión.

En la configuración de creación de la conexión asistente en el Centro de administración de Microsoft 365, escriba la clave de consumidor creada durante el paso 3.4.2 y la clave privada del confluence_privatekey.pcks8 archivo en el paso 3.4.1. Habilite la ventana emergente en el explorador para Centro de administración de Microsoft 365 y seleccione Iniciar sesión.

Paso 3.4.4 Escribir código de verificación para finalizar el inicio de sesión

En la pantalla de inicio de sesión de Confluence, escriba las credenciales de la cuenta de servicio. Después de iniciar sesión correctamente, obtendrá un código de verificación como en la pantalla siguiente.

Escriba el código de verificación en la configuración de creación de conexiones asistente y seleccione Finalizar inicio de sesión. Después de iniciar sesión correctamente, seleccione Siguiente.

OAuth 2.0 (recomendado)

En los pasos siguientes se proporcionan instrucciones sobre cómo registrar la aplicación Configurar un vínculo entrante

1. Vaya a Administración > Configuración > general Vínculos de aplicación.
2. Seleccione Crear vínculo
3. Seleccione Aplicación externa y, a continuación, elija Entrante como dirección.
4. Rellene el
   • Dirección URL de redireccionamiento: https://gcs.office.com/v1.0/admin/oauth/callback
   • Ámbito: Administración
5. Complete el paso de configuración de conexión con el identificador de cliente y el secreto.

Paso 4: Seleccionar propiedades

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

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. De forma predeterminada, el conector indexa todas las páginas.

Especifique los espacios que desea indexar: De forma predeterminada, el conector indexará todos los espacios. Sin embargo, puede elegir incluir o excluir espacios específicos mediante la opción de filtro de espacio. Escriba la lista de claves de espacio que desea incluir o excluir y verá una vista previa de los resultados. Clave de espacio: cada espacio de confluencia tiene una clave de espacio, que es un identificador corto y único que forma parte de la dirección URL de ese espacio. Para obtener la clave de espacio, póngase en contacto con el administrador de confluence.

Nota:

• CQL no se admite para Confluence local.
• Conflunce On-prem indexes only current pages and not archived pages

Paso 5: Administrar permisos de búsqueda

El conector de Microsoft Graph local de Confluence 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 búsqueda de los usuarios que tengan acceso a ellos.

En Confluence Local, los permisos de seguridad para usuarios y grupos se definen mediante permisos de espacio y restricciones de página. El conector de Microsoft Graph local de Confluence aplica permisos efectivos proporcionados por la API de restricciones de contenido.

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.

Con fines de prueba, puede elegir publicar en un público limitado.

Limitaciones

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

• El conector de Microsoft Graph local de Confluence no indexa blogs, archivos adjuntos y comentarios.

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 algún otro problema o quiere proporcionar comentarios, póngase en contacto con nosotros en Microsoft Graph | Apoyo