The Acquia Digital Asset Management (Acquia DAM) module synchronizes Acquia DAM with Drupal's Media Library. This integration enables Drupal site creators to search, browse, and select assets stored in Acquia DAM without leaving the Drupal site builder interface. The module uses embed codes for downloading and serving assets through Drupal.

Installing the Acquia DAM module

To install the module:

• Add the module to the Drupal codebase by using Composer:

  composer require drupal/acquia_dam

• Enable the module for use on the sites by running the following Drush command:

  drush en acquia_dam acquia_dam_integration_link

Generating the API access token

To generate the API access token:

• Log in to the Acquia DAM portal as an administrator.
• From the global dropdown, select Admin.
• Click Global settings > API setup.
• On the API Setup page, click New integration.

• In the Integration Name field, enter a friendly name for the integration.

  For example, DAM and Drupal Integration.

• In the Description field, enter a brief description for the integration.

  For example, This token is created for the example.com site.

• Click Register.

  

  The API Setup page displays a row for the integration.

• In the row for the integration, click Generate User Access Token.

  
• In the Generate User Access Token dialog box, do the following:
  • In the Email Address field, select your email address.

  • Click Generate Token.

    

    The dialog box displays the access token.

  • Copy the access token and save it to a secure location.

    
  • Click Close.

Authenticating a site with an Acquia DAM account

To use Acquia DAM with a site, you must follow the steps below to authenticate the site with an Acquia DAM account:

• Authenticate with a secure API access token for site authentication
• Authorize with Acquia DAM account for user authentication

Authenticating the site

To authenticate your site:

• Log in to your Drupal site and go to the Acquia DAM configuration page at /admin/config/acquia-dam.

  
• In the Access token field, enter the access token that you generated and copied from Acquia DAM.
• In the Acquia DAM domain field, enter your Acquia DAM domain.

• Click Authenticate Site.

  The Acquia DAM configuration page displays a status message to confirm the authentication.

Authenticating the user in Acquia DAM

• Log in to your Drupal application.
• Navigate to your user profile, which is usually located at /user.
• In your profile menu, click the Acquia DAM tab.

• Click the Authorize button to authenticate with Acquia DAM.

Configuring image styles

To configure image styles:

• On the Configuration page, select the Image styles tab.
• In the Allowed image styles list, select the checkboxes for the required image styles.

• Click Save configuration.

  

Configuring metadata

Selecting fields

To select fields:

• On the Configuration page, select the Metadata tab.
• In the Name of metadata field in DAM list, select the checkboxes for the fields that you want to map from Acquia DAM to the Drupal module.

• Click Save configuration.

  

Mapping fields

To map fields:

• Go to Structure and click Media Types in Drupal.
• For images sourced from Acquia DAM, click Edit.
• In Map Fields, view the DAM metadata fields selected during configuration. By default, only the name and alt text fields are available for mapping.

• To map new fields, create the required fields in Drupal and select them for mapping.

  

Configuring DAM media as a field in a content type

To configure DAM media as a field in a content type:

• Create a media field and select Acquia DAM as the media source. For example, for the page content type, add a new field named Media.


• Click Create a new field and choose a field of type as Media.

  

• Set the field label to Media in the Label field and click Continue.

  

• After selecting the required media type from the list, click Save.

  

Acquia DAM Integration with Drupal