Configuring the Customizer component

Configure the Customizer offering of the Component Pack for HCL Connections by setting up a reverse proxy server.

Before you begin

Connections™ Customizer is a proxy service that lets you modify the Connections user experience. Customizer intercepts and modifies requests from clients and responses from servers, so it can customize anything that flows through it, such as the behavior of APIs or the look-and-feel of the user interface.

Connections Customizer performs modifications by injecting JavaScript, CSS, or other web resources into the HTML pages returned by Connections in response to end-user requests. Requests are generated when the user navigates in standard Connections apps such as Communities, Profiles, Files, and Homepage. The customization details (typically, which requests should be modified, and what code should be inserted) are defined by apps stored in the Connections App Registry.

After you configure Connections Customizer, developers can create apps that customize your organization's interface. You can deploy the apps using the App Registry, as explained in Managing Connections Customizer apps.

About this task

The Customizer component uses the services listed in Table 1.

Table 1. Services included in the Customizer stack
Service Name Description
mw-proxy The proxy service that inspects HTTP traffic. Note that this service does not function as the HTTP server (you must configure a reverse proxy server for that purpose, as explained later in this section).
appregistry-service The set of REST APIs that store customization definitions in a Mongo database and leverage Redis as a cache for maximum performance.
appregistry-client The user interface where you can define application registry customizations that will be implemented with Customizer.
mongo The MongoDB database where application registry applications and extensions are stored.
redis The Redis cache where application registry information is temporarily stored to provide maximum performance for Customizer applications and extensions.

Any reverse proxy server can be used with Customizer. You can set one up with the appropriate mw-proxy rules just for this purpose, or you can reuse an existing reverse proxy server (for example, the load balancer for Connections) and add in the rules for mw-proxy. For an example showing how to configure NGINX as a reverse proxy for Customizer, see Configuring the NGINX proxy server for Customizer.

For information on creating apps with Connections Customizer, see Injecting customizations into Connections pages.