Conector de Microsoft Graph local de Confluence
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.
Este artículo está pensado para administradores de Microsoft 365 y responsables de configurar, ejecutar y supervisar el conector de Microsoft Graph local de Confluence. Complementa las instrucciones generales proporcionadas en la configuración de los 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
- Resumen del documento de arquitectura
-
Compatibilidad con búsqueda semántica: los usuarios pueden realizar consultas de lenguaje natural para obtener respuestas precisas.
- Compatibilidad: admite versiones de Confluence superiores a la 8.0.
Requisitos previos
- Instale el GCA [agente del conector de Graph]: asegúrese de que la GCA está instalada en un equipo Windows dentro de la misma red que el origen de datos, accesible a través de la dirección URL de Confluence. Puede encontrar más información sobre el agente del conector de Microsoft Graph.
- Instalar complemento: descargue e instale el complemento local de confluence desde Atlassian Marketplace en la configuración de confluence. Obtención del complemento de Microsoft Graph Connectors Confluence On-prem Plugin | Atlassian Marketplace
- Autenticación: asegúrese de que tiene credenciales de autenticación con acceso correcto.
Introducción
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 local de Confluence
Para conectarse a los datos locales de Confluence, necesita la dirección URL de la instancia de Confluence de su organización. La dirección URL de la instancia de Confluence de su organización suele parecerse a ""https://contoso.atlassian.net.
3. Agente del conector de 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. Puede encontrar respuestas a las preguntas más frecuentes sobre GCA en la sección de preguntas más frecuentes .
4. Instalación del complemento local de Confluence
Compruebe que está instalado el complemento on-prem de Microsoft Graph Connectors Confluence. No es necesario instalar el complemento para cada conector de confluence; Si ya está instalado en la instancia de Confluence, puede omitir este paso para las conexiones locales posteriores 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.
5. Tipo de autenticación
Para autenticar y sincronizar contenido desde Confluence On-prem, elija uno de los tres métodos admitidos:
a. Autenticación básica
Para autenticarse en la instancia, escriba el nombre de usuario y la contraseña de la cuenta de Confluence.
b. OAuth1.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.
c. OAuth 2.0 (recomendado)
En los pasos siguientes se proporcionan instrucciones sobre cómo registrar la aplicación Configurar un vínculo entrante.
- Vaya a Administración > Configuración > general Vínculos de aplicación.
- Seleccione Crear vínculo
- Seleccione Aplicación externa y, a continuación, elija Entrante como dirección.
- Rellene el
- Dirección URL de redireccionamiento:
https://gcs.office.com/v1.0/admin/oauth/callback - Ámbito: Administración o lectura
- Complete el paso de configuración de conexión con el identificador de cliente y el secreto.
6. 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 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 inicia la página de indexación desde su 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í. |
| Sincronización | |
|---|---|
| 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 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 content restrictions API
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:
- 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.
- 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.
Importante
- 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
En este paso, puede agregar o quitar las propiedades disponibles del origen de datos de Confluence. Microsoft 365 selecciona algunas propiedades. 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. Escribir 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. Para obtener más información, visite: Claves de espacio
Filtro de página
En este paso, puede especificar el intervalo de fechas para indexar los documentos. Los parámetros son los siguientes:
- Fecha de última creación: fecha en la que se creó un documento. Solo se indizan los documentos modificados después de esta fecha.
- Fecha de última modificación: fecha en que se modificó un documento. Solo se indizan los documentos modificados después de esta fecha.
Importante
- Asegúrese de que las fechas están en orden cronológico. La "Fecha de última creación" no debe ser posterior a la "Fecha de última modificación".
- Si no se especifica ninguna fecha, se tendrán en cuenta todos los documentos para la indexación.
Administrar propiedades
Aquí puede agregar o quitar las propiedades disponibles del origen de datos local de Confluence. Asigne un esquema a la propiedad (defina si una propiedad se puede buscar, consultar, recuperar o refinar). Además, puede cambiar la etiqueta semántica y agregar un alias a la propiedad . Las propiedades predeterminadas son las siguientes:
| Source (propiedad) | Etiqueta | Esquema |
|---|---|---|
| Autor | authors | Consulta, recuperación |
| Contenido | Búsqueda | |
| CreatedByName | Creada por | Buscar, consultar, recuperar |
| CreatedOn | Fecha y hora de creación | Consulta, recuperación |
| Id | Consulta, recuperación | |
| Árbol de página | Recuperar | |
| SpaceName | Buscar, consultar, recuperar | |
| Cargo | title | Buscar, recuperar |
| UpdatedByName | lastModifiedBy | Recuperar |
| UpdatedOn | lastModifiedDateTime | Consulta, recuperación y refinación |
| URL | url | Recuperar |
Vista previa de datos
Use el botón vista previa de los resultados para comprobar las propiedades y los filtros seleccionados.
Nota:
Tenga en cuenta que la vista previa solo respeta el filtrado de nivel de espacio.
Sincronización
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, 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 las pruebas, puede elegir publicar en un público limitado.
- Busque y valide el contenido indexado y los permisos mediante el explorador Index.
- Encuentre respuestas a preguntas comunes en nuestra sección de preguntas más frecuentes.
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.
Limitaciones
- No indexa blogs, archivos adjuntos ni comentarios.
- Solo indexa las páginas actuales; se excluyen las páginas archivadas.
- CQL[Confluence Query Language] no se admite para Confluence local, pero se admite un filtro de nivel de página y espacio.
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.