View a markdown version of this page

Integración de acciones de Atlassian Confluence Cloud - Amazon Quick
Antes de empezarConfigura la consola para desarrolladores de AtlassianPrepare la autenticaciónConfigurar la integración en Amazon QuickAcciones disponiblesAdministra y soluciona problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración de acciones de Atlassian Confluence Cloud

Usa el conector de acciones de Confluence Cloud de Atlassian para crear, actualizar y gestionar páginas y espacios de Confluence directamente en Amazon Quick mediante lenguaje natural.

Para configurar esta integración, primero debes crear una aplicación OAuth 2.0 (3LO) en la consola de desarrolladores de Atlassian y configurar sus permisos. A continuación, creas la integración en Amazon Quick y la conectas a tu aplicación de Atlassian. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

Configura la consola para desarrolladores de Atlassian

Si tienes pensado usar la autenticación de usuario (3LO), crea una aplicación OAuth 2.0 en Atlassian Developer Console antes de configurar Amazon Quick. Complete todos los pasos siguientes antes de pasar a la consola Amazon Quick.

Si planea usar únicamente la autenticación de servicio (clave de API), puede omitir esta sección y continuar conPrepare la autenticación.

Para obtener más información sobre las aplicaciones OAuth 2.0 (3LO), consulta las aplicaciones OAuth 2.0 (3LO) en la documentación para desarrolladores de Atlassian.

Crea una aplicación OAuth 2.0 (3LO)

Amazon Quick utiliza una aplicación Atlassian OAuth 2.0 (3LO) para autenticarse con tu producto de Atlassian Cloud en nombre de tus usuarios. Crea esta aplicación en la consola para desarrolladores de Atlassian antes de configurar Amazon Quick.

  1. Abre la consola de desarrolladores de Atlassian e inicia sesión con tu cuenta de Atlassian.

  2. Elige Crear y, a continuación, elige la integración 2.0. OAuth

  3. En Nombre, introduce un nombre descriptivo para la integración, por ejemployour-app-name connector.

  4. Revisa y acepta las condiciones para desarrolladores de Atlassian.

  5. Seleccione Crear.

Configuración de permisos

Tras crear la aplicación OAuth 2.0, añade los permisos de API que Amazon Quick necesita para interactuar con tu producto de Atlassian.

  1. Desde tu aplicación en la consola para desarrolladores de Atlassian, selecciona Permisos en el menú de navegación de la izquierda.

  2. Busca la API de tu producto de Atlassian (por ejemplo, la API de Jira o la API de Confluence) y selecciona Añadir. El botón cambia a Configurar después de añadir la API.

  3. Elija Configurar. La página de ámbitos se abre con las pestañas Ámbitos clásicos y Ámbitos granulares.

  4. En la pestaña Ámbitos clásicos, elija Editar ámbitos. Seleccione los ámbitos clásicos necesarios y pulse Guardar.

  5. Seleccione la pestaña Ámbitos granulares y, a continuación, seleccione Editar ámbitos. Seleccione los ámbitos granulares necesarios y elija Guardar.

Para conocer los ámbitos específicos necesarios para la integración, consulte la sección de ámbitos que aparece a continuación.

Ámbitos necesarios para Confluence

Añade los siguientes ámbitos a tu aplicación OAuth 2.0 para la integración de las acciones de Confluence Cloud.

Alcance clásico

En la pestaña Ámbitos clásicos, elija Editar ámbitos y seleccione el siguiente ámbito.

Integración de acciones de Confluence: ámbito clásico
Alcance Description (Descripción)
search:confluence Busca resúmenes de contenido y espacios de Confluence.

Ámbitos granulares

Seleccione la pestaña Ámbitos granulares y, a continuación, seleccione Editar ámbitos. Seleccione los siguientes ámbitos.

Integración de acciones de Confluence: ámbitos granulares
Alcance Description (Descripción)
read:page:confluence Ver el contenido de la página.
write:page:confluence Crea y actualiza páginas.
read:space:confluence Acceda a la información del espacio.

Configuración de la autorización

Configura la URL de devolución de llamada para que Atlassian pueda redirigir a los usuarios a Amazon Quick una vez que hayan autorizado la aplicación.

  1. Desde tu aplicación en la consola de desarrolladores de Atlassian, selecciona Autorización en el menú de navegación de la izquierda.

  2. Junto a OAuth 2.0 (3LO), selecciona Añadir.

  3. Para Callback URLs, ingresa. https://region.quicksight.aws.amazon.com/sn/oauthcallback regionSustitúyala por la AWS región en la que está desplegada la instancia de Amazon Quick, por ejemplous-east-1.

  4. Seleccione Save changes (Guardar cambios).

Registre sus credenciales

Antes de salir de la consola de desarrolladores de Atlassian, confirma que tienes los siguientes valores. Los necesitas para la configuración de Amazon Quick.

  1. Desde tu aplicación en la consola para desarrolladores de Atlassian, selecciona Configuración en el menú de navegación de la izquierda.

  2. En Detalles de autenticación, copia el ID de cliente y los valores secretos.

Credenciales requeridas de Atlassian Developer Console
Valor ¿Dónde encontrarlo
ID de cliente Página de configuración, en Detalles de autenticación
Secret Página de configuración, en Detalles de autenticación

Prepare la autenticación

Los conectores de acción de Confluence Cloud admiten dos métodos de autenticación. Reúna las credenciales necesarias antes de configurar Amazon Quick.

Autenticación de usuario (3LO)

Si has completado la configuración de Atlassian Developer Console de la sección anterior, deberías tener listos los siguientes valores. Introdúzcalos cuando configures la integración en Amazon Quick.

  • URL base: la URL de tu instancia de Confluence para las llamadas a la API. No es la misma URL en la que inician sesión los usuarios. Se parece a lo siguiente:https://api.atlassian.com/ex/confluence/yourInstanceId. Para encontrar tu ID de instancia, navega hastahttps://your-domain.atlassian.net/_edge/tenant_info.

  • ID de cliente: desde la página de configuración de tu aplicación de Atlassian OAuth .

  • Secreto de cliente: desde la página de configuración de tu aplicación de OAuth Atlassian.

  • URL del token: https://auth.atlassian.com/oauth/token

  • URL de autorización: https://auth.atlassian.com/authorize

  • URL de redireccionamiento — https://region.quicksight.aws.amazon.com/sn/oauthcallback

Autenticación del servicio (clave de API)

Recopila la siguiente información de tu administrador de Confluence Cloud:

  • Clave de API: token de API de Confluence.

  • URL base: la URL de tu instancia de Confluence para las llamadas a la API.

  • Correo electrónico: correo electrónico de la cuenta de usuario asociada.

Configurar la integración en Amazon Quick

Tras preparar las credenciales de autenticación, cree la integración en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Seleccione la pestaña Acciones.

  3. En Configurar una nueva integración de aplicaciones para Actions, busca Atlassian Confluence Cloud y selecciona el botón Añadir (con el signo «+»).

  4. En la página de tipos de integración, selecciona Realizar acciones en Atlassian Confluence Cloud y selecciona Siguiente.

  5. En el formulario Crear integración, rellena los siguientes campos:

    • Nombre: nombre descriptivo de tu integración de Confluence.

    • Descripción (opcional): notas sobre cómo se utilizará esta conexión.

    • Tipo de conexión: elija Red pública.

  6. En Configuración de autenticación, elija su método de autenticación y complete los campos obligatorios:

    1. Para la autenticación de usuarios, configure los siguientes campos:

      • URL base: la URL de tu instancia de Confluence para las llamadas a la API, en el formatohttps://api.atlassian.com/ex/confluence/yourInstanceId. Para encontrar el ID de tu instancia, navega hastahttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID de cliente: ID de cliente de la página de configuración de tu aplicación de Atlassian OAuth .

      • Secreto de cliente: secreto de la página de configuración de tu aplicación de OAuth Atlassian.

      • URL del token: https://auth.atlassian.com/oauth/token

      • URL de autorización: https://auth.atlassian.com/authorize

      • URL de redireccionamiento: este campo se rellena previamente con tu URL de devolución de llamada rápida de Amazon.

    2. Para la autenticación del servicio, configure los siguientes campos:

      • Clave de API: token de API de Confluence.

      • URL base: la URL de tu instancia de Confluence para las llamadas a la API.

      • Correo electrónico: correo electrónico de la cuenta de usuario asociada.

  7. Seleccione Crear y continuar.

  8. (Opcional) En la página de integración de Compartir, selecciona los usuarios con los que compartir la integración.

Acciones disponibles

Tras configurar la integración, estarán disponibles las siguientes acciones.

Acciones disponibles de Confluence Cloud
Action Description (Descripción)
Crear página Crea una página nueva.
Obtenga páginas Ver todas las páginas.
Search Busca contenido con CQL.
Actualizar página Actualizar el contenido de la página.

Administra y soluciona problemas

Para editar, compartir o eliminar tu integración, consultaAdministrar las integraciones existentes.

Problemas de autenticación

  • Configuración de la aplicación incorrecta: verifica que la OAuth aplicación en la consola para desarrolladores de Atlassian incluya los ámbitos necesarios y que el URI de redireccionamiento coincida con tu configuración de Amazon Quick.

  • Token de API caducado: si utilizas la autenticación de servicio, comprueba que el token de API no haya caducado y genera uno nuevo si es necesario.

  • URL base incorrecta: la URL base para las llamadas a la API no es la misma que la URL de inicio de sesión de Confluence Cloud. Compruebe que está utilizando el formato de URL de la API:https://api.atlassian.com/ex/confluence/yourInstanceId. Para encontrar tu ID de instancia, navega hastahttps://your-domain.atlassian.net/_edge/tenant_info.

Mensajes de error comunes

  • Access denied. You do not have permission to perform this action— El usuario autenticado no tiene los permisos necesarios en Confluence Cloud. Ponte en contacto con tu administrador de Confluence Cloud para verificar y conceder los permisos adecuados.

  • OAuth 2.0 authorization failed— Comprueba que el ID de cliente, el secreto del cliente y los OAuth ámbitos estén configurados correctamente tanto en Atlassian Developer Console como en Amazon Quick.