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, consulte[Métodos de autenticación](quick-action-auth.md). ## Antes de empezar Asegúrese de disponer de lo siguiente antes de configurar la integración. + Atlassian Confluence Cloud. + Accede a la [consola de desarrolladores de Atlassian](https://developer.atlassian.com/console/myapps/) para crear o gestionar una aplicación. OAuth + Para conocer los requisitos de suscripción, consulte. [Configurar las integraciones en la consola](integration-console-setup-process.md) ## 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 con[Prepare la autenticación](#confluence-action-auth-setup). 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](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/) 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](https://developer.atlassian.com/console/myapps/) e inicia sesión con tu cuenta de Atlassian. 1. **Elige **Crear** y, a continuación, elige la integración 2.0. OAuth ** 1. En **Nombre**, introduce un nombre descriptivo para la integración, por ejemplo`your-app-name connector`. 1. Revisa y acepta las condiciones para desarrolladores de Atlassian. 1. 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. 1. **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. 1. Elija **Configurar**. La página de ámbitos se abre con las pestañas **Ámbitos clásicos y Ámbitos** **granulares**. 1. **En la pestaña **Ámbitos clásicos, elija Editar ámbitos**.** **Seleccione los ámbitos clásicos necesarios y pulse Guardar.** 1. 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. 1. **Junto a **OAuth 2.0 (3LO), selecciona Añadir**.** 1. Para **Callback URLs, ingresa**. `https://region.quicksight.aws.amazon.com/sn/oauthcallback` *region*Sustitúyala por la AWS región en la que está desplegada la instancia de Amazon Quick, por ejemplo`us-east-1`. 1. 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. 1. 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 hasta`https://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.** 1. Seleccione la pestaña **Acciones**. 1. En **Configurar una nueva integración de aplicaciones para Actions**, busca **Atlassian Confluence Cloud** y selecciona el botón Añadir (con el signo «\$1»). 1. **En la página de **tipos de integración**, selecciona **Realizar acciones en Atlassian Confluence** Cloud y selecciona Siguiente.** 1. 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**. 1. 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 formato`https://api.atlassian.com/ex/confluence/yourInstanceId`. Para encontrar el ID de tu instancia, navega hasta`https://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. 1. 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. 1. Seleccione **Crear y continuar**. 1. (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, consulta[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations). ### 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 hasta`https://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.