To use Acquia DAM with a Drupal site, you must complete two levels of authentication:

• Site authentication: Connect the Drupal site to your Acquia DAM instance with a secure API access token.
• User authentication: Allow individual Drupal users to authorize with Acquia DAM. This allows them to browse and select assets.

Both are required for a fully functional integration.

For instructions on how to create the API access token, visit Generating the API access token.

Authenticate the Drupal site with Acquia DAM

Site authentication allows your Drupal site to communicate with Acquia DAM with the API access token you generated in the Acquia DAM portal.

Prerequisites

• You have generated an API access token in Acquia DAM and stored it securely.
• You know your Acquia DAM domain, for example, https://yourcompany.acquiadam.com.

To authenticate your site:

• Log in to your Drupal site as an administrator.

• In the administrative menu, go to Configuration > Media > Acquia DAM, or navigate directly to the following: /admin/config/acquia-dam. 

  
• In the API 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.
• Select Authenticate Site.

After the request completes, the Acquia DAM configuration page displays a status message that indicates whether the site authentication succeeded or failed.

Verify and troubleshoot site authentication

• On success, you should see a confirmation message that the site is authenticated with Acquia DAM. You can now proceed to configure image styles, metadata, and other module settings.
• If authentication fails, check the following:
  • Access token
    • Confirm that you have pasted the entire token with no extra spaces.
    • Verify that the token has not been removed or expired in Acquia DAM.
  • Acquia DAM domain
    • Confirm that the domain matches your Acquia DAM instance exactly.
    • Use the format indicated in the field description.
  • Permissions
    • Ensure that the user account associated with the token has the appropriate permissions in Acquia DAM.
  • Network connectivity
    • Check that your Drupal environment can reach the Acquia DAM domain (no firewall or proxy-blocking outbound requests).

If problems persist, visit the troubleshooting checklist in the Support and resources section.

Authenticate a Drupal user with Acquia DAM

User authentication allows individual Drupal users to authorize access to Acquia DAM under their own account. This is required for users who need to browse and select Acquia DAM assets within the Drupal Media Library.

To authenticate a user:

• Log in to your Drupal application.
• Navigate to your user profile page. By default, this is: /user.

• In your profile, click the Acquia DAM and then click the Authorize to authenticate with Acquia DAM and follow prompts in the authorization flow. 

• A new tab opens and loads the DAM. Once you are logged in, the system requests permission to allow the integration. Select Allow. 

  

After the authorization completes, the user can browse and select Acquia DAM assets in supported Drupal interfaces such as the Media Library, subject to their permissions in Acquia DAM.

Verify and troubleshoot user authentication

If a user cannot see expected assets or receives authorization errors:

• Confirm that site authentication has been completed successfully at /admin/config/acquia-dam.
• Ask the user to return to the Acquia DAM tab on their profile and click Authorize again to refresh their authorization.
• Verify that the user’s account in Acquia DAM has permission to view the assets they expect to see.

For more information on authentication behavior and permissions, visit the troubleshooting checklist in the support and resources section.

Authenticate a site with an Acquia DAM