> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt > Use this file to discover all available pages before exploring further. # Guía de configuración de la integración con AEM Esta guía te explica cómo conectar Adobe Experience Manager (AEM) as a Cloud Service a Profound mediante una credencial OAuth Server-to-Server de Adobe. Una vez conectado, los Agents de Profound pueden acceder, crear y actualizar los modelos de Content Fragment, las carpetas y el contenido que permitan los permisos de AEM de la credencial. ## Antes de empezar Necesitarás: * Un programa de [AEM as a Cloud Service](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/overview/introduction) y un entorno **Author** * Acceso a [AEM Cloud Manager](https://experience.adobe.com/#/cloud-manager) para hacer commits en un repositorio administrado por Adobe y ejecutar un pipeline de configuración (se requiere el rol **Deployment Manager**) * Permisos para administrar perfiles de producto en [Adobe Admin Console](https://adminconsole.adobe.com/) y para crear credenciales OAuth en [Adobe Developer Console](https://developer.adobe.com/console) * Una cuenta de [Profound](https://www.tryprofound.com/) ## Guía de configuración * Abre [Adobe Cloud Manager](https://experience.adobe.com/#/cloud-manager). * Inicia sesión en la organización propietaria del programa de AEM que quieres usar con Profound. * Selecciona y abre el programa y, luego, selecciona **Environments** en la barra lateral izquierda. * Abre el entorno que quieres usar y copia su **Author URL** base. Debería verse así: `https://author-p12345-e67890.adobeaemcloud.com`. Captura de pantalla de la página de resumen del programa en Adobe Cloud Manager con la opción de menú Environments y la Author URL resaltadas Para habilitar el acceso a la API en tu entorno, sigue la [guía de configuración de las API de AEM de Adobe](https://experienceleague.adobe.com/en/docs/experience-manager-learn/cloud-service/aem-apis/openapis/setup). Cuando termines, confirma que tienes el perfil de producto correcto para usar con la API de AEM: * Vuelve a la página del entorno de tu programa de AEM en [Adobe Cloud Manager](https://experience.adobe.com/#/cloud-manager) (donde te quedaste en el [Paso 1](#step-1)). * Abre el menú de acciones del entorno y selecciona **Manage Access** > **Author Profiles**. [Adobe Admin Console](https://adminconsole.adobe.com/) abre la página de tu entorno. Captura de pantalla del menú de acciones del entorno en Adobe Cloud Manager con las opciones Manage Access y Author Profiles resaltadas * Confirma que el perfil **AEM Sites Content Managers - author...** existe para tu programa y entorno. Captura de pantalla de la lista de perfiles de producto en Adobe Admin Console con el perfil author de AEM Sites Content Managers resaltado Para autenticarte con Profound, crea una credencial OAuth. Tú, o cualquier persona con un rol **Developer** en tu perfil de producto **AEM Sites Content Managers**, puede crearla. Para asignar un rol **Developer** a quien crea la credencial, continúa donde te quedaste en el [Paso 2](#step-2): * En la página de tu entorno en [Adobe Admin Console](https://adminconsole.adobe.com/), selecciona el perfil de producto **AEM Sites Content Managers - author...**. * Abre la pestaña **Developers** y, luego, selecciona **Add developers**. Captura de pantalla del perfil de producto en Adobe Admin Console con la pestaña Developers y el botón Add developers resaltados * Agrega el correo electrónico o el nombre de usuario de la persona que crea la credencial OAuth y, luego, selecciona **Save**. Obtén más información sobre cómo asignar desarrolladores a perfiles de producto de Adobe en la guía de Adobe [Manage developers in Adobe Admin Console](https://helpx.adobe.com/enterprise/using/manage-developers.html). * Abre [Adobe Developer Console](https://developer.adobe.com/console). Si sigues estos pasos en orden, ya deberías haber iniciado sesión en la organización propietaria de tu entorno Author de AEM (la misma que en el [Paso 1](#step-1)). * Selecciona **Create new project** en la sección **Quick start**, o ve a **Projects** en el menú de navegación superior y selecciona **Create new project**. Captura de pantalla de la sección de inicio rápido en la página principal de Adobe Developer Console con la opción Create new project resaltada * En la página del proyecto, selecciona **Edit project**, asigna a tu proyecto un nombre descriptivo (por ejemplo, **Profound integration credentials**) y, luego, selecciona **Save**. Captura de pantalla del diálogo Edit Project en Adobe Developer Console con el botón Edit project y el campo Project Title resaltados * Selecciona **Add to Project** > **API**. Captura de pantalla de la página del proyecto en Adobe Developer Console con Add to Project y la opción API resaltadas * En la página **Add an API**, filtra la lista de API por **Experience Cloud**, selecciona **AEM CS Sites Content Management** y, luego, selecciona **Next**. Captura de pantalla de la vista Add an API con la opción de filtro Experience Cloud, la opción AEM CS Sites Content Management y el botón Next resaltados * Selecciona **Server-to-Server** > **OAuth Server-to-Server** como tipo de autenticación. Captura de pantalla del diálogo Configure API con Server-to-Server Authentication y Next resaltados Captura de pantalla del diálogo Configure API con OAuth Server-to-Server, el campo Credential name y el botón Next resaltados * Selecciona el perfil de producto Author que preparaste en el [Paso 2](#step-2) y, luego, guarda la configuración. Captura de pantalla del diálogo Configure API con el perfil de producto AEM Sites Content Managers seleccionado y la opción Save configured API resaltada La API AEM Sites Content Management también proporciona el acceso a carpetas que usa Profound. No se requieren credenciales adicionales. Después de guardar la configuración de la API, [Adobe Developer Console](https://developer.adobe.com/console) te devuelve a la página del proyecto. En la sección **Credentials**, selecciona tu nueva credencial OAuth Server-to-Server. Desde la página de la credencial, copia los valores que necesitas para crear la integración con AEM en Profound: * **Client ID** * **Client Secret** * **Scopes**: copia el valor completo exactamente como lo muestra Adobe * **Organization ID**: opcional; cópialo solo si el tenant de AEM requiere el encabezado `x-gw-ims-org-id` Captura de pantalla de la vista de detalles de la credencial OAuth Server-to-Server con Client ID, Client Secret, Scopes y Organization ID resaltados Antes de poder usar la credencial, registra su client ID en tu entorno Author. * De vuelta en [Adobe Cloud Manager](https://experience.adobe.com/#/cloud-manager), abre el programa y selecciona **Repositories** en la barra lateral izquierda. * Identifica el repositorio administrado por Adobe y la rama que usa el pipeline de configuración de tu entorno. Captura de pantalla de Repositories en Adobe Cloud Manager con la opción de menú Repositories, el nombre del repositorio y la rama del pipeline configurado resaltados * Selecciona **Access Repo Info** y copia la URL del repositorio y las credenciales de acceso. * Con tu flujo de trabajo de desarrollo habitual, clona el repositorio en tu equipo y crea o actualiza el archivo `config/api.yaml` en el directorio raíz con la siguiente configuración: ```yaml theme={null} kind: "API" version: "1" metadata: envTypes: ["dev", "stage", "prod"] data: allowedClientIDs: author: - "" ``` Reemplaza `` por el client ID que copiaste de Developer Console en el [Paso 5](#step-5). Si ya tienes otras credenciales de API configuradas, conserva la configuración existente y agrega el client ID a la lista `author` dentro de `allowedClientIDs`. Obtén más información sobre cómo administrar repositorios y configurar pipelines en los siguientes recursos de Adobe: * [Guía de registro del client ID de la API de AEM](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/developing/open-api-based-apis#registering-a-client-id) * [Administrar repositorios en Cloud Manager](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/using-cloud-manager/managing-code/managing-repositories) * Guía [Usar pipelines de configuración](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/operations/config-pipeline) * Tutorial [Invocar las API de AEM basadas en OpenAPI con autenticación OAuth Server-to-Server](https://experienceleague.adobe.com/en/docs/experience-manager-learn/cloud-service/aem-apis/openapis/invoke-api-using-oauth-s2s) * Todavía en la página de tu programa en [Adobe Cloud Manager](https://experience.adobe.com/#/cloud-manager), selecciona **Pipelines** en la barra lateral izquierda. * Selecciona **Add Pipeline** y, luego, selecciona **Add Non-Production Pipeline** para el entorno de desarrollo, o **Add Production Pipeline** para stage y producción. Captura de pantalla de Pipelines en Adobe Cloud Manager con la opción de menú Pipelines y el botón Add Pipeline resaltados * En el diálogo **Add Pipeline**, selecciona **Deployment Pipeline**, asigna a tu pipeline un nombre descriptivo y, luego, selecciona **Continue**. * En la siguiente pantalla, completa los valores de la siguiente manera: * Select code to deploy: **Targeted deployment** * Include: **Config** * Eligible Deployment Environments: selecciona tu entorno de AEM en el menú desplegable * Repository, Git Branch, Code Location: el repositorio, la rama y el directorio de configuración del [Paso 6](#step-6) * Selecciona **Save**. Tu nuevo pipeline de configuración aparece en la lista de pipelines de la sección **Pipelines**. Selecciona el pipeline y, luego, selecciona **Run selected**. Espera a que el despliegue se complete correctamente. Captura de pantalla de Pipelines en Adobe Cloud Manager con un nuevo pipeline de configuración seleccionado y el botón Run selected resaltado Obtén más información sobre cómo desplegar pipelines de configuración en los siguientes recursos de Adobe: * Guía [Usar pipelines de configuración](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/operations/config-pipeline) * Resumen de [pipelines de CI/CD de Cloud Manager](https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/using-cloud-manager/cicd-pipelines/introduction-ci-cd-pipelines) * En [Profound](https://platform.tryprofound.com), selecciona el nombre de tu organización en la esquina superior izquierda de la plataforma y, luego, selecciona **Settings**. * En la barra lateral izquierda, selecciona **Integrations** en **Account**. * Busca **Adobe Experience Manager (S2S)** y selecciónalo. Captura de pantalla de la vista Integrations de Profound con la tarjeta de la integración Adobe Experience Manager (S2S) resaltada * En la vista de la integración Adobe Experience Manager (S2S), selecciona **+ Add account**. * En el diálogo **Connect Adobe Experience Manager (S2S)**, ingresa la Author URL del [Paso 1](#step-1) y el client secret, el client ID, los scopes y el organization ID que obtuviste en el [Paso 5](#step-5). * Selecciona **Connect account**. Si la conexión se realiza correctamente, tu entorno de AEM aparece en la lista de cuentas conectadas. Captura de pantalla de la vista de la integración Adobe Experience Manager en Profound con una cuenta conectada resaltada Revoca el acceso de Profound a tu entorno de AEM en cualquier momento seleccionando **Revoke** en el menú de acciones de la cuenta de la integración. Captura de pantalla del menú de acciones de una cuenta conectada en Profound con el menú de tres puntos y la opción Revoke resaltados Para asegurarte de que Profound tiene todos los permisos que necesita para trabajar con tu entorno de AEM, verifica que los nodos de Agent de AEM se ejecuten correctamente. * En [Profound](https://platform.tryprofound.com), [crea un nuevo Agent](https://help.tryprofound.com/articles/2212787792-create-an-agent) o abre un borrador de Agent existente. * Agrega los nodos **List Content Fragments** y **Get Content Fragment** de Adobe Experience Manager y, luego, selecciona la instancia de AEM conectada. * Selecciona **Test node** (un ícono de reproducción) en el panel de configuración del nodo y confirma que la salida de AEM contiene los datos esperados. Captura de pantalla del panel de configuración del nodo List Content Fragments con el ícono de reproducción resaltado * Si quieres crear o actualizar content fragments con Agents de Profound, prueba los nodos **Create Content Fragment** y **Update Content Fragment** de la misma manera. Elimina el contenido de prueba directamente en el entorno de AEM. Los nodos de Agent de Profound actuales no incluyen una operación de eliminación. ## Rotación de credenciales de AEM ### Rotar solo un client secret Adobe admite dos client secrets en una misma credencial OAuth Server-to-Server, lo que permite la rotación sin cambiar el client ID. Rota tu client secret según las instrucciones de la [documentación para desarrolladores de Adobe](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/implementation#rotating-client-secrets) y, luego, actualiza las credenciales en Profound (**Integrations** > **Adobe Experience Manager (S2S)** > **Edit credentials** en el menú de acciones de una cuenta conectada). El client ID no cambia durante este proceso, por lo que no necesitas actualizar ni volver a desplegar `api.yaml`. ### Rotar toda la credencial OAuth Para reemplazar toda la credencial OAuth de AEM: 1. Genera una nueva credencial como se describe en el [Paso 4](#step-4) de la guía de configuración. 2. Despliega el nuevo client ID en `config/api.yaml` según las instrucciones del [Paso 6](#step-6) de la guía de configuración. 3. Actualiza las credenciales en Profound. Mantén registrado el client ID anterior hasta que hayas verificado la nueva conexión. ## Prácticas recomendadas * Usa solo un entorno **Author**. Profound no se conecta a AEM Publish ni a Preview. Obtén más información sobre los entornos en los [tutoriales de AEM as a Cloud Service](https://experienceleague.adobe.com/en/docs/experience-manager-learn/cloud-service/cloud-manager/environments). * Prueba por separado los nodos de lectura y escritura de los Agents de Profound para verificar sus permisos de carpetas y repositorio. * Guarda siempre tu client secret y otras credenciales en un gestor de secretos aprobado, y nunca los incluyas en capturas de pantalla, tickets ni en el control de código fuente.