Environment Configuration

Introduction

The Environment Configuration is the place to do the initial configuration of your run time. To be able to deploy solutions you need to create at least one k5-project. This k5-project needs at least 3 service bindings to function and these three bindings can be created on the environment level.

Usually, you will only have to configure the environment settings once but you could change them if needed. Any settings made at this level will only apply to new k5-projects.

Create Service Bindings

The most important function of the Environment Configuration is to provide the cluster-wide default settings which are necessary to create k5-projects.

Open Solution Hub and visit the Environment Configuration tab on the Environment level of the overview. This tab provides three sections, one for each of the mandatory service bindings.

Alternatively, you can do the settings via a REST API called Configuration Management API (see API documentation). This API provides a Swagger UI for ease-of-use but you can use the tool of your choice for calling APIs (e.g. cURL, Postman).

Tip: As long as not configured otherwise, the default URL where you can find the Configuration Management Swagger UI is built like this:

<https://ssob-config>.<domain>

The exact URL can be found within the route named k5-configuration-management. It can be easily retrieved by executing

oc get route k5-configuration -n <namespace>

, whereby <namespace> points to the namespace, where the Solution Hub is installed.

Authentication

This service binding sets up the connection to your IAM provider that is used for authentication of a deployed solution. The following parameters have to be provided:


Form Field	Description
Name	Specify a unique name for this binding.
Client Id	The client ID of a registered OAuth client
Client Secret	The secret value which is bound to the referenced OAuth client.
Issuer	The issuer which has issued the JWT.
JWK URI	The URL of the JSON Web Key set.
User Authorization URI	The URL of the OAuth authorization endpoint.
Token URI	The URL of the OAuth token endpoint.

Database


Form Field	Description
Name	Specify a unique name for this binding.
Database URI	The MongoDB connection string

Example:

mongodb://username:password@mongodb.domain.svc.cluster.local:27017/admin?ssl=false

Messaging


Form Field	Description
Name	Specify a unique name for this binding.
Message Hub URI	Enter the Kafka connection string.
Username	The provided Kafka user must have the permission to read and create topics.
Password	Enter the password for the specified message hub user.
SASL Mechanism	Select the SASL mechanism to use with the message hub.
SASL JAAS Config Login Module	The SASL JAAS Config Login Module used for the SASL mechanism. This field will be auto-filled depending on the selected SASL mechanism.