Skip to content

Using HCL DX Experience APIs in HCL Volt MX Foundry

Custom Data Adapters are used in HCL Volt MX Foundry to integrate external services. These adapters act as reusable services with a defined set of operations. Starting CF218, a new custom data adapter called HCL DX Content Adapter is available. With this custom adapter, you can access the DX Experience APIs easily and you can create services in HCL Volt MX Foundry with predefined request and response schemas. All available endpoints are included in the HCL DX Content Adapter and you can use them when creating services.

HCL DX Content Adapter for REST service for WCM REST V2

The Web Content Manager V2 (WCM REST V2) HCL DX Content Adapter includes all endpoints of the WCM REST V2 APIs.

Support for this feature is not available in the HCL Support Center. For questions and issues, reach out either in the DXers - The HCL DX User Group on Discord, the HCL DX forum or in the Volt MX Marketplace Forum.

Downloading and importing the HCL DX Content Adapter in HCL Volt MX Foundry

To download and import HCL DX Content Adapter, there are two options:

  • If you are using the SaaS offer of HCL Volt MX, import the HCL DX Content Adapter directly from the HCL Volt MX Marketplace using the Volt MX Foundry user interface. For instructions on how to consume a Custom Data Adapter from the Marketplace, see the HCL Volt MX Foundry documentation.

  • For Helm deployments of HCL Volt MX Foundry, download the the HCL DX Content Adapter from the HCL Volt MX Marketplace and import in the HCL Volt MX Foundry console by going to API Management > Custom Data Adapters > Import.

Import the Custom Data Adapter

Note

Make sure that the version of the HCL DX Content Adapter matches the version of your HCL DX deployment.

Preparing the HCL DX environment

  1. To make authenticated requests against the WCM V2 API, the recommended setup is for the HCL DX environment to use an OIDC Identity Provider for authentication.

  2. Configure the WCM REST V2 API to use the identity provider instead of Basic Authentication. To change this, access the WebSphere Administration console and navigate to Security > Global Security > Web and SIP security > Trust association > Interceptors > com.ibm.portal.auth.tai.HTTPBasicAuthTAI.

  3. Either remove /wps/mycontenthandler* from the urlWhiteList property or remove the property completely if it is the only entry.

  4. Restart the Websphere Application Server or all Core Pods after applying the change.

Preparing the HCL DX environment allows HCL Volt MX Foundry to use the same identity provider and forward the authentication to the backend API.

Preparing the HCL Volt MX Foundry environment

In HCL Volt MX Foundry, set up an OAuth 2.0 identity provider. This identity provider must be connected to the same identity provider as the HCL DX environment.

Creating a Service using the HCL DX Content Adapter

To configure a new Service in HCL Volt MX Foundry using the HCL DX Content Adapter:

  1. Create a new Integration Service. Refer to the HCL Volt MX Foundry Documentation for instructions. Select the newly imported WCM V2 HCL DX Content Adapter as the Service Type.

  2. For the Server URL, set the URL to your HCL DX environment. For example, https://<your DX hostname>/wps/mycontenthandler/wcmrest-v2/.

  3. For Authentication, set the Identity provider configured in the Prepare the HCL Volt MX Foundry environment section.

  4. Click Save & Add Operation to confirm.

Create a Service

In the next section, you can choose from the list of Operations to add the WCM REST V2 endpoints. For a detailed description of all available endpoints, refer to WCM V2 API specification.

Testing the Service

In the HCL Volt MX Foundry console, you have the option to test each operation after creating it. You can test an operation by clicking the Save and Fetch response button at the bottom of each operation. A new window appears where you can log in to your identity provider. The result of the request is logged at the bottom of the console.

Test the operation

After confirming the request is successful, you can use the WCM REST V2 endpoints in accordance to the Volt MX Integration Service documentation.

For additional information on HCL Volt MX Foundry Services, refer to the following topics: