| Excerpt |
|---|
The first step to employ Adobe solutions to an interworks.cloud instance is to activate the Adobe Service Manager as well as deploy the RabbitMQ server on your infrastructure. This action will enable the necessary components in interworks.cloud platform so that you can then import the available Adobe SKU's manually and configure the presentation layer in your Storefront. You can see how, by reading the following instructions. |
| Rw ui textbox macro | ||
|---|---|---|
| ||
Requirement for All Infrastructures Having the Adobe Service Manager Enabled Each Adobe Service Manager requires in the infrastructure (cloud or on-premise) the RabbitMQ server to be deployed. |
Getting the Adobe API Credentials
It is assumed that there is a standing agreement with Adobe and that Adobe has provided you with the following guide on creating the necessary credentials for the Adobe API.
| Rw ui textbox macro | ||
|---|---|---|
| ||
Help from an IT personnel is advisable |
| Rw ui textbox macro | ||
|---|---|---|
| ||
Mandatory Migration to the New Adobe Credentials for All Partners by January 27, 2025 |
In the first tab, as a new and existing partner, you can find the latest guide for creating and retrieving your Adobe credentials. These credentials are necessary for connecting the Adobe Service Manager instance to Adobe's systems via API. In the second tab, you can find the old guide for creating and retrieving your Adobe credentials. Although this guide is deprecated, it is kept only for the reference of existing partners.
| Rw ui tabs macro | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
All new as well as existing partners can create their latest Adobe credentials from the related project on the Adobe Developer Console, by:
Then the steps described inside the following PDF guide will direct you on how to convert the crt file to a pfx type with a user-defined password.
After successfully finishing the steps from both PDF guides, you can proceed to the Adobe Services integration Settings page of the BSS portal to configure the integration and paste the pfx Certificate under the respective field. |
Please continue to the following section for more information.
Configuring Adobe API Access on BSS
To configure the Adobe integration instance, please proceed with the following steps:
Navigate to BSS Setup > Administration > System Options > Applications Setup > Adobe Services > Settings.
There are some simple attributes, that define the connection to the Adobe API. The below field values are created by the distributor by following this New Adobe guide at the beginning of this page, under the first tab. Please note that only the “Distributor ID” value is provided by Adobe. Every other field value must be created by you.
Depending on whether you are a new or an existing partner, different fields of each Adobe instance need to be filled in or left empty, depending on the authentication method you have credentials for.
🔹 For the New authentication method, the required fields for the instance authentication are: Client ID, and Client Secret, along with the checkbox called “Enable Server to Server Credentials” to be enabled.
🔹 For the Existing authentication method, the required fields for the instance authentication are: Client ID, Client Secret, Organization ID, Technical Account ID, Distributor ID (provided by default by Adobe), Certificate Password, and Certificate. Also, in this case, the checkbox called “Enable Server to Server Credentials” must be disabled.
The fields are explained as follows:
System Name: In this field, you define how the instance is named, for example: "Adobe Services". This field needs to be filled in always irrespective of the new or the old authentication mechanism.
Client ID: In this field, you fill in the Client ID value. Its form is numeric. This field needs to be filled in always irrespective of the new or the old authentication mechanism.
Client Secret: In this field, you fill in the Client Secret value. This field needs to be filled in always irrespective of the new or the old authentication mechanism.
Organization ID: In this field, you fill in the Organization ID value. Its form is <alphanumericText@AdobeOrg>. This field needs to be filled in only for the old authentication mechanism. The new authentication mechanism does not require this field.
Technical Account ID: In this field, you fill in the Technical Account ID value. Its form is <alphanumericText@”organization”.adobe.com>. This field needs to be filled in only for the old authentication mechanism. The new authentication mechanism does not require this field.
Distributor ID: In this field, you fill in your Distributor ID value. Its form is numeric.
Certificate Password: In this field, you fill in the “pfx“ certificate password. This field needs to be filled in only for the old authentication mechanism. The new authentication mechanism does not require this field.
Certificate: In this field, you need to browse, select, and upload the “pfx“ certificate that you have created, from the previous section “Getting the Adobe API Credentials“. This field needs to be filled in only for the old authentication mechanism. The new authentication mechanism does not require this field.
Pricing Files (COM, EDU, GOV, and their 3YC counterparts): In these fields, you need to browse, select, and upload the Excel file that corresponds to the products you wish to sell, be that Commercial, Education, and Governmental (with a 1-year or a 3-years commitment). Also, these price lists are the ones that you have created and edited, based on the https://interworkscloud.atlassian.net/wiki/spaces/ICPD/pages/830768041/Adobe+VIP+MP+Volume+Discount#Importing-the-Discount-Pricing-Excel-File-with-the-Final-Prices guide.
Products Selling Currencies: In this field, you need to provide the currencies with which you wish to offer Adobe services (COM, EDU, and GOV) to your customers. These currencies, when added in the instance, will:
• Be automatically enabled in the Adobe EDU & GOV products.
• Notbe automatically enabled in the Adobe COM products (except the “Adobe Stock Credit Packs”). This is a manual process that will take place via the Products Importer tool. For more information please continue to the https://interworkscloud.atlassian.net/wiki/spaces/ICPD/pages/830768041/Adobe+VIP+MP+Volume+Discount#Enabling-Pricing-Currency page.
Adobe Agreement Currency*: In this field, you need to provide the currency with which you have agreed with Adobe to sell Adobe services. This currency is used for the provisioning of Adobe services.
*The Distributor should create new instances for each Adobe Agreement Currency he wants to be charged by Adobe and upload the corresponding Excel for this currency from the Portal of Adobe.
Update Product Names: You have two options in this drop-down menu field. You can choose “Continuously update names“ so that the product name descriptions are updated with each run of the Get Services Definition service or “Set default names only on create“ to keep the same product name descriptions that were provided during their first creation.
Update Minimum Purchase Quantity: You have the below two options in this drop-down menu field.
• “Continuously update the minimum purchase quantity”(default option): This option allows you to automatically adjust the minimum purchase quantity to align with the values in the pricing file in the latest GSD instance.
• “Do not automatically update the minimum purchase quantity”: This option allows you to manually set the minimum purchase quantity, regardless of whether Adobe has provided a default requirement. This manual value will only be updated by the BSS user and will override any default minimum quantity requirements set by Adobe.
If there is no value in the “Update Minimum Purchase Quantity“ field, it will not appear in the product details section of the product view page.
| Note |
|---|
Important Clarifications Relating to the “Minimum Purchase Quantity” Functionality:
|
• Enable Server to Server Credentials: This checkbox field needs to be enabled (checked) only if the instance authentication method is the OAuth server-to-server authentication. Otherwise, it needs to be deactivated (unchecked).
| Info |
|---|
Adobe EDU & GOV Support Multiple Currencies Inside the “Products Selling Currencies“ Field Inside the Adobe Instance(s). Each time the Get Services Definition (GSD) process is run, the product prices are updated based on the prices uploaded to the respective pricing-file fields (COM, EDU, and GOV) of the Adobe Service Manager Instance. Concerning the commercial (COM) products, only the “Adobe Stock Credit Packs” update their product prices automatically via the aforementioned process. The rest of the commercial (COM) products along with their prices, are imported to our platform via the products import tool and notvia the Get Services Definition (GSD) process. |
| Note |
|---|
Error While Uploading (COM, EDU, GOV) Pricing Files to the Instance With Invalid Characters When the uploaded pricing files (COM, EDU, GOV) contain invalid characters, the following error is displayed: |
Once you fill in the above fields, click on the "Save" button.
Now, you can click on the Get Services Definition button to import the Adobe Product Type, named Adobe Services, automatically to the BSS.
If you wish to check the results and/or logs of the Get Services Definition process, please check the 'Get Services Definition' Action page.
⚠️ Note that, contrary to the behavior of other interworks.cloud Service Managers, Adobe Service Manager creates only one container product but it does not create BSS end-products to match the Adobe SKU's. The distributor must manually import the end products inside the BSS via an Excel file. This process is analyzed on the Importing/Updating Adobe Products & Prices to BSS page.
You are done with creating the required Adobe Product Type and/or updating the Service Manager with the latest functionality.
Table of Contents
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|