Commerce Studio integration with FusionLucidworks Platform
- Prerequisites
- 1. Create a Commerce Studio integration with Fusion
- 2. Create Fusion roles required for Commerce Studio
- 3. Create a Fusion security JWT realm for Commerce Studio
- 4. Create the lwp service account user in the JWT realm
- 5. Verify Commerce Studio integration with Fusion
- 6. Create a Commerce Studio instance using the UI
This type of Fusion integration lets you connect self-hosted Fusion instances to Lucidworks Commerce Studio.
If you want to migrate from Predictive Merchandiser to Commerce Studio, the information in this topic is used in coordination with the procedures described in Migration guide from Predictive Merchandiser to Commerce Studio.
You must satisfy the prerequisites and complete all of the procedures in the order described in this topic to implement Lucidworks Commerce Studio:
This topic is specific to integrating Lucidworks Platform with Fusion for the use of Commerce Studio.
|
Prerequisites
To create an integration, you must have the following prerequisites in place:
-
Admin privileges to a self-hosted Fusion environment running Fusion 5.9.8 or later.
-
A Fusion application that contains usable data.
-
Workspace Owner permissions in a Lucidworks Platform environment.
-
Privileges to access and use Lucidworks Commerce Studio in a Lucidworks platform workspace.
1. Create a Commerce Studio integration with Fusion
Complete the following procedures to create an integration from Lucidworks Commerce Studio to Fusion.
-
Sign into Lucidworks Platform as a workspace owner.
-
Navigate to Settings > Fusion Integrations and click Connect New Fusion.
-
In the Name field, enter a unique name for the integration. For example,
Lucidworks Demo Dev
. -
In the API URL field, enter the URL of your Fusion instance. For example,
https://FUSION_INSTANCE.com
. Do not enter a path after.com
. -
In the Environment field, select the Fusion instance environment or use the default of Development.
-
Optional: Enter one or more descriptive Tags that differentiate multiple integrations.
-
Do not enter values in any of the fields in the GitHub section. Values in these fields are only required to set up the Configuration Promotion tool integration with Fusion.
-
Click Add. If the value in the API URL field is:
-
Not valid, the integration is not created, and it is not displayed on the Fusion Integrations screen.
-
Valid, the Instructions to Connect with Fusion screen displays:
-
-
Copy both the JWK Set URL value and the Issuer URL value to a secure location. These values must be used to create the JWT realm.
-
Click Close.
-
Verify the new integration displays on the Fusion Integrations screen.
To edit the integration, hold the pointer over the integration, click the pencil icon, enter the changes, and click Save. To delete the integration, hold the pointer over the integration and click the trash can icon. |
2. Create Fusion roles required for Commerce Studio
-
Sign in to your Fusion instance as an admin and click the Fusion application to connect with Commerce Studio.
-
Navigate to System > Access Control > Roles and click Add Role.
-
In the Name field, enter
lwp_user
. -
In the Permissions field, enter:
GET,PUT,DELETE,POST,HEAD:/query/experience-manager/** GET,POST:/query/* GET:/suggestions/** GET:/solr/*/terms GET:/apps/*/query-profiles/** GET,PUT:/apps/* GET:/solr/*/admin/luke
This role does not require any UI permissions, so you do not have to select any values in the UI Permissions field.
-
In the Description field, enter role information. For example, "The lwp_user account is required to access and use Commerce Studio. It is a super user account, but does not include the ability to get, modify, or delete the
HEAD
section of the site." -
Click Save.
-
Click Add Role.
-
In the Name field, enter
lwp_service_account
. -
In the Permissions field, enter the following permissions. These permissions include all of the lwp_user account permissions plus the privileges to migrate Fusion Predictive Merchandiser rewrites, rules, templates and zones.
GET,PUT,DELETE,POST,HEAD:/query/experience-manager/** GET,POST:/query/* GET:/suggestions/** GET:/solr/*/terms GET:/apps/*/query-profiles/** GET,PUT:/apps/* GET,DELETE,PATCH,PUT,POST,HEAD:/apps/*/query-rewrite/** GET,HEAD:/templating/** GET:/solr/*/admin/luke
This role does not require any UI permissions, so you do not have to select any values in the UI Permissions field.
-
In the Description field, enter role information. For example, "The lwp_service_account contains all of the lwp_user permissions as well as the privileges to migrate Fusion Predictive Merchandiser components to Lucidworks Commerce Studio."
-
Click Save.
3. Create a Fusion security JWT realm for Commerce Studio
-
Sign in to your Fusion instance as an admin and click the application in which you created the
lwp_user
andlwp_service_account
accounts to use with Commerce Studio. -
Navigate to System > Access Control > Security Realms and click Add Security Realm.
-
In the Name field, enter a unique connection name. For example, Lucidworks Commerce Studio JWT realm.
-
In the Type field, select jwt.
-
Set the checkboxes in the following configuration.
-
Select the Enabled checkbox.
-
Do not select the Ephemeral Users checkbox.
-
Select the Auto-Create Users checkbox.
-
-
In the Roles field, select
lwp_user
. -
In the JWT Issuer field, paste the Issuer URL value generated in the Create a Commerce Studio integration with Fusion procedure.
-
In the JWK Set URL field, paste the JWKS URL value generated in the Create a Commerce Studio integration with Fusion procedure.
-
Do not enter values (default is blank) in any of the following fields:
-
Signing Key
-
Groups Key
-
Groups Mapping
-
User ID Attribute
-
-
Click Save.
4. Create the lwp service account user in the JWT realm
-
Sign in to your Fusion instance as an admin and click the application to be connected with Commerce Studio.
-
Navigate to System > Access Control > Users and click Add User.
-
In the Realm field, select the JWT realm you created in the Create a Fusion security JWT realm for Commerce Studio.
-
In the Username field, enter
lwp-service-account
, then enter a unique Password and re-enter it in the Confirm Password field. -
In the Roles field, select the
lwp_service_account
role. -
In the Timezone field, select the appropriate timezone for the user account.
-
Click Create.
5. Verify Commerce Studio integration with Fusion
When the Fusion security JWT realm is created, complete the following steps to verify the Fusion information is displayed.
-
Sign into Lucidworks Platform as a workspace owner.
-
Navigate to Settings > Fusion Integrations.
-
Hold the pointer over the integration and click the pencil icon.
-
Verify the information is accurate.
The information in the Instructions section must match the values in the Additional URLs JWKS URL and Issuer URL fields.
6. Create a Commerce Studio instance using the UI
Do not create a Commerce Studio instance using the UI if you are migrating data from Predictive Merchandiser into that Commerce Studio instance. Instead, you must create the instance using the API. |
-
Sign in to Lucidworks Platform as a workspace owner.
-
Navigate to Commerce Studio and click Create New.
-
In the Name field, enter a unique name for the Commerce Studio instance.
-
In the Region field, select the geographic region for the Commerce Studio instance. This cannot be changed after the instance is created.
-
In the Fusion to Connect field, select the Fusion integration instance that matches the Name field created in the Create a Commerce Studio integration with Fusion procedure.
-
Optional: In the Signal Store field, select the location where the Commerce Studio signals are stored. This value is only required if you want to use Lucidworks Analytics.
-
In the Fusion Application field, enter Lucidworks Platform application that connects to your Fusion instance.
-
Click Next to confirm settings, and then Next to create the instance.
Data from the Fusion app is sent to Commerce Studio so you can create rules and refine the search experience. You can only connect one instance of Commerce Studio to a Fusion app. You cannot create multiple instances of Commerce Studio using the same Fusion app. |