Saltar al contenido principal
Para integrar con Confluence, necesitas crear una aplicación de Atlassian que actuará como un puente entre Zylon ↔ Confluence y configurar Zylon para usar la nueva aplicación de Atlassian

​
Crear una aplicación de Atlassian

Primero necesitas una cuenta de Atlassian que será la propietaria de la aplicación. Recomendamos usar una cuenta no personal. Esta cuenta no necesita tener acceso a ningún Space ya que servirá como un puente entre Zylon y Confluence.
  1. Ve a https://developer.atlassian.com/console/myapps/ Haz clic en Create → OAuth 2.0 integration
image.png
  1. Proporciona un nombre significativo para la Aplicación.
image.png
  1. En distribución:
    • En el menú izquierdo navega a Distribution
    • Haz clic en Edit
image.png
  1. En estado de distribución:
  • Selecciona la casilla Sharing.
  • Ingresa un nombre de proveedor o elige la opción Use your own name.
  • Si tienes una política de privacidad, proporciona el enlace a ella. Si no, usa el enlace por defecto: https://example.com/privacy, que está destinado para uso interno.
  • Para la pregunta “¿Tu aplicación almacena datos personales?”, selecciona No
image.png
  1. En permisos:
  • En el menú izquierdo, navega a Permissions.
  • Haz clic en Add para Confluence API.
  • La página se actualiza automáticamente, y debería aparecer un nuevo botón Configure. Si no aparece, actualiza la página manualmente.
  • Haz clic en Configure.
image.png image.png
  1. Haz clic en Granual scopes y luego en Edit scopes
image.png
  1. Agrega uno por uno los siguientes permisos. Puedes buscarlos pegando los valores en el campo con una lupa. Debe haber un total de 10 scopes agregados que puedes revisar antes de guardar. 
        read:content:confluence,
        read:content-details:confluence,
        read:space-details:confluence,
        read:page:confluence,
        read:attachment:confluence,
        read:blogpost:confluence,
        read:custom-content:confluence,
        read:space:confluence,
        read:space.permission:confluence,
        read:folder:confluence,
image.png image.png
  1. En autorización:
  • En el menú izquierdo, navega a Authorization.
  • Haz clic en Add para OAuth 2.0 (3LO).
image.png
  1. En autorización:
  • En el campo Callback URL, ingresa: https://zylon.company.com/api/app/integration/confluence/callbackReemplaza zylon.company.com con el hostname donde está instalado Zylon en tu servidor.
  • Haz clic en Save changes.
image.png
  1. En configuración:
  • En el menú izquierdo, navega a Settings. Copia los dos valores listados bajo Authentication details:
    • Client ID
    • Secret
Necesitarás estos valores para el siguiente paso: Configurar Zylon para usar la Aplicación de Atlassian image.png

​
Configurar Zylon para usar la Aplicación de Atlassian

Con los valores que hemos adquirido en el paso 10, necesitas editar el archivo de configuración de Zylon ubicado en /etc/zylon/zylon-conf.yaml
El archivo de configuración es un archivo .yaml ¡ten cuidado con la sangría, espacios, punto y coma, comillas dobles!
Agrega el siguiente fragmento al final del archivo 
integration:
  confluence:
    enabled: true
    clientId: ""
    clientSecret: ""
    redirectUri: ""
Y completa las propiedades con los valores generados previamente:
  • clientId → valor generado en el paso 10
  • clientSecret → valor generado en el paso 10
  • redirectUri → mismo valor que en el paso 9
Guarda y cierra el archivo /etc/zylon/zylon-conf.yaml Finalmente, ejecuta el siguiente comando para reiniciar Zylon y actualizar la configuración 
zylon-cli update
¡Todo está listo 🎉

​
Solución de Problemas

​
Intento cargar archivos a la base de conocimiento y el botón de Confluence está deshabilitado

Limpia la caché del navegador e intenta de nuevo.

​
Cuando hago clic en Upload files -> From Confluence el inicio de sesión no funciona

  • Verifica que el clientId secretId estén copiados y pegados correctamente en el archivo de configuración de Zylon
  • Verifica que la Callback URL sea correcta en el paso 9 y sea la misma que el redirectUri en el archivo de configuración.

​
No veo ningún espacio para importar

  • Asegúrate de haber iniciado sesión en Confluence con una cuenta que tenga acceso a espacios.
  • Verifica que los permisos requeridos sean correctos como se muestra en el paso 6