Activating the Integration with Adobe

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.

 

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 guides on creating the necessary credentials for the Adobe API.

More specifically, the following PDF guide will direct you through the following three steps:

  1. Creating a project in your Adobe organization inside Adobe’s Developer Console website.

  2. Adding an API to your project by using the “Service Account (JWT) authentication”.

  3. Gathering the generated Credentials to be utilized with the BSS Adobe application.

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 in order 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: 

  1. Navigate to BSS Setup > Administration > System Options > Applications Setup > Adobe Services > Settings.

     

  2. 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 Adobe PDF guide at the beginning of this page. For more information please check also this Adobe technical page: https://www.adobe.io/authentication/auth-methods.html#!AdobeDocs/adobeio-auth/master/JWT/JWT.md Please note that only the “Distributor ID” value is provided by Adobe and every other field value must be created by you.

    Screenshot Adobe SM 2.png

    System Name: In this field, you define how the instance is named, for example: "Adobe Services".
    Client ID: In this field, you fill in the Client ID value. Its form is numeric.
    Client Secret: In this field, you fill in the Client Secret value.
    Organization ID: In this field, you fill in the Organization ID value. Its form is <alphanumericText@AdobeOrg>.
    Technical Account ID: In this field, you fill in the Technical Account ID value. Its form is <alphanumericText@”organization”.adobe.com>.
    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.
    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“.
    Pricing Files (COM, EDU, GOV): 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 guide.
    Products Selling Currencies: In this field, you need to provide the currencies with which you wish to offer Adobe services to your customers. These currencies, when added in the instance, will not automatically be enabled in the Adobe products. This is a manual process that will take place via the Products Importer tool. For more information please continue to the 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.

    Once you fill in the above fields, click on the "Save" button. 

Adobe EDU & GOV Do Not Support More Than One Currency Inside the “Products Selling Currencies“ Field Located Inside the Adobe Instance(s).

 

  1. Now, you can click on the Get Services Definition button to import the Adobe Product Type, named Adobe Services, automatically to BSS.

    If you wish to check the results and/or logs of the Get Services Definition process, please check the 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 page.

     

You are done with creating the required Adobe Product Type and/or updating the Service Manager with the latest functionality.