Securing a Decisions Installation

Overview

During installation, countering security risks and potential attacks on the instance or environment is crucial. Implementing security measures and protocols ensures data protection and a strong defense against threats throughout the application's lifecycle.

Decisions support several ways to secure an installation, including:

• Installing with Windows Integrated Security Credentials
• Secure cookies
• Enabling HTTP Strict Transport Security (HSTS)
• Displaying exception details
• Excluding specific file extensions
• Protecting against cross-frame scripting and/or clickjacking
• Hiding the Server name from the Response Headers

Installing with Windows Integrated Security

Users who have previously configured MSSQL Server using their Windows authentication credentials can leverage the same credentials to enable Windows Integrated Security for their database connection. This feature is advantageous for both system administrators who rely on Windows Integrated Security and users conducting local installations.

1. Proceed with installation until the Database Setup and Hosting Options section of the Installation Guide.
2. From the Settings section, define the desired Directory. Enable the Show Service Settings checkbox. Click Next.
3. In the Service Settings window, under Service Account, select Specify Account.
   Input the Windows Username and Password of the Windows account logged into the installing computer/FileSystem. Click Next.
4. From the Database Setup Page, select MS SQL for the Database Type. Under Connection Type, select Basic and enter the corresponding database server and name via DB Server and DB Database, respectively.
5. Under Connection Settings, select Windows Integrated Security. Click Next.
6. Proceed with the rest of the installation.

Configuring Cookies

Securing Cookies when Terminating SSL and Redirecting Requests

In v8, Secure cookies are enabled by default if the application uses HTTPS requests for web traffic communication. No additional configuration is necessary unless Terminating the SSL. If SSL termination occurs at the Load Balancer/Proxy/Application Gateway and redirects the requests from HTTPS to HTTP on the application, it is essential to secure the cookies. Administrators can achieve this through any of the following two methods:

Via Portal Settings:

1. Navigate to the Integration Settings within the application.
2. From the Security Option drop-down menu, select 'Secure'.
3. Save the close.

Running SQL Query on the Database:

Execute the following command in the Query Editor or in the database to update the Integration Settings.

UPDATE integration_settings
SET security_option = 'Secure'

Same Site Cookies

1. Navigate to the Settings.xml file and update the following text values between the DefaultSameSiteCookieMode tags according to the desired cookie settings.
   
   

   Text Value	Cookie Properties
   None	Indicates the client should disable the same site restrictions
   Lax	Indicates the client should send the cookie with "same-site requests" and "cross-site" top-level navigations.
   Strict	Indicates the client should only send the cookie with "same-site" requests.

2. Save the changes and Restart the application to apply the updated settings.

Securing Session ID in Logs

If using v8.5+, users can encrypt the Session ID when viewing logs. Follow the below steps to set this up.

1. Navigate to C:\Program Files\Decisions\Decisions Server and open Settings.xml as an Administrator.
2. Update the values between the ObfuscateSessionIdInLogs tags to True.
3. Save the changes and Restart the application to apply the updated settings.

Enabling HTTP Strict Transport Security (HSTS)

Using HSTS via a response header, a web app can prevent HTTP communications by forcing only HTTPS communications. This may prevent access to any untrusted or invalid certificates. It also disables prompts asking a user to trust a certificate temporarily.

Method 1

The following instructions are for a self-hosted installation.

1. Complete a Decisions installation.
2. Run the installer as an Administrator. Click EDIT SETTINGS.
3. Locate the EnableHttp setting and set it to False. 
4. Locate the EnableHttps setting and set it to True. Set the HttpsPort to 443.
5. Locate the EnableHsts setting and set it to True.
6. Save the changes and Restart the application to apply the updated settings.
   

Method 2

This method allows more flexibility if a user needs to specify something specific in their HSTS policy by adding it to CustomHeader in the settings.xml.

1. Navigate to C:\Program Files\Decisions\Decisions Server and open Settings.xml as an Administrator.
2. Set the <EnableHsts> value to false.
3. Add the following to the <CustomHeaders> node:

   <CustomHeader>
   <Name>Strict-Transport-Security</Name>
   <Value>max-age=31536000;includeSubDomains</Value>
   </CustomHeader>

4. Save the changes and Restart the application to apply the updated settings.

Show Exception Details

1. From the Decisions Studio, navigate to System > Settings. Open Portal Settings. 
2. Under the PORTAL SETTINGS category, enable the Show Exception Details setting, then click SAVE.

   

Blocking File Extensions

The File Extensions setting allows Admin users to restrict the file types that can be imported and used within Decisions. Admin users can locate this setting at System > Settings > Portal Settings. Search for extensions in the search bar.

By default, the Use Extensions Allowed box is unchecked, meaning all extensions except those entered in the box are usable. The default extensions blocked are .bat, .exe., .ps1, .com. These can be changed and added to by the Admin user. A list of blockable extensions is below.

If the Use Extensions Allowed box is checked, no file extensions are allowed except for the ones entered. By default, .zip and .decobj are permitted. It is not recommended that these be removed.

The following list details all extensions/executables/scripts that the Extensions can restrict the Not Allowed setting.

Protecting Against Cross-Frame Scripting (XFS) Attacks and Clickjacking

1. Navigate to C:\Program Files\Decisions\Decisions Server and open Settings.xml as an Administrator.
2. Add the following code before the closing </Settings> tags in the XML.
   This tag makes the necessary changes to the Content-Security-Policy by adding custom headers that embed Decisions with the domain in [BasePortalURL].

   <CustomHeaders>
   	<CustomHeader>
   		<Name>Content-Security-Policy</Name>
   		<Value>frame-ancestors 'self'; default-src 'self'; script-src https://[BasePortalURL] 'unsafe-inline' 'unsafe-eval'; img-src 'self' 'unsafe-inline' data:; style-src 'self' 'unsafe-inline' 'unsafe-eval'; font-src 'self' data:; worker-src 'self' 'unsafe-inline' blob:</Value>
   	</CustomHeader>
   	<CustomHeader>
   		<Name>X-Content-Type-Options</Name>
   		<Value>nosniff</Value>
   	</CustomHeader>
   </CustomHeaders>

3. Restart the server. If applied correctly, the tags as shown for requests in the Chrome Dev Tools.

Hiding the Server Name from the Response Header

The Server header lists what software the server used to handle a user's request.

Perform the following steps to change the server name from the response header.

1. Navigate to C:\Program Files\Decisions\Decisions Server and open Settings.xml as an Administrator.
2. Add the following code inside the <CustomHeaders> tags in the XML. Change the value MyServer as per convenience. Save and Restartthe server.

       <CustomHeader>
   		<Name>Server</Name>
   		<Value>MyServer</Value>
       </CustomHeader>

3. This will change the Server Name in the Response Header if applied correctly.