Home
Installation Guide
Configuring SSL Certificates for Link
After installing Link, setup the custom SSL certificates for the Link web UI and the Link runtime application server.
Configuring SSL certificates for Link web UI
To configure SSL certificates for Link web UI, complete the following steps:

Installation Guide
- Introduction to Unica Link
  Unica Link is a component that can be installed separately from the Unica application.
- Unica Link prerequisites
  Ensure that these prerequisites are met before installing Unica Link.
- Microsoft Windows installation
  This section describes how to install Link using the Windows Installer.
- Linux Installation
  You can install Unica Link in two modes:
- Setting up Journey and Campaign for Unica Link
- Link Cosmos DB integration
  The purpose of this document is to guide on integrating your web application with Azure Cosmos DB for MongoDB. By following the steps outlined herein, you will seamlessly incorporate Cosmos DB into your application's data storage and retrieval processes.
- Logging
  Logs are produced for your use by Link, the Runtime REST API, and Kafkalink.
- Enabling Unica Link to run on HTTP protocol for Windows and Linux Installation
- Encrypting the password in the properties file
  To enhance security and safeguard sensitive information, encrypt the password stored in the properties file adding a layer of protection to the data.
- Verifying the config.yaml file
  This section describes how to verify the validity of your config.yaml file after making changes in it. When editing the config.yaml file, ensure that the modifications you make are valid. To verify the validity of your config.yaml file after making changes, perform one of the following procedures based on your setup:
- Configuring SSL Certificates for Link
  After installing Link, setup the custom SSL certificates for the Link web UI and the Link runtime application server.
  - Configuring SSL certificates for Link web UI
    To configure SSL certificates for Link web UI, complete the following steps:
  - Configuring SSL certificates for the Link Apache Tomcat application server
    If you implement Link on a setup containing Apache Tomcat sever, the implementation works as a Tomcat application.
  - Configuring SSL certificates for Link using command line tool
    To configure the SSL certificates for Link using command line tool to import certificate in PEM format, complete the following steps:
  - Configuring SSL certificates for Link Java WEB Client
    This documentation explains how to configure an SSL certificate for the Link Java WEB client.
- Troubleshooting
- Known issues
  Summary of known issues in this version of the product.

Configuring SSL certificates for Link web UI

To configure SSL certificates for Link web UI, complete the following steps:

Procedure

Prepare the SSL certificate files.

Within the Link client installation folder, copy the certificate files to the ssl-certificates/public-certificates/ folder. The relative path of the installation root folder for different platforms are as follows:


Microsoft Windows	The client installation folder is DesignServer/client.
Linux (Native)	The client installation folder is node-context/install.

Setup the config.yaml "/client/inbound/ssl" section to point to the certificate files copied in Step 2.

Example:


key: "ssl-certificates/public-certificates/server.key"
cert: "ssl-certificates/public-certificates/server.crt"
ca: " ssl-certificates/public-certificates/gd1.crt,ssl-certificates/public-certificates/gd2.crt,ssl-certificates/public-certificates/gd3.crt "

Restart the Link application. If your user profile has all the appropriate privileges, open a shell and change the working directory to the installation root.

Steps for configuring SSL Certificates in Linux Docker

About this task

To configure SSL certificates for Linux Docker, complete the following steps:

Procedure

Prepare the SSL certificate files.
Within the Link client installation folder, copy the certificate files to the ssl-certificates/public- certificates/ folder.
Stop Link.

Change the following properties in the client section of config.yaml and save the file.

key: "ssl-certificates/public-certificates/server.key"
cert: "ssl-certificates/public-certificates/server.crt"
ca: "ssl-certificates/public-certificates/gd1.crt,ssl-certificates/public-certificates/gd2.crt,ssl-certificates/public-certificates/gd3.crt"

Start Link.
Ignore Certificate Error.

Note: The hip-client container might fail to start due to a missing certificate in the specified path.
Copy the certificates from the local folder to the HIP client container at /usr/src/app using docker cp command.
```
docker cp ssl-certificates hip-client:/usr/src/app
```
Replace ssl-certificates with the path to your local folder containing certificates.
Restart Hip Client.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.