Use Adobe Stock assets in Adobe Experience Manager Assets
- Topics:
- Search
- Adobe Stock
CREATED FOR:
- User
- Admin
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.
Prerequisites to integrate Experience Manager and Adobe Stock
Experience Manager Assets provides users the ability to search, preview, save, and license Adobe Stock assets directly from Experience Manager.
Meet the following requirements to enable this integration:
- 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 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 a direct access 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 an integration (API). This integration authenticates the communication between Experience Manager Assets and Adobe Stock.
Integrate Experience Manager and Adobe Stock
As a developer, execute the following steps to integrate Adobe Experience Manager and Adobe Stock.
Set up a program in Developer Console
Execute the following steps to set up a program in the Developer Console:
- Navigate to the Adobe Developer Console and login to your organization.
- Select Create new project available on the Projects dashboard.
- Click Add to project and select API.
- Select Adobe Stock and click Next.
- Specify a Credential name and verify that the OAuth Server-to-Server is selected and click Next.
- Select AEM Assets Product profile and click Save Configured API. A success message displays to confirm that you created a project in the Developer Console. Your project’s dashboard opens, displaying the project name at the top, Adobe Stock under APIS and AEM Assets under Product profile and OAuth Server-to-Server credential card under Connected credentials.
- Select OAuth Server-to-Server credentials card and the Credential details displays. Use these OAuth Server-to-Server credential details of your project such as Client ID, Client Secret, Scope, Credential Name, Technical Account ID, Organization ID to add configuration in the AEM author instance.
Add configuration in the AEM author instance
Execute the following steps to add configuration in your AEM author instance:
Set up a new Adobe Stock IMS configuration in your AEM author Instance
Execute the following steps to set up a new Adobe Stock IMS configuration in your AEM author instance:
-
Navigate to your AEM author instance.
-
Click
-
Click Create to create a new IMS configuration. The Adobe IMS Technical Account Configuration page displays multiple fields such as Cloud Solution, Title, Authorization Server, Client ID, Client Secret, Scope and Org ID. Follow these instructions to specify the details in these fields:
-
Cloud Solution: Select Adobe Stock.
-
Title: Specify a name for this integration.
-
Authorization Server: Add https://ims-na1.adobelogin.com/ as the authorization server.
-
Client ID: Navigate to your project dashboard, click OAuth Server-to-Server option available in the left pane, select Credential details, copy the Client ID and paste it here (see step 7).
-
Client Secret: Navigate to your project dashboard, click OAuth Server-to-Server option available in the left pane, select Credential details, click Retrieve Client Secret, copy the client secret and paste it here (see step 7).
-
Scope: Navigate to your project dashboard, click OAuth Server-to-Server option available in the left pane, select Credential details, copy the Scope and paste it here (see step 7).
-
Org ID: Navigate to your project dashboard, click OAuth Server-to-Server option available in the left pane, select Credential details, copy the Organization ID and paste it here (see step 7).
-
-
Click Create, the Adobe IMS Configurations page opens and displays the Adobe Stock integration that you created.
Add the Cloud configuration to connect to Adobe Stock
Execute the following steps to add the cloud configuration to connect to Adobe Stock:
-
Navigate to your AEM author instance.
-
Click
-
Click Create and the Adobe Stock Configuration page displays multiple fields. Follow these instructions to specify the details in these fields:
- Title: Navigate to the Adobe IMS Technical Account Configuration page (see step 3), copy the title and paste it here.
- Associated Adobe IMS Configuration: Select the Adobe Stock integration you created.
- Locale: Select English (United States).
-
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
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
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_id
orname
. Double-click to open the user properties. -
Navigate to the Permissions tab and allow
read
permissions for the Adobe Stock cloud configuration:/conf/global/settings/stock
.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
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
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
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
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
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
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
-
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
read
permissions 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.