Use ÃÛ¶¹ÊÓƵ Stock assets in ÃÛ¶¹ÊÓƵ Experience Manager Assets use-adobe-stock-assets-in-aem-assets
ÃÛ¶¹ÊÓƵ 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.
ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock assets that are saved in Experience Manager, without leaving the Experience Manager interface.
Integrate Experience Manager and ÃÛ¶¹ÊÓƵ Stock integrate-aem-and-adobe-stock
Experience Manager Assets provides users the ability to search, preview, save, and license ÃÛ¶¹ÊÓƵ Stock assets directly from Experience Manager.
Prerequisites
The integration requires:
- An
- 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 ÃÛ¶¹ÊÓƵ Developer Console
An enterprise ÃÛ¶¹ÊÓƵ Stock plan,
- Provides product entitlement for ÃÛ¶¹ÊÓƵ Stock (Stocks connected to Experience Manager)
- Credits purchased into the ÃÛ¶¹ÊÓƵ Admin Console for your stock entitlement
- Enables Service Account (JWT) authentication within ÃÛ¶¹ÊÓƵ Developer Console for your stock entitlement
- Enables managing the credits and licensing globally from within ÃÛ¶¹ÊÓƵ Admin Console
Within the entitlement, a default product profile for ÃÛ¶¹ÊÓƵ 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 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 ÃÛ¶¹ÊÓƵ Stock.
Steps to integrate Experience Manager and ÃÛ¶¹ÊÓƵ Stock integration-steps
To integrate Experience Manager and ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Developer Console, create a project for your ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock entitlement.
IMS configuration includes two steps:
Obtain public certificate public-certificate
The public key (certificate) authenticates your product profile in ÃÛ¶¹ÊÓƵ 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 > ÃÛ¶¹ÊÓƵ IMS Configurations.
-
In ÃÛ¶¹ÊÓƵ IMS Configurations page, click Create. The ÃÛ¶¹ÊÓƵ IMS Technical Account Configuration page opens.
-
In the Certificate tab, select ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Developer Console.
Click Next.
-
In the Account tab, ÃÛ¶¹ÊÓƵ IMS account is created which requires the service account credentials.
Open a new tab and create a service account (JWT) connection in ÃÛ¶¹ÊÓƵ Developer Console.
Create service account (JWT) connection createnewintegration
In ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Developer Console with system administrator privileges. The default URL is .
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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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: .
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 ÃÛ¶¹ÊÓƵ Stock cloud service:
-
In the Experience Manager user interface, navigate to Tools > Cloud Services > ÃÛ¶¹ÊÓƵ Stock.
-
In the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock. You can create multiple ÃÛ¶¹ÊÓƵ Stock configurations (for example, locale-based configurations). You can now access, search, and license the ÃÛ¶¹ÊÓƵ Stock assets from within the Experience Manager user interface.
note note NOTE At this stage of integration, only the administrators can access the ÃÛ¶¹ÊÓƵ Stock assets, search Stock assets (using omnisearch), and license the ÃÛ¶¹ÊÓƵ Stock assets. Administrators can further add users or groups to the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock cloud configuration and click Properties.
-
Search to add the users or groups to whom you have assigned permissions to access the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock cloud service.
Following are the permissions required for a user to search and license ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock.
-
Navigate to Tools > Security > Permissions.
-
Search for the user group in the left panel and add new Access Control Entry (ACE) for ÃÛ¶¹ÊÓƵ Stock.
- Configure the path:
/conf/global/settings/stock - Privileges:
jcr:read - Permission Type:
Allow
Click Add.
- Configure the path:
-
Navigate to Tools > Cloud Services > ÃÛ¶¹ÊÓƵ Stock. Select the ÃÛ¶¹ÊÓƵ Stock cloud configuration and click Properties.
-
Add the newly created user group to the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock cloud configuration.
Access ÃÛ¶¹ÊÓƵ Stock assets access-stock-assets
A non-admin user having permissions to the ÃÛ¶¹ÊÓƵ Stock cloud configuration can search and license the ÃÛ¶¹ÊÓƵ Stock assets from the Experience Manager interface.
The user has to perform an extra step of activating the ÃÛ¶¹ÊÓƵ Stock cloud configuration before accessing ÃÛ¶¹ÊÓƵ Stock assets. It is a one-time activity. If the user is assigned permissions on multiple ÃÛ¶¹ÊÓƵ Stock cloud configurations, the user can select the desired configuration from the User Preferences.
To activate the ÃÛ¶¹ÊÓƵ 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 > ÃÛ¶¹ÊÓƵ Stock. You can now view, search, and license ÃÛ¶¹ÊÓƵ Stock assets.
The following table explains how the user permissions work while accessing the ÃÛ¶¹ÊÓƵ Stock assets:
Use and manage ÃÛ¶¹ÊÓƵ Stock assets in Experience Manager usemanage
Using this capability, organizations can allow its users to work using ÃÛ¶¹ÊÓƵ Stock assets in Experience Manager Assets. From within the Experience Manager user interface, users can search ÃÛ¶¹ÊÓƵ Stock assets and license the required assets.
Once an ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock website that are similar to the selected asset H. View the selected assets on ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock. When the search location is not limited to ÃÛ¶¹ÊÓƵ Stock, the search results from Experience Manager and ÃÛ¶¹ÊÓƵ Stock are displayed.
-
To search for ÃÛ¶¹ÊÓƵ Stock assets, click Navigation > Assets > Search ÃÛ¶¹ÊÓƵ Stock.
-
To search for assets across ÃÛ¶¹ÊÓƵ Stock and Experience Manager Assets, click search
Alternatively, start typing Location: ÃÛ¶¹ÊÓƵ Stock in the search bar to select ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock assets by using the quota of their ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock assets. -
Non-admin users have to manually activate the ÃÛ¶¹ÊÓƵ Stock cloud configuration: In the User Preferences window, the Stock Configuration shows the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Stock website. Similarly, if the user updates the reference fields on the ÃÛ¶¹ÊÓƵ Stock website, the updates are not synchronized in Experience Manager.