Welcome
Administration
Here you will find the tasks that are required for administration of your HCL Link product.
Keycloak
This documentation describes the Keycloak functionality.
User Administration
After you install Keycloak, you must consider how the software manages users and authentication.
Default User Administration
Keycloak uses the concept of a realm to manage and authenticate users. When you install the Keycloak server, a realm called testserver is created for you in Keycloak. All server users belong to this realm and when they log in to the server, they log into that realm.
Configuring Clients
This topic documents how to configure clients.

Introduction
Congratulations on your selection of HCL Link as your data integration solution!
What's New
Release Notes
System requirements
A complete desciption of the hardware and software requirements for both Windows and Linux systems.
Installation
Everything you need to know to install HCL Link.
Administration
Here you will find the tasks that are required for administration of your HCL Link product.
- User Management
  HCL Link provides inbuilt support for managing users who may create, deploy and run integrations.
- Keycloak
  This documentation describes the Keycloak functionality.
  - Introduction
    Keycloak is an open-source identity and Access Management solution. It is a single sign-on security application for web applications and RESTful web services. Link and Runtime REST API supports Keycloak solution of user administration and authorization.
  - Installation
    To install Keycloak refer to the latest “Getting Started” documentation available on the Keycloak product website.
  - User Administration
    After you install Keycloak, you must consider how the software manages users and authentication.
    - Default User Administration
      Keycloak uses the concept of a realm to manage and authenticate users. When you install the Keycloak server, a realm called testserver is created for you in Keycloak. All server users belong to this realm and when they log in to the server, they log into that realm.
      - Creating a Realm
        This topic documents how to create a realm.
      - Configuring Clients
        This topic documents how to configure clients.
      - Connecting to Link
        This topic documents how to set up connections between Keycloak and Link.
    - LDAP User Authentication
      You are using a Lightweight Directory Access Protocol and Active Directory HTTP server to manage users and authentication. You want to know the best practices to use that LDAP/AD server to manage user access to Link.
    - Runtime REST API
      Runtime REST API supports Keycloak authentication of user credentials for running maps and flows. Like Link, Runtime REST API can be configured to authenticate users with Keycloak.
- Outbound connections to Runtime Servers
  Transport Layer Security (TLS) client settings can be configured for outbound connections from Design Server to Runtime Servers.
- Account recovery
  These instructions describe how to use the Administrators' account recover utility to recover account information for both Windows and Linux accounts.
Projects
A project is a container for HCL Link artifacts.
Services
Service definitions define REST services and the endpoints of a service. This guide provides step-by-step instructions for creating, importing, and managing services using the system interface, following Microsoft standards.
Connectors
This documentation describes the connectors and how they are used.
Packages
Servers
This documentation contains a description of the server groups and servers.
Variables
The variables described here include Configuration variables, flow variables, and cache variables.
Dashboards
A description of HCL Link dashboards, including the Server dashboard and the Kibana dashboard.
Runtimes
Descriptions of Link runtime services.
Resource Adapters
About the HCL Link Resource Adapters, and how to use them.
Cloud Native Link
Cloud Native Link refers to the HCL Link product installation on a Kubernetes cluster.
Reference
This documentation provides HCL Link reference information.
Notices

Configuring Clients

This topic documents how to configure clients.

Procedure

Log in to the Keycloak Admin Console.
Click on the Clients option from the Configure property. The Clients page opens. Users can see the list of applications available in the Keycloak.
Click on the link-rest client from the list. The Link-rest page opens. When you select the link-rest, it will automatically configure all the properties available in the Settings tab.
Go to the Credentials tab, click on the Regenerate Secret button to create a client secret for the user.
Go to the Roles tab to edit the attributes of respective role, if required.