Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
| Tarea | Role |
|---|---|
| Identificación de la dirección URL de la instancia | Administrador de Confluence |
| Revisar la configuración de espacios y páginas | Administrador de Confluence |
| Definición de la asignación de atributos | Administrador de Confluence |
| Configuración de permisos de acceso de usuario | Administrador de Confluence |
| Adición de descripciones a espacios y páginas | Administrador de Confluence |
| Configuración de la sincronización de id. de entra en crowd | Administrador de Confluence |
Configuración de requisitos previos
| Tarea | Role |
|---|---|
| Creación de una cuenta de servicio | Administrador de Confluence |
| Identificación del recuento de elementos para la ingesta | Administrador de Confluence |
| Configuración de CQL para la búsqueda avanzada | Administrador de Confluence |
| Aprovisionamiento de un punto de conexión de OAuth | Administrador de Confluence |
| Agregar dirección IP a la lista de permitidos | Administrador de confluencia/administrador de red |
| Validación de la indexación de Copilot | Administrador de Confluence |
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:
- Inicie sesión en su cuenta de Confluence .
- Elija Direcciones URL de producto.
- 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.
| Característica | Grupos LDAP | Grupos nativos de confluencia |
|---|---|---|
| Origen | Administrado en un directorio externo | Administrado en Confluence |
| Sincronizar | Sincronización periódica a través de la configuración del directorio de usuario | Creados y mantenidos manualmente por los administradores de Confluence |
| Escalabilidad | Altamente escalable para uso empresarial | Adecuado para equipos pequeños o configuraciones solo de Confluence |
| Control de acceso | Refleja automáticamente los cambios en el directorio | Requiere actualizaciones manuales |
| Auditoría y cumplimiento | Alineación con las directivas de TI y los marcos de cumplimiento | Control descentralizado |
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.
Nota:
Los cambios en la cuenta de servicio pueden afectar a la sincronización de datos con Microsoft 365. Si se modifica la cuenta, es posible que tenga que volver a autenticar el conector en Microsoft 365.
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.
Nota:
Los permisos solo se administran en el nivel de espacio y página. No se tienen en cuenta los permisos de página primaria.
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:
Abra una ventana de exploración de InPrivate e inicie sesión en el portal de administración con sus credenciales.
En el portal de administración, seleccione el origen de datos de Confluence y comience a crear la conexión.
En Autenticación, seleccione OAuth 2.0.
Escriba el identificador de cliente y el secreto de cliente de la aplicación creada por el administrador de Confluence.
Seleccione Autorizar. Se abre una ventana emergente.
Copie la dirección URL del elemento emergente y compárela con el administrador de Confluence.
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.
Una vez que el administrador de Confluence confirme la aprobación, vuelva a la ventana emergente.
Haga clic con el botón derecho en la ventana emergente y seleccione Inspeccionar>consola.
En la consola, pegue el siguiente comando:
window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')Nota:
Si el pegado está deshabilitado, escriba
allow pastingprimero en la consola y, a continuación, pegue el comando de nuevo.Aparece un mensaje correcto en la pantalla de creación de la conexión y el botón Crear se activa.
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:
- Ve a
https://<Confluence instance name>.atlassian.net/wiki/admin/space-reports. - En Informe de espacio, seleccione Crear informe.
- Seleccione Descargar para exportar el informe.
- Abra el archivo .csv descargado.
- En la columna Recuento de contenido , revise el número de páginas que se sincronizarán en cada espacio.
Nota:
El contenido generado por IA en el informe puede ser inexacto. Revise el contenido antes de continuar.
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. -
labelin ("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.
Sugerencia
- Para el filtrado de etiquetas, use etiqueta en (...) para que coincida con varias etiquetas.
- Para las funciones de fecha, CQL admite funciones dinámicas como
startOfYear()oendOfMonth()para simplificar el filtrado de fechas. Por ejemplo,lastmodified >= startOfYear()devuelve páginas modificadas desde el principio del año actual.
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:
-
yourUsernameyyourPasswordcon sus credenciales o use la autenticación basada en tokens. -
https://your-confluence-urlcon la dirección URL base de Confluence. -
SPACEKEYcon la clave de espacio. -
your-labelcon 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.
| Nombre de ámbito | Código |
|---|---|
| Ver los detalles del contenido Ver detalles sobre el contenido y sus propiedades asociadas. |
read:content-details:confluence |
| Visualización de registros de auditoría Ver y exportar registros de auditoría para eventos de Confluence. |
read:audit-log:confluence |
| Ver páginas Ver el contenido de la página. |
read:page:confluence |
| Ver grupos Vea los detalles sobre los grupos, incluidos sus miembros. |
read:group:confluence |
| Ver los detalles del usuario Ver los detalles del usuario. |
read:user:confluence |
| Ver espacios Ver los detalles del espacio. |
read:space:confluence |
| Ver restricciones de contenido y permisos de espacio Ver las restricciones de contenido y los detalles de los permisos de espacio. |
read:permission:confluence |
| Ver resúmenes de contenido Ver información sobre el contenido. Tenga en cuenta que esto no proporciona acceso al propio contenido. |
read:content.metadata:confluence |
| Ver comentarios Ver comentarios en páginas o entradas de blog. |
read:comment:confluence |
| Visualización y descarga de datos adjuntos de contenido Vea y descargue los datos adjuntos de una página o entrada de blog a la que tenga acceso. |
read:attachment: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:
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:
- Revise si todos los elementos necesarios se sincronizan con Microsoft, en función de los requisitos previos.
- Vaya a la página Detalles del conector .
- Compruebe que el recuento de índices coincide con el recuento de páginas en el espacio confluence configurado.