> ## 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.

# Conecta Drupal a Profound

Esta guía te explica cómo conectar tu cuenta de Drupal a Profound. Una vez conectada, los Agents de Profound pueden acceder, editar y administrar tu contenido de Drupal directamente.

## Antes de empezar

Necesitarás:

* Una cuenta de [Drupal](https://www.drupal.org/) con el rol de administrador, o cualquier otro rol que te permita administrar usuarios y permisos (obtén más información en la [documentación de Roles and Permissions](https://www.drupal.org/docs/roles-and-permissions) de Drupal)
* Un sitio web público de Drupal con HTTPS
* El módulo principal de Drupal [JSON:API](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module): impulsa todas las acciones que realiza Profound
* El módulo [JSON:API Permission Access](https://www.drupal.org/project/jsonapi_permission_access) para habilitar el acceso de autenticación de la API para roles de usuario seleccionados
* El módulo [Key auth](https://www.drupal.org/project/key_auth) para habilitar la autenticación con clave de API que permite a Profound realizar acciones en tu nombre
* Una cuenta de [Profound](https://www.tryprofound.com/)

## Guía de configuración

<Steps>
  <Step title="Permite operaciones de escritura en tu módulo JSON:API" id="step-1">
    * En Drupal, ve a **Configuration > Web Services > JSON:API**.
    * Habilita **Accept all JSON:API create, read, update, and delete operations**.
    * Selecciona **Save configuration**.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-write-mode.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=7ff235b4470145a47c434d968e5c8986" alt="Captura de pantalla de la vista de configuración del módulo JSON:API de Drupal con la opción de modo de escritura y el botón para guardar la configuración resaltados" width="1988" height="1076" data-path="images/integrations/drupal/drupal-write-mode.png" />
  </Step>

  <Step title="Crea un usuario de Profound en Drupal" id="step-2">
    * En la plataforma de Drupal, ve a **People** en la barra lateral izquierda y selecciona **+ Add user**.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-people.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=d633700a378e755d4f5d9f62f89450a7" alt="Captura de pantalla de la plataforma de Drupal con la pestaña People y el botón Add user resaltados" width="2512" height="1684" data-path="images/integrations/drupal/drupal-people.png" />
    * Nombra al usuario `profound`, asígnale el rol **Content editor** o cualquier otro rol con permisos de administración de contenido y selecciona **Create new account**.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-add-user.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=cfe1b4f15641c475dff1dca4a7606207" alt="Captura de pantalla del formulario Add user de Drupal con los campos Username y Role, y el botón Create new account resaltados" width="1354" height="1654" data-path="images/integrations/drupal/drupal-add-user.png" />
    * Una vez creado el usuario, aparece en la lista de usuarios.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-user-created.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=0929a896683f768b3cbf1a312818ccad" alt="Captura de pantalla de la vista People de Drupal con el usuario de Profound visible y resaltado en la lista de usuarios" width="1910" height="1388" data-path="images/integrations/drupal/drupal-user-created.png" />
  </Step>

  <Step title="Habilita los permisos necesarios para el usuario de Profound" id="step-3">
    Para permitir que Profound se autentique en Drupal con una clave de API, habilita los permisos **Access JSON:API** y **Use key authentication** para el rol que asignaste a tu usuario de Profound.

    * En Drupal, ve a **People > Permissions**.
    * Busca el permiso correspondiente y habilítalo para el rol que tiene tu usuario de Profound.
    * Selecciona **Save permissions**.

    <Note>
      Un rol estándar de editor de contenido de Drupal tiene permisos de contenido suficientes para que Profound realice las acciones necesarias. Si quieres revisar o personalizar los permisos de contenido de Profound, puedes hacerlo en cualquier momento en la vista **Permissions** de Drupal.
    </Note>
  </Step>

  <Step title="Genera una clave de API" id="step-4">
    * Ve a **People** y selecciona el usuario `profound` que creaste en el [paso 2](#step-2).
    * Agrega `/key-auth` al final de la URL de la página del usuario. Por ejemplo:
      ```text theme={null}
        https://your-site.com/user/5/key-auth
      ```
    * En la página de autenticación con clave del usuario, selecciona **Generate new key**.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-generate-key.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=7ad2783f940381b342b2a58349d2e2eb" alt="Captura de pantalla de la página de autenticación con clave de Drupal con el botón Generate new key resaltado" width="1040" height="498" data-path="images/integrations/drupal/drupal-generate-key.png" />
    * Guarda la clave de API en un lugar seguro; la necesitarás para configurar la integración en Profound.
  </Step>

  <Step title="Conecta Drupal a Profound" id="step-5">
    Ahora que tienes todo lo necesario, crea una integración de Drupal en la plataforma de Profound:

    * En Profound, 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 **Drupal** y selecciónalo.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-integration.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=a66f360f62cd07c292c16ebbf8cdad2a" alt="Captura de pantalla de la vista Integrations de Profound con &#x22;Drupal&#x22; escrito en la barra de búsqueda y la tarjeta de integración de Drupal resaltados" width="1422" height="558" data-path="images/integrations/drupal/drupal-integration.png" />
    * En la vista de la integración de Drupal, selecciona **+ Add account**.
    * En el cuadro de diálogo **Connect Drupal**, introduce la clave de API que generaste en el [paso 4](#step-4) y la URL base de tu sitio web de Drupal.
    * Selecciona **Connect Account**.
          <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-connect.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=715a8bf7577aca43ea9b296fe0d85e4f" alt="Captura de pantalla del cuadro de diálogo Connect Drupal con el botón Connect account resaltado" width="872" height="726" data-path="images/integrations/drupal/drupal-connect.png" />
  </Step>

  <Step title="Verifica la conexión" id="step-6">
    Si tu cuenta de Drupal aparece en la lista de cuentas conectadas, la integración se realizó correctamente y está lista para usarse con Profound.

    Puedes revocar el acceso de Profound a tu cuenta de Drupal en cualquier momento seleccionando **Revoke** en el menú de acciones de la cuenta de la integración.

    <img src="https://mintcdn.com/profound-37face47/Lvba4O-pjtEK-wzg/images/integrations/drupal/drupal-revoke.png?fit=max&auto=format&n=Lvba4O-pjtEK-wzg&q=85&s=37be72150c73b57b402b470d8b58404c" alt="Elemento de cuenta de Profound en la lista de cuentas conectadas con el menú de acciones de tres puntos y la opción Revoke resaltados" width="1190" height="234" data-path="images/integrations/drupal/drupal-revoke.png" />
  </Step>
</Steps>

<Note>
  También puedes conectar tu cuenta de Drupal a Profound directamente en la vista del creador de Agents. Ve a **Agents > + Create new**, agrega uno de los nodos de Drupal al lienzo, selecciónalo para abrir su panel de configuración y sigue el flujo **Connect account**.
</Note>

## Prácticas recomendadas

* Asegúrate de que tu sitio web de Drupal sea público y use HTTPS. Profound rechaza los sitios web sin HTTPS.
* Para personalizar los permisos específicamente para el usuario de Drupal de Profound, considera crear un rol personalizado para él. Obtén más información en la documentación de [Roles and Permissions](https://www.drupal.org/docs/roles-and-permissions#s-create-a-custom-role) de Drupal.
* Al revisar los permisos del usuario de Profound, concédele permisos solo para el contenido que quieras que Profound use.
* Guarda siempre tus claves de API en un lugar seguro, como las notas seguras de tu gestor de contraseñas.

## Solución de problemas

### No aparece ningún permiso de JSON:API en mi vista Permissions de Drupal

Comprueba que el módulo JSON:API Permission Access esté instalado en tu plataforma de Drupal:

* Ve a **Extend** en la barra lateral izquierda.
* Si el módulo está instalado, aparece en la lista de módulos con una casilla marcada.
* Si no está en la lista, instálalo desde la pestaña **Browse modules**.

### Veo el error "We couldn't save these credentials" en Profound

Al conectar tu cuenta de Drupal a Profound, es posible que veas este error:

```txt wrap theme={null}
We couldn't save these credentials

Drupal JSON:API is reachable without a valid API key. Configure JSON:API to require key authentication.
```

Probablemente significa que te falta el módulo [JSON:API Permission Access](https://www.drupal.org/project/jsonapi_permission_access) en Drupal o el permiso **Access JSON:API** para tu usuario de Profound.

Si ese es el caso, instala el módulo y habilita el permiso como se indica en el [paso 3](#step-3).
