Configuration Options¶

Shared Options¶

Please set the following environment variables in your collab config file as required

Key	Description
`user.env.DISABLE_WELCOME_EMAIL`	Optional: Set to disable welcome emails for users
`app.env.BANNED_LINK_URL_EXPRESSION`	Optional: A JavaScript regular expression string where matching link (Bookmark) URLs will be denied creation. Existing links that match will cause errors when updating any links on a node, unless all matching links are deleted. Default: `^javascript:`

Tip

Optional: These settings are only required if you are using HCL Connections as your authentication provider.

Key	Description
`provider.env.WIDGET_ID`	Optional: ID of the Community widget configured in this step
`user.env.CONNECTIONS_NAME`	Optional: If you refer to 'Connections' by another name, set it here
`user.env.CONNECTIONS_CLIENT_ID`	oAuth client-id, usually `huddoboards`
`user.env.CONNECTIONS_CLIENT_SECRET`	oAuth client-secret as configured in this step
`user.env.CONNECTIONS_URL`	HCL Connections URL, e.g. `https://connections.example.com`
`user.env.CONNECTIONS_ADMINS`	Emails or GUIDs of users to grant admin permissions. e.g. `"[\"admin1@company.example.com\", \"PROF_GUID_2\"]`"
`user.env.CONNECTIONS_KEYCLOAK_URL`	Optional: See keycloak authentication for more information
`user.env.CONNECTIONS_KEYCLOAK_REALM`	Optional: See keycloak authentication for more information
`user.env.CONNECTIONS_KEYCLOAK_PATH`	Optional: Keycloak path Default: `/auth/realms` Customise this to `/realms` as of Keycloak v22

Tip

Optional: These settings are only required if you are using HCL Domino as your authentication provider.

Key	Description
`user.env.DOMINO_AUTH_URL`	HCL Domino REST API URL. See domino authentication for more information
`user.env.DOMINO_CLIENT_ID`	oAuth client-id, see domino authentication for more information
`user.env.DOMINO_CLIENT_SECRET`	oAuth client-secret, see domino authentication for more information
`user.env.DOMINO_ADMINS`	Optional: Emails or GUIDs of users to grant admin permissions. See domino authentication for more information
`user.env.DOMINO_USE_PROFILE_IMAGE_ATTACHMENTS`	Optional: set `true` to enable using profile images See domino authentication for more information
`user.env.DOMINO_PROFILE_IMAGE_NAME`	Optional: file name of profile images. Uses first image attached if not set See domino authentication for more information
`user.env.DOMINO_AUTH_SCOPE`	Optional: defaults to `$DATA` See domino authentication for more information
`user.env.DOMINO_REST_SCOPE`	Optional: defaults to `directorylookup` See domino authentication for more information

Tip

Optional: These settings are only required if you are using HCL DX as your authentication provider.

Key	Description
`user.env.DX_URL`	HCL DX URL, e.g. `https://dx.company.com`
`user.env.DX_CLIENT_ID`	oAuth client-id, see dx authentication for more information
`user.env.DX_CLIENT_SECRET`	oAuth client-secret, see dx authentication for more information
`user.env.DX_ADMINS`	Optional: Emails or GUIDs of users to grant admin permissions.
`user.env.DX_AUTH_PROVIDER_NAME`	Optional: name of the OAuth Service Provider. Defaults to `OAuthConfig`

Tip

Optional: These settings are only required if you are using Microsoft Active Directory (AD) as your authentication provider.

Please follow the steps in the Microsoft Active Directory Federation Service guide to configure your AD FS server, and the Huddo Boards application group.

Key	Description	Example / Default
`user.env.MSAD_NAME`	Name on the login button	`Microsoft AD`
`user.env.MSAD_ADMINS`	Email/ID of users to grant admin access	`["admin@example.com", "admin2@example.com"]`
`user.env.MSAD_FS_URL`	AD FS server URL	`https://adfs.example.com`
`user.env.MSAD_CLIENT_ID`	AD FS client id
`user.env.MSAD_CLIENT_SECRET`	AD FS client secret
`user.env.MSAD_LDAP_URL`	URL of LDAP server	`ldap://ad.example.com`
`user.env.MSAD_LDAP_BASE_DN`	Base DN for LDAP search	`DC=example,DC=com`
`user.env.MSAD_LDAP_BIND_DN`	Bind DN for LDAP search	`CN=Boards,OU=Service Accounts,DC=example,DC=com`
`user.env.MSAD_LDAP_BIND_PASSWORD`	Bind password for LDAP search