Configuración del servicio En la nube de Confluence para la ingesta de conectores

El conector de Confluence Cloud Microsoft 365 Copilot integra contenido de Confluence en Microsoft 365, lo que permite a Copilot, Copilot Search y Microsoft Search exponer páginas wiki, blogs y datos adjuntos pertinentes directamente dentro de aplicaciones como Teams, Outlook y SharePoint.

En este artículo se proporciona información sobre los pasos de configuración que los administradores de Confluence deben completar para configurar Confluence Cloud para su organización, incluida la configuración del entorno y la configuración de requisitos previos para el conector de Confluence Cloud.

Para obtener información sobre cómo implementar el conector, consulte Implementación del conector de Confluence Cloud.

Lista de comprobación de configuración

En las siguientes listas de comprobación se muestra el paso implicado en la configuración del entorno y la configuración de los requisitos previos del conector.

Configurar el entorno

Configuración de requisitos previos

Configuración del entorno de Confluence

En las secciones siguientes se describen las tareas de administración para configurar el entorno de Confluence con el fin de habilitar y optimizar la conexión.

Identificación de la dirección URL de la instancia de Confluence

Por lo general, la dirección URL de la instancia de Confluence Cloud tiene el siguiente formato:

• https://<organization_name>.atlassian.net/wiki

Para identificar la dirección URL de la instancia de Confluence Cloud:

1. Inicie sesión en su cuenta de Confluence .
2. Elija Direcciones URL de producto.
3. En Direcciones URL predeterminadas, busque el nombre del sitio y el producto.

También puede ver la dirección URL en el explorador cuando use Confluence Cloud.

Revisión de la configuración de espacios y páginas de Confluence

Para optimizar la indexación y los resultados de búsqueda, revise la configuración de espacios y páginas tanto en Confluence Cloud como en El Centro de datos de Confluence. Esto ayuda a garantizar que los resultados de la búsqueda en Microsoft 365 sean completos, seguros y estén alineados con las expectativas del usuario.

En Confluence Cloud, asegúrese de que los espacios siguen convenciones de nomenclatura claras, usan etiquetas de forma coherente y aplican permisos que coincidan con la visibilidad prevista para Copilot, Copilot Search y Microsoft Search. Organice las páginas en una jerarquía lógica y use títulos y metadatos significativos para mejorar la precisión de la búsqueda.

Definición de la asignación de atributos de Confluence

El método predeterminado para asignar las identidades del origen de datos a Microsoft Entra ID es determinar si la dirección de correo electrónico de cada usuario de Confluence coincide con el nombre principal de usuario (UPN) o la dirección de correo electrónico en Microsoft Entra ID. Si esta asignación predeterminada no satisface las necesidades de su organización, puede definir una fórmula de asignación personalizada.

Para obtener más información sobre la asignación de identidades que no están en Microsoft Entra ID, consulte Asignación de identidades de AD que no son Azure.

Configuración de permisos de acceso de usuario

Los administradores de Confluence pueden integrar directorios LDAP, como Microsoft Entra ID, para administrar de forma centralizada el acceso y los permisos de los usuarios. Al sincronizar grupos LDAP en Confluence, los administradores pueden asignar esos grupos a espacios y páginas para controlar el acceso de visualización y edición para alinearse con la gobernanza de identidades de toda la empresa.

Puede usar grupos anidados sincronizados para administrar listas de control de acceso (ACL), siempre que los miembros del grupo anidado formen parte de un grupo de usuarios de Confluence.

En la tabla siguiente se proporciona una comparación de los grupos LDAP y los grupos nativos de Confluence para los permisos de acceso de usuario de Confluence.

Adición de descripciones para espacios y páginas

Copilot usa las descripciones y descripciones breves de Confluence para buscar coincidencias semánticas entre espacios y páginas con avisos del usuario. Si faltan descripciones, se reduce la relevancia de las respuestas de Copilot. Asegúrese de agregar descripciones y descripciones breves para espacios y páginas en la instancia de Confluence.

Configuración de la sincronización de id. de entra en crowd

Puede configurar Microsoft Entra ID como directorio en Crowd. Al configurar Microsoft Entra ID, todos los cambios en los usuarios, grupos y pertenencias se sincronizan entre Microsoft Entra ID y Crowd periódicamente, o siempre que lo solicite. Puede ver información sobre los usuarios directamente en Crowd mediante el explorador de usuarios y el explorador de grupos.

Para obtener más información, consulte Configuración de Microsoft Entra ID.

Configuración de requisitos previos del conector

En las secciones siguientes se describen los pasos previos que se van a completar antes de implementar el conector de Confluence.

Creación de una cuenta de servicio

Para permitir que el conector de Confluence actualice los elementos con regularidad, configure una cuenta de servicio con acceso de lectura a tablas de conocimiento de Confluence específicas.

Asegúrese de que la cuenta de servicio tiene permisos de lectura para las siguientes tablas necesarias:

• Espacios

Conceda permisos de lectura en todas las tablas aplicables. Para obtener más información, vea Conceder permisos de administrador a los usuarios.

Asegúrese de que la cuenta de servicio está configurada correctamente. Si no existen restricciones de nivel de página, el conector comprueba los permisos de nivel de espacio y sirve el contenido de la siguiente manera:

• Si el acceso anónimo está habilitado para un espacio, su contenido es visible para todos los usuarios del inquilino.
• Si el acceso anónimo está deshabilitado, se aplican permisos de nivel de espacio.
• Si no se definen permisos de nivel de espacio, el contenido no será visible para los usuarios del inquilino.

Error de OAuth debido a credenciales no válidas

Si el administrador de Microsoft 365 tampoco es un administrador de Confluence Cloud, se produce un error en la autorización de conexión con el error "Credenciales de conexión no válidas". Para resolver este error, el administrador de Microsoft 365 puede seguir estos pasos:

1. Abra una ventana de exploración de InPrivate e inicie sesión en el portal de administración con sus credenciales.

2. En el portal de administración, seleccione el origen de datos de Confluence y comience a crear la conexión.

3. En Autenticación, seleccione OAuth 2.0.

4. Escriba el identificador de cliente y el secreto de cliente de la aplicación creada por el administrador de Confluence.

5. Seleccione Autorizar. Se abre una ventana emergente.

6. Copie la dirección URL del elemento emergente y compárela con el administrador de Confluence.

7. Pida al administrador de Confluence que inicie sesión en su cuenta de Confluence y apruebe la solicitud. Después de la aprobación, aparece una pantalla en blanco, lo que confirma que se ha realizado correctamente.

8. Una vez que el administrador de Confluence confirme la aprobación, vuelva a la ventana emergente.

9. Haga clic con el botón derecho en la ventana emergente y seleccione Inspeccionar>consola.

10. En la consola, pegue el siguiente comando: window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')

    Nota:

    Si el pegado está deshabilitado, escriba allow pasting primero en la consola y, a continuación, pegue el comando de nuevo.

11. Aparece un mensaje correcto en la pantalla de creación de la conexión y el botón Crear se activa.

12. Ahora puede cerrar la ventana emergente.

Identificación del recuento de elementos para la ingesta

Para comprobar el recuento de elementos esperado para la ingesta en todos los conectores aplicables en Confluence Cloud:

1. Ve a https://<Confluence instance name>.atlassian.net/wiki/admin/space-reports.
2. En Informe de espacio, seleccione Crear informe.
3. Seleccione Descargar para exportar el informe.
4. Abra el archivo .csv descargado.
5. En la columna Recuento de contenido , revise el número de páginas que se sincronizarán en cada espacio.

Configuración de CQL para la búsqueda avanzada

Para recuperar páginas de un espacio específico en Confluence Cloud que tienen ciertas etiquetas y que se modificaron por última vez dentro de un período de tiempo definido, use Lenguaje de consulta de Confluence (CQL).

Incluya los siguientes componentes en la consulta:

• Clave de espacio : identifica el espacio que desea buscar.
• Tipo de página : filtra los resultados para incluir solo páginas.
• Etiquetas : filtra las páginas por una o varias etiquetas.
• Fecha de última modificación : limita los resultados a las páginas modificadas dentro de un período de tiempo específico.

En el ejemplo siguiente se muestra una consulta CQL.

CQLtype = page AND space = "SPACEKEY" AND label in ("label1", "label2") AND lastmodified >= "2025-01-01"

En el ejemplo anterior:

• type = página: devuelve solo pages.
• space = "SPACEKEY": reemplace "SPACEKEY" por la clave real del espacio.
• label in ("label1", "label2"): devuelve pages con label1 o label2.
• lastmodified >= "2025-01-01": devuelve las páginas modificadas el 1 de enero de 2025 o después.

Puede ajustar el formato de fecha a yyyy-MM-dd o yyyy-MM-dd HH:mm para incluir la hora.

Para ejecutar la consulta mediante la API REST de Confluence Cloud, use la siguiente solicitud POST.

curl -u yourUsername:yourPassword \
     -X POST "https://your-confluence-url/rest/api/search" \
     -H "Content-Type: application/json" \
     -d '{
           "cql": "type=page AND space=\"SPACEKEY\" AND label=\"your-label\" AND lastmodified >= \"2025-01-01\"",
           "limit": 25,
           "start": 0
         }'

Reemplazar:

• yourUsername y yourPassword con sus credenciales o use la autenticación basada en tokens.
• https://your-confluence-url con la dirección URL base de Confluence.
• SPACEKEY con la clave de espacio.
• your-label con la etiqueta deseada.
• Ajuste la fecha y la paginación según sea necesario.

Aprovisionamiento de un punto de conexión de OAuth

Para permitir que el conector de Confluence Cloud acceda a la instancia de Confluence Cloud, un administrador de Confluence debe aprovisionar un punto de conexión de OAuth para permitir que la aplicación Microsoft Search y Microsoft 365 Copilot accedan a la instancia.

Para obtener instrucciones detalladas, consulte Registro de una aplicación en Confluence Cloud.

Use la tabla siguiente para determinar qué ámbitos seleccionar al configurar el acceso a través de la API de Confluence.

Agregar dirección IP a la lista de permitidos

Para asegurarse de que el conector puede acceder a las API de Confluence, agregue las direcciones IP de Microsoft 365 necesarias a la lista de permitidos en el firewall, proxy u otras configuraciones de red.

Para Confluence Cloud, si la configuración de red bloquea el acceso a las API de Confluence, asegúrese de que se permiten las direcciones IP enumeradas en las siguientes páginas de documentación:

• Reglas de firewall de IP
• Direcciones IP y dominios que se van a permitir en el firewall corporativo

Validación de la indexación de Copilot para Confluence

Para confirmar que Microsoft 365 Copilot puede acceder al contenido necesario desde Confluence, siga estos pasos de validación:

1. Revise si todos los elementos necesarios se sincronizan con Microsoft, en función de los requisitos previos.
2. Vaya a la página Detalles del conector .
3. Compruebe que el recuento de índices coincide con el recuento de páginas en el espacio confluence configurado.

Paso siguiente