Compartir a través de


Implementación del conector Copilot local de Confluence

El conector local de Confluence permite a Microsoft 365 indexar y recuperar contenido de instancias autohospedadas de Confluence Data Center o Server. Incluye contenido wiki empresarial en Microsoft Search y Copilot, lo que mejora la visibilidad y la facilidad de uso dentro del ecosistema de Microsoft 365.

En este artículo se describen los pasos para implementar, personalizar y solucionar problemas del conector local de Confluence. Para obtener información general sobre la implementación del conector de Copilot, consulte Configuración de conectores de Copilot en el Centro de administración de Microsoft 365.

Para obtener información de configuración local avanzada de Confluence, consulte Configuración del servicio local de Confluence para la ingesta de conectores.

Requisitos previos

Antes de implementar el conector local de Confluence, asegúrese de que el entorno de Confluence está configurado en su organización. En la tabla siguiente se resumen los pasos para configurar el entorno de Confluence e implementar el conector.

Role Tarea
Administrador de Confluence Configurar el entorno
Administrador de confluencia/administrador de red Configuración de requisitos previos
Administrador de Microsoft 365 Implementar el conector en el Centro de administración de Microsoft 365
Administrador de Microsoft 365 Personalización de la configuración del conector (opcional)

Antes de implementar el conector, asegúrese de que se cumplen los siguientes requisitos previos:

  • Debe ser administrador de Microsoft 365.
  • Instale el Agente del conector de Graph (GCA) en un equipo Windows en la misma red que el servidor de Confluence.
  • Instale el complemento Confluence On-prem desde Atlassian Marketplace.
  • Valide que el complemento web de Confluence Mobile está instalado y habilitado.
  • Asegúrese de que las credenciales de autenticación están disponibles con permisos de administrador de Confluence.
  • Confirme que la versión de Confluence es 8.0 o posterior.

Implementación del conector

Para agregar el conector local de Confluence para su organización:

  1. En el Centro de administración de Microsoft 365, en el panel izquierdo, elija Conectores de Copilot>.
  2. Vaya a la pestaña Conectores y, en el panel izquierdo, elija Galería.
  3. En la lista de conectores disponibles, elija Confluence Local.

Establecer el nombre para mostrar

El nombre para mostrar se usa para identificar referencias en las respuestas de Copilot para ayudar a los usuarios a reconocer el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza y se usa como filtro de origen de contenido.

Puede aceptar el nombre para mostrar local de Confluence predeterminado o personalizar el valor para usar un nombre que reconozcan los usuarios de su organización.

Para obtener más información, consulte Mejora de la detección de Copilot con el contenido de conectores Microsoft 365 Copilot

Establecimiento de la dirección URL de la instancia

Para conectarse al sitio de Confluence, use la dirección URL de la instancia de sitio de la organización. El formato típico es:

  • https://<your-company-domain>/confluence

Para buscar la dirección URL de la instancia:

  • En la consola de Confluence Administración, vaya aDirección URL base del servidorde configuración> general.

Elegir tipo de autenticación

El conector admite los siguientes métodos de autenticación:

  • Autenticación básica: use el nombre de usuario y la contraseña de Confluence.
  • OAuth 1.0a: genere un par de claves pública y privada y cree un vínculo de aplicación. Para obtener más información, vea OAuth.
  • OAuth 2.0 (recomendado): registre un vínculo de aplicación entrante con el ámbito de administrador.

Para la configuración de OAuth 2.0:

  1. Vaya a Administración>Configuración> generalVínculos de aplicación.
  2. Seleccione Crear vínculo>Aplicación> externaEntrante.
  3. Establezca el ámbito en Administración.
  4. Use la siguiente dirección URL de redireccionamiento: https://gcs.office.com/v1.0/admin/oauth/callback.

Implementación

Para implementarse en una audiencia limitada, elija el botón de alternancia situado junto a Lanzamiento a audiencia limitada y especifique los usuarios y grupos a los que se va a implementar el conector. Para obtener más información, consulte Lanzamiento provisional para conectores copilot.

Elija Crear para implementar la conexión. El conector Copilot local de Confluence comienza a indexar contenido de inmediato.

En la tabla siguiente se enumeran los valores predeterminados que se establecen.

Categoría Configuración Valor predeterminado
Usuarios Permisos de acceso Solo las personas con acceso al contenido del origen de datos.
Usuarios Asignar identidades Las identidades de origen de datos se asignan mediante identificadores de Microsoft Entra.
Contenido Incluir o excluir espacio Todos los espacios incluidos.
Contenido Administrar propiedades Para ver las propiedades y esquemas predeterminados, vea Administrar propiedades.
Sincronizar Rastreo incremental Cada 15 minutos.
Sincronizar Rastreo completo Diariamente

Para personalizar estos valores, consulte Personalización de la configuración.

Después de crear la conexión, puede revisar el estado en la sección Conectores de la Centro de administración de Microsoft 365.

Personalización de la configuración

Puede personalizar los valores predeterminados para la configuración del conector local de Confluence. Para personalizar la configuración, en la página del conector del Centro de administración, elija Configuración personalizada.

Personalización de la configuración de usuario

El conector de Confluence Cloud admite los siguientes permisos de búsqueda de usuarios:

  • Todos: los datos indexados son visibles para todos los usuarios.
  • Solo las personas con acceso: los datos indexados solo son visibles para los usuarios con acceso en Confluence.

En Confluence Local, los permisos de seguridad para usuarios y grupos se definen a través de permisos de espacio y restricciones de página. La evaluación de permisos tiene lugar de la siguiente manera:

  • Recupere la configuración de permisos de las restricciones de nivel de página.
  • Recupere la configuración de permisos de las restricciones de página primaria.
  • Recupere la configuración de permisos de los permisos de espacio.
  • Calcule la intersección de las tres configuraciones anteriores para determinar el permiso efectivo en la página. Este conjunto de permisos final se sincroniza con Microsoft 365 Copilot.

Importante

  • En el caso de las versiones del Agente del conector de Microsoft Graph anteriores a la 3.1.14, no se tiene en cuenta la configuración de acceso anónimo definida en el nivel de espacio.
  • Para las versiones del Agente del conector de Microsoft Graph a partir de la versión 3.1.14, se tiene en cuenta la configuración de acceso anónimo definida en el nivel de espacio.

Si elige Solo personas con acceso a este origen de datos, elija si el sitio de Confluence tiene Microsoft Entra ID usuarios aprovisionados o usuarios que no son Microsoft Entra ID:

  • Microsoft Entra ID: elija esta opción si los identificadores de correo electrónico de Confluence coinciden con los nombres principales de usuario (UPN) en Microsoft Entra ID.
  • No Microsoft Entra ID: elija esta opción si los identificadores de correo electrónico de Confluence no coinciden con los UPN. Use regex para asignar identificadores de correo electrónico a UPN.

Novedades a los permisos solo se sincronizan durante los rastreos completos.

Personalización de la configuración de contenido

Puede personalizar la configuración de contenido de las siguientes maneras:

  • Incluya o excluya espacios específicos mediante la opción de filtro de espacio. Cada espacio tiene un identificador de clave de espacio que forma parte de la dirección URL de ese espacio. Para obtener más información, vea Claves de espacio.
  • Especifique un intervalo de fechas para la indexación de documentos. Puede filtrar páginas por fecha de última creación o fecha de última modificación.
  • Agregue o quite propiedades del origen de datos, asigne un esquema a las propiedades (que se pueden buscar, consultar, recuperar, refinar) y cambie las etiquetas semánticas asociadas a las propiedades. En la tabla siguiente se enumeran las propiedades predeterminadas.
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
Title title Buscar, recuperar
UpdatedByName lastModifiedBy Recuperar
UpdatedOn lastModifiedDateTime Consulta, recuperación y refinación
URL url Recuperar

Personalización de intervalos de sincronización

Puede ajustar la frecuencia de sincronización:

  • Rastreo incremental: sincroniza el contenido nuevo y modificado. Los rastreos incrementales no recogen cambios de ACL ni elementos eliminados. El valor predeterminado es cada 15 minutos.
  • Rastreo completo: realiza una sincronización completa de todo el contenido. Los rastreos completos detectan elementos eliminados y sincronizan los cambios de la lista de control de acceso (ACL). El valor predeterminado es diario.

Para obtener más información, consulte Directrices para la configuración de sincronización.