Document the addition of the realm to the connection details

CHANGELOG.md

@@ -8,6 +8,7 @@ All notable changes to the **kdb VS Code extension** are documented in this file
 
 - Display meta data for Insights connections
 - Added option to click at meta data and open in json format the meta data
+- Ability to change the name of the Keycloak realm, used for authentication, from the default value of `insights`. This enables the connection to a kdb Insights Enterprise Free trial instance.
 - Improve the console log quality to "kdb"output pane
 - Insights free trial instances are supported
 - Added execute block command for q code

README.md

@@ -188,6 +188,19 @@ Set the following properties:
 
 ![connecttoinsights](https://github.com/KxSystems/kx-vscode/blob/main/img/insightsconnection.png?raw=true)
 
+Set the following from the Advanced properties if necessary:
+
+| Property               | Description                                                                                                                |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| Define Realm           | Specify the Keycloak realm for authentication. Usually the realm is set to `insights`, which is the default value used by the extension. You only need to change this field if a different realm has been configured on your server.  |
+
+![connecttoinsights](https://github.com/KxSystems/kx-vscode/blob/main/img/insightsconnectionadvanced.png?raw=true)
+
+
+!!!note "For kdb Insights Enterprise Free Trial instances"
+   The realm is configured as `insights-{URL}` where {URL} is the 10 digit code in the trial URL. For example: if your trial url is https://fstc83yi5b.ft1.cld.kx.com/ the realm should be `insights-fstc83yi5b`.
+
+
 1. Click **Create Connection** and the **kdb Insights Enterprise** connection appears under **CONNECTIONS** in the primary sidebar.
 
 1. Right-click the connection, and click **Connect server**.