Show Menu
TOPICS×

Configure asset tagging using the Smart Content Service

You can integrate Adobe Experience Manager with the Smart Content Service using Adobe I/O. Use this configuration to access the Smart Content Service from within Experience Manager.
The article details out the following key tasks that are required to configure the Smart Content Service. At the back end, the Experience Manager server authenticates your service credentials with the Adobe I/O gateway before forwarding your request to the Smart Content Service.
  • Create a Smart Content Service configuration in Experience Manager to generate a public key. Obtain public certificate for OAuth integration.
  • Create an integration in Adobe I/O and upload the generated public key.
  • Configure your Experience Manager instance using the API key and other credentials from Adobe I/O.
  • Optionally, enable auto-tagging on asset upload.

Prerequisites

Before you can use the Smart Content Service, ensure the following to create an integration on Adobe I/O:
  • An Adobe ID account that has administrator privileges for the organization.
  • The Smart Content Service service is enabled for your organization.

Obtain public certificate

A public certificate allows you to authenticate your profile on Adobe I/O.
  1. In the Experience Manager user interface, access Tools > Cloud Services > Legacy Cloud Services .
  2. In the Cloud Services page, click Configure Now under Assets Smart Tags .
  3. In the Create Configuration dialog, specify a title and name for the Smart Tags configuration. Click Create .
  4. In the AEM Smart Content Service dialog, use the following values:
    Service URL : https://mc.adobe.io/marketingcloud/smartcontent
    Authorization Server : https://ims-na1.adobelogin.com
    Leave the other fields blank for now (to be provided later). Click OK .
  5. Click Download Public Certificate for OAuth Integration , and download the public certificate file AEM-SmartTags.crt .

Reconfigure when a certificate expires

When the certificate expires it is no longer trusted. To add a new certificate, follow these steps. You cannot renew an expired certificate.
  1. Log in your Experience Manager deployment as an administrator. Click Tools > Security > Users .
  2. Locate and click dam-update-service user. Click on Keystore tab.
  3. Delete the existing similaritysearch keystore with the expired certificate. Click Save & Close .
    Delete existing similaritysearch entry in Keystore to add a new security certificate
  4. Navigate to Tools > Cloud Services > Legacy Cloud Services . Click Asset Smart Tags > Show Configuration > Available Configurations . Click the required configuration.
  5. To download a public certificate, click Download Public Certificate for OAuth Integration .
  6. Access https://console.adobe.io and navigate to the existing Smart Content Services on the Integrations page. Upload the new certificate. For more information, see the instructions in Create Adobe I/O integration .

Create Adobe I/O integration

To use Smart Content Service APIs, create an integration in Adobe I/O to generate API Key, Technical Account Id, Organization Id, and Client Secret.
  1. On the Integrations page, select the appropriate account and verify that the associated organization role is system administrator.
  2. Click New integration .
  3. On the Create a new integration page, select Access an API . Click Continue .
  4. Under Experience Cloud , select Smart Content . Click Continue .
  5. On the next page, select New integration . Click Continue .
  6. On the Integration Details page, specify a name for the integration gateway and add a description.
  7. In the Public keys certificates , upload AEM-SmartTags.crt file that you downloaded above.
  8. Click Create Integration .
  9. To view the integration information, click Continue to integration details .

Configure Smart Content Service

To configure the integration, use the values of Technical Account ID, Organization Id, Client Secret, Authorization Server, and API key fields from the Adobe I/O integration. Creating a Smart Tags cloud configuration allows authentication of API requests from the Experience Manager instance.
  1. In Experience Manager, navigate to Tools > Cloud Service > Legacy Cloud Services to open the Cloud Services console.
  2. Under the Assets Smart Tags , open the configuration created above. On the service settings page, click Edit .
  3. In the AEM Smart Content Service dialog, use the pre-populated values for the Service URL and Authorization Server fields.
  4. For the fields API Key , Technical Account Id , Organization Id , and Client Secret , use the values generated above.

Validate the configuration

After you've completed the configuration, you can use a JMX MBean to validate the configuration. To validate, follow these steps.
  1. Access your Experience Manager server at https://[aem_server]:[port] .
  2. Go to Tools > Operations > Web Console to open the OSGi console. Click Main > JMX .
  3. Click com.day.cq.dam.similaritysearch.internal.impl . It opens SimilaritySearch Miscellaneous Tasks.
  4. Click validateConfigs() . In the Validate Configurations dialog, click Invoke .
    The validation result is displayed in the same dialog.

Enable smart tagging in the Update Asset workflow (Optional)

  1. In Experience Manager, go to Tools > Workflow > Models .
  2. On Workflow Models page, select the DAM Update Asset workflow model.
  3. Click Edit from the toolbar.
  4. Expand the Side Panel to display the steps. Drag Smart Tag Asset step that is available in the DAM Workflow section and place it after the Process Thumbnails step.
    Figure: Add smart tag asset step after the process thumbnail step in the DAM Update Asset workflow.
  5. Open the step in edit mode. Under Advanced Settings , ensure that the Handler Advance option is selected.
  6. In the Arguments tab, select Ignore Errors if you want the workflow to complete even if the automatic tagging step fails.
    To tag assets when they are uploaded irrespective of whether smart tagging is enabled on folders, select Ignore Smart Tag Flag .
  7. Click OK to close the process step, and then save the workflow.