Server Configuration

/Server Configuration
You are here:
< Back

Server Configuration

The server – the first entry users have to enter when opening the app – is the starting point of K2 Business Apps. The user enters the server name and a file is retrieved containing more specific values for the app. The server name can be anything you’d like, as long as it adheres to the following rules:

  • The website pointed to contains a virtual directory K2BusinessApps.
  • The virtual directory contains the file EndPoints.json.

The easiest way to configure the server is to log on to the K2 server and open IIS (Internet Information Services). In there, you should see at least the K2 website. You can right click the website and select Add Virtual Directory. Enter the name “K2BusinessApps” and select the directory you want to use, using the directory browser.

EndPoints.json

This file is retrieved by K2 Business Apps and need to have a strict format. It contains the possible endpoints used by the app. These can be used in case you want to use multiple security providers in K2 for e.g. internal users and external users.

The file must have the following format. (It may be stripped of spaces and newlines to shorten the file)

{
   "EndPoints":
   [
      {
         "Name":
         {
            "us-EN": "internal user",
            "nl-NL": "interne gebruiker"
         },
         "Url": "https://smoservices.yourdomain.com/SmartObjectServices/wcf/K2 Business Apps 1"
      },
      {
         "Name":
         {
            "us-EN": "external user",
            "nl-NL": "externe gebruiker"
         },
         "Url": "https://smoservices.yourdomain.com/SmartObjectServices/wcf/K2 Business Apps 2"
      }
   ]
}

EndPoints

A collection of items containing a name and URL.

Name

A mapping of language code to the text that will be shown in the Security Provider field.

Url

The URL exposed by K2 SMO Services. These can be found – is exposed via the HostServer.exe.config file – at https://smoservices.yourdomain.com/SmartObjectServices/endpoints/endpoints.xml. There, you should see at least one and at most nine K2 Business Apps WCF endpoints. You should add an endpoint item for each one you want to be available in the app.

2019-09-06T12:09:06+01:00