Use Adobe Stock assets in Adobe Experience Manager Assets use-adobe-stock-assets-in-aem-assets
Adobe Stock service provides designers and businesses with access to millions of high-quality, curated, royalty-free photos, vectors, illustrations, videos, templates, and 3D assets for all their creative projects.
Adobe Stock for enterprise offering, by default, includes sharing rights across the organization. Once an asset has been licensed by a user of your organization, other users of your organization can identify, download, and use this asset without having to license it again. Once an asset has been licensed by your organization, the right to use it is perpetual.
Organizations can integrate their enterprise Adobe Stock plan with Experience Manager Assets to ensure that licensed assets are broadly available for their creative and marketing projects, with the powerful asset management capabilities of Experience Manager. Experience Manager users can quickly find, preview, and license Adobe Stock assets that are saved in Experience Manager, without leaving the Experience Manager interface.
Integrate Experience Manager and Adobe Stock integrate-aem-and-adobe-stock
Experience Manager Assets provides users the ability to search, preview, save, and license Adobe Stock assets directly from Experience Manager.
Prerequisites
The integration requires:
- An enterprise Adobe Stock plan
- A user with permissions in Admin Console to the default Stock product profile
- A user with permissions to the Developer Access profile for creating integration in Adobe Developer Console
An enterprise Adobe Stock plan,
- Provides product entitlement for Adobe Stock (Stocks connected to Experience Manager)
- Credits purchased into the Adobe Admin Console for your stock entitlement
- Enables Service Account (JWT) authentication within Adobe Developer Console for your stock entitlement
- Enables managing the credits and licensing globally from within Adobe Admin Console
Within the entitlement, a default product profile for Adobe Stock exists in Admin Console. Multiple profiles can be created, and these profiles determines who can license Stock assets. A user having access directly to the product profile can access https://stock.adobe.com/ and license Stock assets. Whereas there is another method of using the Developer Access to create integration (API) to authenticate communication between Experience Manager and Adobe Stock.
Steps to integrate Experience Manager and Adobe Stock integration-steps
To integrate Experience Manager and Adobe Stock, perform the following steps in the listed sequence:
-
In Experience Manager, create an IMS account and generate a public certificate (public key).
-
Create service account (JWT) connection
In Adobe Developer Console, create a project for your Adobe Stock organization. Under the project, configure an API using the public key to create a service account (JWT) connection. Get the service account credentials and JWT payload information.
-
In Experience Manager, configure the IMS account using the service account credentials and JWT payload.
-
In Experience Manager, configure an Adobe Stock cloud service using the IMS account.
Create an IMS configuration create-an-ims-configuration
The IMS configuration authenticates your Experience Manager Assets author instance with the Adobe Stock entitlement.
IMS configuration includes two steps:
Obtain public certificate public-certificate
The public key (certificate) authenticates your product profile in Adobe Developer Console.
-
Log in to your Experience Manager Assets author instance. The default URL is
http://localhost:4502/aem/start.html. -
From the Tools panel, navigate to Security > Adobe IMS Configurations.
-
In Adobe IMS Configurations page, click Create. The Adobe IMS Technical Account Configuration page opens.
-
In the Certificate tab, select Adobe Stock from the Cloud Solution dropdown list.
-
You can create a certificate or reuse an existing certificate for the configuration.
To create a certificate, select the Create new certificate check box and specify an alias for the public key. The alias serves as name of the public key.
-
Click Create certificate. Then, click OK to generate the public key.
-
Click the Download Public Key icon and save the public key (.crt) file on your machine. The public key is used later to configure API for your Brand Portal tenant and generate service account credentials in Adobe Developer Console.
Click Next.
-
In the Account tab, Adobe IMS account is created which requires the service account credentials.
Open a new tab and create a service account (JWT) connection in Adobe Developer Console.
Create service account (JWT) connection createnewintegration
In Adobe Developer Console, projects and APIs are configured at organization level. Configuring an API creates a service account (JWT) connection. There are two methods to configure API, by generating a key pair (private and public keys) or by uploading a public key. In this example, the service account credentials are generated by uploading the public key.
To generate the service account credentials and JWT payload:
-
Log in to Adobe Developer Console with system administrator privileges. The default URL is https://www.adobe.com/go/devs_console_ui.
Ensure that you have selected the correct IMS organization (Stock entitlement) from the dropdown (organization) list.
-
Click Create new project. A blank project with a system-generated name is created for your organization.
Click Edit project. Update the Project Title and Description, and then click Save.
-
In the Project overview tab, click Add API.
-
In the Add an API window, select Adobe Stock. Click Next.
-
In the Configure API window, select Service Account (JWT) authentication. Click Next.
-
Click Upload your public key. Click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section. Click Next.
-
Verify the public key and click Next.
-
Select the default Adobe Stock product profile and click Save configured API.
-
Once the API is configured, you are redirected to the API overview page. From the left navigation under Credentials, click the Service Account (JWT) option. Here, you can view the credentials and perform actions such as generate JWT tokens, copy credential details, and retrieve client secret.
-
From the Client Credentials tab, copy the client ID.
Click Retrieve Client Secret and copy the client secret.
-
Navigate to the Generate JWT tab and copy the JWT Payload information.
You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in Experience Manager Assets.
Configure IMS account create-ims-account-configuration
You must have the certificate and service account (JWT) credentials to configure the IMS account.
To configure the IMS account:
-
Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate.
-
Specify a Title for the IMS account.
In the Authorization Server field, enter the URL: https://ims-na1.adobelogin.com/.
Enter the client ID in the API key field, Client Secret, and Payload (JWT payload) that you have copied while creating the service account (JWT) connection.
-
Click Create. An IMS account configuration is created.
-
Select the IMS account configuration and click Check Health.
Click Check in the dialog box. On successful configuration, a message appears that the Token is retrieved successfully.
Configure cloud service configure-the-cloud-service
To configure the Adobe Stock cloud service:
-
In the Experience Manager user interface, navigate to Tools > Cloud Services > Adobe Stock.
-
In the Adobe Stock Configurations page, click Create.
-
Specify a Title for the cloud configuration.
Select the IMS configuration that you have created while configuring the IMS account.
Select your locale from the dropdown list.
-
Click Save & Close.
Your Experience Manager Assets author instance is now integrated with Adobe Stock. You can create multiple Adobe Stock configurations (for example, locale-based configurations). You can now access, search, and license the Adobe Stock assets from within the Experience Manager user interface.
note note NOTE At this stage of integration, only the administrators can access the Adobe Stock assets, search Stock assets (using omnisearch), and license the Adobe Stock assets. Administrators can further add users or groups to the Adobe Stock cloud service and give permissions to these non-admin users in Experience Manager to access the Stock configuration. -
To add users or groups, select the Adobe Stock cloud configuration and click Properties.
-
Search to add the users or groups to whom you have assigned permissions to access the Adobe Stock configuration. See assign permissions to user group.
Assign permissions to user group assign-permissions-to-group
Administrators can create user groups and give permissions to certain users or groups to access the Adobe Stock cloud service.
Following are the permissions required for a user to search and license Adobe Stock assets:
- Configure the path:
/conf/global/settings/stock - Privileges:
jcr:read - Permission Type:
Allow
You can create a user group or assign permissions to an existing user group. Permissions can be assigned from the Experience Manager Assets interface or from the User Admin Console.
To provide access to a user group from Experience Manager:
-
In the Experience Manager user interface, navigate to Tools > Security > Groups. Create a user group for Adobe Stock.
-
Navigate to Tools > Security > Permissions.
-
Search for the user group in the left panel and add new Access Control Entry (ACE) for Adobe Stock.
- Configure the path:
/conf/global/settings/stock - Privileges:
jcr:read - Permission Type:
Allow
Click Add.
- Configure the path:
-
Navigate to Tools > Cloud Services > Adobe Stock. Select the Adobe Stock cloud configuration and click Properties.
-
Add the newly created user group to the Adobe Stock configuration. Click Save & Close.
To provide access to a user from User Admin Console:
-
Open the Experience Manager User Admin Console. The default URL is
http://localhost:4502/userdamin. -
In the left panel, search for the user by entering the
user_idorname. Double-click to open the user properties. -
Navigate to the Permissions tab and allow
readpermissions for the Adobe Stock cloud configuration:/conf/global/settings/stock.note caution CAUTION If the cloud configuration is not allowed, the user can only access Assets in the Experience Manager interface. To allow access to Assets and Adobe Stock assets, ensure that the cloud configuration is allowed for the user. -
Click Save to update the permissions.
-
Add the user or the group to the Adobe Stock cloud configuration.
Access Adobe Stock assets access-stock-assets
A non-admin user having permissions to the Adobe Stock cloud configuration can search and license the Adobe Stock assets from the Experience Manager interface.
The user has to perform an extra step of activating the Adobe Stock cloud configuration before accessing Adobe Stock assets. It is a one-time activity. If the user is assigned permissions on multiple Adobe Stock cloud configurations, the user can select the desired configuration from the User Preferences.
To activate the Adobe Stock cloud configuration:
-
Log in to Experience Manager.
-
Click the user icon from the upper-right corner and then click My Preferences. The User Preferences window opens.
-
Select the desired Stock Configuration from the dropdown list and click Accept to activate the configuration.
-
Navigate to Assets > Adobe Stock. You can now view, search, and license Adobe Stock assets.
The following table explains how the user permissions work while accessing the Adobe Stock assets:
Use and manage Adobe Stock assets in Experience Manager usemanage
Using this capability, organizations can allow its users to work using Adobe Stock assets in Experience Manager Assets. From within the Experience Manager user interface, users can search Adobe Stock assets and license the required assets.
Once an Adobe Stock asset is licensed in Experience Manager, it can be used and managed like a typical asset. In Experience Manager, the users can search and preview the assets; copy and publish the assets; share the assets on Brand Portal; access and use the assets by way of Experience Manager desktop app, and so on.
A. Search assets similar to the assets whose Adobe Stock ID is provided. B. Search assets that match your selection of shape or orientation. C. Search for one of more supported asset types D. Open or collapse the filters pane E. License and save the selected asset in Experience Manager F. Save the asset in Experience Manager with watermark G. Explore assets on Adobe Stock website that are similar to the selected asset H. View the selected assets on Adobe Stock website I. Number of selected assets from the search results J. Switch between Card view and List view
Find assets find-assets
Your Experience Manager users, can search for assets in both, Experience Manager and Adobe Stock. When the search location is not limited to Adobe Stock, the search results from Experience Manager and Adobe Stock are displayed.
-
To search for Adobe Stock assets, click Navigation > Assets > Search Adobe Stock.
-
To search for assets across Adobe Stock and Experience Manager Assets, click search
Alternatively, start typing Location: Adobe Stock in the search bar to select Adobe Stock assets. Experience Manager offers advanced filtering capabilities on the searched assets, allowing users to quickly zero-in on the required assets using filters, such as types of supported assets, image orientation, and licensed state.
Save and view the required assets saveassets
Select an asset that you want to save in Experience Manager. Click Save in the toolbar at the top and provide the name and location of the asset. The unlicensed assets are saved locally with a watermark.
Next time when you search for assets, the saved assets are highlighted with a badge, to indicate that such assets are available in Experience Manager Assets.
License assets licenseassets
Users can license Adobe Stock assets by using the quota of their Adobe Stock enterprise plan. When you license an asset, it is saved without a watermark and is available for searching and using in Experience Manager Assets.
Access metadata and asset properties access-metadata-and-asset-properties
Users can access and preview the metadata, including the Adobe Stock metadata properties for the assets saved in Experience Manager, and add License References for an asset. However, the updates to license reference are not synced between Experience Manager and Adobe Stock website.
Users can see the properties for both, licensed and unlicensed assets.
Known limitations known-limitations
-
Issues in integration with Experience Manager Service Pack 6.5.7.0 and above: An unexpected issue is identified during integration with Experience Manager 6.5.7.0 and above. The issue is under testing and expected to be available in Experience Manager 6.5.11.0. Contact Customer Support for an immediate hotfix.
-
Functionality to restrict users from licensing is not working properly: All users having
readpermissions to the stock configuration are allowed to search and license the Adobe Stock assets. -
Non-admin users have to manually activate the Adobe Stock cloud configuration: In the User Preferences window, the Stock Configuration shows the Adobe Stock cloud configuration as enabled but it does not work for a non-admin user. The user has to click the Accept button to activate the Stock configuration. In absence of this step, the system reflects an error message on accessing Assets.
-
Editorial image warning is not displayed: When licensing an image, users cannot check if an image is Editorial Use Only. To prevent possible misuse, the administrators can turn off the access to editorial assets from the Admin Console.
-
Wrong license type is displayed: It is possible that an incorrect license type is displayed in Experience Manager for an asset. Users can log into the Adobe Stock website to see the license type.
-
Reference fields and metadata are not synced: When a user updates a license reference field, the license reference information is updated in Experience Manager but not on the Adobe Stock website. Similarly, if the user updates the reference fields on the Adobe Stock website, the updates are not synchronized in Experience Manager.